refactor: move legacy docs to doc/legacy/ with opus/sonnet subfolders

2026-07-10 13:13:42 +04:00
parent 3ea7fc66d5
commit 95834a4245
46 changed files with 0 additions and 0 deletions
@@ -0,0 +1,105 @@
+# Динамические тесты — архитектура
+
+> v0.49.0-dev, 7 июня 2026
+> Ветка: `dynamic-tests`
+
+## Концепция
+
+Два теста: **на месте** и **в движении**. Разница — только в подсказке юзеру.  
+Физически оба делают одно: опрашивают 12 PID каждые 250мс, копят в памяти.
+
+## Алгоритм работы (user flow)
+
+```
+1. Ошибки     → scanDtc() — считывание DTC
+2. Диагностика → обычный скрипт L0/L1/L2 на сервер → LLM
+3. LLM сказал сделать тест на месте →
+     ⏱ На месте → СТАРТ → ... → СТОП → данные в памяти
+4. Диагностика → обычный скрипт + динамические данные → LLM
+5. LLM сказал сделать тест в движении →
+     🚗 В движении → СТАРТ → ... → СТОП → данные в памяти
+6. Диагностика → обычный скрипт + динамические данные → LLM (финал)
+```
+
+## Android → Сервер
+
+При нажатии **Диагностика**:
+1. Выполняется обычный скрипт (AT-команды, PID'ы)
+2. Если есть `dynamicSamples` (данные теста) — прикрепляются к тому же запросу
+3. POST `/api/v1/session/upload` с полем `dynamic_samples`
+4. Сервер по наличию `dynamic_samples` понимает, что пришёл динамический тест
+5. Выбирает промпт: `DYNAMIC_PROMPT` если только динамика, или `SYSTEM_PROMPT + DYNAMIC_PROMPT` если и то и то
+
+## Что надо сделать
+
+### Уже сделано (написан код, не проверен)
+- [x] Сервер: `build_dynamic_script()` — скрипт 12 PID 250мс
+- [x] Сервер: `?mode=dynamic` в routes.py
+- [x] Сервер: `DYNAMIC_PROMPT` в prompts.py
+- [x] Android: кнопки «⏱ На месте» / «🚗 В движении» (layout)
+- [x] Android: `DynamicCollector.kt` — сбор 12 PID 250мс
+- [x] Android: `ElmChecker.kt` — добавлены методы для работы с DynamicCollector
+- [x] Android: MainActivity — СТАРТ/СТОП, данные в памяти
+- [x] Android: общий таймер `tv_timer`
+
+### Надо доделать
+- [ ] Android: при старте Диагностики — прикрепить `dynamicSamples` к upload
+- [ ] Сервер: принимать `dynamic_samples` в upload_session, выбирать промпт
+- [ ] Отладка на реальной машине
+
+### До отправки — в памяти
+```kotlin
+data class DynamicSample(
+    val ts: Long,                    // System.currentTimeMillis()
+    val responses: List<RawResponse>  // 12 ответов ELM
+)
+
+val samples = mutableListOf<DynamicSample>()  // в памяти, быстро
+```
+
+### После СТОП — попытка отправки
+```kotlin
+1. Собираем все samples в JSON
+2. POST /api/v1/session/upload
+3. Если 200 → ОК, забыли
+4. Если ошибка → пишем ВСЁ в SessionDb
+```
+
+### Локальное хранение — через SessionDb (уже есть)
+```sql
+-- Таблица sessions (уже существует)
+session_type = "dynamic"   -- отличаем от обычных
+
+-- Таблица responses (уже существует)  
+-- Каждый сэмпл = одна запись в responses:
+--   session_id, step_id = "sample_N", cmd = "batch",
+--   raw = JSON всего опроса, decoded = "запись №N"
+```
+
+**Плюсы**: не надо новой таблицы, `SessionDb` уже умеет `createSession`/`addResponse`/`getResponses`.
+
+**Объём**: 30 секунд × 4 опроса/с × 12 PID = 1440 записей ≈ ~100KB — норм.
+
+### Ретрай непосланных сессий
+При старте приложения: `db.getUnuploadedSessions()` → отправить → пометить `uploaded=1`.
+
+## Промпт для LLM (сервер)
+
+Отдельный `DYNAMIC_PROMPT` в `brain/prompts.py`:
+
+```
+Ты — эксперт по диагностике. Получены временные ряды 12 параметров с интервалом 250мс.
+Проанализируй:
+1. Отклик дросселя — есть ли задержка/провалы
+2. STFT/LTFT — богатая или бедная смесь под нагрузкой и при сбросе
+3. RPM — плавность роста/падения, пропуски
+4. MAP — соответствует ли оборотам
+5. Зажигание — есть ли коррекция, детонация
+6. Аномалии — резкие скачки, выбросы
+Отвечай кратко: 2-3 предложения вывода, затем по пунктам что не так.
+```
+
+## Что НЕ делаем
+- GPS / акселерометр — не сейчас
+- Автодетект фаз (разгон/сброс) — ручной СТАРТ/СТОП
+- Отправка пачками в реальном времени — копим всё до СТОП