docs: заложить фундамент проектирования Штурмана
Каркас документации + содержательный фундамент (фаза проектирования, реализация отложена): - vision: видение, позиционирование, границы (вариант B, 2 красные линии) - principles: 13 сквозных принципов (red lines, offline-first, power-safe…) - architecture: тонкое ядро + SDK, planes, lifecycle, песочница, хостинг UI, карта связей + журнал из 6 решений - dev-environment: разработка с Mac (Lima/ARM64, vcan, Vehicle Simulator) - индексы contracts/ и domains/ (+ единый шаблон домена, заделы по камерам) - заготовки glossary, capability-catalog, roadmap Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,37 @@
|
||||
# Штурман — документация проекта
|
||||
|
||||
> Открытый русскоязычный программный слой («ОС поверх Linux») для автомобиля:
|
||||
> быстрый красивый бортовой интерфейс + голосовой ассистент на русском, который
|
||||
> видит данные машины и объясняет их по-человечески. Только чтение CAN, никогда
|
||||
> не safety-critical. Лицензия **MIT**.
|
||||
|
||||
**Статус: фаза проектирования.** Реализация сознательно отложена — сначала
|
||||
проектируем всё от и до, связно и детально. Этот каталог `docs/` — единственный
|
||||
источник правды по дизайну.
|
||||
|
||||
## Карта документации
|
||||
|
||||
### Tier 0 — фундамент
|
||||
- [vision.md](vision.md) — зачем, что, чем НЕ является, моат, стратегия, границы.
|
||||
- [glossary.md](glossary.md) — единый словарь терминов.
|
||||
- [principles.md](principles.md) — сквозные принципы и ограничения (правила для всех доменов).
|
||||
- [architecture.md](architecture.md) — слои, процессы, шина, **карта связей**.
|
||||
|
||||
### 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) — фазы реализации с зависимостями.
|
||||
|
||||
## Как мы работаем
|
||||
|
||||
Сверху вниз, по одному документу за раз: **предложение → правки → фиксация →
|
||||
следующий.** Каждый домен потом получит отдельный цикл «спека → план → реализация»
|
||||
(но реализация — позже, не сейчас).
|
||||
Reference in New Issue
Block a user