Адмінська Wiki

Використовуйте вкладки Founder / Developer на бічній панелі документації, щоб відфільтрувати цю сторінку. Admin Wiki — це накопичувальна база знань проєкту (Markdown + [[wikilinks]]), а не файловий каталог MDX у /docs і не Markdown CMS новин (NewsRichEditor + shortcode-и). Особисті файли учасників зберігаються в Ring File Cabinet, а не у wiki-сховищі.

Клони Ring зберігають операційні знання у сховищі Postgres: сторінки на рівні tenant і необов’язкові простори project-order. Люди редагують їх у /admin/wiki та на робочих столах Order Lab, а агенти шукають і змінюють їх через ring-mcp, використовуючи те саме WikiKernel.

Рівень	Де
UI	`/admin/wiki` · buyer `/my-orders/[id]` · integrator `/my-jobs/[id]`
Навігація	Суперменю адміністратора Content & Blog → Wiki · заголовок і дії правої панелі
Ядро	`features/wiki/**` (`wiki-service.ts`, ACL, wikilinks, search)
Колекції	`wiki_pages`, `wiki_links`, `wiki_events`
Міграція	`data/migrations/040_wiki_pages.sql`
HTTP	`/api/wiki`, `/api/wiki/[id]`
MCP	`/api/mcp/v1/wiki` · інструменти `ring-wiki-`

Чому це важливо для вашого клону

Чати й тікети забувають. Wiki компілює те, що ваш клон знає про проєкт поселенця: бренд-рішення, нотатки про деплой, передачу роботи інтегратору — із посиланнями, що залишаються актуальними.

Консоль адміністратора

Wiki з’являється в суперменю адміністратора в розділі Content & Blog і в правій панелі поруч із редактором.

Owner Project Lab

Кожне оплачене замовлення проєкту може відкрити сховище проєкту на робочих столах покупця та інтегратора.

Замовлення проєктів CRM

Переходьте з дій Wiki до /admin/crm/orders, коли сторінка належить завданню ringization.

Реалізація

WikiKernel відповідає за ACL, граф посилань, envelope пошуку та події. Адаптери тонкі: Admin UI, панель робочого столу, HTTP, MCP.

Домен

vaultKey: об’єднання TypeScript tenant | po:{projectOrderId} — це поле сторінки, а не env-змінна і не ключ ring-config.
SSOT тіла: bodyMarkdown (не Markdown CMS новин) — Admin UI редагує через TipTap із багатим preview та перемикачем Source Markdown; збереження все одно записує Markdown. Статті новин використовують NewsRichEditor + shortcode-и [[embed:]] / [[mood:]] / [[video:]] замість wiki [[wikilinks]].
Парсер wikilink: ігнорує fenced- та inline-код (приклади в документації не створюють ребер графа).
Lint: ring-wiki-lint / Lint vault; Create stubs автоматично створює чернетки концептуальних сторінок для реальних проблем missing_page.
SSOT графа: ребра wiki_links (local | tenant_ref)
Каталог: похідний список/пошук — підтримуваного _index.md немає
Журнал операцій: wiki_events, лише додавання
Спеціальна сторінка: tenant _schema створюється під час першого відкриття (конституція агента); тіло застарілого прикладу-посилання одноразово виправляється під час ensure
Дерево: дерево папок перенесено з file-registry-viewer (buildTree / expand / кількість папок / ранжований швидкий пошук)

VaultKey — не env-змінна

VaultKey — лише тип TypeScript у features/wiki/types.ts. Не додавайте до або . Файл із не повинен повторно експортувати типи або sync-хелпери — Next трактує кожен export як server action, і повторний export типів стає runtime . Зберігайте actions у лише як async-функції; імпортуйте типи з .

Адмінська Wiki

