# Архив документации Лидерра (CRM bp-gr) — v8.5 (07.05.2026, обновлено 08.05.2026)

**Состав:** 18 файлов в `docs/` + 2 в `db/` + `CLAUDE.md` + `README.md` в корне репозитория (1 главный narrative v8.5 + 12 шифров приложений [А, Б, В, Г, Д, Е, Ж, З, И, К, М, **Н**] в 11 файлах [Б+В физически в одном] + brandbook + 1 маркетинговое ТЗ (TZ_landing v1.0, 08.05.2026) + 3 служебных + 1 правила работы Claude + 1 реестр tooling). *См. историю изменений ниже: v8.5 = реализация 27 решений аудита C из реестра v1.12 (07.05.2026). Schema.sql v8.5 (54 табл/91 инд/35 RLS/4 роли/12 триггеров/4 функции; +`project_user_assignments`, +`crm_audit_writer`, +6 audit-триггеров append-only + hash chain). Narrative v8.5 — переписаны §7.1 (метрики), добавлены §10.8 (антифрод+routing+scoring+region+escalation), §12.5.5 (TTFR+UTM cohort), §14.8 (audit hash chain + export log), §17.9 (Telegram + late payment alerts), §19.10.11–12 (DNS-rebinding + marketing.conversion), §22.13 (SSO/Sentry/SET LOCAL/anti-DDoS/TTL secrets/two-person), §23.10.11 (break-glass + two-person UI), Прил.И Часть Г (9 операционных процедур).*

**Эволюция версий:**
v8.0 (25.04.2026)
→ v8.1 (03.05.2026)
→ v8.2 (04.05.2026)
→ v8.2.1 (правки аудита)
→ v8.3 (04.05.2026, +30 продуктовых решений, +Прил. К, +brandbook, +конспект)
→ v8.3+ (04.05.2026, +Прил. М v1.0, +аудит партий 1–11, Открытые_вопросы → v1.5)
→ v8.3++ (05.05.2026, +партии аудита 12–15, Прил. М → v1.1, schema.sql → v8.3, Открытые_вопросы → v1.6, +CHANGELOG-v8_3.md, +конспект сессии 05.05; **21 файл**)
→ v8.3++ optimized (05.05.2026, объединение 11 файлов в 5 без потери информации; 21 → 16 файлов).
→ v8.3++ optimized + правила Claude (05.05.2026, поздний вечер): `Konspekt_sessii_05_05_2026.md` удалён (информация в `Объединённый_конспект.md`); добавлены `Объединённый_конспект.md` и `Pravila_raboty_Claude_v1_1.md`; 16 → 17 файлов.
→ **v8.3.1 (05.05.2026, поздний вечер): аудит связности архива + 13 точечных правок в 5 файлах. Разрешена коллизия `OPEN-И-2` (вариант B′: «контакты эскалации» → `OPEN-И-12` P1). Синхронизирована таблица OPEN-И-* в Runbook v8.2 Часть В. Исправлены 4 ссылки на удалённый `Konspekt_sessii_05_05_2026.md` → `Объединённый_конспект.md`. Помечена 📜 историческая таблица §28 narrative. `Открытые_вопросы` → v1.7. Архитектурных изменений: 0. Состав: 17 файлов (без изменений).**
→ v8.3.2 (05.05.2026, поздний вечер, итерация 2): закрытие 3 🟡-расхождений бэклога v8.4 + закрытие Биз-10 переоткрытого + синхронизация narrative до v8.3.1 + устранение унаследованного расхождения сводки §0 в Прил. Е.
→ **v8.3.3 (06.05.2026): добавление Прил. Н — реестра 28 инструментов разработки, скиллов Claude Code, MCP-серверов и плагинов в 4 фазах (фаза 0 — текущая, +1, +2, +3). Создан корневой `CLAUDE.md` — оперативная карта для Claude Code (приоритет правил, стек, карта инструментов, запреты). Шифр Н занят. Pravila_raboty_Claude обновлены до v1.2 (§4.8 — добавление Н в занятые шифры). Открытые_вопросы обновлены до v1.9 (упоминание Прил. Н в шапке). Архитектурных изменений: 0. Правки в 3 файлах. (1) `schema.sql` — добавлены явные комментарии «-- НЕ tenant-уровневая. RLS не применяется намеренно» к `impersonation_tokens` и `pd_subject_requests` (false-positive в self-review v8.3.1). (2) `Открытые_вопросы` v1.7 → v1.8: 📜-пометка к историческому хвосту v1.5→v1.6, Биз-10 ⏸ → ✅, устранено унаследованное расхождение сводки §0 (шапка ✅ 30 при сумме строк 32 в v1.7 → шапка ✅ 33 при сумме строк 33 в v1.8; теперь арифметически согласовано). (3) `CRM_bp-gr_Инструкция_v8_5.md` v8.3 → v8.3.1 — синхронизация 8 точек по Биз-10 (§6.3, §9, §10.2, §10.3, §12.2, §17.5, §17.6): удалены устаревшие `deals.reminder_text`/`deals.reminder_at`/`is_done`/`idx_deals_reminder`, переписан DDL `reminders` по schema.sql v8.3 (`created_by`, `assignee_id`, `completed_at`, RLS), добавлен паритетный фильтр `?reminders=today\|last\|future\|none`. **Архитектурных изменений: 0.** Состав: 17 файлов (без изменений).**
→ **v8.4 (06.05.2026, поздний вечер): финал narrative v8.4.** Все 13 разделов плана переписаны (§1, §5, §7, §8, §9, §12, §14, §17, §18.4, §19.10, §22, §23.10, §26). Главный narrative переименован: `CRM_bp-gr_Инструкция_v8_3.md` → `CRM_bp-gr_Инструкция_v8_5.md`. Schema → v8.4 (+`outbound_webhook_subscriptions`, +`outbound_webhook_deliveries`, +2 RLS, +5 индексов). Метрики schema: 51/81/31 → **53/86/33**. Открытые_вопросы → v1.10 (закрыто 11 вопросов с дефолтами; все P2 закрыты; 50 продуктовых: 40✅/5🟦/5⏸; 0 P2). Промежуточный `Plan_narrative_v8_4.md` удалён (план выполнен). Прил. Н, Прил. М, brandbook — без изменений. Состав: 17 файлов в `docs/` (минус удалённый Plan) + 2 в `db/` + CLAUDE.md + README.md в корне.
→ **v8.5 (07.05.2026): реализация 27 решений аудита C из реестра v1.12.** schema.sql v8.4 → v8.5 (53→54 табл, 86→91 инд, 33→34 RLS, 34→35 ENABLE RLS, 3→4 роли, 0→12 триггеров, 0→4 функции, +`project_user_assignments`, +`crm_audit_writer`, ~26 новых колонок, ALTER `api_keys.expires_at SET NOT NULL DEFAULT NOW()+365d`). Narrative v8.4 → v8.5 (переименован файл; добавлены §10.8/§12.5.5/§14.8/§17.9/§19.10.11–12/§22.13/§23.10.11; обновлены метрики §7.1). README архива v8.4 → v8.5. Прил. И → v0.3 (+Часть Г: 9 процедур). 8 P0 разблокировали триггер фазы 1. Открытые_вопросы → v1.12 (67✅/5🟦/5⏸ из 77; 0 P2). Состав: **17 файлов в `docs/`** + 2 в `db/` + CLAUDE.md + README.md (без изменений в составе — переименования не меняют count).

