Technical Reference
Engineering-depth reference. Cross-refs to source-of-truth docs in docs/develop/.
Repo layout
PatientRx/
├── apps/
│ ├── api/ # NestJS 10 · TypeScript strict · port 6201
│ ├── web/ # Next.js 15 · React 19 · port 6200
│ ├── ml/ # FastAPI · Python 3.12 · port 6202
│ ├── landing/ # Pure HTML · deployed to Azure SWA
│ ├── docs/ # Docusaurus · this site
│ └── research/
│ ├── memory-store/ # FastAPI · port 6401 (SPEC-01, 05)
│ ├── research-engine/ # FastAPI · port 6402 (SPEC-02)
│ ├── orchestrator/ # FastAPI · port 6403 (SPEC-03)
│ ├── model-optimization/ # FastAPI · port 6404 (SPEC-04, 07)
│ └── benchmark/ # CLI harness (SPEC-07)
├── packages/
│ └── patientrx-contracts/ # Shared Pydantic schemas + Protocol ABCs
├── research-engine/packages/
│ ├── patientrx-guardrails/ # HIPAA-aware audit + consent SDK
│ ├── patientrx-memory-sdk/ # Memory-store SDK
│ └── patientrx-memory-mcp/ # MCP server for Claude Code
├── specs/ # 61 feature specs (speckit artifacts)
├── docs/ # Source-of-truth docs
├── infrastructure/
│ └── azure-monitor/ # KQL + workbooks + alerts (SPEC-07)
├── scripts/ # CI gates + dev tools + migrations
└── .claude/ # 51 skills + 11 hooks + config
Subsections
- Services → — every service's purpose + port + owner
- Stack → — tech choices + rationale
- Data flows → — request paths, retrieval, audit
- Development workflow → — speckit pipeline + hooks + testing
Authoritative source-of-truth docs
| Topic | Location |
|---|---|
| Modules inventory | docs/develop/modules.md |
| Features table | docs/develop/features.md |
| Flows | docs/develop/flows.md |
| CI gates | docs/develop/ci-gates.md |
| Testing patterns | docs/develop/testing.md |
| Skills inventory | docs/develop/skills.md |
| Hooks inventory | docs/develop/hooks.md |
| Patterns catalog | docs/develop/patterns.md (generated) |
| Development process | docs/develop/development-process.md |