Рівень	Де
UI	`/admin/wiki` · buyer `/my-orders/[id]` · integrator `/my-jobs/[id]`
Навігація	Суперменю адміністратора Content & Blog → Wiki · заголовок і дії правої панелі
Ядро	`features/wiki/**` (`wiki-service.ts`, ACL, wikilinks, search)
Колекції	`wiki_pages`, `wiki_links`, `wiki_events`
Міграція	`data/migrations/040_wiki_pages.sql`
HTTP	`/api/wiki`, `/api/wiki/[id]`
MCP	`/api/mcp/v1/wiki` · інструменти `ring-wiki-`

Чому це важливо для вашого клону

Консоль адміністратора

Wiki з’являється в суперменю адміністратора в розділі Content & Blog і в правій панелі поруч із редактором.

Owner Project Lab

Кожне оплачене замовлення проєкту може відкрити сховище проєкту на робочих столах покупця та інтегратора.

Замовлення проєктів CRM

Переходьте з дій Wiki до /admin/crm/orders, коли сторінка належить завданню ringization.

Реалізація

WikiKernel відповідає за ACL, граф посилань, envelope пошуку та події. Адаптери тонкі: Admin UI, панель робочого столу, HTTP, MCP.

Домен

vaultKey: об’єднання TypeScript tenant | po:{projectOrderId} — це поле сторінки, а не env-змінна і не ключ ring-config.
SSOT тіла: bodyMarkdown (не Markdown CMS новин) — Admin UI редагує через TipTap із багатим preview та перемикачем Source Markdown; збереження все одно записує Markdown. Статті новин використовують NewsRichEditor + shortcode-и [[embed:]] / [[mood:]] / [[video:]] замість wiki [[wikilinks]].
Парсер wikilink: ігнорує fenced- та inline-код (приклади в документації не створюють ребер графа).
Lint: ring-wiki-lint / Lint vault; Create stubs автоматично створює чернетки концептуальних сторінок для реальних проблем missing_page.
SSOT графа: ребра wiki_links (local | tenant_ref)
Каталог: похідний список/пошук — підтримуваного _index.md немає
Журнал операцій: wiki_events, лише додавання
Спеціальна сторінка: tenant _schema створюється під час першого відкриття (конституція агента); тіло застарілого прикладу-посилання одноразово виправляється під час ensure
Дерево: дерево папок перенесено з file-registry-viewer (buildTree / expand / кількість папок / ранжований швидкий пошук)

VaultKey — не env-змінна

Адмінська Wiki

Рівень	Де
UI	`/admin/wiki` · buyer `/my-orders/[id]` · integrator `/my-jobs/[id]`
Навігація	Суперменю адміністратора Content & Blog → Wiki · заголовок і дії правої панелі
Ядро	`features/wiki/**` (`wiki-service.ts`, ACL, wikilinks, search)
Колекції	`wiki_pages`, `wiki_links`, `wiki_events`
Міграція	`data/migrations/040_wiki_pages.sql`
HTTP	`/api/wiki`, `/api/wiki/[id]`
MCP	`/api/mcp/v1/wiki` · інструменти `ring-wiki-`

Чому це важливо для вашого клону

Консоль адміністратора

Wiki з’являється в суперменю адміністратора в розділі Content & Blog і в правій панелі поруч із редактором.

Owner Project Lab

Кожне оплачене замовлення проєкту може відкрити сховище проєкту на робочих столах покупця та інтегратора.

Замовлення проєктів CRM

Переходьте з дій Wiki до /admin/crm/orders, коли сторінка належить завданню ringization.

Реалізація

WikiKernel відповідає за ACL, граф посилань, envelope пошуку та події. Адаптери тонкі: Admin UI, панель робочого столу, HTTP, MCP.

Домен

