shushilpant/mining-project-guinea

# ACCI — Adaptive Continuous Compliance Intelligence A web-based compliance and investment-intelligence platform for West African mining authorities, with a regional focus on Ghana, Guinea, and Côte d'Ivoire. ACCI gives a ministry a single hub to monitor operator performance, track compliance against mining agreements, assess risk, trace beneficial ownership, watch local-content delivery, and prepare for negotiations — with an optional, provider-agnostic AI analyst layered on top. > **Status:** Prototype / demonstrator (internal reference PEB-0526-WA-MIN-05). All operators, agreements, financials, and risk flags are illustrative seed data, not live records. ## Table of contents - Features - Tech stack - Getting started - Demo credentials - AI assistant - Project structure - Domain model - Design system - Security & auditability - Deployment - Available scripts ## Features The application is organised into modular pages (each lazily loaded). Routes are gated behind authentication and scoped by role. | Module | Route | What it does | | --- | --- | --- | | Dashboard | `/` | High-level overview: operators, compliance rate, active agreements, critical risk flags, and a morning brief. | | Agreements | `/agreements` | Repository of mining contracts — license type, commodity, royalties, concession area, term. Drill into `/agreements/:id`. | | Performance | `/performance` | Operator scorecards tracking commitments (production, infrastructure, environmental, employment) against actuals. Drill into `/performance/:operatorId`. | | Risk | `/risk` | Automated risk assessment flagging production shortfalls, expiring agreements, and overdue infrastructure. Drill into `/risk/:flagId`. | | Transparency | `/transparency` | EITI-style reporting and document access logs, with a real spreadsheet export. | | Scenarios | `/scenarios` | Financial and operational modelling. | | Negotiation | `/negotiation` | AI-assisted briefing generation for renewals and disputes. | | Ownership | `/ …