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>

.wiki/concepts/admin-api-embed-pilonuxt.md

@@ -0,0 +1,54 @@
+---
+title: Admin-api embed in pilonuxt — retire standalone container
+type: concept
+tags: [admin-api, pilonuxt, vds, embed, middleware, nuxt]
+related: [[admin-api-surface-normalization]], [[namespace-consolidation-snolla]]
+updated: 2026-08-05
+---
+
+# Admin-api embed in pilonuxt
+
+Оператор (vitya) постановил 2026-08-04: admin-api должен жить в `apps/web`
+как Nuxt-server-middleware, а НЕ отдельным контейнером. По образу `@snolla/content-api`
+и `@snolla/forms-api`.
+
+## Архитектура
+
+```
+piloruxt (стек 16)
+├── /snolla/*        → @snolla/content-api  (useBase)
+├── /snolla-forms/*  → @snolla/forms-api    (useBase)
+└── /admin/api/*     → @snolla/admin-api    (useBase)  ← НОВОЕ
+```
+
+## Реализация
+
+- Пакет: `@snolla/admin-api@0.2.0`
+- Экспорт: `createAdminMiddleware({prefix})` — Fastify-плагин без `.listen()`
+- Маунт: `server/routes/admin/[...].ts` = `useBase('/admin/api', fromNodeMiddleware(createAdminMiddleware({prefix:''})))`
+- Конфиг: `JWT_SECRET` + `DATABASE_URL` + `S3_*` в env контейнера (fail-fast в buildApp)
+- Prisma: `prisma generate --schema` в Dockerfile (отдельный RUN, не postinstall)
+
+## Деплой
+
+- Образ: `registry.kzntsv.site/pilonuxt:e95d2d9` (2026-08-05)
+- Стек: Portainer 16 (pilonuxt)
+- Env: `JWT_SECRET`, `DATABASE_URL`, `S3_ACCESS_KEY_ID`, `S3_SECRET_ACCESS_KEY`
+
+## Стек 25 — RETIRED
+
+Старый standalone admin-api (`admin-api.vds.kzntsv.site`, стек 25) удалён из Portainer.
+Контейнер `admin-api` остановлен и удалён.
+
+## Smoke (прод)
+
+- `/admin/api/health` → 200 `{"status":"ok"}`
+- `/admin/api/stores?siteId=...` → 401 (auth required, правильно)
+- `/` → 200
+- `/catalog` → 200
+- `/snolla/pages` → 200
+
+## Loader
+
+Адаптирован под camelCase-wire 0.2.0. baseUrl → `https://pilorama98.ru/admin`.
+Dry-run 224/0/224 PASS. Ждёт vitya на прод-импорт.

.wiki/concepts/namespace-consolidation-snolla.md