vaultKey: об’єднання TypeScript tenant | po:{projectOrderId} — це поле сторінки, а не env-змінна і не ключ ring-config.
SSOT тіла: bodyMarkdown (не Markdown CMS новин) — Admin UI редагує через TipTap із багатим preview та перемикачем Source Markdown; збереження все одно записує Markdown. Статті новин використовують NewsRichEditor + shortcode-и [[embed:]] / [[mood:]] / [[video:]] замість wiki [[wikilinks]].
Парсер wikilink: ігнорує fenced- та inline-код (приклади в документації не створюють ребер графа).
Lint: ring-wiki-lint / Lint vault; Create stubs автоматично створює чернетки концептуальних сторінок для реальних проблем missing_page.
SSOT графа: ребра wiki_links (local | tenant_ref)
Каталог: похідний список/пошук — підтримуваного _index.md немає
Журнал операцій: wiki_events, лише додавання
Спеціальна сторінка: tenant _schema створюється під час першого відкриття (конституція агента); тіло застарілого прикладу-посилання одноразово виправляється під час ensure
Дерево: дерево папок перенесено з file-registry-viewer (buildTree / expand / кількість папок / ранжований швидкий пошук)

VaultKey — не env-змінна

Related documentation

Admin console

Наступний крок: SSOT навігації консолі адміністратора — Wiki розташована в Content & Blog і в правій панелі.

Owner Project Lab

Ring MCP Server

Залежність: інструменти ring-wiki-* використовують той самий токен сервісу MCP, що й інструменти news/entity.

News Module

Див. також: news — це Markdown-shortcode-и через NewsRichEditor; не зберігайте там тіла wiki.

Актор	Tenant-сховище	Проєктне сховище
Admin / Buyer	Повне читання/запис	Повне (власні замовлення)
Integrator	Читання + лише додавання	Повне (призначені замовлення)
Agent (ring-mcp)	Лише читання	Повне

VAULT_KEY

.env

ring-config.json

'use server'

ReferenceError: VaultKey is not defined

app/_actions/wiki.ts

@/features/wiki/types

Форма	Розв’язання
`[[slug]]` / `[[Title]]` / `[[path/slug]]` / `[[Page\|display]]`	Те саме сховище
`[[@Payments]]` / `[[tenant:Payments]]`	Tenant-сховище

Зона	Шлях
Типи / ACL / парсер / пошук	`features/wiki/types.ts`, `acl.ts`, `wikilink-parser.ts`, `search-score.ts`
Сервіс	`features/wiki/wiki-service.ts`
Визначення актора (buyer/integrator)	`features/wiki/resolve-wiki-actor.ts`
Робочий простір адміністратора	`features/wiki/components/wiki-workspace.tsx`
Панель робочого столу	`features/wiki/components/wiki-desk-panel.tsx`
Server actions	`app/_actions/wiki.ts` (лише async exports)
Права панель	секція `wiki` `admin-nav-config` rail + `admin-rail.tsx`
MCP-маршрути	`app/api/mcp/v1/wiki/**`
BackendSelector	`wiki_pages`, `wiki_links`, `wiki_events`

Інструмент	Роль
`ring-wiki-search`	`matches[]` у формі Legiox (лексичний пошук)
`ring-wiki-list` / `get`	Каталог + зворотні посилання
`ring-wiki-create` / `update` / `delete`	CRUD (`confirm` для delete); створення/запис агентом у tenant заборонено
`ring-wiki-lint`	Сироти / недійсні посилання
`ring-wiki-events`	Список або додавання до журналу операцій

1
Застосуйте міграцію
bash
psql "$DATABASE_URL" -f data/migrations/040_wiki_pages.sql
Також присутня в data/schema.sql для чистих інсталяцій. Окремі env-змінні для wiki не потрібні, окрім наявних Postgres DATABASE_URL / токена сервісу MCP.

Викликайте WikiService лише з адаптерів

typescript


import * as WikiService from '@/features/wiki/wiki-service'
import { resolveWikiActor } from '@/features/wiki/resolve-wiki-actor'
import type { VaultKey } from '@/features/wiki/types'

const actor = await resolveWikiActor({
  userId: session.user.id,
  role: session.user.role,
  orderId, // when scoping a project vault
})
await WikiService.ensureTenantSchema(actor)
const vault: VaultKey = 'tenant'
const pages = await WikiService.listPages(actor, vault)

