init commit

python_app/docs/operations_runbook.md

@@ -0,0 +1,49 @@
+# Operations runbook
+
+## 1. Подготовка
+- Собрать C++ binaries (`make`).
+- Проверить `run_config.json` и доступность hardware.
+- Для native режима убедиться в правах на USB/GPIO.
+
+## 2. Запуск GUI
+```bash
+python3 -m python_app.gui.main
+```
+
+## 3. Базовый сценарий live run
+1. Проверить Radar/Switches config.
+2. Выбрать calibration/reference sets.
+3. Нажать `Start`.
+4. Проверить обновление history и графика.
+5. Нажать `Stop`.
+
+## 4. Сохранение snapshot
+1. Указать `Path`, `Name`, `Last N`.
+2. Нажать `Save Numpy Snapshot`.
+3. Проверить `manifest.json` и каталоги `raw/preprocessed/results`.
+
+## 5. Проверка snapshot
+```bash
+python3 python_app/scripts/check_snapshot_numpy.py <snapshot_dir>
+```
+
+## 6. Конвертация snapshot для vna_system
+```bash
+python3 python_app/scripts/convert_snapshot_to_vna_history.py \
+  <snapshot_dir> \
+  -o <output_json> \
+  --input 0 \
+  --output-index 0
+```
+
+Полученный JSON содержит `sweep_history` и загружается в `vna_system` через кнопку загрузки истории у B-scan графика.
+
+## 7. Типовые проблемы
+- Пустой график: проверить processing mode и наличие trace payloads.
+- Нет запуска в B-scan: проверить ограничение combo для native switches.
+- Ошибки лимитов радара: проверить соединение с устройством и serial.
+- Процессы не стартуют: смотреть crash reports в GUI log.
+
+## 8. Безопасная остановка
+- Использовать `Stop` в UI.
+- При закрытии окна вызывается стоп всех процессов и закрытие dialogs/readers.