**Рабочее название продукта:** **Лидерра**.

---

## ⚡ Что нового в v8.3++ optimized — структурная оптимизация

В рамках сессии 05.05.2026 (вечер) проведена структурная оптимизация архива по схеме «Вариант B + SVG inline» (выбрано заказчиком). Цель: уменьшение количества файлов без потери информации, для упрощения навигации и передачи разработчикам.

**Что объединено:**

| Что | В файл | Почему |
|---|---|---|
| `CHANGELOG-v8_2.md` + `CHANGELOG-v8_3.md` | `CHANGELOG_schema.md` | Стандарт keep-a-changelog: один журнал, новые записи сверху. |
| `ER_диаграмма_v8_1.md` (Прил. Б) + `State_machines_v8_1.md` (Прил. В) | `Приложение_Б_В_БД_диаграммы_v8_3.md` | Оба — Mermaid-диаграммы по `schema.sql`. Один читатель — CTO/backend. |
| 5 SVG-файлов лого (`liderra-*.svg`) | inline в `brandbook.md` v1.1 § 9 | Frontend копирует SVG из markdown (раздел 9.1–9.5). |
| `audit-batch-12..15-2026-05-05.md` (4 файла) | `Аудит_partii_12_15_originala_v8_3.md` | Все 4 партии — одна сессия аудита 05.05, один контекст. |
| `Konspekt_sessii_05_05_2026_obrabotka_arkhiva.md` + `Konspekt_sessii_05_05_2026_obrabotka_partiy_12_15.md` | `Konspekt_sessii_05_05_2026.md` | Один день — один конспект, две части. |

**Что НЕ объединено** (роле-ориентированные документы — у каждого свой читатель):

- Прил. Г (Админка SaaS), Прил. И (Runbook), Прил. К (Облако) — отдельные документы для DevOps + admin.
- Прил. Д (Workflow ПДн), Прил. Ж (Оферта/Политика), Прил. З (Уведомление РКН) — отдельные юр. документы для разных юристов / РКН.
- Прил. М (Анализ оригинала) — самостоятельный документ-обоснование.

**Что в принципе не существует, но фигурирует в кросс-ссылках архива:** конспект интервью 04.05.2026 (`Konspekt_sessii_04_05_2026_intervyu.md`) и единый отчёт аудита 04.05.2026 (`crm-bp-gr-audit-2026-05-04.md`) **в этом архиве не приложены** — они хранятся в предыдущей итерации. Решения 04.05 интегрированы в шапку `CRM_bp-gr_Инструкция_v8_5.md`, выводы аудита 04.05 — в `Прил_М_Analiz_originala_v8_3.md` v1.1.

---

## Состав архива v8.3++ optimized

### Главный narrative (1 файл)

| Файл | Размер | Описание |
|---|---|---|
| `CRM_bp-gr_Инструкция_v8_5.md` | ~340 КБ | **Главный файл** — полное ТЗ из 28 разделов. v8.4 = v8.3.1 + переписаны все 13 разделов плана v8.4 (§1, §5, §7, §8, §9, §12, §14, §17, §18.4, §19.10, §22, §23.10, §26). 06.05.2026 — финал. |

### Приложения (12 шифров — А, Б, В, Г, Д, Е, Ж, З, И, К, М, Н) — 11 файлов

