SuperApp Ghana — enterprise financial platform monorepo (6 microservices, Terraform, K8s, CI/CD, FortiCNAPP)
# SuperApp Platform — Monorepo
> Ghana's enterprise digital financial platform. Mono-repo containing all microservices, shared libraries, infrastructure-as-code, Kubernetes manifests, CI/CD pipelines, and documentation in a single repository.
---
## 📦 Repository Structure
```
superapp-monorepo/
│
├── src/ ← All application code
│ ├── shared/ ← Libraries shared by all services
│ │ ├── SuperApp.Common/ ← Result , AppError types, PagedResult
│ │ ├── SuperApp.Domain/ ← AggregateRoot, DomainEvent, Money value object
│ │ ├── SuperApp.Messaging/ ← Kafka topic constants + all event contracts
│ │ ├── SuperApp.Infrastructure/← Repository pattern, Outbox, EF Core base
│ │ └── SuperApp.Security/ ← Correlation ID, security headers middleware
│ │
│ └── services/ ← Microservices (one folder = one deployable)
│ ├── identity-api/ ← Auth, registration, MFA, KYC, JWT issuance
│ ├── payment-api/ ← Payment processing (GhIPSS, ExpressPay, Hubtel)
│ ├── wallet-api/ ← Digital wallet with double-entry ledger
│ ├── account-api/ ← Bank account management
│ ├── notification-api/ ← SMS, email, push via Hubtel
│ └── api-gateway/ ← YARP reverse proxy + rate limiting + JWT validation
│
├── tests/
│ ├── unit/ ← Fast unit tests (no Docker required)
│ └── integration/ ← Integration tests using Testcontainers
│
├── platform/ ← All infrastructure and deployment code
│ ├── terraform/ ← Azure IaC (AKS, SQL, Event Hubs, Key Vault...)
│ ├── kubernetes/ ← Cilium policies + Helm values per service
│ ├── gitops/ ← ArgoCD ApplicationSet (GitOps deployment)
│ └── scripts/deploy.sh ← Single end-to-end deployment script
│
├── docs/ ← Archit …