Дмитрий
3c13cc5d64
P0 (4) — арифметические конфликты в CLAUDE.md, прошли мимо второго аудита: - §3 header «Карта 28 инструментов» → «33» (header застрял с pre-FD эпохи) - §3.4 header «(+5, итого 28)» → «итого 29» (после #30 в фазу 2) - §3.3 footer «из 30 номеров минус #1 = 29» → «33 номеров: 29 phase-active + 3 off-phase + 1 historic» - §6 «Активно: 19 инструментов из 29» (vs раскладка 9+8+7=24) → «24» в обоих местах P1 (5) — sync stale `+`-refs после второго аудита: - PSR_v1 шапка: «CLAUDE.md v1.84+/Pravila v1.9+» → «v1.86+/v1.10+» - Tooling шапка: «Pravila v1.9+/PSR_v1 v1.5+/CLAUDE.md v1.84+» → «v1.10+/v1.7+/v1.86+» - CLAUDE.md §5 п.5 «PSR_v1 v1.5+» → «v1.7+» P2 (2) — внутренние несогласованности: - PSR_v1 line 4/856 «slot уровня 2.5» → «уровня 2b» (описка внутри changelog'а v1.6) - CLAUDE.md §3.3 #33 «вне Pravila §13» → «вне UI-пула §13» (Pravila §13.2 v1.10 включает claude-md-management как infrastructure subsection) Sync-правки в connected files: - README.md + README_АРХИВ_v8_5.md «карта 28 инструментов» → «33» - Tooling §11.5/§12 «не входят в 28 инструментов» → «33 формализованные позиции» Через `/claude-md-management:claude-md-improver` с cross-impact-анализом перед каждой группой правок. Pravila v1.10 без изменений (cross-refs к нему уже актуальны). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
96 lines
7.9 KiB
Markdown
96 lines
7.9 KiB
Markdown
# Прил. Л — HTML-прототипы Лидерра
|
||
|
||
Самодостаточные HTML-прототипы 8 ключевых экранов клиентского приложения и админки SaaS. Это не боевой код — это **референс для дизайнера** (Диз-1) и **рабочая заготовка для frontend-команды** в спринтах 1, 4, 5, 8, 14.
|
||
|
||
## Как пользоваться
|
||
|
||
```
|
||
открыть web/index.html → выбрать экран → двойной клик
|
||
```
|
||
|
||
## Структура проекта
|
||
|
||
```
|
||
liderra/
|
||
├── README.md ← этот файл (про прототипы)
|
||
├── CLAUDE.md ← оперативная карта для Claude Code (приоритет правил, 33 инструмента)
|
||
├── docs/ ← документация, инструкции, аудиты, брендбук, Прил. Н (tooling)
|
||
├── web/ ← HTML-прототипы экранов
|
||
└── db/ ← schema.sql и changelog схемы
|
||
```
|
||
|
||
Каждый прототип:
|
||
|
||
- Полностью офлайн-самодостаточный, кроме одного запроса к Google Fonts за `Inter` и `JetBrains Mono` (можно заменить на локальный fallback за минуту).
|
||
- Содержит **«пилюлю i»** в правом нижнем углу — открывает спецификацию экрана: состояния, API-контракты, требования безопасности, что не реализовано.
|
||
- Использует только токены из `brandbook.md` v1.1. Если в проекте появятся новые токены — править надо брендбук, не прототип.
|
||
|
||
## Источники истины
|
||
|
||
| Что | Где |
|
||
|---|---|
|
||
| Палитра, типографика, размерная сетка | `brandbook.md` v1.1 §3, §4, §5, §8 |
|
||
| SVG-логотипы | `brandbook.md` §9.1–9.5 |
|
||
| Поведение экранов | `CRM_bp-gr_Инструкция_v8_5.md` v8.5 |
|
||
| Админка SaaS (экран 08) | `Админка_SaaS_v8_2.md` |
|
||
| Открытые вопросы по дизайну | `Открытые_вопросы_v8_3.md` Диз-1, Диз-3 |
|
||
|
||
## Статус экранов
|
||
|
||
| # | Экран | Статус | Сессия |
|
||
|---|---|---|---|
|
||
| 01 | Логин · Регистрация · 2FA · Recovery | ✅ Готово | 05.05.2026 |
|
||
| 02 | Дашборд | ✅ Готово | 05.05.2026 |
|
||
| 03 | Список сделок | ✅ Готово | 06.05.2026 |
|
||
| 04 | Карточка сделки | ⏸ В очереди | — |
|
||
| 05 | Канбан-доска | ⏸ В очереди | — |
|
||
| 06 | Биллинг и тарифы | ⏸ В очереди | — |
|
||
| 07 | Настройки тенанта | ⏸ В очереди | — |
|
||
| 08 | Админка SaaS | ⏸ В очереди | — |
|
||
|
||
Прототипы выпускаются по одному за сессию.
|
||
|
||
## Что прототип НЕ делает
|
||
|
||
- Не подключается к API. Все формы отправляют заглушки (`alert` или симулированный успех).
|
||
- Не использует Vue/Vuetify — это сознательно, чтобы прототип открывался в браузере и читался без npm.
|
||
- Не покрывает все пограничные состояния (loading skeletons, ошибки сети). Эти состояния перечислены в spec-аннотации каждого экрана.
|
||
- Не финализирует слабо проработанные в ТЗ места — их я отмечаю в спецификации тегом `[?]` (по соглашению `Pravila_raboty_Claude_v1_1.md` §3.1).
|
||
|
||
## Что брать из прототипа в боевой код
|
||
|
||
- **CSS-переменные из `:root`** — копировать в `resources/css/brand.css` Vue-проекта (но единственный источник истины — `brandbook.md §8.1`).
|
||
- **Структура DOM и aria-атрибуты** — переносить в `.vue` компоненты как есть.
|
||
- **JavaScript-логику** — переписывать на Composition API, но логика валидаций (zxcvbn-эвристика, TOTP-таймер, ввод по 1 цифре с автопереходом) уже близка к боевой.
|
||
|
||
## Версионирование
|
||
|
||
Каждый файл прототипа фиксирует свою версию в шапке (`<!-- Версия: vX.Y от ДД.ММ.ГГГГ -->`). При смене узла брендбука или narrative — обновляем затронутые прототипы и фиксируем в этой таблице:
|
||
|
||
| Дата | Что изменилось |
|
||
|---|---|
|
||
| 05.05.2026 | v0.1 — прототип №01 (Логин/Регистрация/2FA/Recovery) |
|
||
| 05.05.2026 | v0.2 — прототип №02 (Дашборд) |
|
||
| 06.05.2026 | v0.3 — добавлен корневой `CLAUDE.md` и `docs/Tooling_v8_3.md` (Прил. Н v1.0). Архив документации v8.3.2 → v8.3.3. Прототипы не менялись. |
|
||
| 06.05.2026 | v0.4 — прототип №03 (Список сделок). Narrative переведён на v8.4 (все 13 разделов плана переписаны, файл переименован → `CRM_bp-gr_Инструкция_v8_4.md`). Schema → v8.4 (+ outbound_webhook_*). |
|
||
|
||
---
|
||
|
||
*Прил. Л v0.4 от 06.05.2026 — 3/8 прототипов готовы (01–03), narrative на v8.4, schema на v8.5 (07.05.2026 — реализация 27 решений аудита C; narrative v8.5 готовится).*
|
||
|
||
## Документация для разработчика
|
||
|
||
| Документ | Что в нём |
|
||
|---|---|
|
||
| [CLAUDE.md](CLAUDE.md) | Оперативная карта для Claude Code: приоритет правил (6 уровней + Pravila §12 hard rule), стек проекта, карта 29 инструментов «когда что использовать», 11 запретов, текущая фаза |
|
||
| [docs/Tooling_v8_3.md](docs/Tooling_v8_3.md) | Прил. Н v1.10 — полный реестр 29 активных инструментов в 4 фазах (фаза 0 — документация; +1 Laravel; +2 Vue + Frontend Design plugin; +3 pre-prod), конфликты и решения, процедура перехода между фазами, особенности Windows + PowerShell |
|
||
| [docs/Pravila_raboty_Claude_v1_1.md](docs/Pravila_raboty_Claude_v1_1.md) v1.6 | Продуктовые правила работы Claude в проекте (включая §12 Superpowers hard rule + §13 Frontend Design paired stack + §13.9 hard-link на R10) |
|
||
| [docs/Plugin_stack_rules_v1.md](docs/Plugin_stack_rules_v1.md) v1.3 | Координация Superpowers + Frontend Design (R0–R13) — gate, фазы UI-фичи, разделение TDD/визуал, ревью по аспекту |
|
||
| [docs/README_АРХИВ_v8_5.md](docs/README_АРХИВ_v8_5.md) v8.5 | Состав архива, навигатор по документам |
|
||
| [docs/CRM_bp-gr_Инструкция_v8_5.md](docs/CRM_bp-gr_Инструкция_v8_5.md) v8.5 | Главное ТЗ из 28 разделов (v8.5 — реализация 27 решений аудита C от 07.05.2026; v8.4 финал был 06.05.2026) |
|
||
| [db/schema.sql](db/schema.sql) v8.11 | Схема БД PostgreSQL 16 (56 базовых таблиц + 12 партиций, 97 индексов, 38 RLS-политик, 4 роли, 13 триггеров, 5 функций — после v8.11 от 09.05.2026, audit P0-02 + O-perf-02/03) |
|
||
|
||
## Репозиторий
|
||
|
||
https://github.com/CoralMinister/liderra (приватный)
|