Repository Map

ops-platform/
├── apps/
│   └── webapp/              # Next.js frontend
├── backend/
│   └── core-api/            # FastAPI backend
├── app-doc/                 # Docusaurus documentation site
├── supabase/
│   └── migrations/          # v2 schema and migration history
├── docs/                    # internal runbooks, migration plans, references
├── monitoring/              # Prometheus/Grafana/Alertmanager config
├── scripts/                 # validation, health, deployment helper scripts
├── .github/workflows/       # CI/CD/security workflows
├── docker-compose.yml
└── AGENTS.md                # canonical architecture/developer rules

Where to start by task

Task	Start here
Frontend page/UX	apps/webapp/src/app, then apps/webapp/src/modules
Feature module behavior	apps/webapp/src/modules/<feature> and backend/core-api/app/modules/<domain>
Backend endpoint	backend/core-api/app/api/v1/api.py, module router/service
Auth/OIDC	apps/webapp/src/app/auth, apps/webapp/src/lib/oidc.ts, backend/core-api/app/core/auth.py
RBAC/API keys	backend/core-api/app/core/rbac_*, backend/core-api/app/core/api_key_auth.py
Database change	supabase/migrations, backend/core-api/db_schema.sql
Escrow/web3	backend/core-api/app/modules/escrow_chain, apps/webapp/src/modules/escrow-chain
Docs	app-doc/docs, app-doc/sidebars.ts, app-doc/docusaurus.config.ts
Deployment	docker-compose.yml, .github/workflows, docs/DEPLOYMENT.md