docs: AI documentation protocol and roadmap context tool

Протокол работы AI-ассистентов, зоны frontend/backend/shared, статусы, журнал, шаблоны и скрипт сводки дорожной карты.

Refs: 1.2.3

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
This commit is contained in:
TMSHandDevin committed 2026-11-08 17:14:44 +03:00
1 parent 699e6bbd57
commit a1ce4bdb8a
15 files changed
+804

No files matched your search

+25
View File
@@ -0,0 +1,25 @@
# Frontend: документы зоны
Зона `frontend` (`docs/ai/PROTOCOL.md`, раздел 2): приложение «Штиль» (`apps/console`), «Штиль Помощник» (`apps/helper`), дизайн-система `packages/ui`.
Здесь — внутренние правила Frontend, которые не нужны Backend. Всё, что влияет на API, права, функции, безопасность Tauri, — в `shared`.
## Документы
| Файл | О чём | Появится в |
|---|---|---|
| `design-system.md` | Токены (цвета, отступы, радиусы, тени), темы, типографика, иконки, правила вёрстки | #2.13 |
| `components.md` | Каталог компонентов `packages/ui`: назначение, варианты, когда какой использовать | #2.13 |
| `conventions.md` | Структура `src/`, именование, состояние (Pinia / TanStack Query), роутинг, i18n, обработка ошибок API | #2.14 |
| `platform-layer.md` | Слой `src/platform/`: Tauri API, хранилище ключей, профили серверов | #2.14 |
| `screens/<экран>.md` | Экран: назначение, данные, права, состояния (загрузка, пусто, ошибка) | по мере появления |
Шаблон для экранов и модулей — `docs/ai/templates/module.md`. Информационная архитектура и макеты (общие для обеих сторон) — `docs/ux/`.
## Исходные данные из дорожной карты (до решений #1.11 и #2.13)
Это рекомендации карты, а не принятые решения. После решения перенести в `design-system.md` и удалить отсюда.
- Шрифты Unbounded, Manrope, JetBrains Mono — локально, без CDN. Иконки — Lucide.
- Темы светлая и тёмная, по умолчанию — системная. Минимальный размер окна 1280×720.
- Меню ≤ 11 пунктов в 3 группах: Работа · Управление · Аналитика. Недоступное по правам или редакции скрыто.
- Селектор области (подразделения) фильтрует весь экран. Карточки — в боковой панели. Ctrl+K — поиск и команды.
- Помощник: при старте только иконка в трее, окно создаётся по клику и уничтожается при закрытии; цели ≤ 40 МБ ОЗУ в покое, ≤ 150 МБ с окном, открытие ≤ 1 с.