# Сайт-генератор резюме без опыта работы

Сайт для тех, кто ищет первую работу (школьники, студенты, выпускники колледжей/вузов, гэп-год) и не знает, что писать в резюме без опыта. Помогает найти "скрытые" навыки в хобби/интересах и объясняет, где они пригодятся.

## Статус

Прототипная стадия. Все файлы ниже — рабочие черновики для оценки тона, механик и дизайна, не production-код.

**Куда смотреть в первую очередь:** `START_HERE.md` — краткий вход для новой сессии/устройства
(как запустить, карта проекта, текущая точка останова). Здесь — полный журнал решений и
роадмап; деплой — в `docs/DEPLOY.md`.

**Astro-версия собрана (пункт 2 плана «Дальнейшие шаги» → см. конец README).** Теперь в репозитории
две плоскости:
- Ветка/репо на GitHub: **github.com/Splendor1980/resume-site-v17** (пуб/приват — как создано). Это
  git-ремот для синхронизации проекта между устройствами, а не хостинг сайта (см. «Дорожная карта»).
- `index.html` и `data/`, `prototypes/` **в корне** — прежний прототип (SPA на чистом JS), сохранён
  как история решений и для сравнения;
- **Astro-приложение** в `src/` — статические SEO-страницы идей + конструктор как «остров» на
  `/konstruktor/`. Именно его нужно развивать дальше и хостить (шаг 3 плана — домен и хостинг).

**Как запустить Astro-версию локально:**
```
npm install          # первый раз
npm run dev          # http://localhost:4321/  (только один раз потребуется npx playwright install chromium)
npm run build        # статическая сборка в dist/
npm run preview      # посмотреть собранное
npm run test:e2e     # headless-проверка конструктора и SEO-страниц (Playwright)
```
Важно: `npm run build` сам копирует `data/ideas.json`, `prototypes/` и `README.md` в `public/`
(скрипт `scripts/sync-data.mjs`) — это runtime-файлы, на которые ссылается конструктор. Если меняешь
`data/ideas.json` — правь только корневой файл, копия в `public/` обновится при сборке.

Архивы для скачивания версионируются по папке (`resume-site-v4`, следующий будет `v5` и
так далее) — не переиспользуем номер версии повторно, чтобы не путать файлы в загрузках.

**Правило версионирования (договорённость с v17):** текущая папка проекта — `resume-site-v17`,
при загрузке на GitHub имя папки/репо НЕ меняем. Каждое следующее крупное изменение — это
переименование папки в `resume-site-v18`, `resume-site-v19` и т.д. (номер +1 от текущего,
не пропуская). Мелкие правки внутри одной версии папку не переименовывают.

## Структура

```
index.html               — ГЛАВНАЯ СТРАНИЦА продукта (не список черновиков!):
                            три режима поиска идей (листай / по профессии / помощник-подсказчик)
                            + резюме слева, само переключается между компактным и плотным
                            шаблоном в зависимости от объёма выбранного контента (< 2 выбранных
                            идей → компактный сайдбар-шаблон, 2+ → плотный многосекционный).
                            Шестерёнка (правый верхний угол) открывает служебную панель со
                            ссылками на черновики ниже — обычный посетитель туда не заходит.

data/
  ideas.json            — база связок "интерес → навыки → роли → комментарий", 103 записи
                           (schema v3: category — устойчивая, examples_now — обновляемые
                           конкретные примеры игр/сериалов, освежать раз в 6-12 мес)
  about-snippets.json   — примеры фрагментов "О себе/навыки" для вдохновения,
                           размечены по persona, tone и length (short/medium/long)

prototypes/  (черновики, оставлены для истории решений — доступны из index.html через шестерёнку)
  01-cards-board.html              — экран "листания идей" с фильтром по тегам
  02-builder-split-screen.html     — первая версия конструктора со статичным шаблоном резюме
  03-template-compact-vs-dense.html — сравнение шаблонов резюме под разный объём текста
                                       (дизайн отсюда перенесён в главный index.html)
  04-mode-switcher.html            — предыдущая версия главной страницы (три режима), но ещё
                                       со статичным, не адаптивным шаблоном резюме слева
  05-ai-assistant-system-prompt.md — черновик системного промта для платного ИИ-ассистента
                                       (режим 3); провайдер — YandexGPT Lite, подключение
                                       отложено до появления реального спроса (см. README)

src/                    — Astro-приложение (SSG под SEO), мастер-копия конструктора
  layouts/BaseLayout.astro  — общий <head> SEO-страниц: title/description/canonical/OG/метрика,
                              JSON-LD (передаётся как structuredData)
  components/
    Constructor.astro   — «ОСТРОВ» интерактивности, перенесён из index.html почти без изменений.
                          Отличия от прототипа: fetch('/data/ideas.json') по абсолютному пути,
                          ссылки черновиков и данных абсолютные (/prototypes/...), заголовок
                          карточки стал ссылкой на её SEO-страницу. CSS — изолированный (is:global),
                          JS собирается/минифицируется Astro. Логика отлажена Playwright-тестом —
                          сознательно не переписывалась на React/Vue.
    Header.astro / Footer.astro / Metrika.astro
  pages/
    index.astro         — лендинг: hero под длинный поисковый запрос, «как работает», подборка
                          популярных идей, все темы, FAQ (с JSON-LD FAQPage), CTA на конструктор
    idei/index.astro    — полный список 103 идей, сгруппированных по тегам (ItemList JSON-LD)
    idei/[slug].astro   — СТАТИЧЕСКИЕ SEO-СТРАНИЦЫ: 103 шт., по одной на запись ideas.json.
                          Route: /idei/strategy_games/ и т.д. Внутри: хлебные крошки, activity_title
                          (h1/заголовок), resume_bullet, comment как объяснение «почему интересно
                          работодателю», навыки, роли, примеры, employer_value, блок исследований,
                          CTA на конструктор, похожие идеи (связи по тегам). JSON-LD Article.
    konstruktor.astro    — страница-обёртка для Component.astro (полный экран приложения).
    methodika.astro      — страница «О методологии» (/methodika/): принцип «хобби → навыки →
                          роль», подходы Ramit Sethi / Laszlo Bock / инфостиль, честная пометка
                          «исследования есть у 3 из 103» + блок с реальными источниками
                          (динамически из data/ideas.json), AboutPage JSON-LD, CTA на конструктор
public/                 — статика, попадающая в dist как есть
  data/ideas.json       — рабочая копия для runtime-fetch конструктора (автообновляется сборкой)
  prototypes/, README.md, favicon.svg, og-cover.svg, robots.txt
astro.config.mjs        — site (=https://resumegenerator.ru), trailingSlash, @astrojs/sitemap
                            (конструктор исключён)
scripts/
  sync-data.mjs         — копирует data/prototypes/README в public/ (вызывается prebuild)
  run-e2e.mjs           — обёртка теста: сама поднимает «astro preview» на :4321, ждёт готовности,
                          запускает test-constructor.mjs и гасит сервер (нужен только npm run build;
                          это то, что реально вызывает npm run test:e2e)
  test-constructor.mjs  — сами проверки: 103 карточки, фильтры, add/toggle, режимы, чат, дровер,
                          SEO-ссылка на статику, лендинг, список идей
  upload-yandex.mjs     — выгрузка dist/ в Yandex Cloud Object Storage (AWS SDK, без глобального CLI):
                          node scripts/upload-yandex.mjs {buckets|sync [--delete]|configure}
                          (ключи из deploy/.env, см. см. docs/DEPLOY.md)
data/                    — источник истины (см. выше), из него генерируются и статика в /idei,
                           и (через public-копию) доска в конструкторе
```

