sankofa-hw-infra/README.md

Sankofa HW Infra

Hardware procurement, inventory, and operations platform for sovereign cloud operations: offer intake, inspection workflows, purchasing controls, asset lifecycle, multi-site management, and integrations. UniFi is used as a hardware-aware, compliance-relevant infrastructure layer (product intelligence, support horizon, per-sovereign controller topology). See docs/architecture.md, docs/integration-spec-unifi.md, and docs/sovereign-controller-topology.md.

Stack

• Monorepo: pnpm workspaces
• API: Fastify (Node), REST /api/v1, JWT + RBAC/ABAC
• Web: React + Vite
• DB: PostgreSQL (Drizzle), S3-compatible object storage
• Workflow: Embedded state machines (PO approval, inspection)

Quick start

1. Copy env.example to .env and set DATABASE_URL, optional S3_*, JWT_SECRET.
2. Start Postgres: cd infra && docker compose up -d
3. Migrate: pnpm db:migrate
4. Install: pnpm install
5. API: pnpm --filter @sankofa/api run dev (port 4000)
6. Web: pnpm --filter @sankofa/web run dev (port 3000)

Scripts

• pnpm run build — build all packages
• pnpm run test — run tests
• pnpm run lint — lint
• pnpm db:migrate — run DB migrations

Docs

• Architecture
• ERD
• OpenAPI
• RBAC sovereign operations, Compliance profiles
• CI/CD
• Integration specs, Proxmox, Redfish
• Purchasing feedback loop, Sovereign controller topology
• Capacity dashboard spec (RU utilization, power headroom, GPU inventory; UI at /capacity)
• Operational baseline (current hardware in-hand; see data/operational-baseline-hardware.json for structured import)
• Vendor portal (vendor user login, scoped offers/POs), Offer ingestion (scrape + email intake)
• Next steps before Swagger and UI
• Runbooks