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

> Открытый русскоязычный программный слой («ОС поверх Linux») для автомобиля:
> быстрый красивый бортовой интерфейс + голосовой ассистент на русском, который
> видит данные машины и объясняет их по-человечески. Только чтение CAN, никогда
> не safety-critical. Лицензия **MIT**.

**Статус: фаза проектирования.** Реализация сознательно отложена — сначала
проектируем всё от и до, связно и детально. Этот каталог `docs/` — единственный
источник правды по дизайну.

## Карта документации

### Tier 0 — фундамент
- [vision.md](vision.md) — зачем, что, чем НЕ является, моат, стратегия, границы.
- [glossary.md](glossary.md) — единый словарь терминов.
- [principles.md](principles.md) — сквозные принципы и ограничения (правила для всех доменов).
- [architecture.md](architecture.md) — слои, процессы, шина, **карта связей**.
- [tech-stack.md](tech-stack.md) — канонический технический стек (Rust-first) и крейты.

### Tier 1 — сквозные контракты (соединительная ткань)
- [contracts/](contracts/README.md) — IPC, модель данных, plugin-SDK, безопасность, железо.

### Инфраструктура разработки
- [dev-environment.md](dev-environment.md) — как вести разработку изолированно, с Mac.

### Tier 2 — домены
- [domains/](domains/README.md) — детальные спеки подсистем (A–L) по единому шаблону.

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

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

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