kk0t9
5ba19cde46
- GPS-скорость: zero-clamp <~2-3 км/ч (на стоянке Doppler-шум, не ноль) — distraction v1 получал бы ложный on; FixQuality многоуровневый (no_fix/2d/3d/augmented/dead_reckoning + HDOP/sats); dead_reckoning не валиден для distraction/Nav; валидность времени ≠ позиции - приватность локации: эфемерна (без трека в v1), audit-log, исключена из LLM-промпта, while-in-use грант, on-device - антенна (внешняя/активная), TTFF cold/warm-start, окно без GPS на старте поездки; питание GPS в sleep/battery-cutoff (обесточивание+cold-start по умолчанию) - резистивная ADC-лесенка руля: контракт window-table + кондиционирование + collision-drop + темп-дрейф; транспорт ввода = uinput/evdev (не Shell-D-Bus, иначе surface-апы не покрыты); гейтинг руль-действий в distraction - IMU опционален/не гарантирован → dashcam (J) = непрерывный ring-buffer, не на g-sensor - точность времени SHM (~десятки-сотни мс), PPS опц./hardware-gated; Nav «фаза 2»→v4 - кросс-док: a-base §7/§14 (SHM, split time-row + K-dep), hardware §4 (антенна/1PPS), domains/README (K-cell без TPMS/климата), ipc Location (enum), c-shell §7/§9/§11 (clamped speed, uinput-ввод, закрыт Location-вопрос) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.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, безопасность, железо.
Инфраструктура разработки
- dev-environment.md — как вести разработку изолированно, с Mac.
Tier 2 — домены
- domains/ — детальные спеки подсистем (A–L) по единому шаблону.
Tier 3 — планирование
- capability-catalog.md — мастер-индекс всех функций (MVP/later + фаза).
- roadmap.md — фазы реализации с зависимостями.
Как мы работаем
Сверху вниз, по одному документу за раз: предложение → правки → фиксация → следующий. Каждый домен потом получит отдельный цикл «спека → план → реализация» (но реализация — позже, не сейчас).