# Фаза 0 — осмотр боевого «глазами новичка»: план

> **Для исполнителя:** это **диагностический** проход (наблюдение + скриншоты), а НЕ написание кода —
> поэтому шаги не TDD, а действия в браузере с фиксацией находок. TDD-планы будут на Фазах 1–4.
> Исполнять можно инлайн (`superpowers:executing-plans`) с чекпойнтами. Шаги — чекбоксы.

**Цель:** пройти текущий боевой liderra.ru глазами клиента-новичка полным путём (включая реальный
приход лидов), собрать находки и три заготовки: карту мест для «?»-подсказок, черновик FAQ, сценарий
приветственного тура.

**Подход:** браузер (Playwright MCP), скриншот каждого шага в папку прогона. На каждом экране — два
взгляда: «работает ли» и «поймёт ли новичок / подсказывает ли портал». Боевые деньги клиента не
трогаем; тест-данные и заказы у поставщика убираем после.

**Связано:** спека [../specs/2026-06-25-novice-self-service-and-faq-design.md](../specs/2026-06-25-novice-self-service-and-faq-design.md);
прошлый прогон [../findings/2026-06-24-dumb-user-walk/](../findings/2026-06-24-dumb-user-walk/).

**Папка прогона:** `docs/superpowers/findings/2026-06-25-novice-self-service/`

---

## Принцип фиксации находки

Каждая находка — строка в нужном файле:

- **REPORT.md** — баги/блокировки/визуал/UX-затыки: `тип · экран · что не так · ожидаемое vs факт · скрин`.
- **TOOLTIP-MAP.md** — где портал не подсказывает: `экран · элемент · чего не хватает · предлагаемый
  текст · вид (?, hint, пустое состояние) · важность 🔴/🟠/🟡`.
- **FAQ-DRAFT.md** — кандидат-вопрос + черновик ответа (простым языком).
- **TOUR-SCENARIO.md** — кандидат-шаг тура: `что подсветить · текст шага · на каком экране`.

Важность: 🔴 застрянет/уйдёт/напишет в поддержку · 🟠 догадается с трудом · 🟡 косметика.

---

## Task 0: Пред-полётная подготовка и безопасность

**Файлы:** создать папку `docs/superpowers/findings/2026-06-25-novice-self-service/` (+ пустые
REPORT.md / TOOLTIP-MAP.md / FAQ-DRAFT.md / TOUR-SCENARIO.md с заголовками).

- [ ] **Шаг 1:** Проверить, что боевой жив: `https://liderra.ru` и `https://liderra.ru/login` → HTTP 200
  (curl или Playwright navigate). Зафиксировать.
- [ ] **Шаг 2:** Снять baseline денег клиента (сверка «до»): через `prod-deploy-validator`-канал или
  read-only SQL зафиксировать `tenant 2` = баланс и число сделок (ожидаем 1 836 400.00 ₽ / 1013).
  Записать в REPORT.md как «эталон до».
- [ ] **Шаг 3:** Завести папку прогона и 4 файла-заготовки (REPORT/TOOLTIP-MAP/FAQ-DRAFT/TOUR-SCENARIO).
- [ ] **Шаг 4 (ЧЕКПОЙНТ владельца — нужен GO):** согласовать способ создания тест-клиента на боевом:
  - **Рекомендуется:** владелец **сам регистрирует** новый тест-аккаунт через UI (проходит реальную
    Yandex-капчу и код из письма) — это заодно честно проверяет самый трудный для новичка экран; затем
    отдаёт логин/пароль, дальше иду я. *(Playwright капчу не пройдёт — это не баг, защита боевого.)*
  - **Альтернатива:** создать тест-тенант через прод-SQL (как 22.06, тест-клиенты id 17–23).
  Зафиксировать выбор. **Без GO дальше не идём** (создание клиента — изменение боевого).

**Готово, когда:** боевой 200, эталон денег записан, папка готова, способ создания клиента согласован.

---

## Task 1: Регистрация и первый вход (самый важный экран для новичка)

- [ ] **Шаг 1:** Открыть `/register`. Скрин `01-register.png`. Взгляд новичка: понятно ли, что вводить,
  зачем телефон, что такое капча; есть ли подсказки.
