Дмитрий
60897e0ed2
§5 Источник данных — Webhook: - §5.1 переписан: 3 канала ingress (webhook ~95%, manual ~3%, CSV ~2%) - Добавлен блок про outbound webhook как уникальное преимущество с привязкой к §19.10 и 7 линиям доказательств §8 Воронка и статусы: - §8.1: 14 статусов с явным разделением 6 системных vs 8 настраиваемых, цвета hex из брендбука v1.1, описание каждого статуса - §8.2: free state machine (CTO-2) с 4-пунктным обоснованием - §8.5 переписан в 4 подсекции: что настраивается (только название на MVP), примеры, резолв через Redis-кеш, UX inline-редактирования §9 Мои Проекты (большой раздел): - 5 → 10 подсекций - §9.2: таблица с лимитами/регионами/днями - §9.4: карточка проекта 11 секций (паритет с оригиналом, партии 10.3-10.7) - §9.5: EffectiveLimitCalculator (главное расхождение №2 с оригиналом): динамический effective_daily_limit_today, 5 триггеров пересчёта, логирование в project_limit_adjustments - §9.6: project_suppliers m2m - §9.7: soft-delete + retention 180 дней (Биз-14, cron disabled до Б-1) - §9.8: capabilities поставщиков B1/B2/B3 (партия 13.3.5) - §9.9: расширенные действия. §9.10: окно обслуживания (паритет не делаем) §12 Дашборд: - §12.5.6 «Конверсия проектов» (паритет с /admin/visit/rt-stat, партия 12.1): 17 колонок (id/тег/проект/статус/источник/обработано + 11 status-колонок), формат N (XX.XX%), monotone per column, total-row, видимость через users.preferences - Наши расширения сверх паритета: экспорт XLSX через report_jobs + drill-down из ячейки в /deals - +2 эндпоинта в §12.6 Шапка narrative обновлена. План v8.4: 12/13 ✅ (было 8/13). Осталось только §23.10 Админка SaaS (большой). cspell-words.txt: +резолв, +пунктным. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Прил. Л — HTML-прототипы Лидпоток
Самодостаточные HTML-прототипы 8 ключевых экранов клиентского приложения и админки SaaS. Это не боевой код — это референс для дизайнера (Диз-1) и рабочая заготовка для frontend-команды в спринтах 1, 4, 5, 8, 14.
Как пользоваться
открыть web/index.html → выбрать экран → двойной клик
Структура проекта
lidpotok/
├── README.md ← этот файл (про прототипы)
├── CLAUDE.md ← оперативная карта для Claude Code (приоритет правил, 28 инструментов)
├── docs/ ← документация, инструкции, аудиты, брендбук, Прил. Н (tooling)
├── web/ ← HTML-прототипы экранов
└── db/ ← schema.sql и changelog схемы
Каждый прототип:
- Полностью офлайн-самодостаточный, кроме одного запроса к Google Fonts за
InterиJetBrains Mono(можно заменить на локальный fallback за минуту). - Содержит «пилюлю i» в правом нижнем углу — открывает спецификацию экрана: состояния, API-контракты, требования безопасности, что не реализовано.
- Использует только токены из
brandbook.mdv1.1. Если в проекте появятся новые токены — править надо брендбук, не прототип.
Источники истины
| Что | Где |
|---|---|
| Палитра, типографика, размерная сетка | brandbook.md v1.1 §3, §4, §5, §8 |
| SVG-логотипы | brandbook.md §9.1–9.5 |
| Поведение экранов | CRM_bp-gr_Инструкция_v8_3.md v8.3.1 |
| Админка SaaS (экран 08) | Админка_SaaS_v8_2.md |
| Открытые вопросы по дизайну | Открытые_вопросы_v8_3.md Диз-1, Диз-3 |
Статус экранов
| # | Экран | Статус | Сессия |
|---|---|---|---|
| 01 | Логин · Регистрация · 2FA · Recovery | ✅ Готово | 05.05.2026 |
| 02 | Дашборд | ⏸ В очереди | — |
| 03 | Список сделок | ⏸ В очереди | — |
| 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.cssVue-проекта (но единственный источник истины —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. Прототипы не менялись. |
Прил. Л v0.1 от 05.05.2026 — старт серии прототипов.
Документация для разработчика
| Документ | Что в нём |
|---|---|
| CLAUDE.md | Оперативная карта для Claude Code: приоритет правил (5 уровней), стек проекта, карта 28 инструментов «когда что использовать», 10 запретов, текущая фаза |
| docs/Tooling_v8_3.md | Прил. Н v1.0 — полный реестр 28 инструментов в 4 фазах (фаза 0 — сейчас, +1 Laravel, +2 Vue, +3 pre-prod), конфликты и решения, процедура перехода между фазами, особенности Windows + PowerShell |
| docs/Pravila_raboty_Claude_v1_1.md v1.2 | Продуктовые правила работы Claude в проекте |
| docs/README_АРХИВ_v8_3.md v8.3.3 | Состав архива, навигатор по документам |
| docs/CRM_bp-gr_Инструкция_v8_3.md v8.3.1 | Главное ТЗ из 28 разделов |
| db/schema.sql v8.3 | Схема БД PostgreSQL 16 (51 таблица + 12 партиций, 81 индекс, 31 RLS-политика) |