How xaltezzarx/boneqc works
BoneQC is a web platform for technical quality control of DXA DICOM studies, not a diagnostic system. The main workflow is study upload and validation, queued analysis, frozen C7 inference, and a structured QC result for review. The API also supports expert annotations and consensus, dataset snapshots, model management, audit, and operations. The README documents the end-to-end architecture; source-index references and excerpts clarify several API, queue, and evaluation responsibilities. Worker internals and some route implementations were not excerpted, so their detailed relationships are shown only where documented or indexed.
Main entry points: worker.py Processing worker · main.py API router · page.tsx Web workspace · studies.py Study and dataset routes
Components 25
Web experience
- Web workspace
apps/web/app/(protected)/studies/[id]/page.tsx - Expert review
apps/web/components/clinical-review-panel.tsx - Web API proxy
apps/web/app/api/backend/[...path]/route.ts
Product API
- API router
apps/api/app/main.py - Study and dataset routes
apps/api/app/api/v1/studies.py - Analysis routes
apps/api/app/api/v1/analysis.py - Annotation routes
apps/api/app/api/v1/annotations.py
QC processing
- Job creation
apps/api/app/analysis/service.py - Processing worker
apps/api/app/worker.py - DICOM safeguards
apps/api/app/dicom - Quality evaluation
apps/api/app/quality/engine.py - Uncertainty evaluation
apps/api/app/uncertainty/engine.py - Decision resolution
apps/api/app/decision/resolver.py
Product state
- Analysis results
apps/api/app/models/analysis_result.py - Audit events
apps/api/app/audit/service.py - Study object storage
apps/api/app/storage/service.py - Analysis queue
apps/api/app/queue/service.py - Model registry
apps/api/app/model_registry/service.py - Expert annotations
apps/api/app/models/study_annotation_consensus.py - Dataset snapshots
apps/api/app/dataset/snapshots.py
Inference runtimes
- C7 product adapter
apps/api/app/ai/c7_product.py - C7 gateway client
apps/api/app/ai/c7_gateway.py - Frozen C7 runtime
- Product AI service
apps/ai-engine/app/main.py
Other components
- Clinical user
Connections 26
- Clinical user → Web workspace: uses
README.md - Web workspace → Web API proxy: requests
apps/web/app/api/backend/[...path]/route.ts - Web API proxy → API router: forwards requests
README.md - API router → Study and dataset routes: registers routes
apps/api/app/main.py - API router → Analysis routes: registers routes
apps/api/app/main.py - API router → Annotation routes: registers routes
apps/api/app/main.py - Study and dataset routes → Study object storage: stores study files
- Analysis routes → Job creation: creates jobs
- Job creation → Analysis queue: enqueues job
apps/api/app/analysis/service.py - Job creation → Audit events: records event
apps/api/app/analysis/service.py - Analysis queue → Processing worker: dispatches jobs
README.md - Processing worker → DICOM safeguards: checks DICOM
apps/api/app/worker.py - Processing worker → C7 product adapter: invokes analysis
apps/api/app/worker.py - C7 product adapter → C7 gateway client: uses gateway
apps/api/app/ai/c7_product.py - C7 gateway client → Frozen C7 runtime: calls runtime
README.md - Processing worker → Quality evaluation: evaluates observations
apps/api/app/worker.py - Processing worker → Uncertainty evaluation: evaluates confidence
apps/api/app/worker.py - Processing worker → Decision resolution: resolves outcome
apps/api/app/worker.py - Processing worker → Analysis results: persists result
README.md - Analysis results → Web workspace: presents result
README.md - Web workspace → Expert review: opens review
apps/web/components/clinical-review-panel.tsx - Expert review → Annotation routes: submits annotations
- Annotation routes → Expert annotations: records consensus
- Study and dataset routes → Dataset snapshots: manages snapshots
- Processing worker → Model registry: resolves model
apps/api/app/worker.py - Processing worker → Product AI service: optional remote inference
apps/api/app/worker.py