| Шифр | Файл | Назначение |
|---|---|---|
| **А** | `schema.sql` (v8.4) | Единая БД-схема: **53 логические таблицы + 12 партиций, 86 индексов, 33 RLS-политики**, 3 роли БД. **v8.4 = v8.3 + outbound webhook DDL** (закрытие тех-долга §19.10): +`outbound_webhook_subscriptions` (15 полей, 2 индекса), +`outbound_webhook_deliveries` (16 полей с retry-флоу 7 попыток до 24ч, 3 индекса), +2 RLS-политики. **v8.3 = v8.2 + патчи партий 12–15:** переписана `reminders`, удалены `deals.reminder_text/reminder_at`, расширены `suppliers` 5 полями capabilities (B1/B2/B3), добавлено `tenants.desired_daily_numbers` (Биз-16), 3 новых ключа `system_settings` для cron purge-deleted (Биз-14). Спутник: `CHANGELOG_schema.md` (записи Z=v8.4, A=v8.3, B=v8.2). Обоснование — `Analiz_originala_v8_3.md` § 3.5. |
| **Б+В** | `Приложение_Б_В_БД_диаграммы_v8_3.md` | **Объединено в v8.3++ optimized.** Часть Б — ER-диаграмма (6 доменных Mermaid-подграфов + flowchart-карта + справочник 81 FK + рейтинг таблиц). Часть В — 4 машины состояний (`saas_transactions`, `tariff_subscriptions`, `report_jobs`, `refund_requests`). **Внимание:** ER-диаграмма от v8.1 — не отражает изменений schema v8.2/v8.3. Обновление до v8.3 запланировано в v8.4 narrative. |
| **Г** | `Админка_SaaS_v8_2.md` | Спецификация админки SaaS. **v8.2** — добавлены DO-3 (5 компенсирующих мер безопасности), DO-5 (SSO Yandex 360), Биз-9 (2FA на всех тарифах), incidents_log экран, экран лога восстановлений Биз-7. |
| **Д** | `Workflow_pd_subject_requests_v8_2.md` | Workflow обращений субъектов ПДн. **v8.2** — добавлены OPEN-Д-1 (поле `processing_restricted`), OPEN-Д-5 (DDL таблицы `incidents_log`). |
| **Е** | `Открытые_вопросы_v8_3.md` | Сводный workplan. **v1.10** (06.05.2026) — закрыто 11 вопросов с дефолтами (Биз-6/10/11/12/13/14/15/16, OPEN-К-1/7, OPEN-И-12); все P2 закрыты; 50 продуктовых вопросов: **40✅/5🟦/5⏸**, 1 P0 (Б-1), 4 P1, 0 P2. |
| **Ж** | `Oferta_i_Politika_v8_2.md` | Структурный шаблон оферты + Политики. **v8.2** — добавлены OPEN-Ж-3 (Click-wrap), название Лидерра, хостинг Yandex Cloud, обновлена трансграничная передача под Ю-7. |
| **З** | `Uvedomlenie_RKN_v8_2.md` | Шаблон уведомления РКН. **v8.2** — закрыт пункт 9 (адрес ЦОД Yandex Cloud Москва), название Лидерра, отметка про DPA OPEN-К-6. |
| **И** | `Runbook_ekspluatatsii_v8_2.md` | Runbook on-call дежурного. **v8.2** — добавлены OPEN-И-1 (incidents_log integration), OPEN-И-2 (стратегия CRM-интеграций: Уровень 1 на MVP + amoCRM в спринте 14–15). |
| **К** | `Vybor_oblaka_v8_3.md` | Сравнение облачных провайдеров. **v1.1** — зафиксировано решение «Yandex Cloud, ru-central1». |
| **М** | `Analiz_originala_v8_3.md` | Анализ оригинала crm.bp-gr.ru и архитектурные следствия. **v1.1** — расширено по итогам параллельного аудита партий 12–15 от 05.05: новый § 3.5 (DDL для schema.sql v8.3), новый § 6.6 (security-антипаттерны оригинала), новый детальный § 9 (партии 12–15 с подразделами 9.1–9.6 для backend и продакта), окончательный вердикт по outbound webhooks (нет — 7 линий доказательств), 3 новых вопроса (Биз-14/15/16). |
| **Н** | `Tooling_v8_3.md` | **Новое в v8.3.3.** Реестр 28 инструментов разработки, скиллов Claude Code, MCP-серверов и плагинов в 4 фазах: фаза 0 — текущая (документация + HTML-прототипы, 9 инструментов: 3 MCP-сервера, 4 линтера docs, 2 безопасности); фаза 1 — старт Laravel (+9 нетто −1, итого 17, главное — Laravel Boost заменяет PostgreSQL MCP); фаза 2 — старт Vue/Vuetify (+6, итого 23, включая Superpowers выборочно — 3 skills); фаза 3 — pre-production (+5, итого 28: Semgrep, Trivy, Dependabot, pg_audit, pg_anonymizer). §6 — конфликты и решения, §7 — приоритет правил при конфликте (5 уровней), §9 — что НЕ ставим (10+ запрещённых дублей), §10 — процедура перехода между фазами, §11 — конфигурация под Windows + PowerShell. **v1.0**, утверждено заказчиком 06.05.2026. |

### Бренд-материалы (1 файл)

| Файл | Назначение |
|---|---|
| `brandbook.md` | **v1.1 — обновлено в v8.3++ optimized.** Брендбук Лидерра: палитра, типографика, правила использования логотипа, готовые CSS-переменные, Vuetify 3 тема. **§9** — все 5 SVG-исходников логотипа (`liderra-logo-full`, `-mono`, `-dark`, `-icon`, `-favicon`) интегрированы inline. Frontend копирует SVG из соответствующего раздела markdown в свой проект. |

### Маркетинговые ТЗ (1 файл, добавлен 08.05.2026, физически — в `лендинг/` в корне репо)

| Файл | Назначение |
|---|---|
| `../лендинг/TZ_landing_v1_0.md` | **v1.0 от 08.05.2026.** Техническое задание на одностраничный рекламный лендинг (`liderra.ru/`). Целевая аудитория №1 — действующие клиенты crm.bp-gr.ru. 15 разделов: цели и КПИ, ЦА и боли (источник — Прил. М), 12 блоков структуры (Hero → Проблема → 7 преимуществ → Безопасность → Тарифы → FAQ → CTA → Footer), копирайт по блокам с 3 вариантами H1, дизайн-требования (брендбук v1.1/v2 Forest), стек (рекомендация Astro+Vue islands, отдельно от SaaS), производительность (Lighthouse ≥90), WCAG 2.1 AA, аналитика Я.Метрика+UTM-cohort, формы со SmartCaptcha, юр. требования (152-ФЗ, 3 чекбокса click-wrap), 9 открытых вопросов OPEN-Лендинг-1..9, чеклист готовности к запуску. **⏸ Выкатка в продакшен блокирована Б-1** (реквизиты юр. лица); дизайн/копирайт/разметка могут разрабатываться параллельно. Физический путь: `лендинг/TZ_landing_v1_0.md` в корне репозитория (отдельная папка под будущий код/макеты лендинга). |

### Служебные файлы (4 файла)