@@ -0,0 +1,70 @@
+---
+title: Snolla namespace consolidation — @snollajs → @snolla
+type: concept
+tags: [snolla, verdaccio, namespace, migration, admin-api]
+related: [[../entities/vds-kzntsv]], [[verdaccio-token-lifecycle]]
+updated: 2026-08-05
+---
+
+# Snolla namespace consolidation
+
+Оператор (vitya) постановил 2026-08-04: выживает неймспейс **`@snolla`**.
+`@snollajs/*` мигрируют В `@snolla/*`.
+
+## Причина
+
+`@snolla/admin-api`, `@snolla/admin-api-client`, `@snolla/admin-schema-gen` уже были
+опубликованы под `@snolla`. Дробить на два неймспейса не имело смысла.
+
+## Опубликованные пакеты (Verdaccio, волна 2026-08-04)
+
+| Старое имя | Новое имя | Версия |
+|---|---|---|
+| `@snollajs/data` | `@snolla/data` | 0.15.0 |
+| `@snollajs/liquid` | `@snolla/liquid` | 0.11.0 |
+| `@snollajs/numbering` | `@snolla/numbering` | 0.7.5 |
+| `@snollajs/mailer` | `@snolla/mailer` | 0.8.3 |
+| `@snollajs/forms-core` | `@snolla/forms-core` | 0.1.0 |
+| `@snollajs/core` | `@snolla/core` | 0.26.6 |
+| `@snollajs/forms-api` | `@snolla/forms-api` | 0.1.0 |
+| `@snollajs/snolla` | `@snolla/snolla` | 0.43.2 |
+| `@snollajs/content-api` | `@snolla/content-api` | 0.18.0 |
+| `@snollajs/content-api-client` | `@snolla/content-api-client` | 0.10.0 |
+| `@snollajs/forms-api-client` | `@snolla/forms-api-client` | 0.1.0 |
+| `@snolla/site-schema-gen` | `@snolla/content-schema-gen` | 0.6.0 (rename) |
+| `@snolla/cli` | (bump) | 0.12.0 |
+| `@snolla/theme-check` | (bump) | 0.3.0 |
+| - | `@snolla/admin-api` | 0.2.0 |
+| - | `@snolla/admin-api-client` | 0.3.0 |
+| - | `@snolla/admin-schema-gen` | 0.2.0 |
+
+## Консьюмеры
+
+Все сайты тиража snolla на VDS обновлены 2026-08-04/05:
+
+| # | Сайт | Стек | Пакет |
+|---|---|---|---|
+| 1 | pilorama98.ru | 16 | `@snolla/content-api` + `@snolla/forms-api` |
+| 2 | labtools.ru | 17 | `@snolla/snolla` |
+| 3 | emspb.ru | 18 | `@snolla/snolla` |
+| 4 | labtools.pro | 19 | `@snolla/snolla` |
+| 5 | tandemmebel.ru | 20 | `@snolla/snolla` |
+| 6 | kupimknigi.spb.ru | 21 | `@snolla/snolla` |
+| 7 | on.snolla.com | 22 | `@snolla/snolla` |
+| 8 | maljarka.tandemmebel.ru | 23 | `@snolla/snolla` |
+| 9 | stostayer.new | 16 | **заморожен** (0.3.18, не пересобрать) |
+
+## Паттерн бампа
+
+Для каждого сайта:
+1. `apps/web/package.json`: `@snollajs/snolla` → `@snolla/snolla@0.43.2`
+2. `apps/web/index.js`: `from '@snollajs/snolla'` → `from '@snolla/snolla'`
+3. `.yarnrc.yml`: добавить scope `@snolla` (Verdaccio) + `npmPreapprovedPackages`
+4. `yarn install --no-immutable` → fresh lockfile
+5. Build на VDS, push в registry, Portainer PUT (env-preserving, pullImage:true)
+6. Live smoke: /, /robots.txt, /sitemap.xml, theme assets
+
+## Старые имена
+
+`@snollajs/*` остаются на Verdaccio (заморожены, не обновляются). Удаление — отдельным шагом,
+после полной миграции всех консьюмеров.

.wiki/index.md

@@ -23,6 +23,8 @@ Catalog of all wiki pages. One line per page, organized by type. Updated on ever
 ## Concepts
 
 
+- [admin-api-embed-pilonuxt](concepts/admin-api-embed-pilonuxt.md) — admin-api embedded in pilonuxt /admin/api, stack 25 retired (2026-08-05)
+- [namespace-consolidation-snolla](concepts/namespace-consolidation-snolla.md) — @snollajs → @snolla, 8 sites bumped, 17 packages (2026-08-04/05)
 - [admin-infra-project](concepts/admin-infra-project.md) — design + migration plan для OpeItcLoc03/admin (canonical)
 - [backup-inventory-2026-06](concepts/backup-inventory-2026-06.md) — карта всех машин × что реально бэкапится (с доказательством); дыры по приоритету (kreknin SPOF, nl-vds x-ui.db, bookva-*, openwrt) — триггер: MSSQL 3-нед gap
 - [bindmount-config-edit-preserve-mode](concepts/bindmount-config-edit-preserve-mode.md) — правка bind-mounted config'а через mktemp+mv роняет режим 644→600 → non-root контейнер (uid 1000) EACCES crash-loop; chmod --reference=backup. + гоча: bind-mount затеняет config образа целиком → класть полную секцию, не дельту. Инциденты books-job-scheduler + task-runner 2026-06-18

.wiki/log.md

@@ -2,6 +2,8 @@
 
 Append-only log of wiki operations (ingests, promotions, lints, migrations).
 
