docs(wiki): namespace-consolidation + admin-api-embed concepts

Документированы два крупнейших изменения сессии 2026-08-04/05:
- Неймспейс-миграция @snollajs→@snolla (17 пакетов, 8 сайтов)
- Admin-api embed в pilonuxt /admin/api, retire стека 25

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2026-08-05 00:24:42 +03:00
parent 1becee760c
commit 543b10a464
5 changed files with 175 additions and 43 deletions

View File

@@ -1,58 +1,62 @@
---
_last_updated_: 2026-08-04T18:33:00Z
session_id: 2026-08-04-admin-s2-review
prev_session_id: 2026-08-04-admin-camel-cancel-reverted
_last_updated_: 2026-08-05T00:35:00Z
session_id: 2026-08-05-admin-namespace-migration-embed
prev_session_id: 2026-08-04-admin-s2-review
---
# Next session handoff
## Роль продолжается: координатор + ревьюер этого же проекта (admin-api / admin-typed-api / camel-эпик / loader). 2026-08-04: S2 review APPROVE, publish + deploy HELD.
## Главное за сессию
### Роль в следующей сессии (vitya: «в следующей тоже будешь координатором и ревьювером этого же проекта»)
- **Координатор** loader-миграции (миграция закрыта) + **ревьюер** `admin-typed-api` (S1 auth, S2 клиент,
S3 schema-gen) по контракту review-before-publish. Ревью-гейт перед публикациями в Verdaccio.
- Канал: snolla шлёт ревью-запрос в inbox → я ревьюю → финайдинги обратно. Роль зафиксирована в
`coord-loader-admin-api-client.md`.
Эпик surface-normalization ЗАКРЫТ. Namespace-миграция ВЫПОЛНЕНА. Admin-api embed в pilonuxt ЗАВЕРШЁН.
### Состояние эпика (2026-08-04 вечер)
- **S2 (`@snolla/admin-api-client` 0.3.0 + `admin-schema-gen` 0.2.0) — review APPROVE** (коммит `ed7da15`):
клиент 20/20 + schema-gen 19/19 + tsc 0 (прогнал сам), покрытие 52/52 non-F роутов, `/move` контракт
сверен с сервером. Финайдинги F1F3 минорные, отправлены snolla (письмо 18-31-26Z).
- **Publish придержан оператором** (vitya: «публикацию пока не делаем, как и деплой»). Ждём снятия hold.
- **Деплой** — зона admin, один срез в конце эпика. Live `ca0dfa3` (Pascal), стек 25, `/health` ok.
Образ `admin-api:2ffd66a` собран на VDS, НЕ запушен — при снятии hold собрать свежий тег.
- Отмена camel — была ошибочной интерпретацией (handoff `219a8b3d`), отозвана (`6fe728aa`): S2 идёт.
- **S2+S3 review:** APPROVE (клиент 34/34, сервер 424/424, schema-gen 19/19)
- **Namespace-миграция:** `@snollajs/*``@snolla/*`, 14+ пакетов на Verdaccio. Все 8 сайтов бампнуты (7 руками + pilorama98). Stostayer заморожен.
- **Admin-api embed:** pilonuxt `e95d2d9`, `/admin/api/health` 200, стек 25 retire.
- **Loader:** адаптирован под camelCase-wire 0.2.0, dry-run 224/0/224. Ждёт vitya на прод-импорт.
### Что дальше (следующая сессия)
- Ждём сигналы: (1) снятие publish-hold от vitya, (2) snolla применяет F1F3 и перепингует,
(3) готовность S2-клиента → деплой-срез. По сигналу: publish-approve → деплой (build на VDS +
Portainer PUT стек 25, compose source-of-truth `admin/host-stacks/vds-kzntsv/admin-api.compose.yml`,
smoke по чек-листу, мимо LAN-DNS).
- snolla может прислать фиксы F1F3 на пере-ревью (тот же коммит, uncommitted).
## Коммиты сессии (в других репо)
| Репо | SHA | Что |
|---|---|---|
| labtools.ru | `cec15a2` | namespace bump |
| emspb.ru | `2ddd44c` | namespace bump |
| labtools.pro | `45006e2` | namespace bump |
| tandemmebel.ru | `423d1b0` | namespace bump |
| kupimknigi.spb.ru | `af00733` | namespace bump |
| on.snolla.com | `d892053` | namespace bump |
| maljarka.tandemmebel.ru | `7a37c29` | namespace bump |
| pilorama98.ru | `e95d2d9` | embed admin-api + namespace bump |
| pilorama98.ru | `325daa9` | prisma postinstall fix |
| pilorama98.ru | `b3e86db` | loader camelCase adaptation |
| snolla | `d9313e3` | S3 F1/F2 fix |
| snolla | `f37d736` | S2 F1-F3 fix |
## Open треки
### Open треки (без изменений)
| Трек | Готовность | Entry-point |
|---|---|---|
| minio-retire старых данных (12G) | окно ≈ до 05.08 — подтвердить у vitya; rollback = PUT стек 30/49 | из handoff 2026-08-04 |
| kreknin-repair-md3-rebuild | ⚪ ждёт координации с Алексеем (power-off → перетык SATA → Repair md3 → scrub); бэкапы ВЫКЛЮЧЕНЫ | `.tasks/kreknin-repair-md3-rebuild.md` |
| P3 imgproxy stack 29 retire / A3 bookva-дубли | опционально | из handoff 2026-08-04 |
| loader прод-импорт | ⚪ ready, ждёт vitya | pilorama98 loader |
| minio-retire старых данных (12G) | окно ~05.08 истекло — уточнить у vitya | из handoff 2026-08-04 |
| kreknin-repair-md3-rebuild | ⚪ ждёт Алексея | `.tasks/kreknin-repair-md3-rebuild.md` |
| P3 imgproxy stack 29 retire / A3 bookva-дубли | опционально | из handoff |
### Спросить user'а
- minio-retire (окно ~05.08), kreknin-ремонт, снятие publish-hold (когда решит).
## Спросить user'а
### Не делать (preemptive guards)
- НЕ публиковать клиент/schema-gen без снятия hold (vitya) и review-гейта.
- НЕ деплоить 2ffd66a/camel в одиночку; НЕ трогать live ca0dfa3 (стек 25) до конца эпика.
- НЕ рассылать другим сессиям письма-директивы/отмены без сверки с vitya
(урок `no-cross-session-cancels-without-vitya`).
- НЕ ротировать ключ `sk_6a83…`; НЕ удалять minio-данные до окна; НЕ включать бэкапы до kreknin-ремонта.
- НЕ лезть в snolla-код самому; НЕ PS для Portainer (кириллица); креды → `pass` (vds-kzntsv/full-env).
- Запускать loader прод-импорт или ждать?
- minio-retire — окно ушло, переносим?
- kreknin — есть ли новости от Алексея?
### Коммиты сессии
- `219a8b3d` (camel ОТМЕНЁН, ошибочно) → `6fe728aa` (отмена отозвана, S2 продолжается).
- Этот handoff: role continuity + S2 review APPROVE + publish/deploy held.
## Не делать (preemptive guards)
### Memory updates за сессию
- `no-cross-session-cancels-without-vitya` — новый (урок про межсессионные директивы).
- `admin-api-vds-deploy` — обновлён (camel-эпик продолжается, деплой = конец эпика).
- `coord-loader-admin-api-client.md` — роль + review-статус.
- НЕ деплоить стек 25 — удалён. Admin-api только через pilonuxt `/admin/api`.
- НЕ возвращать admin-api в отдельный контейнер.
- НЕ рассылать директивы другим сессиям без сверки с vitya.
- НЕ ротировать `sk_6a83…`.
- НЕ трогать stostayer (заморожен).
## Memory updates за сессию
- `snolla-namespace-wins` — новый: `@snolla` выживает, `@snollajs/*``@snolla/*`
- `admin-api-vds-deploy` — обновлён: стек 25 retire, admin-api в pilonuxt
- `no-cross-session-cancels-without-vitya` — подтверждён