## Ключевые решения по ходу разработки

- **Монетизация**: бесплатно — генерация идей и вдохновение; платно (~50₽ или пакетом) —
  скачивание/редактирование. Рассматриваются варианты: пакет вместо разового платежа,
  бесплатный экспорт с watermark, "поделись — получи бесплатно".
- **Экономика ИИ**: основной объём (подбор идей, сборка черновика резюме) работает БЕЗ
  живого вызова ИИ — за счёт заранее подготовленной базы `ideas.json`. Живой ИИ подключается
  только на платном этапе финальной редактуры текста.
- **SEO**: интерактивный конструктор (это, по сути, SPA на JS) поисковики не индексируют.
  Реальный SEO-трафик должен идти через отдельные статические страницы, сгенерированные
  из `ideas.json` (например `/idei/kvadrokopter-pomoshnik-blogera`). Нужен SSG-фреймворк —
  чистый `index.html` для этого не подходит.
- **Переход на Astro сделан (шаг 2 плана).** Маршруты: `/` — SEO-лендинг, `/idei/<id>/` —
  103 статические страницы идей (генерируются из `ideas.json` на сборке), `/konstruktor/` —
  интерактивный конструктор как «остров» (перенесён из `index.html` почти без изменений).
  Подробное дерево — в разделе «Структура». Осознанные решения, принятые при переносе:
  - **Конструктор НЕ переписан на React/Vue** — логика в `Constructor.astro` осталась ванильной,
    проверена Playwright-тестом (запуск `npm run test:e2e`). Нативный скрипт собирается и
    минифицируется Astro-бандлером; это и есть «остров» в смысле Astro — вся остальная часть
    сайта статический HTML.
  - **Слаги — английские id из базы** (`/idei/strategy_games/`), а не транслитерация названий.
    Причина: стабильность и уникальность без ручной разметки 103 записей; транслитерация
    русских названий в слаги — отдельная контентная/техзадача, не сделано.
  - **`ideas.json` живёт в двух местах**: источник истины `data/ideas.json` (из него генерируются
    SEO-страницы на сборке) + рабочая копия `public/data/ideas.json` для runtime-fetch()
    конструктора. Копию обновляет `scripts/sync-data.mjs` при каждом `npm run build` — руками
    ничего не трогаем.
  - **Домен вписан**: `site` в `astro.config.mjs` и `Sitemap:` в `public/robots.txt` =
    **`https://resumegenerator.ru`** (куплен на reg.ru), на него указывают canonical/OG/sitemap.
    Канонический адрес — без `www`; редирект `www` → без `www` делаем на DNS/хостинге (шаг 3).
  - **HTTPS включён и работает** (18.08.2026): сертификат Let's Encrypt выпущен на домен
    (`CN=resumegenerator.ru`, действителен до 16.11.2026), `http://` отдаёт 301 → `https://`,
    каталоги `/`, `/idei/`, `/methodika/`, sitemap/robots проверены по https — 200, live E2E PASS.
    Открывается из РФ (Yandex Cloud), переживает перевыпуск сертификата автоматически.
- **Стек**: выбран **Astro** — статическая генерация страниц под SEO + "острова" интерактивности
  только там, где нужны (конструктор резюме). Astro не привязан к конкретному хостингу.
- **Хостинг — НЕ Vercel**: изначально рассматривался Vercel, но отклонён. Причины: (1) российские
  карты не принимаются для платных тарифов, (2) отдельные сайты на `*.vercel.app` реально
  попадают в реестр Роскомнадзора, (3) есть подтверждённые случаи, когда `.ru`-домен, привязанный
  к Vercel, переставал открываться с мобильного интернета в РФ без VPN. Для сайта на российскую
  аудиторию (и с `.ru`-доменом) это неприемлемый риск.
  Решение: **Yandex Cloud** (Object Storage + Cloud Functions — аналог связки Vercel) либо для
  старта проще — **обычный российский VPS** (Timeweb Cloud, Selectel, Beget) с Node.js,
  отдающим и статику, и вебхук оплаты с одной машины. Оплата хостинга и оплата от пользователей
  (через ЮKassa) в этом случае в одной валюте/юрисдикции — меньше точек отказа.
  GitHub Pages по-прежнему годится только для просмотра статических прототипов (нет
  серверных функций для вебхука оплаты), не для продакшена.
- **Не только лето**: изначально ниша задумывалась как "выпускники + летние подработки",
  но верно расширена до "любой, кому нечего писать в резюме" — зимние каникулы, первая
  работа после колледжа/вуза, гэп-год. Все тексты должны быть сезонно-нейтральными.
- **Актуальность примеров**: конкретные игры/сериалы/тренды быстро устаревают, поэтому в
  схеме `ideas.json` они вынесены в отдельное поле `examples_now`, не смешанное с
  устойчивой логикой (`category`, `skills`, `roles`).
- **Авторское право**: реальные резюме/тексты других людей брать нельзя ни для дизайна
  (лицензии), ни для контента (авторское право + чужие персональные данные). Вместо этого —
  собственная база примеров, сгенерированная с нуля.
- **Адаптивные шаблоны**: короткий текст ("О себе" в одну строку) не должен выглядеть как
  пустой лист А4. Решение — шаблоны на два типа: "компактный" (сайдбар, крупная типографика,
  визуальные элементы для малого объёма контента) и "плотный" (для тех, у кого есть что
  рассказать развёрнуто). Система должна сама подбирать шаблон по объёму заполненного
  контента, а не спрашивать пользователя.