- [ ] **Шаг 2:** Пройти регистрацию (способом из Task 0 шаг 4): email → капча → код из письма → реквизиты.
  Скрины каждого под-шага (`02-..`, `03-..`). Фиксировать в TOOLTIP-MAP всё, где новичок может встать
  (зачем ИНН, что будет дальше, сколько шагов осталось).
- [ ] **Шаг 3:** Первый вход → онбординг-карточка «Добро пожаловать». Скрин. Проверить U2 (зовёт ли
  «коллега», спрашивает ли имя — на текущей боевой сборке). Записать факт.
- [ ] **Шаг 4:** Кандидаты тура: отметить в TOUR-SCENARIO, что нового клиента стоит провести
  (пополнить → создать проект → где появятся заявки).

**Готово, когда:** тест-аккаунт создан, путь регистрации отснят, находки занесены.

---

## Task 2: Дашборд (первый экран кабинета)

- [ ] **Шаг 1:** Дашборд пустого аккаунта. Скрин `05-dashboard-empty.png`. Что видит новичок первым;
  понятно ли, что делать дальше; есть ли стартовый блок и CTA.
- [ ] **Шаг 2:** Каждый KPI/блок — нужна ли «?»-подсказка («что это число значит»). Занести в TOOLTIP-MAP.
- [ ] **Шаг 3:** Счётчик «хватит на N дней» (B1 уже починен) — переподтвердить, что не врёт. В REPORT.
- [ ] **Шаг 4:** FAQ-кандидаты с дашборда («что такое заявка», «с чего начать»).

**Готово, когда:** дашборд отснят, подсказки и FAQ-кандидаты занесены.

---

## Task 3: Создание и включение проекта

- [ ] **Шаг 1:** «Проекты» — пустое состояние. Скрин. Понятен ли смысл раздела и кнопка создания.
- [ ] **Шаг 2:** Мастер проекта шаг 1 (реквизиты) и шаг 2 (источник). Скрины. Переподтвердить U1
  (понятные подписи «Сайт, с которого нужны заявки» — уже на боевом). Отметить, где нужны «?» (тип
  Сайт/Звонок/СМС, лимит в день, «Вся РФ»).
- [ ] **Шаг 3:** Создать проект. Скрин. Проверить U5 — баннер про «18:00/синхронизация»: пугает ли
  новичка, есть ли мягкая формулировка. В REPORT + TOOLTIP-MAP.
- [ ] **Шаг 4 (ЧЕКПОЙНТ — GO на реальные заказы):** включить проект → это заводит **реальные заказы у
  поставщика**. Подтвердить у владельца. После включения — скрин статуса проекта; отметить U3 (видно ли
  где-нибудь, кроме биллинга, что происходит).

**Готово, когда:** проект создан и (с GO) включён, находки занесены, факт заказов у поставщика зафиксирован для уборки.

---

## Task 4: Биллинг, баланс, тариф, пополнение

- [ ] **Шаг 1:** «Биллинг» — обзор. Скрин. Понятны ли баланс, «запас», тарифная лесенка («вы здесь»).
- [ ] **Шаг 2:** Кнопка «Автопополнение» (U6) — переподтвердить состояние (неактивна/скрыта/с подписью).
  В REPORT решение «скрыть vs подпись» отметить как вопрос владельцу.
- [ ] **Шаг 3:** Диалог пополнения (онлайн-оплата выключена — смотрим экран/тексты, реальную оплату НЕ
  проводим). Скрин. Что увидит новичок, понятна ли сумма/шаги. TOOLTIP-MAP + FAQ («как пополнить»).
- [ ] **Шаг 4:** Каждый термин биллинга — кандидат на «?» («тариф», «ступень», «провенанс», «запас»).

**Готово, когда:** биллинг отснят, подсказки и FAQ-кандидаты по деньгам занесены.

---

## Task 5: Реальный поток лидов и списания

- [ ] **Шаг 1 (после GO Task 3):** дождаться/инициировать приход реального лида (как 22.06 — инъекция
  вебхука с прод-сервера в TEST-диапазоне vid, привязка к включённому проекту). Зафиксировать метод.
