How artemmukh/dental-flux-ai works
Dental Flux AI is a backend prototype for reviewing panoramic dental X-rays: a session accepts an image, runs tooth/findings analysis, supports clinician corrections, and produces a draft report for confirmation. Confirmed sessions can feed correction/export data. The README also describes anonymized LLM reporting and validation. The sampled code shows orchestration and storage, but not every API or ML implementation; edges below use indexed references, excerpts, or README statements rather than assuming an unsampled pipeline.
Main entry points: mock_state.py Session orchestration · main.py API application · report_gen.py Report generation · mutations.py Edit mutations
Components 24
API and sessions
- API application
backend/app/main.py - Session endpoints
backend/app/api/sessions.py - Finding endpoints
backend/app/api/findings.py - Chat endpoint
backend/app/api/chat.py - Confirmation endpoint
backend/app/api/confirm.py - Edit log endpoint
backend/app/api/log.py - Overlay endpoint
backend/app/api/overlay.py - Export endpoint
backend/app/api/export.py - Report endpoint
backend/app/api/report.py - Session orchestration
backend/app/core/mock_state.py
Image analysis
- ML backends
backend/app/ml - Finding enrichment
backend/app/ml/enrich.py
Clinical review
- Edit mutations
backend/app/core/mutations.py - FDI rules
backend/app/core/fdi.py
Reports and LLM
- Report generation
backend/app/llm/report_gen.py - Formula and review views
backend/app/report - LLM validator
backend/app/llm/validator.py - OpenRouter client
backend/app/llm/client.py - Fallback report
backend/app/llm/fallback.py
Persistence and export
- Session store
backend/app/core/store.py - Dataset exports
backend/app/export
Other components
- Clinician
- Panoramic image
- OpenRouter
Connections 33
- Panoramic image → Session endpoints: uploads
README.md - Clinician → API application: uses API
README.md - API application → Session endpoints: routes
backend/app/main.py - API application → Finding endpoints: routes
backend/app/main.py - API application → Chat endpoint: routes
backend/app/main.py - API application → Confirmation endpoint: routes
backend/app/main.py - API application → Edit log endpoint: routes
backend/app/main.py - API application → Overlay endpoint: routes
backend/app/main.py - API application → Export endpoint: routes
backend/app/main.py - API application → Report endpoint: routes
backend/app/main.py - Session endpoints → Session orchestration: delegates
backend/app/api/sessions.py - Finding endpoints → Session orchestration: delegates
backend/app/api/findings.py - Chat endpoint → Session orchestration: delegates
backend/app/api/chat.py - Confirmation endpoint → Session orchestration: delegates
backend/app/api/confirm.py - Edit log endpoint → Session orchestration: delegates
backend/app/api/log.py - Overlay endpoint → Session orchestration: delegates
backend/app/api/overlay.py - Export endpoint → Session orchestration: delegates
backend/app/api/export.py - Report endpoint → Session orchestration: delegates
backend/app/api/report.py - Session orchestration → ML backends: runs inference
backend/app/core/mock_state.py - Session orchestration → Finding enrichment: enriches findings
backend/app/core/mock_state.py - Session orchestration → Session store: reads and writes
backend/app/core/mock_state.py - Session orchestration → Edit mutations: applies edits
backend/app/core/mock_state.py - Edit mutations → FDI rules: validates numbers
backend/app/core/mutations.py - Edit mutations → Session store: records edits
backend/app/core/mutations.py - Session orchestration → Report generation: builds report
backend/app/core/mock_state.py - Report generation → OpenRouter client: requests completion
backend/app/llm/report_gen.py - Report generation → LLM validator: validates draft
backend/app/llm/report_gen.py - Report generation → Fallback report: falls back
backend/app/llm/report_gen.py - Report generation → Formula and review views: builds report views
backend/app/llm/report_gen.py - Formula and review views → FDI rules: uses FDI rules
backend/app/report/review_list.py - OpenRouter client → OpenRouter: calls service
README.md - Session orchestration → Dataset exports: exports sessions
backend/app/core/mock_state.py - Dataset exports → Session store: reads confirmed data
backend/app/export/__init__.py