# Штурман

Open-source русскоязычный companion-слой («ОС поверх Linux») для авто на **RK3588**: быстрый Slint-UI +
голосовой RU-ассистент, читающий OBD/CAN **только на чтение**, + расширяемый Plugin API. Лицензия **MIT**.

> Статус: **реализация v0** (фундамент — образ-болванка + dev-харнесс + первый Slint-кадр). Дизайн
> завершён, источник правды — [`docs/`](docs/).

## Красные линии (нерушимы)

- **Никогда не safety-critical** — двигатель/тормоза/ABS/ESP/руль/подушки; в системе нет actuator-путей.
- **CAN только на чтение** — стандартные OBD-II read (Mode 01/03/07/09/0A); запрещены write/actuator/Mode-04/UDS-write.

## Документация

- Точка входа: [`CLAUDE.md`](CLAUDE.md).
- Дизайн (источник правды): [`docs/`](docs/) — архитектура, контракты, домены.
- План реализации: [`docs/roadmap.md`](docs/roadmap.md); спеки вех — [`docs/specs/`](docs/specs/).

## Быстрый старт (dev)

Разработка ведётся в ARM64 Lima-VM (нативно к таргету RK3588). Команды — через `just`:

```
just vm-up      # поднять dev-VM (Lima)        — появляется в Плане 5
just run        # boot → стаб-сервисы на D-Bus → первый Slint-кадр
just ci         # lint + test + deny (локальный гейт)
```

> Сейчас доступно: `just build` / `just test` / `just lint` / `just deny` (сборка/тесты `shturman-common`
> на хосте). Lima-VM и сквозной `run`/`e2e` — по мере планов реализации.

## Лицензия и контрибьютинг

MIT — см. [`LICENSE`](LICENSE). Контрибьюции — по DCO (`git commit -s`), см. [`CONTRIBUTING.md`](CONTRIBUTING.md).

> **Примечание о UI-тулките:** Slint для embedded доступен бесплатно под **GPL-3.0** → шипимый UI-бинарь
> прод-образа (v4) будет под GPL-3.0; решение по тулкиту/лицензии осознанно отложено к v4 (см.
> [`docs/specs/`](docs/specs/)). Ядро и остальной код — MIT.