Tesfayesus40/nahu-platform

Enterprise Digital Agriculture Platform for Ethiopia # Nahu Platform Ethiopia's digital agriculture platform — a secure, mobile-first marketplace connecting farmers, buyers, cooperatives, and the wider agricultural value chain. **Author:** Tesfayesus Yimenu Yirdaw **License:** MIT --- ## Vision Build the digital infrastructure that enables Ethiopia's agricultural economy to operate more efficiently, transparently, and globally. See Business Model for the full enterprise vision. ## Roadmap (official) | Document | Role | |----------|------| | **PROJECT_ROADMAP.md** | Living phase status — **start here for current work** | | **NAHU_MASTER_ROADMAP.md** | Master source of truth (vision, architecture, versions, decisions) | | Strategic roadmap archive | Adopted strategic text | **Current phase:** Phase 1 – RC1 Pilot & UAT. Next major product milestone after coffee maturity: **Nahu Farms v2.0**. Do not start future phases early. --- ## Repository map ``` nahu-platform/ ├── apps/ │ └── api/ # NestJS backend (@nahu-platform/api) ├── packages/ # Shared libraries (future: mobile-core, ui) ├── database/ │ ├── migrations/ # SQL-first schema migrations (identity, marketplace, orders) │ └── docs/ # Data dictionary ├── docs/ # Business, architecture, domain model, engineering guides ├── package.json # Monorepo root (pnpm + Turborepo) ├── pnpm-workspace.yaml └── turbo.json ``` | Path | Purpose | |------|---------| | `apps/api/` | REST API under `/api/v1` — Identity, Marketplace, Orders, Certificates, Advisory | | `database/migrations/` | Authoritative schema changes (apply manually in order) | | `docs/` | Business rules, architecture principles, engineering playbook | | `packages/` | Reserved for shared packages (`@nahu-platform/*`) | --- ## Prerequisites | Tool | Version | |------|---------| | Node.js | 20+ | | pnpm | 9.x (`packageManager` field pins 9.15.0) | | PostgreSQL | 14+ | --- ## Quick start ### 1. Clone and install ```bash git clone …