How yogenyslav/ldt-2026 works
This repository implements a DXA-image quality-assessment product: users upload or receive studies, asynchronous services analyze them, and results return to review, annotation, and reporting workflows. The graph follows the documented UI → manager → worker → NATS → analyzer path and includes the analyzer’s region-specific quality stages. README statements support several cross-service links; source excerpts show selected internal wiring, while unsampled subsystems are represented only at the level supported by the tree and documentation.
Main entry points: main.go HTTP API · App.tsx Web application · service.py Analyzer service · pipeline.py Quality pipeline
Components 28
User workflows
- Web application
ui/src/App.tsx - Review workspace
ui/src/_root/pages/Study.tsx - Annotation and training
ui/src/_root/pages/Annot.tsx - Reports workspace
ui/src/_root/pages/Reports.tsx
Study management
- HTTP API
dicom-manager/cmd/service/main.go - DICOM intake and retrieval
dicom-manager/internal/api/dicom/upload/handler.go - Job status and decisions
dicom-manager/internal/api/job/result_decision/handler.go - Annotation and training API
dicom-manager/internal/api/annotation/submit/handler.go - Report generation
dicom-manager/internal/usecases/report/generate/usecase.go - Manager event listener
dicom-manager/cmd/job_listener/main.go
Analysis processing
- Job RPC service
dicom-worker/internal/rpc/worker/handler.go - Transactional outbox
dicom-worker/cmd/outbox/main.go - Result listener
dicom-worker/cmd/result_listener/main.go - Job expiration
dicom-worker/cmd/expiration_checker/main.go
Quality analysis
- Analyzer service
dicom-analyzer/service.py - Quality pipeline
dicom-analyzer/qc/pipeline.py - Region voting
dicom-analyzer/qc/region_vote.py - Model registry
dicom-analyzer/qc/hub.py - Spine criteria
dicom-analyzer/qc/spine_branch.py - Hip criteria
dicom-analyzer/qc/hip_branch.py - Pelvis geometry
dicom-analyzer/qc/crest_math.py - Implant assessment
dicom-analyzer/qc/implant_trochanter.py - Result rendering
dicom-analyzer/render.py
Storage and integrations
- Orthanc DICOM server
- NATS messaging
- PostgreSQL
- S3-compatible storage
Other components
- Staff user
Connections 35
- Staff user → Web application: uses
README.md - Web application → HTTP API: calls HTTP
README.md - Web application → Review workspace: opens
ui/src/App.tsx - Web application → Annotation and training: opens
ui/src/App.tsx - Web application → Reports workspace: opens
ui/src/App.tsx - Review workspace → HTTP API: requests results
README.md - Annotation and training → HTTP API: submits annotations
README.md - Reports workspace → HTTP API: requests reports
README.md - HTTP API → DICOM intake and retrieval: routes intake
dicom-manager/cmd/service/main.go - DICOM intake and retrieval → Orthanc DICOM server: stores and retrieves images
README.md - DICOM intake and retrieval → Job RPC service: starts jobs
README.md - Job RPC service → Transactional outbox: creates events
- Transactional outbox → NATS messaging: publishes jobs
README.md - NATS messaging → Analyzer service: delivers jobs
README.md - Analyzer service → Orthanc DICOM server: loads images
README.md - Analyzer service → Quality pipeline: runs analysis
- Quality pipeline → Model registry: uses models
dicom-analyzer/qc/pipeline.py - Quality pipeline → Region voting: votes region
dicom-analyzer/qc/pipeline.py - Quality pipeline → Spine criteria: analyzes spine
dicom-analyzer/qc/pipeline.py - Quality pipeline → Hip criteria: analyzes hip
dicom-analyzer/qc/pipeline.py - Spine criteria → Pelvis geometry: uses geometry
dicom-analyzer/qc/spine_branch.py - Hip criteria → Implant assessment: assesses implant
dicom-analyzer/qc/hip_branch.py - Analyzer service → NATS messaging: returns results
README.md - NATS messaging → Result listener: delivers results
dicom-worker/cmd/result_listener/main.go - Result listener → PostgreSQL: saves results
- Result listener → NATS messaging: publishes status
dicom-worker/cmd/result_listener/main.go - NATS messaging → Manager event listener: delivers status
dicom-manager/cmd/job_listener/main.go - Manager event listener → PostgreSQL: updates jobs
dicom-manager/cmd/job_listener/main.go - Job status and decisions → PostgreSQL: reads and writes jobs
- Annotation and training API → PostgreSQL: stores submissions
- Report generation → S3-compatible storage: stores report files
README.md - HTTP API → Report generation: routes report requests
dicom-manager/cmd/service/main.go - Analyzer service → Result rendering: renders overlays
- Transactional outbox → PostgreSQL: persists events
- Job expiration → PostgreSQL: checks timeouts
dicom-worker/cmd/expiration_checker/main.go