kk0t9 2eaa561892 docs(domain I): v2 — навигация (offline OSM/роутинг/turn-by-turn), после adversarial-ревью (24 находки) + кросс-док
Последний домен. Offline-first навигация: OSM-карты (MapLibre GL Native),
оффлайн-роутинг (Valhalla), turn-by-turn, поиск/POI, связка с ассистентом.
Не safety/ADAS (#1). Фаза v4. Многоагентный adversarial-ревью: 28 находок,
24 подтверждены (default-refute), все применены.

Ключевое из ревью:
- stale нав-промпт под звонком (проигрался бы ПОСЛЕ поворота) → продюсер I снимает заявку по окну релевантности; H остаётся контент-агностичным.
- Нет секции отказ-путей → добавлена (no-route/geocoder-fail/битые-тайлы/ENOSPC, симметрично J/H/L).
- Маршрут через границу регионов / назначение в нескачанном регионе → детект покрытия + предложение докачать / маршрут до края.
- reroute-шторм в urban-canyon → детект схода с гистерезисом + HDOP/FixQuality-гейт; dead_reckoning трактуется как нет-фикса.
- Якорь RDS-TMC G §7 → H §7 (FM-радио живёт в медиа-тракте H, не в сетевом G).
- MapLibre Native = BSD-2-Clause (не BSD-3); ODbL-атрибуция (#12); единицы км/мили из локали (data-model §4, #10).
- Интент «домой» разведён: D §6 = домашний экран (v1), навигация-домой = Nav-интент (v4).
- Добавлены секции Зависимости и last-parked (K §2/L §5 ждали); Boot-Stage 2; speed-limit — пассивный бейдж, не предупреждение (#1).

Кросс-док: d-assistant §6 («домой» = домашний экран; навигация-домой → Nav v4).
(architecture §3/§6 уже содержат Nav; a-base apps-storage уже покрывает нав-PII.)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-23 14:23:34 +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%