- **AI-провайдер — выбор сделан (YandexGPT Lite), но подключение сознательно отложено**:
  сравнивали GigaChat Business, YandexGPT Lite и агрегатор Ofox.ai — Ofox отклонён (не решает
  вопрос доступа/данных из РФ, просто прокси поверх зарубежных моделей, неясный статус для
  встраивания в клиентский продукт). YandexGPT Lite выигрывает у GigaChat Business по порогу
  входа (не требует юрлица для базового доступа). НО: оба тарифицируются по токенам без
  абонплаты — значит подключать их есть смысл только когда появится реальный трафик.
  Режимы 1 и 2 (карточки, поиск по профессии) не требуют ИИ вообще — работают на чистом
  `ideas.json`. Запускаем их первыми, без ИИ-зависимости и без затрат.
  **Триггер для подключения живого ИИ**: когда появится измеримый сигнал, что люди реально
  доходят до режима 3 и хотят большего, чем дают карточки — не раньше.
  До этого момента режим 3 остаётся локальным помощником-подсказчиком (поиск по ключевым
  словам + словарь синонимов, уже реализовано в `index.html`), без единого платного вызова.
- **Три режима конструктора** (переключаются одной кнопкой на экране):
  1. *Листай и собирай* — базовый режим, карточки идей с фильтром по тегам (уже реализован).
  2. *Навыки под профессию* — обратный режим: пользователь выбирает интересующую роль/профессию,
     система показывает навыки, которые для неё может — но не факт что имеет — обладать; это
     переиндексация того же `ideas.json` по полю `roles`, отдельных данных не требует.
  3. *Помощник-подсказчик* — сейчас бесплатный и локальный: наводящими вопросами и
     ветвлением по темам подбирает идеи из `ideas.json` (поиск по ключевым словам +
     словарь синонимов, без внешнего ИИ). Живой платный ИИ (RAG поверх той же базы) —
     в бэклоге, подключается по указанному выше триггеру.
- **Самозанятость**: подходит для приёма платежей от физлиц (ставка 4% НПД, лимит дохода
  2.4 млн ₽/год). Для приёма оплаты + автофискализации чеков — агрегаторы вроде ЮKassa,
  CloudPayments (сами формируют чек в "Мой налог").
- **`index.html` теперь загружает полную базу через `fetch('data/ideas.json')`**, а не
  захардкоженный список ~20 карточек, как было раньше во всех трёх режимах. Все 103 записи
  теперь видны и в "листай и собирай", и в "навыки под профессию", и в подсказчике.
  Важно: `fetch()` не работает при открытии файла двойным кликом с диска (`file://`) —
  нужен локальный сервер (`python -m http.server`) или реальный хостинг (GitHub Pages и
  выше уже подходят). На этот случай на странице показывается понятное предупреждение
  вместо молчаливой пустой страницы.
- **Резюме-панель увеличена (~в 1.6 раза, 300px → 480px макс.) и стала редактируемой**:
  поля Имя, Целевая роль, Телефон, Email, Образование — обычные `<input>`, значения
  хранятся в отдельном JS-объекте `profile`, который переживает перерисовку шаблона при
  добавлении/удалении идей (проверено headless-тестом в Playwright — значения не теряются).
  Вопрос "платно или бесплатно" по самому редактированию — сознательно не решён, нужно
  обкатать на реальных пользователях сначала.
- **Исправлена ошибка: нельзя было убрать добавленную идею.** Кнопка "Добавить в резюме"
  раньше навсегда переходила в состояние "Добавлено" без возможности отмены — теперь это
  полноценный toggle (`toggleAdded()`), работает одинаково в режиме "листай" и в
  рекомендациях подсказчика. В режиме "навыки под профессию" тоже поправлено: снятие
  галочки с навыка убирает карточку из резюме, только если ни один другой отмеченный
  навык больше не ссылается на ту же карточку.
- **Резюме больше не показывает объясняющий `comment` дословно.** Раньше в "Что предлагаю"
  (компактный шаблон) и "Проектный опыт" (плотный шаблон) подставлялся текст поля
  `comment` — а он написан вторым лицом, объясняющим тоном ("Стратегии учат
  распределять ресурсы...") и адресован пользователю сайта, а не читается как то, что сам
  кандидат написал бы о себе рекрутеру. Заменено на `skills` — короткие профессиональные
  формулировки, которые уже есть в базе и звучат уместно в резюме. `comment` остался только
  в карточках при листании — там ему место. Полноценные авторские резюме-формулировки под
  каждую из 103 записей — в бэклоге как отдельная контент-задача, не сделано.
- **Локальный подсказчик получил словарь синонимов/жаргона** (`SYNONYMS` в `index.html`) —
  около 40 записей вида "катка"/"дота"/"кс" → тег "игры", "стрим"/"твич" → тег "видео" и т.д.
  Это упрощённая версия изначально задуманного "этапа 2" (полноценный ручной список
  ключевых слов на каждую из 103 записей не сделан — это большой объём контентной работы,
  отложено до появления сигнала, что базового стемминга + словаря недостаточно).
- **Добавлен тёплый блок-синтез черт характера** (`TRAIT_RULES` + `renderTraitSynthesis()`),
  показывается в режиме "Помощник-подсказчик" после выбора 2+ идей. НЕ психологический
  разбор в духе "глубокого" ИИ-примера (пользователь показал скриншот диалога с Google AI —
  там реально впечатляющая генеративная глубина, но: а) для резюме подобный текст всё
  равно избыточен, б) для настоящей персонализации нужен живой ИИ, не шаблоны — попытка
  подделать это статикой быстро начинает повторяться и терять доверие). Вместо этого —
  ~14 правил вида "теги → черта характера" (например `["дети","животные"] → "забота о
  других"`), каждое с 3 вариациями фразы для разнообразия, показывается отдельно от самого
  резюме (это не документ для рекрутера, это поддержка для пользователя). Проверено
  headless-тестом (Playwright): комбинация тегов "дети"+"животные" корректно матчит
  правило "забота о других".
- **"О себе" и "Проектный опыт"/"Что предлагаю" стали редактируемыми полями** (textarea),
  а не статичным текстом. Показывают автосгенерированный черновик, пока пользователь не
  начнёт печатать — после первой правки поле "становится его" и не перезатирается при
  добавлении новых идей (проверено тестом: правка переживает даже переключение между
  компактным и плотным шаблоном). Есть кнопка "↺ вернуть автотекст" для отката.
- **Исправлена грамматическая ошибка в "О себе"**: было "Активно интересуюсь: [название
  категории в именительном падеже]" — требует творительного падежа, согласование ломалось
  почти всегда. Вместо ручного склонения 103 категорий (риск новых ошибок, нужна морфология)
  формулировка переписана на "Мои интересы: [список]" — падеж вообще не нужен.
