Files

T

kk0t9 3d13bb5827 docs: tech-stack + контракты ipc/data-model (+ ревью-фиксы)

- tech-stack: Rust-first (один прод-рантайм; Python — dev-only), полный стек, крейты
- architecture: ассистент Python→Rust для консистентности; boot-порядок
  (Broker+App-Host до Shell); потолок частоты сигналов ~10–20 Гц
- contracts/ipc: реестр D-Bus (сервисы ядра/апов, соглашения, портал-брокеринг)
  + открытые вопросы из self-review
- contracts/data-model: VSS-aligned каталог сигналов, OBD-PID маппинг, DTC-модель;
  добавлен MIL-статус (PID 0x01) для killer-фичи, состояние машины, расход-estimate

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-20 20:01:36 +03:00

2.7 KiB

Raw Blame History

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

Открытый русскоязычный программный слой («ОС поверх 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 — фазы реализации с зависимостями.

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

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

2.7 KiB Raw Blame History