Files
shturman/docs/domains
kk0t9 3fd9b42bb0 docs(tails): закрыть кросс-док хвосты (a-base/b/dev-env/J/hardware) + наполнить glossary
Закрыты накопленные мелкие хвосты из ревью F/J/H/G:
- Stage-нормализация: Stage-0/1/2 → Stage 0/1/2 по 6 докам (a/b/f/h/j/hardware); каноническая запись Stage 0/1/2 в glossary.
- a-base §8: видео-пайплайн (DMABUF камер / VPU dashcam) внесён в OOM-порядок — задняя защищена (Stage 1), dashcam/surround throttleable.
- a-base §12: dashcam-медиа (отдельный носитель) + контакты/журнал (G) в список factory-reset wipe.
- b §12: grace-hold резолвнут  — J запросчик (J §7), B владелец/арбитр (§4 шаг 2, §7).
- dev-environment: моки fake-камера (J)/аудио (H)/BT-телефон (G) + plugin-host-харнесс; just-цели plugin-dev-run/sideload.
- J §3/§11/§13 + hardware §4: сигнал реверса  GPIO фонаря з.х. (выбранный дефолт); CAN-gear отложен (нет gear-сигнала в E).
- glossary.md: наполнен (~55 терминов в 7 областях: машина/CAN, платформа/IPC, ассистент/аудио, питание/boot, хранилище/OTA, связь/телефон, безопасность).

Tier-3 capability-catalog + roadmap не трогаются — зависят от доменов I+L.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-23 12:46:36 +03:00
..

Домены (Tier 2)

Детальные спеки подсистем. Каждый домен — отдельный документ по единому шаблону (ниже). Файлы создаём по мере наполнения; здесь — карта и план.

Статус: индекс + шаблон. Содержательные файлы доменов появляются по ходу работы.

Единый шаблон домена

  1. Назначение и границы — что делает, чего НЕ делает.
  2. Функции — таблица: функция | MVP / later | зависит от | фаза.
  3. Данные и интерфейсы — что домен публикует/потребляет на шине (ссылки на ../contracts/).
  4. Зависимости — ссылки на другие домены и контракты (← здесь «связи»).
  5. Открытые вопросы / решения.

Карта доменов

# Домен Файл Кратко
A Базовая система / OS a-base-system.md образ, read-only rootfs, boot, watchdog, OTA, board support
B Питание и жизненный цикл b-power-lifecycle.md ACC, graceful shutdown, sleep, защита eMMC
C Shell / UX / лаунчер c-shell-ux.md тайлы, темы день/ночь, профили, driver-distraction, ввод с мультируля, мультидисплей
D Голосовой ассистент d-assistant.md wake→STT→LLM→TTS, vehicle-context, память о водителе (.md), офлайн-фолбэк, провайдер-агностик
E Vehicle Data (OBD/CAN, read-only) e-vehicle-data.md PIDs, DTC + расшифровка, поездки, расход, VSS-модель
F Plugin host & экосистема f-plugin-host.md загрузка/sandbox/lifecycle плагинов, дистрибуция, dev-tools (API — в ../contracts/plugin-sdk.md)
G Связь / телефон g-connectivity-phone.md BT HFP, модем/LTE, WiFi/hotspot, проекция телефона
H Медиа / аудио h-media-audio.md вся стандартная мультимедиа (локальное/BT A2DP/AVRCP/радио/стриминг) + арбитр аудио (политика фокуса/ducking поверх PipeWire)
I Навигация i-navigation.md офлайн-карты OSM, роутинг, POI, связка с ассистентом
J Камеры / видео j-cameras-video.md задняя камера, парктроник-оверлей, dashcam
K Датчики / периферия k-sensors-peripherals.md GPS/Location, IMU; кнопки руля — резистивная ADC-лесенка (CAN-кнопки/TPMS/климат/парктроник на CAN — у E); выделенные не-CAN датчики
L Облако / компаньон l-cloud-companion.md мобильное приложение, синхронизация, бэкап, OTA-канал, телеметрия (opt-in)

Порядок наполнения определим в roadmap.md; технически — после контрактов.

Заделы (сиды для будущих доменов)

Идеи на будущее, пойманные по ходу проектирования; раскрываются при наполнении домена.

  • J (Камеры). Камеры — динамический набор 0..N источников видео, не одна задняя. Задел: подключение доп. камер — фронтальная для видеорегистратора (dashcam), камеры кругового обзора (360°/surround) и т.п. Набор источников и «виды» (например surround-композит) — расширяемые, плагин может добавить источник/вид.
  • K (Датчики). Парктроники и подобные датчики ближнего действия — как источник данных (чтение с CAN через Vehicle-Data или отдельный датчик) для оверлеев/ предупреждений поверх видео-вида.
  • Архитектурная связь: видео-источники идут через data-plane (PipeWire/V4L2); задняя/парктроник-вид требуют низколатентного раннего пути (см. Решение №3 и lifecycle).