CIRCA-RL-GHANA/Root

Root Files # PROMPT Genie **Version:** 1.0.0 · **Status:** Production Multi-role super-app for West Africa (Ghana, Nigeria) — combining financial services, ride-hailing, e-commerce, and social features in a single platform. --- ## Architecture Overview | Layer | Technology | |---|---| | Backend API | NestJS 10 · TypeScript 5 · Node.js 18 | | Database | PostgreSQL 15 | | Cache / Queues | Redis 7 | | Real-time | Socket.io 4 (NestJS Gateway) | | ORM | TypeORM 0.3 | | Mobile / Web | Flutter 3.2+ | | State Management | Provider 6 + Riverpod 2 | | Reverse Proxy | Nginx 1.25 | | Containerisation | Docker + Docker Compose | | TLS | Let's Encrypt (Certbot) | --- ## Repository Layout ``` thedep/ ├── orionstack-backend--main/ # NestJS API server │ ├── src/ │ │ ├── app.module.ts # Root module (27 feature modules) │ │ ├── main.ts # Bootstrap, Helmet, CORS, Swagger │ │ ├── config/ # Env validation (Joi), TypeORM factory │ │ ├── database/ # Data source, migrations (25), seeds │ │ ├── gateway/ # WebSocket chat gateway (Socket.io) │ │ ├── common/ # Filters, interceptors, guards, DTOs │ │ └── modules/ # 27 feature modules (see below) │ ├── Dockerfile # Multi-stage production image │ └── docker-compose.yml # Dev stack (postgres, redis, app) ├── thepg/ # Flutter mobile + PWA app │ ├── lib/ │ │ ├── main.dart # App entry point │ │ ├── core/ # Network, routing, theme, providers │ │ ├── features/ # 12 feature modules (~180 screens) │ │ ├── models/ # Shared data models │ │ ├── services/ # Business logic services │ │ └── widgets/ # Reusable UI components │ └── pubspec.yaml ├── nginx/ # Nginx config + conf.d/ ├── docker-compose.prod.yml # Production full-stack compose ├── Makefile # Operational commands └── script …