Unified Project Structure
Last updated: February 2026
emtb-monorepo/
├── .github/ # CI workflows (GitHub Actions)
├── apps/
│ ├── api/ # NestJS backend application
│ │ ├── src/
│ │ │ ├── auth/ # Authentication (JWT, Passport, login/register)
│ │ │ ├── casl/ # CASL ability factory & policies guard
│ │ │ ├── client/ # Client management module
│ │ │ ├── site/ # Site management module
│ │ │ ├── cadastre/ # Cadastre management module
│ │ │ ├── reclamation/ # Tax claim (reclamation) module
│ │ │ ├── invoice/ # Client invoice module
│ │ │ ├── partner/ # Partner management module
│ │ │ ├── partner-invoice/ # Partner billing module
│ │ │ ├── user/ # User management module
│ │ │ ├── email/ # Email campaigns (Brevo integration)
│ │ │ ├── document/ # Document management
│ │ │ ├── storage/ # S3/R2 object storage service
│ │ │ ├── dashboard/ # Dashboard KPI endpoints
│ │ │ ├── reports/ # PDF report generation
│ │ │ ├── exports/ # Excel export generation
│ │ │ ├── import/ # Data import CLI commands
│ │ │ ├── health/ # Health check endpoint
│ │ │ ├── common/ # Shared decorators, pipes, filters, guards
│ │ │ ├── database/
│ │ │ │ ├── entities/ # TypeORM entity definitions
│ │ │ │ ├── migrations/ # TypeORM migrations
│ │ │ │ └── data-source.ts # TypeORM data source config
│ │ │ ├── cli/ # CLI command modules (nest-commander)
│ │ │ ├── types/ # Backend-specific type definitions
│ │ │ └── scripts/ # Utility scripts (seed, import, migrate)
│ │ ├── test/ # E2E test config
│ │ ├── Dockerfile # Multi-stage Docker build
│ │ └── package.json
│ │
│ ├── frontend/ # React + Vite frontend application
│ │ ├── src/
│ │ │ ├── main.tsx # App entry point
│ │ │ └── globals.css # Global styles
│ │ ├── app.tsx # Root App component with router
│ │ ├── components/ # Shared UI components
│ │ │ ├── data-grid-pro/ # MUI DataGrid Pro wrappers
│ │ │ ├── feedback/ # Dialogs, snackbars, confirmations
│ │ │ ├── ui/ # Base UI primitives (Shadcn/MUI)
│ │ │ └── ...
│ │ ├── features/ # Feature modules (domain-driven)
│ │ │ ├── auth/ # Login, auth context, guards
│ │ │ ├── clients/ # Client list, detail, forms
│ │ │ ├── sites/ # Site management
│ │ │ ├── cadastres/ # Cadastre management
│ │ │ ├── reclamations/ # Tax claim management
│ │ │ ├── factures/ # Client invoices
│ │ │ ├── factures-partenaire/ # Partner invoices
│ │ │ ├── partners/ # Partner management
│ │ │ ├── emails/ # Email campaign management
│ │ │ ├── users/ # User management
│ │ │ ├── dashboard/ # Dashboard & KPIs
│ │ │ └── reports/ # Report generation
│ │ ├── hooks/ # Shared React hooks
│ │ ├── lib/ # Utilities, API client, auth helpers
│ │ ├── pages/ # Page-level route components
│ │ ├── providers/ # Context providers (Auth, MUI, Query)
│ │ ├── menu-items/ # Sidebar navigation config
│ │ ├── Dockerfile # Multi-stage Docker build (Nginx)
│ │ └── package.json
│ │
│ └── e2e/ # Playwright E2E tests
│ ├── tests/ # Test specs
│ ├── playwright.config.ts
│ └── package.json
│
├── shared/
│ └── types/ # Shared TypeScript types (@emtb/shared-types)
│ ├── src/
│ └── package.json
│
├── docs/ # Project documentation (served by Docusaurus)
│ ├── architecture/ # Architecture docs
│ ├── prd/ # Product requirements
│ ├── stories/ # User stories
│ ├── epics/ # Epic definitions
│ └── index.md # Documentation homepage
│
├── docs-site/ # Docusaurus documentation site
│ ├── docusaurus.config.js
│ ├── sidebars.js
│ └── package.json
│
├── scripts/ # Root-level utility scripts
├── turbo.json # Turborepo pipeline config
├── package.json # Root workspace config
├── .yarnrc.yml # Yarn 4 configuration
└── README.md # Project introduction