# Python App Documentation

## Назначение
Каталог `python_app/docs` содержит техническую документацию по Python-части радарной системы: GUI, orchestration, storage, hardware adapters и эксплуатационные сценарии.

## Карта документов
- `architecture_overview.md`: общая модульная архитектура и границы ответственности.
- `runtime_data_flow.md`: потоки данных от acquisition до отображения и snapshot.
- `gui_architecture.md`: структура GUI, mixin-контроллеры, plotting/runtime helpers.
- `hardware_layer.md`: слой работы с LibreVNA и переключателями.
- `storage_formats.md`: форматы NPZ/binary/numpy snapshot и naming.
- `shm_protocol_and_readers.md`: shared-memory ring контракт и декодирование payload.
- `preprocessing_and_capture_workflow.md`: калибровка/референс и последовательный захват.
- `operations_runbook.md`: запуск, диагностика, типовые инциденты.
- `module_reference.md`: справочник ключевых Python-модулей.

## Границы
- Документация описывает Python-часть проекта в `python_app`.
- C++ конвейер (`data_acq_and_processing`) описывается только в части интеграционных точек с Python.

## Версия документации
Актуально для состояния репозитория после рефакторинга: разделения `models`, `storage/npz`, `orchestration/shm`, `gui/plotting`, `gui/runtime`, `gui/controllers/sections`.