| Файл | Назначение |
|---|---|
| `CHANGELOG_schema.md` | **Объединено в v8.3++ optimized** из CHANGELOG-v8_2.md + CHANGELOG-v8_3.md. Журнал изменений `schema.sql`: запись A (v8.2 → v8.3), запись B (v8.1 → v8.2). Спутник для backend: изменения Eloquent-моделей, новые сервисы, миграция данных, тестирование. |
| `Аудит_partii_12_15_originala_v8_3.md` | **Объединено в v8.3++ optimized** из 4 файлов (`audit-batch-12..15-2026-05-05.md`). Read-only аудит crm.bp-gr.ru через Claude в Chrome 05.05.2026, 4 параллельные партии. Часть 12 — Конверсия проектов + Напоминания + Досье. Часть 13 — Рекомендации источников + Настройки реестра + Просмотреть + Звонки. Часть 14 — Редкие статусы + KB + Безопасность профиля. Часть 15 — Карточки 12 интеграций «API ▾», окончательный вердикт по outbound webhooks. Источник для Прил. М v1.1. |
| `Объединённый_конспект.md` | **Сводный конспект сессий проекта.** Объединяет 6 исходных конспектов: `Конспект_1.md`, `Конспект_сессии_v8_0.md`, `Конспект_сессии_03_05_2026_1.md`, `Конспект_сессии_03_05_2026.md`, `Конспект_сессии_04_05_2026.md`, `Konspekt_dialoga_05_05_2026.md`. Хроника работы 03–05.05.2026: создание v8.0 → v8.1 → v8.2 → v8.3+ → v8.3++ optimized. Часть VI — «Соглашения о работе и бэклог» (стала источником для свода правил `Pravila_raboty_Claude_v1_1.md`). *Заменяет ранее существовавший `Konspekt_sessii_05_05_2026.md` (2 части дня 05.05): информация по обеим частям сессии 05.05 интегрирована в эту сводку.* |
| `README_АРХИВ_v8_3.md` | Этот файл (v8.3++ optimized + правила Claude). |

### Служебные правила (1 файл, добавлен 05.05.2026 поздно вечером)

| Файл | Назначение |
|---|---|
| `Pravila_raboty_Claude_v1_1.md` | **v1.1, утверждено 05.05.2026.** Свод правил работы Claude в проекте: роль системного архитектора-документалиста (§1), что Claude делает сам / спрашивает / не делает (§2), формат ответов и работы с файлами (§3), документация и версионирование (§4: включая паттерн «3 варианта», self-review, шифры приложений), безопасность и ПДн (§5), Claude в Chrome — режим аудита оригинала (§6), работа с открытыми вопросами (§7), рутины сессии (§8: включая защиту от компакции контекста). Содержимое скопировано в поле "Project instructions" Claude.ai; файл хранится здесь как канонический источник. |

---

## Сводка: 21 → 16 файлов (-24%)

| Категория | Было (v8.3++) | Стало (v8.3++ optimized) | Δ |
|---|---|---|---|
| Главный narrative | 1 | 1 | 0 |
| Приложения А–М | 11 (включая Б, В отдельно) | 10 (Б+В объединены) | -1 |
| Бренд-материалы (brandbook + 5 SVG) | 6 | 1 | -5 |
| Аудиты партий 12–15 | 4 | 1 | -3 |
| Конспекты сессии 05.05 | 2 | 1 | -1 |
| Служебные (CHANGELOG ×2 + README) | 3 | 2 (CHANGELOG объединён + README) | -1 |
| **Итого** | **21** | **16** | **-5** |

### Текущее состояние (после 08.05.2026, добавление TZ_landing): 19 файлов в `docs/` + 2 в `db/` + `CLAUDE.md` в корне

| Категория | v8.3++ optimized | v8.3.2 | v8.3.3 | v8.5 + landing (текущее) | Δ к v8.3.3 |
|---|---|---|---|---|---|
| Главный narrative | 1 | 1 | 1 | 1 | 0 |
| Приложения (А, Б+В, Г, Д, Е, Ж, З, И, К, М, **Н**) | 10 | 10 | **11** | 11 | 0 |
| Бренд-материалы | 1 | 1 | 1 | 1 | 0 |
| Маркетинговые ТЗ (TZ_landing v1.0) | 0 | 0 | 0 | **1** | +1 |
| Служебные (CHANGELOG, Аудит, README, Объединённый_конспект) | 4 | 4 | 4 | 4 | 0 |
| Служебные правила (`Pravila_raboty_Claude_v1_1.md`) | 0 | 1 | 1 (v1.2) | 1 | 0 |
| **Итого в `docs/` + `db/`** | **16** | **17** | **18** | **19** | **+1** |
| `CLAUDE.md` в корне репозитория | 0 | 0 | 1 | 1 | 0 |
| **Итого по репозиторию** | 16 | 17 | 19 | **20** | +1 |

*Прил. А (`schema.sql`) и спутник `CHANGELOG_schema.md` физически живут в `db/`, но логически считаются частью архива документации. `CLAUDE.md` — новый файл фазы 0: оперативная карта для Claude Code, не заменяет документы архива (см. Прил. Н §7).*

---

## Что нового в v8.3 относительно v8.2.1

### Зафиксировано 30 продуктовых решений

Подробно — в `Объединённый_конспект.md` (Часть V «v8.3+ → v8.3++ optimized», 05.05.2026), и (для интервью 04.05) в шапке `CRM_bp-gr_Инструкция_v8_5.md`.

Сводка:

**Облачная инфраструктура (8 решений):**

- DO-1 → **Yandex Cloud, ru-central1** ✅
- OPEN-К-2..8 → детали инфры, RPO/RTO, бэкапы, DPA ✅

**Бизнес / биллинг (8 решений):**

- Б-2..6 → формат закрывающих, минимум пополнения 100₽, округление вниз, 1С 8.3 XML ✅
- Биз-5/7/9 → trial, восстановление лидов, 2FA ✅
- Биз-3/4/8 → автоматические следствия других решений ✅

**CTO / архитектура (6 решений):**

- CTO-6..11 → MFA, RLS на MVP, JivoSite, Vuetify 3, click-wrap, и др. ✅

**Юристу / документам (3 решения):**

