# README-HANDOFF.md — комплект разработчика iya.ru platform (2026-10-19)

> Привет, собрат. Этот архив — всё, что нужно, чтобы продолжить разработку
> платформы iya.ru с нуля (даже если workspace пуст). Состояние: фазы P1–P16
> закрыты, платформа релизопригодна, гейты зелёные (483 теста / 3109 утверждений
> / 0 падений · lint 224/0 · i18n 42/66). HEAD репозитория: `017a636` (380 коммитов).

## Порядок чтения (не пропускай)

1. **`AGENTS.md`** — входная точка: состав комплекта, быстрый старт, задание,
   10 напутствий по выживанию в этой среде.
2. **`RESILIENCE-PLAYBOOK.md`** — среда регулярно теряет состояние (3 сбоя
   позади): 6 слоёв защиты, ритуал чекпоинта, decision-tree восстановления,
   24 реальные грабли с лекарствами.
3. **`SETTINGS-PLAN.md`** — **ЗАДАНИЕ №1 (фаза P18)**: раздел
   `/dashboard/settings`, потерянный при раннем падении. Инвентаризация потерь
   (§1), карта reuse UI→AuthService (§2), готовые роуты (§4), фазы S0–S4 (§9).
   Начни с S0. Оценка: 4–6 рабочих блоков.
4. **`AGENT-CONTRIB-PLAN.md`** — **ЗАДАНИЕ №2 (фаза P17)**: sandboxed agent
   contribution pipeline, фазы C0–C8. Выполняется ПОСЛЕ P18 (ADR-020).
5. **`REWORK-STATE.md`** — точка правды: §0 статус, §1 ADR-лог (ADR-020 —
   текущий), §8 known bugs (B-006 = твоё задание, B-007 исправлен), §9 правила
   1–11 и NEXT STEP.
6. Остальное по ходу работы: `AGENT-GUIDE.md` (карта workspace, процедуры),
   `ENVIRONMENT.md` + `setup-env.sh` (рецепт среды), `WORKLOG.md` (дневник,
   читай ХВОСТ), `CHANGELOG.md`, `BETA.md` (fix list).

## Полный проект

**`IYA-DEV-BUNDLE.tar.gz`** (+ `.sha256`) — репозиторий `iya-platform/` с полной
`.git`-историей (380 коммитов), i18n-дубликатами, всеми гайдами и скриптами.
Распаковка и проверка — в `AGENTS.md` §2. Если workspace уже содержит живой
`/home/user/iya-platform` с чистым `git status` и HEAD `017a636` — бандл не нужен.

## Ключевые правила (полностью — в RESILIENCE-PLAYBOOK и AGENTS.md §4)

- Выживает только `/home/user` (снапшот ≤128 МБ — следи за бюджетом, лишнее в
  `/mnt/oss`). `/mnt/oss` переживает сбросы: зеркала в `iya-platform-backups/`,
  `iya-agent-bundle/`, `iya-i18n/`.
- Чекпоинт каждые 15–25 вызовов инструментов: гейты → атомарный commit →
  REWORK-STATE §0/§9 → WORKLOG → `scripts/sync.sh` → `scripts/pack_p12.sh` →
  `scripts/pack_bundle.sh --mirror` → `du -sh /home/user`.
- Большие файлы пиши частями ≤200 строк. Контекст на исходе — СНАЧАЛА чекпоинт.
- Пользователя вопросами не блокируй: спорные решения — в ADR-лог. Каждый раунд
  заканчивай отчётом «что осталось + %» (правило 11; формула прогресса — в
  REWORK-STATE §9, знаменатель 18).
- Инвентаризационный аудит (перезапускай после каждой фазы P18):
  `php scripts/_inventory_audit.php` (внутри бандла; цель — 0 стабов в
  account-группе).

## Что уже проверено на этом состоянии (2026-10-19)

- `php tests/run.php` → 483/3109/0; `php bin/iya lint` → 224/0;
  `php scripts/build_i18n.php --check` → 42/66.
- `php bin/iya migrate --reset && php bin/iya seed` → dev-БД пересобирается
  начисто (фикс B-007: FK-порядок дропа; проверено и на «рваной» БД).
- Аудит маршрутов: 525 роутов, 23 стаба (все — предмет P18), 0 мёртвых
  render-целей, 0 битых ассетов.

Удачи. Начни с `AGENTS.md`.