MCP-обробники встановлюють isAgent: true, тому правила запису tenant застосовуються, навіть якщо роль токена сервісу — superadmin.

Додавання замість заміни

typescript


await WikiService.updatePage(actor, pageId, {
  bodyMarkdown: '## Note\nIntegrator addendum…',
  mode: 'append', // required for integrator on tenant
})

Актор	Tenant-сховище	Проєктне сховище
Admin / Buyer	Повне читання/запис	Повне (власні замовлення)
Integrator	Читання + лише додавання	Повне (призначені замовлення)
Agent (ring-mcp)	Лише читання	Повне

VAULT_KEY

.env

ring-config.json

'use server'

ReferenceError: VaultKey is not defined

app/_actions/wiki.ts

@/features/wiki/types

Форма	Розв’язання
`[[slug]]` / `[[Title]]` / `[[path/slug]]` / `[[Page\|display]]`	Те саме сховище
`[[@Payments]]` / `[[tenant:Payments]]`	Tenant-сховище

Зона	Шлях
Типи / ACL / парсер / пошук	`features/wiki/types.ts`, `acl.ts`, `wikilink-parser.ts`, `search-score.ts`
Сервіс	`features/wiki/wiki-service.ts`
Визначення актора (buyer/integrator)	`features/wiki/resolve-wiki-actor.ts`
Робочий простір адміністратора	`features/wiki/components/wiki-workspace.tsx`
Панель робочого столу	`features/wiki/components/wiki-desk-panel.tsx`
Server actions	`app/_actions/wiki.ts` (лише async exports)
Права панель	секція `wiki` `admin-nav-config` rail + `admin-rail.tsx`
MCP-маршрути	`app/api/mcp/v1/wiki/**`
BackendSelector	`wiki_pages`, `wiki_links`, `wiki_events`

Інструмент	Роль
`ring-wiki-search`	`matches[]` у формі Legiox (лексичний пошук)
`ring-wiki-list` / `get`	Каталог + зворотні посилання
`ring-wiki-create` / `update` / `delete`	CRUD (`confirm` для delete); створення/запис агентом у tenant заборонено
`ring-wiki-lint`	Сироти / недійсні посилання
`ring-wiki-events`	Список або додавання до журналу операцій

1
Застосуйте міграцію
bash
psql "$DATABASE_URL" -f data/migrations/040_wiki_pages.sql
Також присутня в data/schema.sql для чистих інсталяцій. Окремі env-змінні для wiki не потрібні, окрім наявних Postgres DATABASE_URL / токена сервісу MCP.

Викликайте WikiService лише з адаптерів

typescript


import * as WikiService from '@/features/wiki/wiki-service'
import { resolveWikiActor } from '@/features/wiki/resolve-wiki-actor'
import type { VaultKey } from '@/features/wiki/types'

const actor = await resolveWikiActor({
  userId: session.user.id,
  role: session.user.role,
  orderId, // when scoping a project vault
})
await WikiService.ensureTenantSchema(actor)
const vault: VaultKey = 'tenant'
const pages = await WikiService.listPages(actor, vault)

Додавання замість заміни

typescript


await WikiService.updatePage(actor, pageId, {
  bodyMarkdown: '## Note\nIntegrator addendum…',
  mode: 'append', // required for integrator on tenant
})

Актор	Tenant-сховище	Проєктне сховище
Admin / Buyer	Повне читання/запис	Повне (власні замовлення)
Integrator	Читання + лише додавання	Повне (призначені замовлення)
Agent (ring-mcp)	Лише читання	Повне

VAULT_KEY

.env

ring-config.json

'use server'

ReferenceError: VaultKey is not defined

app/_actions/wiki.ts

@/features/wiki/types

Форма	Розв’язання
`[[slug]]` / `[[Title]]` / `[[path/slug]]` / `[[Page\|display]]`	Те саме сховище
`[[@Payments]]` / `[[tenant:Payments]]`	Tenant-сховище

