Адмінська Wiki

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

Адмінська Wiki

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

Адмінська Wiki

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

Ring MCP

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

1. Плейбук платформи — адміністратори зберігають tenant-сторінки про те, “як ми ringize-мо”, платіжні рейки та макроси підтримки.
2. Мозок окремого замовлення — покупець та інтегратор спільно використовують сховище po:{orderId} для рішень цього клону (без секретів — вони залишаються в #secrets Order Lab).
3. Імпорт агентом — ring-mcp створює/оновлює концептуальні сторінки, додає операційні події та перевіряє недійсні [[wikilinks]].
4. Продуктовий NODUS зі Store Research — Agent Knowledge → Research від Vendor/admin записує tenant wiki-сторінку (Product NODUS — {name}) і зберігає productNodusWiki у продукті — повний NODUS JSON у сховищі, короткий опис Markdown у продукті. Див. Multi-Vendor Store.
5. Посилання між сховищами — із проєктної сторінки посилайтеся на поняття платформи через [[@Payments]] або [[tenant:Payments]].

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

• Відкрийте /admin/wiki як адміністратор платформи; переконайтеся, що _schema створено (заголовок розташований у правій панелі).
• Використовуйте Actions правої панелі: CRM project orders, News, CRM tasks, Wiki docs.
• Створіть шлях папки (наприклад, concepts), задавши path для нових сторінок — папки є префіксами шляхів, а не порожніми документами.
• Використовуйте [[Page]] для посилань у тому самому сховищі; [[@Title]] — щоб цитувати tenant-знання з проєктного сховища.
• На /my-orders/[id] або /my-jobs/[id] використовуйте Project Wiki лише для цього замовлення.
• Ніколи не вставляйте ключі Firebase або токени RingBase у тіла wiki-сторінок.

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

Wikilinks

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

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

1. 1

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

   bash

   
   psql "$DATABASE_URL" -f data/migrations/040_wiki_pages.sql

   Також присутня в data/schema.sql для чистих інсталяцій. Окремі env-змінні для wiki не потрібні, окрім наявних Postgres DATABASE_URL / токена сервісу MCP.

2. 2

   Викликайте 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.

3. 3

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

   typescript

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

Поглиблення: шаблон колекцій JSONB (`id` + `data`), який використовують wiki_pages та споріднені таблиці.

Ring MCP

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

1. Плейбук платформи — адміністратори зберігають tenant-сторінки про те, “як ми ringize-мо”, платіжні рейки та макроси підтримки.
2. Мозок окремого замовлення — покупець та інтегратор спільно використовують сховище po:{orderId} для рішень цього клону (без секретів — вони залишаються в #secrets Order Lab).
3. Імпорт агентом — ring-mcp створює/оновлює концептуальні сторінки, додає операційні події та перевіряє недійсні [[wikilinks]].
4. Продуктовий NODUS зі Store Research — Agent Knowledge → Research від Vendor/admin записує tenant wiki-сторінку (Product NODUS — {name}) і зберігає productNodusWiki у продукті — повний NODUS JSON у сховищі, короткий опис Markdown у продукті. Див. Multi-Vendor Store.
5. Посилання між сховищами — із проєктної сторінки посилайтеся на поняття платформи через [[@Payments]] або [[tenant:Payments]].

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

• Відкрийте /admin/wiki як адміністратор платформи; переконайтеся, що _schema створено (заголовок розташований у правій панелі).
• Використовуйте Actions правої панелі: CRM project orders, News, CRM tasks, Wiki docs.
• Створіть шлях папки (наприклад, concepts), задавши path для нових сторінок — папки є префіксами шляхів, а не порожніми документами.
• Використовуйте [[Page]] для посилань у тому самому сховищі; [[@Title]] — щоб цитувати tenant-знання з проєктного сховища.
• На /my-orders/[id] або /my-jobs/[id] використовуйте Project Wiki лише для цього замовлення.
• Ніколи не вставляйте ключі Firebase або токени RingBase у тіла wiki-сторінок.

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

Wikilinks

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

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

1. 1

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

   bash

   
   psql "$DATABASE_URL" -f data/migrations/040_wiki_pages.sql

   Також присутня в data/schema.sql для чистих інсталяцій. Окремі env-змінні для wiki не потрібні, окрім наявних Postgres DATABASE_URL / токена сервісу MCP.

2. 2

   Викликайте 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.

3. 3

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

   typescript

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

Поглиблення: шаблон колекцій JSONB (`id` + `data`), який використовують wiki_pages та споріднені таблиці.

Ring MCP

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

1. Плейбук платформи — адміністратори зберігають tenant-сторінки про те, “як ми ringize-мо”, платіжні рейки та макроси підтримки.
2. Мозок окремого замовлення — покупець та інтегратор спільно використовують сховище po:{orderId} для рішень цього клону (без секретів — вони залишаються в #secrets Order Lab).
3. Імпорт агентом — ring-mcp створює/оновлює концептуальні сторінки, додає операційні події та перевіряє недійсні [[wikilinks]].
4. Продуктовий NODUS зі Store Research — Agent Knowledge → Research від Vendor/admin записує tenant wiki-сторінку (Product NODUS — {name}) і зберігає productNodusWiki у продукті — повний NODUS JSON у сховищі, короткий опис Markdown у продукті. Див. Multi-Vendor Store.
5. Посилання між сховищами — із проєктної сторінки посилайтеся на поняття платформи через [[@Payments]] або [[tenant:Payments]].

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

• Відкрийте /admin/wiki як адміністратор платформи; переконайтеся, що _schema створено (заголовок розташований у правій панелі).
• Використовуйте Actions правої панелі: CRM project orders, News, CRM tasks, Wiki docs.
• Створіть шлях папки (наприклад, concepts), задавши path для нових сторінок — папки є префіксами шляхів, а не порожніми документами.
• Використовуйте [[Page]] для посилань у тому самому сховищі; [[@Title]] — щоб цитувати tenant-знання з проєктного сховища.
• На /my-orders/[id] або /my-jobs/[id] використовуйте Project Wiki лише для цього замовлення.
• Ніколи не вставляйте ключі Firebase або токени RingBase у тіла wiki-сторінок.

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

Wikilinks

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

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

1. 1

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

   bash

   
   psql "$DATABASE_URL" -f data/migrations/040_wiki_pages.sql

   Також присутня в data/schema.sql для чистих інсталяцій. Окремі env-змінні для wiki не потрібні, окрім наявних Postgres DATABASE_URL / токена сервісу MCP.

2. 2

   Викликайте 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.

3. 3

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

   typescript

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

Поглиблення: шаблон колекцій JSONB (`id` + `data`), який використовують wiki_pages та споріднені таблиці.