Repository Overview: checkout

# Repository Overview: checkout

**Files:** 82 | **Lines:** 81784 | **Import cycles:** 1

## Project Summary


`checkout` is a json codebase of 82 files. Execution starts at `src/webui/server.py`, `src/webui/static/app.js`.




## System map

The main parts of checkout and how they connect. 7 more parts are not shown.

```mermaid
flowchart TB
  subgraph tier_actor["Who uses it"]
    direction LR
    n_actor_user(["<b>User</b><br/></br><small>Uses the system</small>"]):::actor
  end
  subgraph tier_surface["Ways in"]
    direction LR
    n_src_webui["<b>webui</b><br/></br><small>12 Python files</small>"]:::surface
  end
  subgraph tier_engine["Engine"]
    direction LR
    n_src_utils["<b>utils</b><br/></br><small>4 Python files</small>"]:::engine
    n_src_diarization_py["<b>diarization.py</b><br/></br><small>1 Python file</small>"]:::engine
    n_src_diarization_syntax_py["<b>diarization_syntax.py</b><br/></br><small>1 Python file</small>"]:::engine
    n_src_model_transport_py["<b>model_transport.py</b><br/></br><small>1 Python file</small>"]:::engine
    n_src_stt_whisper_to_nats_py["<b>stt_whisper_to_nats.py</b><br/></br><small>1 Python file</small>"]:::engine
  end
  n_actor_user -->|"uses"| n_src_webui
  n_src_stt_whisper_to_nats_py ==>|"imports"| n_src_utils
  n_src_stt_whisper_to_nats_py ==>|"imports"| n_src_webui
  n_src_webui ==>|"imports"| n_src_model_transport_py
  n_src_diarization_py -->|"imports"| n_src_model_transport_py
  n_src_diarization_syntax_py -->|"imports"| n_src_diarization_py
  n_src_stt_whisper_to_nats_py -->|"imports"| n_src_diarization_py
  n_src_stt_whisper_to_nats_py -->|"imports"| n_src_diarization_syntax_py
  n_src_webui -->|"imports"| n_src_diarization_py
  n_src_webui -->|"imports"| n_src_diarization_syntax_py
  click n_src_webui "?page=module_page%3Asrc%2Fwebui" "Open the webui page"
  click n_src_utils "?page=module_page%3Asrc" "Open the utils page"
  click n_src_diarization_py "?page=module_page%3Asrc" "Open the diarization.py page"
  click n_src_diarization_syntax_py "?page=module_page%3Asrc" "Open the diarization_syntax.py page"
  click n_src_model_transport_py "?page=module_page%3Asrc" "Open the model_transport.py page"
  click n_src_stt_whisper_to_nats_py "?page=module_page%3Asrc" "Open the stt_whisper_to_nats.py page"
  classDef actor stroke-dasharray:4 4
  classDef surface stroke-width:2px
  classDef engine stroke-width:1px
```

## Primary Execution Flows

- `src/webui/diagnostics.py::DiagnosticsRunner::run` (5 steps)

- `src/webui/staged_jobs.py::StagedFileJobService::start_step` (5 steps)

- `src/stt_whisper_to_nats.py::FileJobWorkerService::start_job` (4 steps)

- `src/pyannote_diarization_server.py::PyannoteProgressHook::__call__` (3 steps)

- `src/webui/job_lock_server.py::acquire` (3 steps)












## Codebase health signals
- **Hotspots:** 1 files are both high-churn and high-complexity
- **Stable core:** 11 files unchanged in 90+ days
- **Most changed (90d):** `.version`, `src/.version`, `DOCS/FILE_DIARIZATION_STACK.md`
- **Oldest file:** `src/__init__.py` (220 days)


---

*Built from the code's structure. It states what is there, not why it is that
way. The explanatory prose is a separate, model-written layer.*