kk0t9
9a3b6a8753
Веха v0.2: рефактор плоского shturman.target в фазовый конвейер. - Stage 0: shturman-splash (Slint software-render → splash.png, до первого кадра); - Stage 1: критический набор v0.1 → shturman-stage1.target (без изменений тела); - Stage 2: shturman-stage2-warmup (oneshot-плейсхолдер, после кадра); - shturman.target → зонтик; общий headless-render хелпер из shell переиспользует splash. D-Bus-поверхности нет (фазы — systemd). Splash в VM = software-render PNG (U-Boot framebuffer — HW, шов §10). Тайминг <10c — функц. в VM, вердикт на RK3588. Приёмка: фазы разделены + splash до кадра + warmup после + регресс v0.1/v0.6 зелёный. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Signed-off-by: Alexander <akotenev2003@gmail.com>
Штурман — документация проекта
Открытый русскоязычный программный слой («ОС поверх 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 — фазы реализации с зависимостями.
Как мы работаем
Сверху вниз, по одному документу за раз: предложение → правки → фиксация → следующий. Каждый домен потом получит отдельный цикл «спека → план → реализация» (но реализация — позже, не сейчас).