- [ ] **Шаг 2:** «Заявки/Сделки» со свежими лидами. Скрины `24-..`, `25-..`. Карточка сделки —
  переподтвердить U4 (реальная цена лида видна). В REPORT.
- [ ] **Шаг 3:** История списаний в биллинге — скрин. Сверить billing-audit на реальном пути (копейки,
  тариф, провенанс `charge_source='rub'`). Если есть подозрение — `billing-audit` скилом.
- [ ] **Шаг 4:** Заморозка по балансу (если довести баланс до нуля безопасно на тест-клиенте) —
  переподтвердить U3/C1 (виден ли статус на дашборде/в проектах, формат денег и тон). Скрины.

**Готово, когда:** реальный лид прошёл, списание сверено, U3/U4/C1 переподтверждены.

---

## Task 6: Остальной кабинет (заявки-виды, настройки, помощь)

- [ ] **Шаг 1:** «Сделки» vs «Канбан» (U7) — переподтвердить путаницу; отметить разнобой слов
  (сделка/лид/заявка) для единого словаря. Скрины списка и канбана.
- [ ] **Шаг 2:** Экспорт (CSV/XLSX) — кнопка понятна ли новичку; «?» нужен? (файл не разбираем глубоко).
- [ ] **Шаг 3:** Настройки профиля — скрин; подсказки (смена email через support и т.п. — уже есть, не
  ломать). Где ещё нужен «?».
- [ ] **Шаг 4:** Раздел «Помощь» — скрин. Что там уже есть, куда ляжет ссылка на будущий FAQ.

**Готово, когда:** оставшиеся экраны отсняты, U7 и словарь зафиксированы, место под FAQ намечено.

---

## Task 7: Сборка трёх заготовок (главный результат фазы)

- [ ] **Шаг 1:** Дописать **REPORT.md** — резюме для владельца + полный список находок (баги/блок/визуал/UX)
  с приоритетами и ссылками на скрины.
- [ ] **Шаг 2:** Свести **TOOLTIP-MAP.md** — таблица «экран · элемент · текст подсказки · вид · важность»
  по всем экранам (это вход в Фазу 1).
- [ ] **Шаг 3:** Свести **FAQ-DRAFT.md** — список вопросов-ответов простым языком (вход в Фазу 2). Минимум:
  что такое заявка; как пополнить; почему списали; как включить проект; что значит «хватит на N дней»;
  почему приём на паузе; чем «Список» отличается от «Доски».
- [ ] **Шаг 4:** Свести **TOUR-SCENARIO.md** — 4–6 шагов приветственного тура (вход в Фазу 3).

**Готово, когда:** четыре файла заполнены и пригодны как вход в Фазы 1–3.

---

## Task 8: Уборка и сверка денег (обязательно)

- [ ] **Шаг 1:** Снять заказы у поставщика, созданные тест-проектом (как 22.06 — `DeleteSupplierProjectJob`/
  ручная очистка). Зафиксировать, что у поставщика чисто.
- [ ] **Шаг 2:** Вычистить тест-аккаунт/тест-лиды на боевом (или оставить помеченным — по решению владельца).
- [ ] **Шаг 3:** Сверка денег «после» == «до»: `tenant 2` = 1 836 400.00 ₽ / 1013. Записать в REPORT.
- [ ] **Шаг 4:** `verification-before-completion` — подтвердить фактами (HTTP 200, деньги целы, поставщик
  чист) перед тем как сказать «фаза готова».

**Готово, когда:** боевой чист, деньги клиента целы (до==после), отчёт закрыт.

---

## Самопроверка плана против спеки

- §6 Фаза 0 спеки (свежий осмотр → карта подсказок + FAQ-черновик + сценарий тура) → Task 1–7. ✓
- §4 (боевой, тест-клиент, полный путь с лидами, скрины) → Task 0–6. ✓
- §8 (безопасность, уборка, сверка денег) → Task 0 шаг 2 + Task 8. ✓
- §5 (новая категория «портал не подсказывает») → TOOLTIP-MAP во всех Task. ✓
- Переподтверждение открытых U2/U3/U5/U6/U7/C1/V1 → Task 1/3/4/5/6. ✓
- Чекпойнты на изменения боевого (создание клиента, включение проекта) → Task 0 шаг 4, Task 3 шаг 4. ✓
