kk0t9 7a30ed7a7d docs(domain B): v2 после adversarial-ревью (22 находки) + кросс-док
Существенная переработка power-lifecycle:
- детект running по НАПРЯЖЕНИЮ бортсети (~14В генератор vs ~12.4В покой), не RPM (v2);
  Power.IgnitionState — единственный канон lifecycle-состояния
- триггер shutdown ≠ rate-of-change: ACC-off / under-voltage-held / thermal-trip;
  cold-crank до ~6В — НОРМА (ride-through), не индикатор обрыва
- SoC↔MCU shutdown-протокол специфицирован СЕЙЧАС: hold-up-таймер + heartbeat +
  safe-to-cut + fail-safe при потере линка (обе стороны); MCU — fail-safe-авторитет
- abort при re-power до PONR (ShutdownAborted); shutting-down разбит abortable/committed
- НОВОЕ: thermal shutdown (триггер/гистерезис/UX); ordered teardown (E закрывает ISO-TP);
  таблица MCU-vs-supercap; battery deep-discharge cutoff; монотонные часы для таймеров;
  первый boot без времени; периодическое сохранение времени
- watchdog по фазам (runtime + shutdown RebootWatchdogSec/MCU-дедлайн + boot-окно);
  v0=SoC+MCU+reboot, bootcount=v4
- фазы: MCU HW fail-safe-таймер = v0 (не v1); save-time = v0
- кросс-док: security-privacy (mic power-gated), ipc Power (enum/reason/ShutdownAborted),
  e/data-model (engine_running не дублирует IgnitionState), a-base §7 (периодич. save)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-21 01:53:57 +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, безопасность, железо.

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

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

Tier 2 — домены

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

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

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

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

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

S
Description
No description provided
Readme MIT 578 KiB
Languages
Rust 76.1%
Shell 19.6%
Just 4.3%