+## [2026-08-05] ingest | concepts/namespace-consolidation-snolla + concepts/admin-api-embed-pilonuxt — крупнейшие изменения сессии: неймспейс-миграция @snollajs→@snolla (17 пакетов, 8 сайтов бампнуты), admin-api embed в pilonuxt /admin/api, retire стека 25. +index.md строки.
+
 ## [2026-07-30] migrate | RELOCATE runbook `scripts/minio-split-cutover/runbook.md` → `concepts/minio-split-cutover-runbook.md` (дисциплина: runbook'и → `.wiki/concepts/`, не `scripts/`; `scripts/` для executable). +UPDATE content: v3-секция (snolla 0.43.2 опубликована, live MinIO verify ЗЕЛЁНЫЙ оба конфига, resolutions=optional determinism НЕ mandatory — regression-гипотеза v3 SigV4 vs MinIO НЕ воспроизвелась end-to-end, «CONFIRMED» framing откатан), креды нормализованы → `pass show minio-vds/full-env` (были plaintext в bash-примерах — wiki-конвенция «креды в pass, не в git»). +index.md строка. Старый `scripts/minio-split-cutover/` удалён (в нём кроме runbook'а ничего не было). Cross-ref [[on-snolla-vds-deploy-runbook]], [[minio-imgproxy-on-vds]], [[snolla-live-prod-inplace-image-bump]], [[../entities/vds-kzntsv]], [[../entities/books-vds]]. Related memory: admin `aws-sdk-v3-smithy-sigv4-minio-regression`, `aws-sdk-v2-minio-2025-works-no-smithy-pin`.
 
 ## [2026-07-29] implement | NEW concepts/snolla-local-admin-https-binding.md + UPDATE index.md (concepts +2 строки) — локальный .NET-админ snolla (catch-all IIS `snolla`) переведён на HTTPS. Повод: `https://pilorama98.snolla.com/admin` → 404 → ERR_CONNECTION_CLOSED. Корень 404: `pilorama98.snolla.com` не был в hosts-override → реальный DNS → VDS `89.253.255.94` → traefik без роута (системный прокси `127.0.0.1:10808` маскировал «server 127.0.0.1» в curl). pilorama98 — реальный сайт в `dbo.Sites` (Alias=pilorama98, PrimaryDomain=pilorama98.ru, Live), вне тиража-5 из design-дока. Корень ERR_CONNECTION_CLOSED: браузер HSTS-апгрейдил http→https, а локальный IIS без 443. Решение: **IIS-native self-signed wildcard `*.snolla.com` на :443 + Trusted Root**, НЕ traefik (локальный acme.json пуст → LE на snolla.com нет; traefik-as-TLS-terminator = NAT-loopback/docker.sock/URL-Rewrite/SERVER_PORT-leak готчи без выгоды). Скрипт elevated (UAC): `New-SelfSignedCertificate -Subject '*.snolla.com' -DnsName '*.snolla.com','snolla.com' -TextExtension EKU serverAuth` (гоча: `-DnsName` конфликтует с ручным SAN `2.5.29.17` → SAN через `-DnsName`) → копия в `Cert:\LocalMachine\Root` → `New-WebBinding snolla https 443 *` + `AddSslCertificate` + restart. Cert thumb `6E2212B4C13BD28E2FF680322F11741193E8C619`, SAN `*.snolla.com,snolla.com`, 10 лет — покрывает все alias'ы. hosts: добавлен `pilorama98.snolla.com` (elevated, построчно — `Get-Content -Raw` мог опустошить файл). Результат: `https://<alias>.snolla.com/admin/account/login` → 200 форма SNOLLA (pilorama98/kupimknigi/internal/tandemmebel верифицированы). **Голый `/admin` → 302 `/login` → 301 `https://www.<PrimaryDomain>/`** — предсуществующее поведение CMS (оператор подтвердил: «так и было» на RUVDS), не поломка миграции; рабочий entry-point `/admin/account/login`. `on.snolla.com` → 404: hosts стоит `internal.snolla.com` (реальный alias сайта `on` = `internal`), не `on` (design-док писал `on`). Trade-off: self-signed не LE — допустимо (админка локальная, FW закрыт). +index.md (2 строки: design-док ранее не был индексирован + новый page). Cross-ref [[snolla-local-admin-and-on-snolla-migration-design]], [[traefik-on-windows-docker-desktop]], [[stostayer-admin-minio-config]].