- Ю-6/7 → закрытые юр. вопросы ✅
- Ю-1/2/3 → закрыты ранее в v8.1 ✅

**Дизайнеру (2 решения):**

- Диз-2 → брендбук Лидерра (см. `brandbook.md` v1.1) ✅
- Диз-4 → шрифты (Inter / SF Pro) ✅

**DevOps (3 решения):**

- DO-3 → 5 компенсирующих мер безопасности ✅
- DO-5 → SSO Yandex 360 ✅
- DO-1 → Yandex Cloud (см. выше) ✅

### Что осталось от заказчика (на 05.05.2026)

**P0 (блокер спринта 0):** 1 вопрос — **Б-1** (реквизиты юр. лица). От него зависят также Диз-3, DO-2, DO-4, Биз-14 (cron purge-deleted активируется только после Б-1).

**P1 / P2:** Биз-6 (формат акта-сверки) в процессе. Биз-10..16 (из аудита) — все с разумными дефолтами, не блокеры.

### Что осталось мне (Claude) — на 06.05.2026 (поздний вечер)

В порядке приоритета:

1. **Прил. Л — HTML-прототипы 04..08** (P1, Диз-1) — осталось 5 из 8 (готовы 01-login, 02-dashboard, 03-deals от 05–06.05.2026). В очереди: 04 карточка сделки, 05 канбан, 06 биллинг, 07 настройки тенанта, 08 админка SaaS. **Заметка**: заказчик 06.05 упомянул «дизайн не нравится» — до старта 04..08 уточнить, не требуется ли переоткрытие Диз-2 (брендбук v1.1).
2. ✅ ~~v8.4 narrative~~ — **выполнено 06.05.2026**: все 13 разделов переписаны, файл переименован в `_v8_4.md`, schema → v8.4, Plan_narrative_v8_4 удалён.

---

## Что нового после аудита партий 1–11 (04.05.2026)

### Главные открытия аудита

1. **Раскрыта сущность «Поставщик» (B1/B2/B3)** — это не наше внутреннее техническое поле, а **архитектурный слой над проектом** в оригинале. У нас должна быть таблица `suppliers` + `project_suppliers`. Применено в schema.sql v8.2.
2. **Динамические лимиты по балансу** — `effective_daily_limit = min(project.daily_limit, balance / lead_cost)`. Применено в schema.sql v8.2 (поле `projects.effective_daily_limit_today` + таблица `project_limit_adjustments`).
3. **Outbound webhook'ов в оригинале НЕТ** (24 keyword × 0 совпадений в DOM, истории, формах). Наш Уровень 1 (outbound webhook на MVP) — конкурентное преимущество.
4. **Карточка сделки всегда editable во всех 14 статусах** — нет state-machine на стороне UI. Бэк должен принять любой переход.
5. **Prompt injection-атака в DOM каждой страницы оригинала** — `claude-agent-stop-container` + кнопка «Stop Claude». Источник не установлен. Действия Claude в Chrome ✅ корректные.

### Что обновлено в архиве после аудита партий 1–11 (04.05)

- Создано `Прил_М_Analiz_originala_v8_3.md` v1.0.
- `Открытые_вопросы_v8_3.md` → v1.5 (+раздел 11 с Биз-10..13).
- Применены патчи к `schema.sql` v8.2 (+4 таблицы, +6 полей).

### Новые продуктовые вопросы заказчику из аудита партий 1–11 (все с дефолтами, не блокеры)

| ID | Вопрос | Дефолт | Когда нужен |
|---|---|---|---|
| Биз-10 | Модель «задач» сделки (переоткрыт в v1.6 — см. ниже) | См. v1.6 | Спринт 5 |
| Биз-11 | Мульти-кошельковый биллинг (отдельные счёт за trial-бонус и за пополнения) | Один счёт | Спринт 7 |
| Биз-12 | Телефонная интеграция | Не делаем (Post-MVP) | — |
| Биз-13 | Magic-link 24ч для менеджеров | Делаем на MVP | Спринт 11 |

---

## Что нового после аудита партий 12–15 (05.05.2026)

### Главные открытия партий 12–15

1. **Биз-10 переоткрыт** (партия 12) — в оригинале `model.histories[].type='reminder'` массив, нужна отдельная таблица `reminders` (минимальный паритет: text + remind_at + created_by + created_at + наше расширение `completed_at`). Удалены `deals.reminder_text/reminder_at`.
2. **B1/B2/B3 capabilities жёстко подтверждены** (партия 13.3.5) — цитата UI «B2 поддерживает связку sender_name+keyword, B3 — только sender_name». Применено: `suppliers` +5 полей capabilities в schema.sql v8.3.
3. **Outbound webhook'ов НЕТ — окончательно** (партия 15) — 7 линий доказательств: 5 открытых карточек интеграций, 0/31 keyword в 71 КБ кастомного JS, 0 внешних XHR из браузера. Уточнение: для Bitrix24 есть hardcoded URL `prostats.info/bitrix24/webhook.php`, но это inbound с т. з. CRM.
4. **Оригинал не имеет 2FA, журнала входов, списка сессий** (партия 14) — у нас всё это есть в schema v8.2 (Биз-9). Сильный security-апгрейд.
5. **Антипаттерны оригинала**:
   - Пароль виден plaintext в `<input type="text">` на странице профиля (партия 14). У нас — отдельная защищённая форма «Старый/Новый/Подтверждение».
   - API-ключи и client_secret в `<input type="text">` во всех 5 открытых карточках интеграций (партия 15). У нас — `type="password"` + кнопка-toggle «Показать».
6. **Карточка сделки во всех 14 статусах единая** (косвенно, партия 14) — гипотеза не опровергнута.

### Что обновлено в архиве после аудита партий 12–15

