amadou112/AfricaTradeX

AI-powered global import/export, logistics & trade intelligence platform (Africa-first). FastAPI + Next.js modular monolith, synthetic demo data, honest labelled AI. # AfricaTradeX AI-powered global import, export, logistics, and trade intelligence platform, built for Africa — starting with Mali and West Africa. The product specification lives in CLAUDE.md. This README covers running it. **Current state: Phase 1 — Platform Foundation.** See Roadmap for what is and is not built. --- ## Quick start Requires Docker Desktop. ```bash cp .env.example .env docker compose up -d --build ``` First boot runs migrations and seeds demo data automatically. Then open: | Service | URL | | -------------- | ------------------------------ | | Web app | localhost | | API docs | localhost | | Full stack via NGINX | localhost | | MinIO console | localhost | Host ports are configurable in `.env` (`HOST_*_PORT`) so the stack coexists with other local projects. Container-internal ports never change. ### Demo accounts Password for all seeded accounts is `SEED_DEMO_PASSWORD` from `.env` (default `Demo!Pass123`). | Email | Role | | ------------------------------- | ------------------- | | `admin@africatradex.demo` | Administrator | | `buyer@africatradex.demo` | Individual buyer | | `business@africatradex.demo` | Business buyer | | `supplier1@africatradex.demo` | Supplier (verified) | | `supplier5@africatradex.demo` | Supplier (pending review) | | `logistics@africatradex.demo` | Logistics provider | | `customs@africatradex.demo` | Customs agent | | `warehouse@africatradex.demo` | Warehouse operator | | `institution@africatradex.demo` | Institutional user | > **All seeded suppliers, products, prices, ratings, and duty rates are simulated.** > No payment processor, carrier API, currency feed, or customs system is connected. > The UI labels this everywhere it appears. --- ## Landed cost (Phase 2) The platform's defining question — …