- **Отклонена идея с вымышленным "научно-исследовательским институтом"** для обоснования
  связок навыков — это фабрикация несуществующего источника, репутационный и юридически
  небезопасный риск (как заявления "исследования показали" у сомнительных БАДов). Если для
  конкретных связок будут найдены настоящие исследования — их можно процитировать по
  существу, с реальным источником. Общий вывод: уверенный тон без выдуманного авторитета.
- **Убрана запутанная/дублирующая подсказка в "Навыки под профессию"**: подсказка снизу
  ссылалась на "профессию выше", но при длинном списке ролей это легко пропустить.
  Верхняя подсказка (перед списком) сделана заметнее (карточка с иконкой вместо мелкого
  серого текста), а нижняя переформулирована без отсылки к "выше".
- **Режим "Навыки под профессию" — починена навигация.** Оказалось, что база даёт 271
  уникальную роль на 103 записи (роли слишком раздроблены — "Технический ассистент",
  "Технический ассистент в геймдев-студии" и т.д. как отдельные строки). Добавлено поле
  поиска над списком (фильтрует на лету) + после выбора профессии плитка сворачивается в
  один чип "Выбрано: Х [изменить]", результат сразу виден без скролла через десятки чипов.
  Отдельная задача на будущее (не сделано) — нормализовать/объединить похожие роли в самих
  данных, а не только чинить интерфейс сверху.
- **Добавлен блок "🔬 Что говорят исследования"** — необязательное поле `research` в
  `ideas.json` (v3.1), пока заполнено только для 3 карточек (`reading_books`, `team_shooter`,
  `team_sport`), где реально существуют метаанализы/систематические обзоры. Каждая запись
  содержит: вывод, честную оговорку (воспроизводимость, ограничения) и реальный источник со
  ссылкой. Раскрывается по клику в карточке при листании, в резюме не попадает (как и
  `comment`). Осознанно НЕ добавлено на все 103 записи — для большинства узких связок
  ("квадрокоптер → пространственное мышление") просто не существует профильных исследований;
  добавлять туда наукообразный текст значило бы либо упрощать до неправды, либо фабриковать
  источник (что мы уже отклонили как отдельную идею с вымышленным институтом).
- **Резюме-панель теперь масштабируется под размер экрана**, а не упирается в жёсткий
  потолок в пикселях. Было `minmax(320px, 480px)` — на больших мониторах колонка визуально
  "терялась" на фоне выросшего правого блока. Стало `minmax(320px, min(34vw, 560px))` —
  растёт вместе с окном, но не бесконечно (проверено тестом: 435px на экране 1280px,
  560px на экране 1920px).
- **Поле "Образование" было однострочным `<input>`** — длинный текст обрезался по ширине
  вместо переноса. Заменено на `<textarea>`, как "О себе" и "Проектный опыт".
- **Проверка перед финалом: чего не хватает в резюме относительно реальной практики.**
  Поискал профессиональные рекомендации по резюме без опыта (2026 год). Добавлено два поля,
  которых не хватало: "Желаемый график" (критично для нашей аудитории — сезонные/частичные
  подработки, работодатели часто фильтруют именно по доступности) и "Портфолио / ссылки"
  (рекомендуется для creative/tech категорий — GitHub, Instagram, YouTube и т.д., необязательное).
- **Реализован настоящий PDF-экспорт** (раньше только обсуждали, не строили): кнопка
  "📄 Скачать PDF" вызывает `window.print()` — печать/сохранение как PDF средствами браузера,
  без единой библиотеки и без сервера (согласуется с философией "не тратить на хостинг").
  Технически: отдельный скрытый `#printSheet`, который перед печатью (`beforeprint`)
  заполняется чистым HTML без полей ввода/интерфейса — иначе textarea со скроллом обрезали
  бы текст на печати (браузеры не печатают проскроленное содержимое textarea).
  **Важный баг, пойманный и исправленный по ходу**: первая версия печати прятала интерфейс
  через `visibility:hidden`, что не убирает элементы из потока документа — в PDF получалось
  23 страницы, из них 22 пустых (лента из 103 карточек всё ещё занимала место, просто была
  невидима). Исправлено на `display:none` + вынос `#printSheet` за пределы `.layout`.
  Проверено реальной генерацией PDF через Playwright + разбором через `pypdf`: 2 идеи → 1
  страница, 8 идей → всё ещё 1 страница, весь текст (включая новые поля) присутствует
  корректно, ничего не обрезано.
- **Проверка на реальное переполнение страницы (30 карточек) нашла ещё один баг.**
  Единый текстовый блок "Проектный опыт" мог разорваться браузером посреди предложения
  на границе страниц (например "терпение в" на стр. 2, "рутинной проверке фактов" на стр. 3).
  Причина: все пункты жили в одном текстовом узле, браузер не знал, что это отдельные
  смысловые единицы. Исправлено: если поле не редактировалось вручную — каждый пункт
  теперь отдельный блок с `break-inside:avoid` (запрет разрыва внутри одного пункта).
  Важно — `break-inside:avoid` НЕ ставится на всю секцию целиком (это заставило бы браузер
  держать хоть 30 пунктов на одной странице и создавать огромные пустые разрывы) — только
  на отдельный пункт. Проверено повторной генерацией PDF с 30 карточками: 3 страницы,
  граница между всеми страницами теперь проходит по чистому началу нового пункта.
  Если поле "Проектный опыт" отредактировано пользователем вручную — оно печатается как
  свободный текст без разбивки на пункты (структуры уже нет, редактировать нечем).
- **Заодно найден и исправлен скрытый XSS-баг**: функция `esc()` экранировала только
  кавычки, не `<`/`>`/`&` — теперь, когда почти все поля резюме стали редактируемыми
  пользователем, это было реальной дырой (можно было сломать вёрстку страницы, вставив
  `<script>` в поле "Имя"). Проверено тестом: спецсимволы больше не ломают страницу.
- **Архитектурное уточнение (стоит понимать, а не считать недоделкой):** PDF использует
  ОТДЕЛЬНЫЙ, третий макет — не копию компактного и не копию плотного экранного шаблона.
  Кнопка печати заблокирована до 2+ идей (тот же порог, что переключает экран на плотный
  вид), поэтому сценарий "мало контента, нужен сайдбар для компенсации пустоты" в PDF
  просто никогда не наступает — печатать нечего, если идей меньше 2. Поэтому один
  универсальный печатный макет — осознанное решение, а не пропущенный кейс.
