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:
1 parent
699e6bbd57
commit
a1ce4bdb8a
15 files changed
+804
No files matched your search
@@ -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 с.
|
||||
Reference in new issue
Block a user