Протокол работы 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>
2.8 KiB
2.8 KiB
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 с.