Files
shturman/docs/contracts/README.md

21 lines
2.3 KiB
Markdown

# Контракты (Tier 1) — соединительная ткань
> Сквозные интерфейсы, которыми домены связаны друг с другом. **«Связи» проекта
> живут здесь.** Каждый контракт — отдельный документ; создаём по мере наполнения.
Статус: **индекс**. Документы наполняем после фундамента (architecture + principles).
| Документ | Назначение |
|----------|------------|
| `ipc.md` | D-Bus сервисы, интерфейсы, схемы сообщений: кто что публикует/слушает. |
| `data-model.md` | VSS-подобная таксономия сигналов машины + общие типы данных. |
| `plugin-sdk.md` | API расширения: манифест, capability-модель, точки расширения (экраны, тайлы, интенты, доступ к данным). *Рантайм плагинов — домен F.* |
| `security-privacy.md` | Sandboxing плагинов, модель разрешений, обработка данных, 152-ФЗ. |
| `safety.md` | Граница «не safety-critical» + структурный энфорсмент red-lines (CAN read-only) + driver-distraction-политика. *Комплемент security-privacy: вред/отказы, не злоумышленник.* |
| `performance.md` | NFR-бюджеты: латентность, кадровый бюджет, память/ресурсы, тепло — принцип #11 как измеримый контракт. |
| `design-system.md` | Визуальный язык ОС: токены (цвет/тип/space/motion), компонент-таксономия, distraction-визуал. AMG-leaning премиум, dark-first; рендерит Shell (C). |
| `hardware.md` | Целевой таргет (RK3588), топология питания, периферия + **HAL/board-support API** для портирования на другое железо/авто. |
> Важный нюанс: **plugin-SDK** (API, тут) и **домен F «Plugin host»** (рантайм,
> sandbox, дистрибуция — в [domains/](../domains/README.md)) — разные вещи, ссылаются друг на друга.