- **Критичный баг: кнопка "Скачать PDF" визуально разблокировалась, но физически не
  нажималась.** Пользователь сообщил "подсвечивается, но не работает" — и это подтвердилось
  дословно. Причина в двух слоях:
  1. `.cta-lock.ready` сбрасывал только `opacity` (визуальная непрозрачность), но не
     `pointer-events` — а базовое правило `.cta-lock` ставит `pointer-events:none` навсегда.
     То есть кнопка выглядела активной, но клики сквозь неё физически не проходили —
     **с самого первого дня, как кнопка стала кликабельной.**
  2. Отдельно (уже при заполнении длинных полей): резюме-панель — `overflow-y:auto` со
     своим скроллом — становится выше экрана, и кнопка внизу может уехать за пределы
     видимой области. Решено: счётчик + кнопка вынесены в отдельный `.resume-footer`,
     закреплённый снизу панели (flex-колонка, футер не скроллится вместе с содержимым).
  Оба бага пойманы не чтением кода, а **воспроизведением обычного клика мышью** в
  headless-браузере (`page.click()`, не программным вызовом функции) — именно так
  вскрылось, что Playwright сам отказывался кликать с ошибкой "элемент перехватывает
  указатель", что и оказалось точным описанием того, что видел пользователь. Проверено
  повторным тестом после фикса: обычный клик теперь реально вызывает печать, а блокировка
  при <2 идей по-прежнему работает (регресс не сломан).
- **Задача 1 из плана "репост вместо оплаты" — сделана.** `prototypes/06-post-texts.md`:
  три готовых текста для репоста (разный тон, чтобы посты у разных людей не выглядели
  одинаковой копипастой). На сайте — модалка выбора при клике "Скачать PDF" (если ещё не
  разблокировано): **два равноценных пути**, оба закрывают доступ одинаково честно —
  "Поделиться и скачать сразу" (копируешь готовый текст, публикуешь, вставляешь ссылку на
  пост) или "Просто подождать 10 минут" (таймер на localStorage, переживает обновление
  страницы, по истечении — автоматическая разблокировка без всяких условий). Это осознанно
  мягкая механика — жёсткого "не поделился — не получишь" нет.
  **Важно понимать масштаб того, что сделано сейчас**: проверка ссылки на пост —
  пока честная система на доверии (человек вставляет ссылку, кнопка сразу разблокирует).
  Реальной проверки, что пост действительно опубликован и содержит нужный маркер — ещё
  нет, это отдельная задача (см. следующий пункт).
- **Следующая задача (не сделана)**: серверная функция проверки ссылки на пост. По
  обсуждению — без ИИ (детерминированная проверка на маркер в тексте страницы дешевле и
  надёжнее, чем спрашивать GigaChat), но это первая фича, которая требует хоть какого-то
  бэкенда — раньше весь сайт был чисто статичным. Кандидат — Yandex Cloud Function
  (не Vercel, см. решение про хостинг выше).
- **Тексты постов переписаны** по обратной связи — в духе Огилви (конкретика вместо общих
  слов, уважение к интеллекту читателя, никакого дутого хайпа) и Година (пост продаёт идею
  "опыт есть у всех, просто его не научили замечать", а не сам сервис). Синхронизировано в
  двух местах: `prototypes/06-post-texts.md` (для справки) и `POST_VARIANTS` в `index.html`
  (то, что реально видит пользователь в модалке) — проверено тестом, что оба места совпадают.
- **Найдена и закрыта дыра: печать в обход нашей кнопки (Ctrl+P / меню браузера).** Наша
  проверка условия жила только в обработчике клика по кнопке — но Ctrl+P или системное меню
  "Печать" вызывают то же самое событие печати напрямую, минуя кнопку и любую нашу логику.
  Саму команду печати средствами веба заблокировать нельзя в принципе (это системная функция
  браузера) — но можно и нужно контролировать, ЧТО показывается при печати. Раньше
  `renderPrintSheet()` срабатывала на любое событие печати без всякой проверки — то есть
  обход через Ctrl+P отдавал бы полное резюме. Исправлено: проверка `isUnlocked()` теперь
  прямо в обработчике `beforeprint` — без разблокировки печатается вежливая заглушка
  ("Скачивание пока не разблокировано..."), а не содержимое резюме. Проверено тестом:
  прямой вызов события `beforeprint` (эквивалент Ctrl+P) в обход кнопки — до разблокировки
  показывает заглушку без единого личного данного, после разблокировки работает как обычно.
- **Добавлена явная подсказка "Сохранить как PDF" — это выбор внутри окна печати браузера
  (в списке принтеров), а не отдельная кнопка на сайте.** Пользователь сообщил, что не увидел
  варианта "сохранить" — оказалось, это не баг, а неочевидный шаг в системном диалоге печати.
  Теперь под кнопкой явно написано, где искать эту опцию.
- **Задача 2 из плана "репост вместо оплаты" — сделана.** `prototypes/07-verify-post-function.md`:
  рабочий код для Yandex Cloud Function (Node.js), которая проверяет, что ссылка ведёт на
  реальный пост в VK/Дзене со ссылкой на наш сайт — без ИИ, простой поиск подстроки в HTML
  (обоснование — см. пункт выше про GigaChat и надёжность детерминированной проверки для
  бинарных решений). На сайте (`index.html`) уже подключён вызов этой функции через константу
  `VERIFY_FUNCTION_URL` — **пока пустая**, поэтому сайт продолжает работать в прежнем
  доверительном режиме, пока функция не задеплоена и её URL не вставлен туда вручную.
  Переход на реальную проверку — это правка одной строки, без изменений в остальном коде
  (проверено тестом: оба режима — с пустым URL и с мок-функцией — работают корректно).
  **Важная честная оговорка, задокументированная в самом файле**: серверный HTTP-запрос
  может не увидеть часть контента VK, если платформа рендерит его через JS — это не
  проверено вживую (VK/Дзен недоступны из моей песочницы), поэтому в файле явно указано:
  после деплоя нужно протестировать на 2-3 реальных постах, и вариант "подождать 10 минут"
  остаётся рабочим всегда — на случай, если автоматическая проверка не сработает технически.
- **Тарифная сетка переработана на 3 уровня скорости + 24-часовой срок действия.**
  Раньше разблокировка была "навсегда" (localStorage-флаг без срока) — валидное замечание:
  для бесплатного тестового этапа это нормально, но для будущей платной модели 50₽ не
  подразумевает пожизненный доступ. Теперь: `UNLOCK_KEY` хранит timestamp, а не просто '1',
  доступ действует 24 часа и автоматически истекает (проверено тестом: искусственно состаренная
  метка на 25 часов — модалка открывается заново). Три вкладки с разной скоростью открытия —
  оплата 50₽ (пока заглушка "скоро", ЮKassa не подключена) → мгновенно, пост в VK/Дзене → через
  10 минут после подтверждения, ничего не делать → через 10 часов. Идея награждать более
  быстрым доступом за более весомое действие — осознанное решение, не техническое ограничение.
  Между "3 попытки" и "24 часа" выбрано второе — попытки нельзя надёжно считать (не отличить
  "нажал печать и отменил" от "нажал и сохранил"), время — просто сравнение меток, без
  двусмысленности.