- `Прил_М_Analiz_originala_v8_3.md` → v1.1 (+§3.5 DDL для schema.sql v8.3, +§6.6 security-антипаттерны, +§9 детальная развёртка партий 12–15).
- `Открытые_вопросы_v8_3.md` → v1.6 (+раздел 12 «Аудит партий 12–15», +Биз-14/15/16, Биз-10 переоткрыт).
- `schema.sql` → v8.3 (+5 полей в `suppliers`, +1 поле в `tenants`, -2 поля в `deals`, переписана таблица `reminders`, +3 ключа в `system_settings`).
- Создан `CHANGELOG-v8_3.md` (объединён с v8_2 в `CHANGELOG_schema.md` в рамках оптимизации архива).
- Создан `Konspekt_sessii_05_05_2026_obrabotka_partiy_12_15.md` (объединён в `Konspekt_sessii_05_05_2026.md`).

### Новые продуктовые вопросы заказчику из аудита партий 12–15 (все с дефолтами, не блокеры)

| ID | Вопрос | Дефолт | Когда нужен |
|---|---|---|---|
| Биз-10 (переоткрыт) | Модель напоминаний — отдельная таблица или поля в deals? | Отдельная таблица `reminders` | Спринт 5 |
| Биз-14 | TTL для soft-deleted проектов | 180 дней + cron disabled до Б-1 | После Б-1 |
| Биз-15 | OSINT-wizard «Рекомендации источников» | Не делаем на MVP | — |
| Биз-16 | Поле `tenants.desired_daily_numbers` | Делаем | Спринт 1 |

---

## С чего начать чтение

### Любой читатель (общее ориентирование)

1. `Объединённый_конспект.md` — сводная хроника проекта 03–05.05.2026 (v8.0 → v8.3++ optimized). Часть V посвящена сессии 05.05.2026 (обе части дня): обработка архива и аудит партий 1–11 (1-я половина дня), аудит партий 12–15 (вечер), структурная оптимизация архива.
2. `Открытые_вопросы_v8_3.md` v1.10 — раздел 0 (сводная статистика 50 продуктовых вопросов) + разделы 11, 12 (новые вопросы из аудита).
3. `Analiz_originala_v8_3.md` (Прил. М) v1.1 — раздел 0 «TL;DR» — что нового после аудита (3 расхождения, 2 подтверждения, 7 новых продуктовых вопросов).

### Claude / разработчик, входящий в проект

1. `CLAUDE.md` (корень репозитория) — оперативная карта: приоритет правил, стек, карта 33 инструментов «когда что использовать», 12 запретов, текущая фаза.
2. `Tooling_v8_3.md` (Прил. Н) — полный реестр 33 формализованных позиций тулчейна (29 active по фазам + 3 off-phase + 1 historic), конфликты и решения, процедура перехода между фазами, особенности Windows + PowerShell.
3. `Pravila_raboty_Claude_v1_1.md` v1.2 — продуктовые правила работы Claude (роль, что Claude делает сам / спрашивает / не делает, формат ответов, ПДн, Claude в Chrome, открытые вопросы, рутины сессии).

### Заказчик / архитектор проекта

1. `CRM_bp-gr_Инструкция_v8_5.md` — раздел «Что нового в v8.3» в шапке.
2. `Analiz_originala_v8_3.md` (Прил. М) v1.1 — разделы 0, 2, 5 (TL;DR + главные открытия + 7 новых вопросов с рекомендациями).
3. `Открытые_вопросы_v8_3.md` v1.10 — раздел 10 «Что осталось от заказчика» + разделы 11–12 (Биз-10..16).

### Backend-разработчик

1. `CRM_bp-gr_Инструкция_v8_5.md` — раздел «Что нового в v8.3» (обязательно), потом разделы 1–7, 20–22.
2. **`Analiz_originala_v8_3.md` (Прил. М) v1.1 — обязательно**: §2 (новые архитектурные сущности), §3 (DDL для schema.sql v8.2 и v8.3), §3.5 (детальный DDL партий 12–15), §4 (изменения в narrative), §9 (детальная развёртка партий 12–15 для backend).
3. **Приложение А (`schema.sql` v8.3)** — единая консолидированная схема.
4. **`CHANGELOG_schema.md`** — спутник: запись A (v8.2 → v8.3), запись B (v8.1 → v8.2). Eloquent-модели, сервисы, миграция, тестирование.
5. **Приложение Б+В** (`Приложение_Б_В_БД_диаграммы_v8_3.md`) — Часть Б — ER. Часть В — для биллинга. **Внимание:** для статусов сделок state-machine НЕТ (Прил. М §2.4) — все переходы свободные. ER-диаграмма от v8.1 — не отражает v8.2/v8.3 изменений (см. предупреждение в шапке файла).
6. Приложение Д v8.2 — DDL `incidents_log` и `processing_restricted` берёт отсюда.
7. Приложение И v8.2 — что делать при инциденте.

### Frontend-разработчик

1. `CRM_bp-gr_Инструкция_v8_5.md` — раздел 26 (UX/Frontend) + шапка v8.3 (CTO-6, CTO-11, JivoSite, click-wrap).
2. **`brandbook.md` v1.1 — обязательно**: палитра, типографика, готовая Vuetify 3 тема. **§9.1–9.5** — 5 SVG-исходников логотипа inline (копировать в `/public/assets/`).
3. **`Analiz_originala_v8_3.md` (Прил. М) v1.1** §4.5 — спецификация карточки проекта (паритет с оригиналом + наши расширения), §4.4 — карточка сделки всегда editable, §9.4.4 — антипаттерны оригинала с credentials (использовать `type="password"`), §9.3 — формат «Тихих часов».
4. Приложение Г v8.2 — спецификации UI админки SaaS.

### DevOps

1. `CRM_bp-gr_Инструкция_v8_5.md` — раздел «Что нового в v8.3» (DO-1, DO-3, DO-5, OPEN-К-2..8).
2. **Приложение К v1.1** — обоснование выбора Yandex Cloud + список патчей в v8.4.
3. **`Analiz_originala_v8_3.md` (Прил. М) v1.1 §6, §6.6** — обнаруженная prompt injection-атака в DOM оригинала + новые антипаттерны из партий 12–15 (пароль plaintext, API-ключи в text-input); CSP-требования для нашей платформы (§4.9).
4. Приложение З v8.2 — пункт 9 (адрес ЦОД), пункт 11 (УЗ-4).
5. Приложение И v8.2 — runbook + integration с `incidents_log`. Также — раздел про cron `projects:purge-deleted` (Биз-14).

