How naveenraj-g/fhir-server works
This is a FastAPI FHIR R4 healthcare API. A client sends an authenticated resource request; the router resolves dependencies, invokes resource services and repositories, and returns either FHIR or plain JSON. Coverage excerpts show that path directly, while README documentation establishes broader resource support, JWT permissions, tenant scoping, Redis-backed middleware, terminology, vitals, and health probes. Several broader branches are documented but their implementation wiring was not sampled, so those links are marked unverified.
Main entry points: main.py Application entry · coverage.py Resource routes · coverage_service.py Coverage service · coverage_repository.py Coverage repository
Components 18
API and access
- Application entry
app/main.py - JWT authorization
app/auth/dependencies.py - Resource routes
app/routers/coverage.py - Input schemas
app/schemas/coverage/input.py - Format negotiation
app/core/content_negotiation.py
FHIR resource workflow
- Coverage service
app/services/coverage_service.py - Coverage repository
app/repository/coverage_repository.py - FHIR resource models
app/models/coverage/coverage.py - FHIR/plain mappers
app/fhir/mappers/coverage/__init__.py
Runtime platform
- PostgreSQL
- Async database layer
app/core/database.py - Redis sessions and limits
app/core/redis.py - Request middleware
app/middleware/request_context.py
Additional capabilities
- Terminology API
app/routers/terminology.py - Vitals API
app/routers/vitals.py - Health probes
app/main.py
Other components
- API client
- FHIR client
Connections 17
- API client → Application entry: sends request
- Application entry → JWT authorization: requires JWT
app/main.py - Application entry → Resource routes: mounts routes
app/main.py - Resource routes → Input schemas: validates input
app/routers/coverage.py - Resource routes → Coverage service: invokes
app/routers/coverage.py - Coverage service → Coverage repository: delegates CRUD
app/services/coverage_service.py - Coverage repository → FHIR resource models: queries and writes
app/repository/coverage_repository.py - Coverage repository → Async database layer: uses sessions
- Async database layer → PostgreSQL: stores records
- Coverage service → FHIR/plain mappers: maps resources
app/services/coverage_service.py - Resource routes → Format negotiation: formats response
app/routers/coverage.py - Application entry → Request middleware: configures middleware
- Request middleware → Redis sessions and limits: uses Redis
- Application entry → Terminology API: mounts capability
app/main.py - Application entry → Vitals API: mounts capability
app/main.py - Application entry → Health probes: serves probes
app/main.py - FHIR client → Resource routes: requests resources