Files
shturman/docs
kk0t9 c377a34c4f docs(v0.4): спека MCU/thermal fail-safe (тепловой триггер + MCU-протокол + fail-safe)
Веха v0.4 (A12/B08/B09/B10) поверх живого FSM v0.3. Решение брейнсторма: разработка без
платы (принцип #13) — MCU-копилот как reference-арх, софт+симуляция, физический выбор
B08/B09 + железо отложены в HW-bring-up-подфазу. Симметрия с v0.3: чистое ядро (ThermalPolicy/
codec) → абстракция (TempSource/Throttler/Coprocessor trait) → dev-mock.

Скоуп: тепловая политика+гистерезис → Event::ThermalTrip (реюз FSM); SoC↔MCU протокол + кодек
(CRC/replay/desync-guard) + CoprocessorClient (heartbeat/wait-for-completion/safe-to-cut);
B09 fail-safe-таймер — модель (hang/budget → Event::FailsafeCut → off); D-Bus ThermalState/
ThermalChanged (контракт сейчас, рендер v0.5). Приёмка §9.4; швы §10.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Alexander <akotenev2003@gmail.com>
2026-06-25 15:00:10 +03:00
..

Штурман — документация проекта

Открытый русскоязычный программный слой («ОС поверх Linux») для автомобиля: быстрый красивый бортовой интерфейс + голосовой ассистент на русском, который видит данные машины и объясняет их по-человечески. Только чтение CAN, никогда не safety-critical. Лицензия MIT.

Статус: фаза проектирования. Реализация сознательно отложена — сначала проектируем всё от и до, связно и детально. Этот каталог docs/ — единственный источник правды по дизайну.

Карта документации

Tier 0 — фундамент

  • vision.md — зачем, что, чем НЕ является, моат, стратегия, границы.
  • glossary.md — единый словарь терминов.
  • principles.md — сквозные принципы и ограничения (правила для всех доменов).
  • architecture.md — слои, процессы, шина, карта связей.
  • tech-stack.md — канонический технический стек (Rust-first) и крейты.

Tier 1 — сквозные контракты (соединительная ткань)

  • contracts/ — IPC, модель данных, plugin-SDK, безопасность/приватность, safety (граница+distraction), производительность (NFR), дизайн-система (визуальный язык), железо.

Инфраструктура разработки

  • dev-environment.md — как вести разработку изолированно, с Mac.

Tier 2 — домены

  • domains/ — детальные спеки подсистем (A–L) по единому шаблону.

Tier 3 — планирование

  • capability-catalog.md — мастер-индекс всех функций (MVP/later + фаза).
  • roadmap.md — фазы реализации с зависимостями.

Как мы работаем

Сверху вниз, по одному документу за раз: предложение → правки → фиксация → следующий. Каждый домен потом получит отдельный цикл «спека → план → реализация» (но реализация — позже, не сейчас).