### Юрист

1. **Приложение Ж v8.2** — оферта + Политика (главный документ для редактуры).
2. **Приложение З v8.2** — для подачи в РКН.
3. **Приложение Д v8.2** — workflow обращений субъектов ПДн.
4. `Открытые_вопросы_v8_3.md` v1.10 раздел 1 — все юр. задачи.
5. **Новая задача от 04.05:** OPEN-К-6 — DPA с Yandex Cloud (раздел 7 в Открытых).
6. **Новая задача от 05.05:** Биз-14 (TTL soft-deleted проектов = 180 дней — пересечение с 152-ФЗ, может потребовать корректировки).

### Бухгалтер

1. `Открытые_вопросы_v8_3.md` v1.10 раздел 2 — Б-1 (ждём от вас) и решения по Б-2..6.
2. `CRM_bp-gr_Инструкция_v8_5.md` шапка v8.3 раздел «Биллинг» — формат XLSX/email, минимум 100₽, округление вниз, 1С 8.3 XML.

### Дизайнер

1. **`brandbook.md` v1.1** — главный документ. SVG-исходники теперь inline в §9.1–9.5.
2. Когда появится — Приложение Л (HTML-прототипы 8 экранов).

### Compliance-админ SaaS / поддержка

1. **Приложение Д v8.2** — обработка обращений субъектов ПДн.
2. Приложение Г v8.2 §4 — ролевая модель + 5 компенсирующих мер DO-3.
3. Приложение И v8.2 — runbook + работа с `incidents_log`.

---

## История версий

