dev-procfile/report/01-project-index.md

Project index

Repository	Purpose	Main domain
ui	Next.js customer site and dashboard	onboarding, assets, buy/redeem, market, history
api	Only public HTTP gateway; translates REST to gRPC	API/auth boundary
auth	OTP, JWT, TFA, identity, bank info, roles/permissions	identity and access
wallet	Wallet, asset, transaction, market, IPG, BNPL, redeem, alert workers	financial orchestration
GL	Append-only double-entry ledger and explorer	backup financial truth
AdminPanel	Django operations console with direct shared-DB access	manual administration
proto	Versioned gRPC contracts	service boundary
DevOps	Compose, Traefik, databases, Redis, RabbitMQ, MinIO, monitoring	runtime platform
Kuknos-Node-scripts	Kuknos/Stellar node operations	blockchain infrastructure
docs	Product documentation	documentation
alert	Legacy/minimal alert repository; active alert server is in Wallet	notifications

Runtime shape

Browser -> UI -> API -> Auth / Wallet / Market / Alert

Wallet uses PostgreSQL and Redis, submits blockchain work through the Stellar-compatible Kuknos adapter, and publishes durable transaction events through RabbitMQ. Wallet also has a separate durable outbox that mirrors lifecycle events and successful monetary effects to GL.

Branch reality

• Refactor code is active in wallet, auth, proto, and AdminPanel feature branches.
• Full GL code is now checked out on GL/feat/refactor-v1, tracking origin/feat/refactor-v1.
• api and dev-procfile have no local or remote feat/refactor-v1 ref in this checkout; both remain on main rather than inventing an untracked branch lineage.
• Stage compose currently deploys API/Auth/Wallet/Admin/UI, but not GL or the GL explorer.