Tech Team — Internal Engineering Documentation¶
Service catalogue¶
The platform consists of 9 NestJS services, 1 internal SPA, and 4 shared packages.
| Service | Purpose | Doc |
|---|---|---|
admin-api |
BFF for the internal admin UI: Google OIDC sessions, dashboard fan-out, audit log | services/admin-api.md |
admin-ui |
Internal admin SPA (Vite + React + Mantine) | services/admin-ui.md |
ai-review |
AI-driven case review (DERM 5.0.0 integration) | services/ai-review.md |
auth |
OAuth2 client credentials, JWT issuance, JWKS, admin SSO callback | services/auth.md |
clinical-api |
Cases, patients, findings, diagnoses (system of record) | services/clinical-api.md |
consent |
Consent type registry + per-patient consent records | services/consent.md |
human-review |
Human reviewer queue + decision capture | services/human-review.md |
notifications |
Email / Slack delivery via BullMQ | services/notifications.md |
orchestrator |
Cross-module workflow engine | services/orchestrator.md |
user-management |
User profile, roles, org membership | services/user-management.md |
Shared packages¶
See packages.md.
Cross-service flows¶
- AI review flow — case submission → AI inference → diagnosis projection
- Orchestrator flow — workflow definition driving cross-service actions
Runbooks¶
Architecture decision records¶
Engineering specs and plans live in docs/superpowers/specs/ and
docs/superpowers/plans/. The ADR index curates the
most-relevant decisions.