- **ЮKassa — решение по варианту оплаты отложено (зафиксировано для шага 5)**. Обсуждён
  вариант «доступ на 24 часа»: доступ = разовая ссылка-токен (`/unlock/<token>`), валидация
  на лёгкой Cloud Function (по схеме `prototypes/07-verify-post-function.md`). Такая ссылка
  работает с ЛЮБОГО устройства и браузера, куда её отправил покупатель (не привязана к
  localStorage конкретного браузера). Регистрация не нужна. Решение «делать / не делать» и
  выбор между вариантами (а) разовая ссылка на 24ч, (б) лёгкая регистрация, (в) гибрид —
  на этапе шага 5, по сигналу спроса из шага 4. Пока оставлено как есть (share-to-unlock +
  ожидание).
- **Разговорный ИИ и промт-формат (для шага 5)**. Живых голосовых ассистентов с отдельным
  полем «системный промт» не существует (ни у Алисы/ЯндексGPT, ни у Гигачата, ни у Google).
  Но роль задаётся первой репликой в том же диалоге (текстом или голосом) — и ассистент
  держит её дальше. Самый переносимый формат для продукта — текстовый промт (10–20 строк,
  вставляется в любой текстовый чат), голосовой вариант — надстройка «произнеси это первым
  сообщением». Формат зафиксирован; реализация — в шаге 5.
- **Бонус к разблокировке: подготовка к устному собеседованию — решения приняты,
  реализация отложена до шага 5.** После успешной проверки поста (share-to-unlock)
  пользователь получает помимо доступа к PDF «подарок» — промт для репетиции
  собеседования с ИИ (ссылки на Гигачат и Алису + текст промта). Решения: минимум
  5 вопросов (это лишь подсказка — цифру пользователь изменит), подача — «воздушный
  пузырь»-подсказка после разблокировки (не отдельная страница), воронка — за пост
  (бесплатно как приманка трафика — перспектива), промт персонализируется ролью и
  навыками из выбранных идей. Подробности и черновик промта —
  `prototypes/08-interview-prep-bonus.md`.
- **Закрыта реальная дыра: "О себе" и "Проектный опыт"/"Что предлагаю" были видны и
  копируемы бесплатно прямо в редакторе, кнопка "Скачать PDF" блокировала только сам PDF, а
  не исходный текст.** Теперь эти два блока размыты (`filter:blur`) и недоступны для правки
  (`readonly`) до разблокировки — с понятной подписью "🔒 Открой полный текст". Важно:
  **сам PDF после разблокировки остаётся полностью копируемым** — это осознанно (см. более
  ранний пункт про ATS-совместимость, копирайт-защита PDF признана вредной идеей). Защищаем
  не файл, а момент раскрытия контента. Теги/навыки и карточки при листании остаются видны
  всегда — эта информация и так бесплатна при простом просмотре сайта, скрывать её незачем.
  Блюр снимается автоматически в момент истечения таймера (добавлен `updateResume()` в
  обработчики завершения обоих таймеров) — не требует лишнего клика от пользователя.
