CellionOne/Resourcehub-Africa

# ResourceHub Africa ResourceHub Africa is an Autonomous Resource Intelligence Operating System (ARIOS) for African resource sectors. The launch wedge is Nigerian mining, but the codebase is organised for country, sector, source, tenant, and intelligence-product expansion without redesign. ## Current Status This repository contains: - Enterprise documentation and build planning artifacts in `docs`. - A FastAPI backend with tenant, role, permission, audit, registry, governance, intelligence-foundation, control-centre, subscription, and API marketplace shells. - A Next.js operational frontend for administering foundation records and monitoring ARIOS readiness. - SQL migrations in `backend/migrations`. - Backend and frontend tests/build scripts. The current product remains foundation-first: manual governance, placeholder workflows, and read-only control-centre aggregation are implemented before autonomous ingestion, AI execution, advanced GIS, graph inference, billing, or marketplace execution. ## Repository Layout - `AGENTS.md`: project working instructions for Codex. - `docs`: business, product, architecture, and build planning documents. - `backend`: FastAPI service, SQLAlchemy models, routes, tests, migrations, and env example. - `frontend`: Next.js app, shared API client, screens, and env example. - `DEPLOYMENT.md`: local, Replit, database, migration, verification, and GitHub push instructions. ## Local Setup ### Backend ```powershell cd backend python -m venv .venv .venv\Scripts\Activate.ps1 pip install -r requirements.txt Copy-Item .env.example .env uvicorn app.main:app --reload --host 0.0.0.0 --port 8000 ``` The backend health endpoint is: ```text 127.0.0.1 ``` ### Frontend ```powershell cd frontend npm install Copy-Item .env.example .env.local npm run dev ``` The frontend defaults to `NEXT_PUBLIC_API_BASE_URL=127.0.0.1`. ## Environment Variables Backend variables are documented in `backend/.env.exam …