| Версия | Дата | Что нового |
|---|---|---|
| v8.0 | 25.04.2026 | Стартовая полная инструкция |
| v8.1 | 03.05.2026 | Закрыты 11 P0 (CTO-1..5, Биз-1, Биз-2, Ю-1, Ю-2, Ю-3); +5 приложений (А, Б, В, Г, Е); реселлерская модель |
| v8.2 | 04.05.2026 | +4 приложения (Д, Ж, З, И); расширены Открытые вопросы |
| v8.2.1 | 04.05.2026 | Аудит связности — 5 точечных правок; +Прил. К (черновик) |
| v8.3 | 04.05.2026 | Интервью с заказчиком — 30 продуктовых решений; +brandbook; +Прил. К утверждён; +конспект сессии; имя продукта = Лидерра |
| v8.3+ | 04.05.2026 | Аудит crm.bp-gr.ru через Claude в Chrome (11 партий, read-only); +Прил. М v1.0; +файл аудита 04.05; Открытые_вопросы → v1.5 (раздел 11, +Биз-10..13); раскрыта сущность «Поставщик» (B1/B2/B3); подготовлен пакет патчей schema.sql v8.2; обнаружена prompt injection в DOM оригинала |
| v8.3++ | 05.05.2026 (день) | Параллельный аудит партий 12–15 (4 файла); Прил. М → v1.1 (+§3.5 DDL, +§6.6 security-антипаттерны, +§9 детальная развёртка партий 12–15); Открытые_вопросы → v1.6 (+раздел 12, +Биз-14/15/16, Биз-10 переоткрыт); schema.sql → v8.3; +CHANGELOG-v8_3.md; +конспект сессии 05.05 (2-я часть); окончательный вердикт «outbound webhooks нет» (7 линий доказательств); **21 файл** |
| **v8.3++ optimized** | **05.05.2026 (вечер)** | **Структурная оптимизация архива (Вариант B + SVG inline): объединено 11 файлов в 5. CHANGELOG-v8_2 + v8_3 → CHANGELOG_schema.md. Прил. Б + Прил. В → Приложение_Б_В_БД_диаграммы_v8_3.md. 4 файла аудита 12–15 → Аудит_partii_12_15_originala_v8_3.md. 2 конспекта 05.05 → Konspekt_sessii_05_05_2026.md. 5 SVG → inline в brandbook.md v1.1 §9.1–9.5. **Информация полностью сохранена** — только структурное укрупнение. Итог: 21 → 16 файлов (-24%).** |
| **v8.3++ optimized + правила Claude** | **05.05.2026 (поздний вечер)** | **Удалён `Konspekt_sessii_05_05_2026.md` (информация дублируется в `Объединённый_конспект.md`, потери нет). Добавлены: `Объединённый_конспект.md` (свод по 6 исходным конспектам сессий), `Pravila_raboty_Claude_v1_1.md` (свод правил работы Claude в проекте, утверждён заказчиком, скопирован в Project instructions). Итог: 16 → 17 файлов.** |
| **v8.3.1** | **05.05.2026 (поздний вечер)** | **Аудит связности архива (отчёт в чате 05.05) + точечные правки. (1) Разрешена коллизия `OPEN-И-2`: «контакты эскалации» переименованы в `OPEN-И-12` (P1, вариант B′ по решению заказчика); смыслы `OPEN-И-2` (CRM-интеграции, ✅) и `OPEN-И-11` (миграции `crm_connections`, ✅) сохранены. (2) Синхронизирована таблица OPEN-И-* в `Runbook_ekspluatatsii_v8_2.md` Часть В с шапкой (была расхожесть ✅/⏸ для OPEN-И-1/2). (3) Исправлены 4 ссылки на удалённый `Konspekt_sessii_05_05_2026.md` → `Объединённый_конспект.md` (Части V–VI). (4) Добавлены пометки 📜 ИСТОРИЧЕСКАЯ ЗАПИСЬ к таблице приложений §28 narrative. (5) `Открытые_вопросы` → v1.7. **Затронуто файлов: 5** (`Runbook_ekspluatatsii_v8_2.md`, `Объединённый_конспект.md`, `Открытые_вопросы_v8_3.md`, `CRM_bp-gr_Инструкция_v8_5.md`, `Аудит_partii_12_15_originala_v8_3.md` + этот README). **Архитектурных изменений: 0.** Итог: 17 файлов (без изменений в составе).** |
| **v8.3.3** | **06.05.2026** | **Добавление Прил. Н — реестра 28 инструментов разработки, скиллов Claude Code, MCP-серверов и плагинов в 4 фазах. Создан корневой `CLAUDE.md` — оперативная карта для Claude Code (приоритет 5 уровней правил, стек проекта, карта 28 инструментов «когда что использовать», 10 запретов). Обновлены: `Pravila_raboty_Claude_v1_1.md` v1.1 → v1.2 (§4.8 — Н в занятые шифры; счётчик занятых: 11 → 12), `Открытые_вопросы_v8_3.md` v1.8 → v1.9 (упоминание Прил. Н в шапке; продуктовых вопросов не добавлено). Обновлён корневой `README.md` — раздел «Документация для разработчика» со ссылками на `CLAUDE.md` и Прил. Н. **Затронуто файлов:** 6 (`docs/Tooling_v8_3.md` — новый, `CLAUDE.md` — новый, `docs/README_АРХИВ_v8_3.md`, `docs/Pravila_raboty_Claude_v1_1.md`, `docs/Открытые_вопросы_v8_3.md`, `README.md` корня + этот же README архива). **Архитектурных изменений: 0.** **Состав: 18 файлов** в `docs/`+`db/` + `CLAUDE.md` в корне (было: 17 в `docs/`+`db/`). |
| **v8.4** | **06.05.2026** (поздний вечер) | **Финал narrative v8.4 + финализация архива.** В одну сессию: (1) переписаны все 13 разделов плана v8.4 (§1, §5, §7, §8, §9, §12, §14, §17, §18.4, §19.10, §22, §23.10, §26 — 6 коммитов от `938066f` до `c8db9a2`); (2) schema.sql v8.3 → v8.4: +`outbound_webhook_subscriptions`, +`outbound_webhook_deliveries`, +2 RLS, +5 индексов, метрики 51/81/31 → **53/86/33** (закрытие тех-долга §19.10, OPEN-И-2 Уровень 1); (3) Открытые_вопросы v1.9 → v1.10: закрыто 11 вопросов с дефолтами, все P2 закрыты, 50 продуктовых: 40✅/5🟦/5⏸; (4) main narrative переименован: `CRM_bp-gr_Инструкция_v8_3.md` → `_v8_4.md` (через `git mv`); (5) промежуточный `Plan_narrative_v8_4.md` удалён (план выполнен 13/13); (6) обновлены кросс-ссылки в `CLAUDE.md` (§0/§2/§6/§8 — версии, метрики 53/86/33, прототипы 3/8), `README.md` (статусы прототипов, репозиторий CoralMinister), `db/schema.sql`, `db/CHANGELOG_schema.md` (запись §Z), `web/index.html`, `.lychee.toml` (exclude приватного репозитория); (7) этот README архива переименован в `README_АРХИВ_v8_4.md`. **Затронуто файлов:** 8 (narrative переименован + 7 правок). **Архитектурных изменений в v8.4 относительно v8.3:** outbound webhook (только) — 2 таблицы, изменение статуса с «Post-MVP» на «MVP» по итогам реверс-инжиниринга оригинала (партия 15). **Состав: 17 файлов** в `docs/` (минус удалённый Plan) + 2 в `db/` + CLAUDE.md + README.md в корне. |
| v8.3.2 | 05.05.2026 (поздний вечер, итерация 2) | Закрытие бэклога 🟡-расхождений + закрытие Биз-10 переоткрытого + синхронизация narrative + устранение унаследованной ошибки счётчика сводки. (1) `schema.sql` — добавлены явные комментарии «-- НЕ tenant-уровневая. RLS не применяется намеренно: …» к `impersonation_tokens` и `pd_subject_requests` (метрики не изменились: 51 таблица + 12 партиций, 81 индекс, 31 RLS, 0 orphan-FK). (2) `Открытые_вопросы` v1.7 → v1.8: 📜-пометка к историческому хвосту v1.5→v1.6 (стр. 432); закрыт **Биз-10** окончательно (⏸ переоткрытый → ✅), решение — минимальный паритет с оригиналом (отдельная таблица `reminders` без приоритетов/каналов/recurrence); устранено унаследованное расхождение сводки §0 (шапка `✅ 30` при сумме строк 32 в v1.7 → теперь арифметически согласовано: `✅ 33`, `⏸ 12`, `P2 7`, добавлена сноска про принцип «арифметическая сумма строк»). (3) `CRM_bp-gr_Инструкция_v8_5.md` v8.3 → v8.3.1 — синхронизация **8 точек** по Биз-10: §6.3 (импорт CSV: `deals.reminder_at` → `INSERT INTO reminders`), §9 (DDL `deals` без `reminder_text`/`reminder_at`/`idx_deals_reminder`), §10.2 (колонка «Ближайшее активное напоминание» с подзапросом), §10.3 (`EXISTS`-подзапрос + паритетный фильтр `?reminders=today\|last\|future\|none`), §12.2 (KPI: `is_done = false` → `completed_at IS NULL`), §17.5 (DDL `reminders` переписан: `created_by`, `assignee_id`, `completed_at`, 4 индекса, RLS), §17.6 (cron: `where('is_done', false)` → `whereNull('completed_at')`). **Затронуто файлов: 4** (`schema.sql`, `Открытые_вопросы_v8_3.md`, `CRM_bp-gr_Инструкция_v8_5.md`, `Объединённый_конспект.md` Часть VIII + этот README). **Архитектурных изменений: 0.** Итог: 17 файлов (без изменений в составе).** |

---

*Архив сформирован 05.05.2026 (вечер), последняя правка — 06.05.2026 поздний вечер (финал narrative v8.4: все 13 разделов переписаны, файл переименован, schema → v8.4, Plan_narrative удалён). Версия пакета: **v8.4**.*
*Состав: 17 файлов в `docs/` + 2 в `db/` + `CLAUDE.md` + `README.md` в корне репозитория. Полностью самодостаточен (не требует распакованных предыдущих версий).*
