kayzaddy/nfip

National Fuel Intelligence Platform - Tanzania v1.0.0 MVP # National Fuel Intelligence Platform (NFIP) -green) -orange) Enterprise-grade petroleum intelligence platform for Tanzania — **Version 1.0.0 MVP** baseline (implementation + governance frameworks). **National production deployment and operational evidence are pending.** See docs/release/v1.0.0-MVP/. ## Architecture Official deployment: **cloud-direct TLS** — NFIP connects to TLS4/TLS-450 consoles over private VPN/MPLS (`NFIP_DEPLOYMENT_MODE=CLOUD_DIRECT`). Optional edge gateway: `LOCAL_AGENT`. See Cloud-Direct Architecture and Network Guide. ``` nfip/ ├── apps/ │ ├── api/ # NestJS backend (Clean Architecture + DDD + CQRS) │ └── web/ # Next.js frontend (Executive dashboards + GIS) ├── packages/ │ └── shared/ # Shared types, enums, constants ├── docker-compose.yml └── .env.example ``` ### Backend Stack - **NestJS** + TypeScript - **PostgreSQL** + Prisma ORM - **Redis** (caching) - **RabbitMQ** (message queue) - **OpenSearch** (search) - **Socket.IO** (real-time streaming) - **Argon2** + JWT (authentication) - **RBAC** (authorization); ABAC planned — not platform-wide in MVP ### Frontend Stack - **Next.js 15** + TypeScript - **TailwindCSS** + ShadCN UI - **Framer Motion** (animations) - **React Query** (data fetching) - **Mapbox GL** (GIS map) - **Recharts** (charts) ## Quick Start ### Prerequisites - Node.js 20+ - pnpm 9+ - Docker & Docker Compose ### 1. Start Infrastructure ```bash docker compose up -d ``` ### 2. Install Dependencies ```bash pnpm install ``` ### 3. Configure Environment ```bash cp .env.example .env ``` ### 4. Setup Database ```bash pnpm db:generate pnpm db:migrate pnpm db:seed ``` ### 5. Start Development ```bash pnpm dev ``` - **API**: localhost - **Swagger**: localhost - **GraphQL**: localhost - **Frontend**: localhost - **WebSocket**: ws://localhost:3001/live ### Default Credentials - Email: `admin@ewura.go.tz` - Password: …