# Module reference

## `python_app.gui`
- `main.py`: GUI entrypoint.
- `app_window.py`: composition root.
- `controllers/app_window_*_mixin.py`: функциональные части окна.
- `controllers/sections/*`: построители UI-секций.
- `plotting/bscan_math.py`: математика B-scan.
- `plotting/bscan_history.py`: cache/signature для B-scan.
- `runtime/history.py`: сигнатуры run/history merge.
- `runtime/constraints.py`: режимные ограничения.

## `python_app.models`
- `dataset_model.py`: dataclass-модели sweep/result данных.
- `run_config_schema.py`: dataclass-schema run config.
- `run_config_codec.py`: encode/decode/load.
- `run_config_validation.py`: payload checks/parsing helpers.
- `run_config_model.py`: фасадный экспорт.

## `python_app.orchestration`
- `config_writer.py`: runtime config + bundle files.
- `live_processing_config.py`: live processing JSON writer.
- `process_supervisor.py`: управление процессами C++ pipeline.
- `shm/*`: shared-memory чтение и декодирование.
- `shm_reader.py`: фасадный экспорт.

## `python_app.storage`
- `store_api.py`: абстракция хранилища.
- `npz/store.py`: `NpzStore`.
- `npz/serialize.py`: binary serializers.
- `npz/snapshot_numpy.py`: snapshot selection/writers.
- `npz/paths.py`: naming/path helpers.
- `npz_store.py`: фасадный экспорт.

## `python_app.hardware_full`
- `librevna_service.py`: high-level service.
- `librevna_backends.py`: native/mock adapters.
- `librevna_driver/*`: USB/protocol/session/controller stack.
- `switch_service.py`: switch facade.
- `switch_drivers/*`: native/mock switch implementations.

## `python_app.workflows`
- `sequential_capture_workflow.py`: последовательный capture session.
- `calibration_workflow.py`, `reference_workflow.py`: helper workflows.

## `python_app.scripts`
- `check_snapshot_numpy.py`: snapshot validator + plots.
- `manual_smoke_run.py`: локальный smoke сценарий.
- `hardware_raw_orchestrator_test.py`: raw ring visualization utility.
- `vna_only_raw_test.py`: direct VNA check utility.