- **Полное внедрение переработки текста по методологии Ramit Sethi (Briefcase Technique) /
  Laszlo Bock (Google) / Ильяхов (инфостиль).** Пользователь подготовил `resume_cards_transformed.xlsx`
  на все 103 записи с новыми полями: `NEW_activity_title`, `NEW_skills_reframed`,
  `NEW_resume_bullet`, `NEW_employer_value`, `NEW_about_snippet` — переход от "входящих данных"
  (мои интересы) к "исходящим" (что я умею и какую ценность даю работодателю).
  **Качество проверено построчно**: id полностью совпали с базой (103/103), но найдено 21 из
  103 записей с шаблонным fallback-паттерном ("Отработал: X — через регулярную
  целенаправленную практику" / "Развиваю X через системную практику в Y") — заметно слабее
  остальных 82 по конкретности, плюс реальная грамматическая ошибка (несогласование падежа:
  "Развиваю техническая грамотность" вместо "техническую грамотность"). Эти 21 переписаны
  вручную в том же качестве, что и остальные — список id в `data/ideas.json` (v4, `note`).
  **Что изменилось технически**:
  - `aboutTextFrom()`/`expLineFrom()` теперь берут `about_snippet`/`resume_bullet` напрямую
    вместо алгоритмической формулы "skill-first" (та была нашей временной заплаткой).
  - Карточки при листании (`renderBoard()`) показывают `activity_title` как заголовок
    (исходная категория ушла в мелкий "eyebrow" сверху), `resume_bullet` как основной текст,
    `employer_value` отдельным акцентным блоком "💼", `skills_reframed` вместо сырых навыков
    в тегах. `comment` остался только в блоке исследований — как и раньше, не идёт в резюме.
  - "Навыки под профессию" тоже показывает `skills_reframed` + `employer_value` под каждым
    навыком вместо сырого списка.
  - **Пойман и исправлен баг склейки текста**: несколько `about_snippet` соединялись пробелом
    без знака препинания ("...с ресурсами Умею соблюдать...") — исправлено на перенос строки.
  Проверено полным циклом на реальных данных (включая одну из переписанных 21 записей) —
  от карточки до готового PDF на 1 страницу, тест через настоящую генерацию PDF (Playwright +
  pypdf), не только чтением кода.
- **Откат по фидбеку: блюр "О себе"/"Проектный опыт" убран.** Причины: (а) создавал эффект
  "кота в мешке" — пользователь выполняет условие вслепую, не видя, что получает; (б) нельзя
  было исправить ошибки в тексте или дописать своё, пока не разблокировано. Идея с рекламой
  как альтернативным способом показа текста — рассмотрена и отклонена: аудитория сайта
  включает несовершеннолетних, а показ им рекламы — зона повышенных юридических и этических
  требований у большинства рекламных сетей, не стоит того ради экономии на одной фиче.
  Решение: копирование текста — "на совести пользователя", защищаем только момент выдачи
  файла (кнопка), не сам текст.
- **Откат тарифной сетки к простой двухвариантной версии** (по фидбеку: 3 вкладки с оплатой
  "пугают" для пробного запуска). Убрана вкладка оплаты (была просто заглушкой "🚧 Скоро",
  реальной оплаты и не было). "Поделиться" снова даёт мгновенный доступ (было — через 10
  минут), "Подождать" снова 10 минут (было — 10 часов). **24-часовой срок действия доступа
  сохранён** — это отдельное, всё ещё актуальное решение, не связанное со скоростью открытия.
- **Добавлен обязательный шаг-инструкция перед вызовом печати** (решает пункт фидбека:
  пользователь не заметил переключатель "Сохранить как PDF" в системном окне печати — он
  жил только мелким текстом под кнопкой, легко пропустить). Теперь после разблокировки
  (и при каждом повторном заходе в течение 24 часов) показывается отдельный экран с двумя
  пронумерованными шагами ("выбери Сохранить как PDF" → "нажми Сохранить") — печать
  вызывается только после явного клика "Понял, открыть окно печати →", а не тихо в фоне.
  Мы не можем управлять самим системным диалогом печати (это вне досягаемости веб-страницы,
  та же причина, по которой нельзя заблокировать Ctrl+P) — но можем сделать инструкцию
  невозможной пропустить, а не просто мелкой подписью сбоку.
  Проверено тестом: печать не вызывается до явного подтверждения инструкции пользователем.
- **Подключена Яндекс.Метрика** (ID 111722479, вписан в `src/components/Metrika.astro`,
  noscript-пиксель включён). **Вебвизор и карта кликов отключены намеренно** — аудитория
  сайта включает несовершеннолетних, а Вебвизор пишет подробную запись сессии (движения
  мыши, вводимый текст). Для базовой статистики посещаемости это не нужно, а приватность
  лучше беречь с запасом.
- **Отклонена идея с блокировкой выделения/копирования через CSS `user-select:none` или
  JS-обработчики `copy`/`contextmenu`**: (а) `user-select:none` технически не работает
  внутри `<textarea>`/`<input>` в большинстве браузеров — это нативные элементы формы со
  своим механизмом выделения, CSS-свойство на них не действует; (б) блокировка через JS
  тривиально обходится (F12 → консоль → `.value` читает текст напрямую), скорее всего
  ломает копирование на мобильных (нативный интерфейс выделения ОС, не Ctrl+C), и заново
  создаёт проблему, которую уже решили раньше — пользователь не может скопировать кусок
  текста в другое поле резюме или во внешнюю форму (например, hh.ru). Копирование остаётся
  "на совести пользователя", как и решили ранее — защищаем только момент выдачи файла.
- **Название режима 3 сознательно НЕ переименовано в "ИИ агент"** — обсуждали, отложили:
  сейчас там нет никакого ИИ (детерминированный поиск по ключевым словам), называть это
  "ИИ" было бы обманом ожиданий, особенно на фоне впечатляющего примера от других сервисов.
  Переименовать в "ИИ агент для генерации идей" стоит ровно в момент, когда туда подключат
  живую модель (см. пункт про YandexGPT/триггер выше) — тогда название станет правдой.

## Дальнейшие шаги

- [x] Расширить `ideas.json` до 100+ записей — готово, 103 записи (v3)
- [x] Определиться со стеком для реального сайта — Astro + Yandex Cloud/российский VPS
      (не Vercel, см. раздел про хостинг выше)
- [x] Определиться с AI-провайдером — YandexGPT Lite вместо Ofox.ai/GigaChat (см. раздел выше),
      само подключение осознанно отложено до появления реального трафика
- [x] Спроектировать шаблоны резюме — решено остановиться на 2 (компактный/плотный),
      осознанно не делать 8-12 layout-ов впрок. Дешёвая альтернатива на будущее вместо
      новых макетов — 2-3 акцентные цветовые палитры поверх тех же 2 шаблонов
- [x] Собрать макет переключателя режимов + режим "навыки под профессию" —
      `prototypes/04-mode-switcher.html`
- [x] Написать системный промт для ИИ-ассистента (режим 3) —
      `prototypes/05-ai-assistant-system-prompt.md`
- [x] Сделать `04-mode-switcher` главной страницей (`index.html`), пересадить туда адаптивный
      шаблон резюме из `03`, старый список черновиков спрятать за иконку-шестерёнку
- [x] Подключить полную базу `ideas.json` (103 записи) через `fetch()` вместо
      захардкоженного списка ~20 карточек в `index.html`
- [x] Сделать локальный "подсказчик" умнее без внешнего ИИ: улучшённый поиск по ключевым
      словам (грубый стемминг для русского) + ветвящийся режим "не знаю, с чего начать"
- [x] Добавить тёплый блок-синтез черт характера (не психологический разбор, не в резюме) —
      промежуточный вариант между "ничего" и "ждать живого ИИ"
- [x] Сделать "О себе" и "Проектный опыт" редактируемыми, починить грамматику ("Мои
      интересы" вместо "интересуюсь"), убрать дублирующую подсказку в "навыки под профессию"
- [x] Починить навигацию в "навыки под профессию" — поиск по 271 роли + сворачивание плитки
      после выбора
- [x] Добавить блок "🔬 Что говорят исследования" — 3 карточки с реальными источниками
      (reading_books, team_shooter, team_sport), остальные 100 намеренно без него
- [x] Финальный аудит перед сдачей: добавлены поля "график"/"портфолио", реализован
      настоящий PDF-экспорт (window.print()), исправлен XSS в esc(), проверено реальной
      генерацией PDF — 1 страница при 2-8 идеях, ничего не обрезается
- [x] Продумать привязку оплаты — решено: сессия/localStorage с истечением через 24 часа,
      не аккаунт (см. пункт про тарифную сетку выше). Реальная интеграция с ЮKassa — ещё
      не сделана (кнопка-заглушка "🚧 Скоро"), но механика хранения доступа готова
- [x] Механика разблокировки платного функционала — решено и затем упрощено по фидбеку:
      2 равноценных пути (поделиться — сразу / подождать — 10 минут), доступ действует 24
      часа. Защита содержимого блюром — пробовали, откатили (см. пункт про "кота в мешке"
      выше) — копирование "на совести пользователя", защищаем только момент выдачи файла
- [x] Подключить сбор данных — Яндекс.Метрика (пока без реального ID счётчика, см. пункт
      выше)
- [x] E-E-A-T-страница «О методологии» `/methodika/` — сделано: подходы Ramit Sethi /
      Laszlo Bock / инфостиль, честная пометка «исследования у 3 из 103», динамический блок
      с реальными источниками, AboutPage JSON-LD. Ссылка в футере (на всех страницах) +
      мини-блок на лендинге.

## Согласованный порядок следующих шагов (не начато)

Обсуждали и осознанно зафиксировали порядок — **ИИ намеренно последний пункт**, не в одном
пакете со стартовой инфраструктурой (отступление от изначального плана пользователя,
согласовано в диалоге):

1. [x] Сбор данных (Яндекс.Метрика) — сделано, см. выше
2. [x] Переход на Astro для статических SEO-страниц — сделано, см. статус и раздел «Структура»:
       лендинг `/`, 103 статические страницы `/idei/<id>/` из `ideas.json`, конструктор «остров» на
       `/konstruktor/`. Домен вписан (https://resumegenerator.ru). См. шаг 3 — хостинг.
3. [x] Покупка RU-домена + раздача на реальном хостинге (Yandex Cloud Object Storage / RU VPS,
      не Vercel — см. решение про хостинг выше). Сделано: https://resumegenerator.ru работает,
      HTTP → 301 → HTTPS, сертификат Let's Encrypt до 16.11.2026. Остались оформительские шаги:
      главное зеркало в Вебмастере + `www` → без `www` (см. чек-лист в `docs/DEPLOY.md`)
4. [ ] Дать сайту пожить с реальным трафиком, посмотреть на данные из Метрики — доходят ли
      люди до "Помощника-подсказчика", просят ли явно большего, чем дают карточки
5. [ ] Только после этого — интеграция ЮKassa (если данные покажут, что бесплатных механик
      уже недостаточно) и/или подключение живого ИИ (YandexGPT/GigaChat — по сигналу спроса,
      не заранее)

## Дорожная карта: детализация оставшихся шагов

Разбивка по владельцу действия. «[я]» — можно сделать прямо из этого репозитория, не нужны
внешние ресурсы; «[ты]» — требуется твоё действие (деньги / аккаунт / юридическое / решение).

### Шаг 3. Домен + хостинг (после него сайт станет публичным)

- [ ] [ты] Выбрать хостинг по критериям из README (раздел «Хостинг — НЕ Vercel»):
      Yandex Cloud Object Storage, либо RU-VPS (Timeweb Cloud / Selectel / Beget). Оплата
      и юрисдикция в РФ, без зарубежных привязок. Домен уже готов (resumegenerator.ru).
- [x] [ты] Зарегистрировать RU-домен — сделано: **resumegenerator.ru** на reg.ru.
- [x] [ты] Прислать сюда домен → [я] правки — сделано: `site` в `astro.config.mjs` и
      `Sitemap:` в `public/robots.txt` = `https://resumegenerator.ru`. Canonical без `www`;
      редирект `www` → без `www` задать на DNS/хостинге при настройке шага 3.
- [x] [я] Подготовить деплой-конфиги, которые закроют любой из выбранных вариантов:
      `deploy/Dockerfile` + `deploy/nginx.conf.sample` (для VPS на Node) и
      `deploy/deploy-yandex.sh` для выгрузки `dist/` в Object Storage (шаблон переменных —
      `deploy/.env.example`). Сделано.
- [x] [я] Написать `docs/DEPLOY.md` с пошаговой настройкой для 2-3 конкретных провайдеров
      (что купить, куда заливать `dist/`, как включить HTTPS) + чек-лист перед продакшеном.
      Сделано — деплой-слой готов, ждёт только выбора провайдера и домена.
- [x] [ты] Завести счётчик в Яндекс.Метрике → [я] впишу `YM_COUNTER_ID` в
      `src/components/Metrika.astro` и добавлю noscript-пиксель (комментарий уже на месте).
      Вебвизор не включаем — решение зафиксировано в README. — сделано: ID 111722479 вписан,
      noscript на месте, проверено E2E.
- [ ] [ты] В Яндекс.Вебмастере выставить **главное зеркало `https://resumegenerator.ru`** +
      переобход/переиндексацию (иначе Яндекс может склеить http/https как два сайта).
- [ ] [ты] Настроить `www` → без `www`: CNAME `www` → `resumegenerator.ru` в Cloud DNS
      (сейчас `www` не резолвится) + при необходимости редирект `www` → `https://resumegenerator.ru`.
- [ ] [ты] Открыть сайт, проверить на 2-3 устройствах; после HTTPS выключить HTTP-412/старую
      «проверку» в браузерах — сайт должен открываться чисто по https.

### Шаг 4. Жить с трафиком и смотреть данные

- [x] [я] Подготовить список KPI и как их читать в Метрике (что считается «хорошо»):
      доходимость до `/konstruktor/`, до режима 3, конверсия в разблокировку PDF,
      какие `/idei/` страницы приносят органику. Сделано — это раздел «KPI» в
      `docs/DEPLOY.md`.
- [ ] [ты] Дать сайту пожить 2-6 недель, наблюдать; по итогам — сигнал к шагу 5.
- [ ] Пока сайт живёт — НЕ добавляем платное и НЕ подключаем ИИ (осознанное решение,
      см. «Согласованный порядок…» выше).

### Шаг 5. ЮKassa и живой ИИ (только по сигналу спроса из шага 4)

- [ ] [я] Заранее (без деплоя) подготовить код Yandex Cloud Function — вебхук ЮKassa:
      принимает уведомление об оплате, ставит `UNLOCK_KEY` на 24 часа (механика уже есть
      в `Constructor.astro`), фискализация — на стороне ЮKassa. По аналогии с
      `prototypes/07-verify-post-function.md`.
- [ ] [я] Подготовить код подключения YandexGPT Lite к режиму 3 (RAG поверх `ideas.json`):
      шаблон Cloud Function + правки в `Constructor.astro`, чтобы переключение «локальный
      подсказчик → живой ИИ» было одной константой. Ничего не деплою и не вызываю без сигнала.
- [ ] [ты] Решить бизнес-модель (разово 50₽ / пакет / watermark — варианты в README), завести
      магазин ЮKassa и/или получить API-ключ YandexGPT. Передать ключи/параметры [я] — вставлю
      и подключу.

### Опциональные улучшения (не блокеры, можно в любом порядке)

- [ ] [я] Русские слаги `/idei/…`: сейчас используются английские `id` (`/idei/strategy_games/`).
      Можно добавить алгоритмическую транслитерацию + таблицу ручных переопределений для
      «красивых» URL под русский поиск. Отдельная механика, данные менять не нужно.
- [ ] [я] Нормализация ролей в `ideas.json` (271 уникальная роль → меньше): объединить
      дубли вроде «Технический ассистент / Технический ассистент в геймдев-студии».
      Чистка данных, интерфейс менять не надо.
- [ ] [я] Улучшить title/description отдельных `/idei/` страниц под длинные запросы (по данным
      Метрики из шага 4 — какие реально приходят).
- [ ] Не добавляем блок «исследования» на оставшиеся 100 карточек без реальных источников —
      решение зафиксировано, фабриковать не будем.