From cda88547c4b810b4a98f08e6345cb7783c287e7a Mon Sep 17 00:00:00 2001 From: Ku6epXBOCTuK Date: Sat, 12 Sep 2026 13:27:14 +0500 Subject: [PATCH] docs: update plans --- docs/backlog.md | 3 ++- docs/plan-platform.md | 6 ++--- docs/plan-redesign.md | 53 ++++++++++++++++++++++++------------------- docs/roadmap.md | 9 ++++---- 4 files changed, 40 insertions(+), 31 deletions(-) diff --git a/docs/backlog.md b/docs/backlog.md index fb47486..0ef4189 100644 --- a/docs/backlog.md +++ b/docs/backlog.md @@ -91,7 +91,8 @@ Общий план: `docs/plan-platform.md`; WASM-ядро и CLI уже в `docs/roadmap.md` (фазы 3–8) — здесь только новые треки. -- [ ] PWA: manifest + service worker, оффлайн-режим, установка (после C19 и S1) +- [ ] PWA: manifest + service worker, оффлайн-режим, установка (после C17 и S1; + C19 отложен — не блокер) - [ ] API: спайк серверного ядра (нативный Rust vs edge-wasm), ключи, free tier (после wasm-фаз 5–7) diff --git a/docs/plan-platform.md b/docs/plan-platform.md index dc72632..213e30d 100644 --- a/docs/plan-platform.md +++ b/docs/plan-platform.md @@ -43,7 +43,7 @@ - Гейт: один и тот же пайплайн даёт пиксельно идентичный результат в браузере, CLI и API (harness фазы 7 расширяется третьим рантаймом). -## 2. Фаза 10 — PWA (после C17/C19 и S1) +## 2. Фаза 10 — PWA (после C17 и S1; C19 не блокер) - [ ] **[P1]** Манифест: имя (бренд после R1 из plan-seo §6), иконки 192/512 + maskable, theme-color из дизайн-токенов, `display: standalone`. @@ -64,8 +64,8 @@ ## 3. Порядок и связи - WASM-ядро, эталоны, CLI — `docs/roadmap.md` фазы 2–8 (не дублируются). -- PWA — после C17/C19 (один дизайн, реальные маршруты) и после S1 `plan-seo.md` - (не кешировать noindex-версии); API — после фаз 5–7. +- PWA — после C17 (один дизайн, реальные маршруты) и после S1 `plan-seo.md`; C19 + отложен и PWA не ждёт (не кешировать noindex-версии); API — после фаз 5–7. - Синергия с дистрибуцией: «works offline, installable» и публичный API — аргументы для Product Hunt / alternative.to / GitHub (plan-seo S4c) и для GEO-текстов (`llms.txt`, описания категорий). diff --git a/docs/plan-redesign.md b/docs/plan-redesign.md index 67c55d0..63a6d04 100644 --- a/docs/plan-redesign.md +++ b/docs/plan-redesign.md @@ -1,11 +1,13 @@ # План: переезд на новый дизайн (refs) — параллельная сборка -> Статус: C17 **выполнен** (`docs/archive/plan-c17.md`). Остались C18–C21 (шаг -> 5–6) — **следующий этап**. Они больше не привязаны к «верности против рефа»: -> `docs/archive/plan-design-fix.md` закрыт, аудит против рефа прекращён. Tech -> debt закрыт (`docs/archive/plan-tech-debt.md`). Backlog №14 (переезд старых -> файлов в `old/`) — **выполнено**. Покупка домена НЕ была блокером C17: домен -> нужен для S1 (`plan-seo.md`) — canonical, sitemap, снятие `noindex`. +> Статус: C17 **выполнен** (`docs/archive/plan-c17.md`), C18 **выполнен**. +> Остались C20 (шаг 6, проверка нового дизайна) — **следующий этап**. C19/C21 +> (шаг 7, удаление старого) — **отложены**, нет ценности. Они больше не +> привязаны к «верности против рефа»: `docs/archive/plan-design-fix.md` закрыт, +> аудит против рефа прекращён. Tech debt закрыт +> (`docs/archive/plan-tech-debt.md`). Backlog №14 (переезд старых файлов в +> `old/`) — **выполнено**. Покупка домена НЕ была блокером C17: домен нужен для +> S1 (`plan-seo.md`) — canonical, sitemap, снятие `noindex`. > > Источники: `refs/` — Next/React-референс (правда по пикселям и интерактиву), > `refs-html/` — статические HTML-снимки для быстрого просмотра в браузере. @@ -380,24 +382,31 @@ src/routes/preview/tools/[id]/+page.svelte - [x] **[C18]** Правки импортов/редиректов после переноса, проверка билда. _(Билд собирается без ошибок, линт/свелт-чека нет — выполнен.)_ -### Шаг 6. Удаление старого +### Шаг 6. Проверка нового дизайна -- [ ] **[C19]** Удалить старое: маршруты `routes/v1/**`, код `lib/v1/**`, - `app_v1.css` (и его токены), неиспользуемые классы. К этому моменту `kit/` - уже упразднён (C17 разложил его в `components/`), навести порядок в - `components/` (согласовать подпапки, финальное имя каталога). **И раскрыть - ESLint `recommended` на весь код** — убрать scoped-блок `newCode` в - `web/eslint.config.js` (см. AGENTS.md), прогнать `lint` и починить - всплывшие ошибки в оставшемся коде. _Примечание: доменные модули - (`lib/core`, `lib/registry`, тесты и т.п.) — это не «старый дизайн», у них - свой линт-долг; расширение `recommended` на них может выдать много ошибок. - Решить на C19: либо чиним сразу, либо расширяем scoped только на - `src/routes/**` + `src/lib/components/**`._ - [ ] **[C20]** Финальный проход по брейкпоинтам 1200/1100/800/480; build без - предупреждений; `grep` по старым токенам/классам пуст. -- [ ] **[C21]** _(опционально)_ Удалить `refs/` и `refs-html/` из репо — они - больше не источник правды. + предупреждений; `grep` по старым токенам/классам пуст. Доказательство + отсутствия регресса: старый `v1/` работает и не затронут. +### Шаг 7. Опциональная чистка (отложен, нет срока) + +- [ ] **[C21]** Удалить `refs/` и `refs-html/` из репо — они больше не источник + правды. +- [ ] **[C19]** Удалить старое: маршруты `routes/v1/**`, код `lib/v1/**`, + `app_v1.css` (и его токены), неиспользуемые классы. **И раскрыть ESLint + `recommended` на весь код** — убрать scoped-блок `newCode` в + `web/eslint.config.js`, прогнать `lint` и починить всплывшие ошибки. + _Примечание: доменные модули (`lib/core`, `lib/registry`, тесты и т.п.) — + это не «старый дизайн», у них свой линт-долг; расширение `recommended` на + них может выдать много ошибок. Решить на C19: либо чиним сразу, либо + расширяем scoped только на `src/routes/**` + `src/lib/components/**`._ +- [ ] Навести порядок в `components/` (согласовать подпапки, финальное имя + каталога). + +> **Удаление v1 не решает никаких текущих задач** и не даёт пользовательской +> ценности. Старый код лежит мёртвым, не мешает, не ломает билд. Удалять стоит +> только когда нет горящих задач и хочется навести порядок. +> > Если какой-то коммит тянет за собой > 500 строк (например, C6/C7), разбивать > на под-коммиты по 2–4 компонента. Тесты/билд прогонять после каждого коммита, > чтобы регрессия локализовалась одним шагом назад. @@ -414,8 +423,6 @@ src/routes/preview/tools/[id]/+page.svelte > удаление `(old)/` + смена root-layout — в ОДНОМ коммите. Снятие `noindex` > также в C17, **если домен уже куплен**; иначе — отложить на S1. Не дробить > сам C17. -> - **C19 должен идти строго после C17** (старый `app.css`/`ui/` удаляем только -> когда old-сайт уже выключен). > - Очерёдность зависимостей: `design2.css` (C3) и kit-компоненты (C5–C7) должны > существовать до страниц, которые их импортируют (C8–C14). diff --git a/docs/roadmap.md b/docs/roadmap.md index 2d7ebb4..b8a95c2 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -2,10 +2,11 @@ > **Статус:** Фаза 1 (полноценный TS-сайт) в основном выполнена — сайт живёт, > каталог переведён в типизированный `registry` (121/125), новый дизайн по -> `plan-redesign.md` стал основным на корневых маршрутах (C17 выполнен), старый -> UI — на `/v1/*` (удаление отложено до C19). Tech debt закрыт. Следующий этап: -> C18–C21 (`plan-redesign.md`, §10). Домен нужен для SEO (`plan-seo.md`, -> S1-domain). Фазы 2–8 — будущие. Фазы 9–10 спланированы в +> `plan-redesign.md` стал основным на корневых маршрутах (C17/C18 выполнены), +> старый UI — на `/v1/*` (удаление отложено, ценности не даёт — C19 в бэклоге). +> Tech debt закрыт. Следующий этап: C20 (проверка нового дизайна, +> `plan-redesign.md`, §10) + SEO S1-free (`plan-seo.md`) + баги. Домен нужен для +> SEO (`plan-seo.md`, S1-domain). Фазы 2–8 — будущие. Фазы 9–10 спланированы в > `docs/plan-platform.md`. ## 0. Решения