> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equa.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Architecture

> System architecture and design documentation for the Equa platform

# Architecture

This section covers the technical architecture of the Equa equity management platform, including system design, data model, infrastructure, and integration patterns.

## Documents (12)

| Document                                                                   | Description                                                       | Status |
| -------------------------------------------------------------------------- | ----------------------------------------------------------------- | ------ |
| [System Overview](/architecture/system-overview)                           | High-level system architecture and component diagram              | DRAFT  |
| [Data Model](/architecture/data-model)                                     | Core entities (92 TypeORM), relationships, and database schema    | DRAFT  |
| [Frontend Architecture](/architecture/frontend-architecture)               | equa-web 24-module structure, routing, state management           | DRAFT  |
| [Backend Architecture](/architecture/backend-architecture)                 | equa-server module structure, middleware, service layer           | DRAFT  |
| [Auth & Permissions](/architecture/auth-and-permissions)                   | Login, OAuth, RBAC, organization permissions                      | DRAFT  |
| [File Storage Architecture](/architecture/file-storage-architecture)       | Document storage, upload pipeline, CDN                            | DRAFT  |
| [Notification System](/architecture/notification-system)                   | Email, in-app notifications, event-driven architecture            | DRAFT  |
| [Event & Activity Model](/architecture/event-and-activity-model)           | Activity feed, audit trail, event sourcing                        | DRAFT  |
| [Third-Party Integrations](/architecture/third-party-integrations)         | Google Drive, Microsoft, third-party service patterns             | DRAFT  |
| [Entity Relationship Diagrams](/architecture/entity-relationship-diagrams) | Visual ER diagrams for all domain entities                        | DRAFT  |
| [Deployment Infrastructure](/architecture/deployment-infrastructure)       | Railway/nginx interim, legacy Cloud Run reference, CI/CD pipeline | DRAFT  |
| [Environments & Config](/architecture/environments-and-config)             | Environment variables, staging/production config                  | DRAFT  |

## Source Repositories

| Repository                                                                | Role                           |
| ------------------------------------------------------------------------- | ------------------------------ |
| [equa-web](https://github.com/EQUAStart/equa-web)                         | Frontend (React SPA modules)   |
| [equa-server](https://github.com/EQUAStart/equa-server)                   | Backend API (Node.js modules)  |
| [equa-patternlib](https://github.com/EQUAStart/equa-patternlib-nextjs)    | Design system (30+ components) |
| [equa-desktop-app](https://github.com/EQUAStart/equa-desktop-app-mac-ios) | macOS/iOS native client        |