Зона	Шлях
Типи / ACL / парсер / пошук	`features/wiki/types.ts`, `acl.ts`, `wikilink-parser.ts`, `search-score.ts`
Сервіс	`features/wiki/wiki-service.ts`
Визначення актора (buyer/integrator)	`features/wiki/resolve-wiki-actor.ts`
Робочий простір адміністратора	`features/wiki/components/wiki-workspace.tsx`
Панель робочого столу	`features/wiki/components/wiki-desk-panel.tsx`
Server actions	`app/_actions/wiki.ts` (лише async exports)
Права панель	секція `wiki` `admin-nav-config` rail + `admin-rail.tsx`
MCP-маршрути	`app/api/mcp/v1/wiki/**`
BackendSelector	`wiki_pages`, `wiki_links`, `wiki_events`

Інструмент	Роль
`ring-wiki-search`	`matches[]` у формі Legiox (лексичний пошук)
`ring-wiki-list` / `get`	Каталог + зворотні посилання
`ring-wiki-create` / `update` / `delete`	CRUD (`confirm` для delete); створення/запис агентом у tenant заборонено
`ring-wiki-lint`	Сироти / недійсні посилання
`ring-wiki-events`	Список або додавання до журналу операцій

1
Застосуйте міграцію
bash
psql "$DATABASE_URL" -f data/migrations/040_wiki_pages.sql
Також присутня в data/schema.sql для чистих інсталяцій. Окремі env-змінні для wiki не потрібні, окрім наявних Postgres DATABASE_URL / токена сервісу MCP.

Викликайте WikiService лише з адаптерів

typescript


import * as WikiService from '@/features/wiki/wiki-service'
import { resolveWikiActor } from '@/features/wiki/resolve-wiki-actor'
import type { VaultKey } from '@/features/wiki/types'

const actor = await resolveWikiActor({
  userId: session.user.id,
  role: session.user.role,
  orderId, // when scoping a project vault
})
await WikiService.ensureTenantSchema(actor)
const vault: VaultKey = 'tenant'
const pages = await WikiService.listPages(actor, vault)

Додавання замість заміни

typescript


await WikiService.updatePage(actor, pageId, {
  bodyMarkdown: '## Note\nIntegrator addendum…',
  mode: 'append', // required for integrator on tenant
})

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Loading documentation...

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Loading documentation...

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Loading documentation...

Documentation

Швидкий вхід (CTO · аудитори · агенти)

Loading documentation...

Loading documentation...

Loading documentation...

Адмінська Wiki

Чому це важливо для вашого клону

Консоль адміністратора

Owner Project Lab

Замовлення проєктів CRM

Related documentation

Admin console

Owner Project Lab

Ring MCP Server

News Module

Адмінська Wiki

Чому це важливо для вашого клону

Консоль адміністратора

Owner Project Lab

Замовлення проєктів CRM

Related documentation

Admin console

Owner Project Lab

Ring MCP Server

News Module

Адмінська Wiki

Чому це важливо для вашого клону

Консоль адміністратора

Owner Project Lab

Замовлення проєктів CRM

Related documentation

Admin console

Owner Project Lab

Ring MCP Server

News Module

Ring MCP

Знання агента Store

Типові сценарії

Чекліст оператора

Хто що може записувати

Wikilinks

Карта модулів

Інструменти ring-mcp

Застосуйте міграцію

Викликайте WikiService лише з адаптерів

Додавання замість заміни

Data Model

Ring File Cabinet

Multi-Vendor Store

Ring MCP

Знання агента Store

Типові сценарії

Чекліст оператора

Хто що може записувати

Wikilinks

Карта модулів

Інструменти ring-mcp

Застосуйте міграцію

Викликайте WikiService лише з адаптерів

Додавання замість заміни

Data Model

Ring File Cabinet

Multi-Vendor Store

Ring MCP

Знання агента Store

Типові сценарії

Чекліст оператора