init commit

python_app/docs/preprocessing_and_capture_workflow.md

@@ -0,0 +1,32 @@
+# Preprocessing and capture workflow
+
+## 1. Назначение
+До запуска live-pipeline необходимо выбрать calibration/reference set, покрывающие целевые run combos.
+
+## 2. Процесс в GUI
+1. Открыть `Preprocessing Panel`.
+2. Выбрать или создать имя набора (`set_name`).
+3. Запустить `Start Calibration Sequence` или `Start Reference Sequence`.
+4. Для каждого combo нажимать `Capture Current Combo`.
+5. По завершении данные сохраняются в `NpzStore`.
+
+## 3. Internal flow
+- `AppWindowPreprocessMixin` создает `SequentialCaptureSession`.
+- Session управляет:
+  - `LibreVnaService`
+  - input/output `SwitchService`
+  - последовательным обходом full combo matrix.
+- После полной матрицы вызывается `finalize(store)`.
+
+## 4. Связь с live run
+`_start_run()` проверяет:
+- выбраны ли calibration/reference sets,
+- покрывают ли выбранные sets все run combos (`has_combo_coverage`),
+- доступны ли bundle-файлы для preprocessor.
+
+## 5. Диагностика
+Типовые ошибки:
+- set already exists,
+- incomplete capture sequence,
+- hardware not available,
+- mismatch requested combos vs stored combos.