# 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.