Preparing Ring content
Preparing Ring content
Preparing Ring content
Організації (entities) це профілі організацій у центрі продуктового циклу Ring: знайдіть або створіть профіль, запросіть учасників, публікуйте можливості, за бажанням активуйте магазин і підтримуйте актуальність пошуку після кожної зміни.
Використовуйте вкладки Founder / Developer у бічній панелі документації, щоб фільтрувати цю сторінку. Видимість статей у бічній панелі керується lib/docs/audience-curated-docs.ts (Layer1); ця сторінка призначена для обох аудиторій.
Організації не є сторінкою бізнес-каталогу, доданою пізніше: це основний запис організації, до якого прив'язані можливості, магазини продавців, процедури верифікації та пошук через Tunnel.
| Аспект | Що постачає Ring |
|---|---|
| Галузевий каталог | Вертикальний пресет через ring-config entities.preset (platform = 26 типів; agricultural = альтернативний каталог) |
| Видимість | public · subscriber · member · confidential (+ прапорець isConfidential) |
| Верифікація | Статуси черги none → pending / under_review → verified / rejected через POST /api/entities/{id}/verify |
| Команда | Власник addedBy, members[] і збережені ролі запрошення в memberRoles (OWNER, ADMIN, MEMBER); запрошення за email наявного користувача |
| Гості | Відвідувачі можуть відкривати /entities і /entities/<id> без облікового запису й бачити публічні неконфіденційні профілі (з 2026-10-17) |
| Групи | Необов'язковий parentEntityId прив'язує філію до групової організації, а необов'язковий geo містить координати |
| Актуальність | syncEntityDiscovery(): теги кешу, revalidatePath, Tunnel entity:* |
| Рівень даних | PostgreSQL JSONB через DatabaseService; UI читає SerializedEntity (дати ISO) |
Вашим поселенцям і операторам потрібна надійна поверхня організації: хто ми, яку галузь заявляємо, хто нас бачить і як ми співпрацюємо. Організації дають кожній організації таку поверхню без окремої CRM.
Учасники створюють профілі на /entities/add; публічні й обмежені за роллю списки на /entities.
Вкладки /entities/my: All (власні), Store (власні + storeActivated), Member of.
Вакансії та партнерства прив'язуються до організації; верифікована присутність підвищує довіру під час підбору.
Ні. Активний каталог береться з entities.preset. Стандартний platform містить 26 id галузей (technologySoftware … other). agricultural підставляє вертикальний каталог для велнесу та ферм. Клони можуть накладати пресети через ringdom-clone-build.
Це власний граф організацій Ring для пошуку, можливостей, магазину й конфіденційних столів, а не продукт синхронізації з LinkedIn.
Так. Публічні неконфіденційні організації показуються й доступні для перегляду без входу. Усе інше, як і раніше, потребує облікового запису.
Автентифіковані користувачі з привілеями member (або адміністратор платформи / відповідність конфіденційної ролі). Конфіденційні організації потребують конфіденційного доступу (canCreateEntity).
DELETE /api/entities/{id} з JSON { "confirm": true } або UI видалення в /entities/[id]/delete. Без підтвердження повертається 400.
Вкладка Store показує лише організації, де addedBy === currentUser і storeActivated === true. Спершу активуйте магазин продавця.
Ні. requestEntityVerification відкриває або подає запис verification_procedures (entity_identity) і встановлює verificationStatus організації в pending. Перевірка це робочий процес операторів і адміністраторів.
Наступний крок: деталі контракту REST/MCP для тих самих маршрутів CRUD, запрошення, верифікації й аналітики.
Залежить від: як syncEntityDiscovery інвалідує кеші й публікує події Tunnel entity:*.
Той самий процес: можливості прив'язуються до організацій як organizationId, учасники публікують з контексту організації.
Наступний крок: активуйте storeActivated для організації та керуйте мультивендорним маркетплейсом.
Організації (entities) це профілі організацій у центрі продуктового циклу Ring: знайдіть або створіть профіль, запросіть учасників, публікуйте можливості, за бажанням активуйте магазин і підтримуйте актуальність пошуку після кожної зміни.
Використовуйте вкладки Founder / Developer у бічній панелі документації, щоб фільтрувати цю сторінку. Видимість статей у бічній панелі керується lib/docs/audience-curated-docs.ts (Layer1); ця сторінка призначена для обох аудиторій.
Організації не є сторінкою бізнес-каталогу, доданою пізніше: це основний запис організації, до якого прив'язані можливості, магазини продавців, процедури верифікації та пошук через Tunnel.
| Аспект | Що постачає Ring |
|---|---|
| Галузевий каталог | Вертикальний пресет через ring-config entities.preset (platform = 26 типів; agricultural = альтернативний каталог) |
| Видимість | public · subscriber · member · confidential (+ прапорець isConfidential) |
| Верифікація | Статуси черги none → pending / under_review → verified / rejected через POST /api/entities/{id}/verify |
| Команда | Власник addedBy, members[] і збережені ролі запрошення в memberRoles (OWNER, ADMIN, MEMBER); запрошення за email наявного користувача |
| Гості | Відвідувачі можуть відкривати /entities і /entities/<id> без облікового запису й бачити публічні неконфіденційні профілі (з 2026-10-17) |
| Групи | Необов'язковий parentEntityId прив'язує філію до групової організації, а необов'язковий geo містить координати |
| Актуальність | syncEntityDiscovery(): теги кешу, revalidatePath, Tunnel entity:* |
| Рівень даних | PostgreSQL JSONB через DatabaseService; UI читає SerializedEntity (дати ISO) |
Вашим поселенцям і операторам потрібна надійна поверхня організації: хто ми, яку галузь заявляємо, хто нас бачить і як ми співпрацюємо. Організації дають кожній організації таку поверхню без окремої CRM.
Учасники створюють профілі на /entities/add; публічні й обмежені за роллю списки на /entities.
Вкладки /entities/my: All (власні), Store (власні + storeActivated), Member of.
Вакансії та партнерства прив'язуються до організації; верифікована присутність підвищує довіру під час підбору.
Ні. Активний каталог береться з entities.preset. Стандартний platform містить 26 id галузей (technologySoftware … other). agricultural підставляє вертикальний каталог для велнесу та ферм. Клони можуть накладати пресети через ringdom-clone-build.
Це власний граф організацій Ring для пошуку, можливостей, магазину й конфіденційних столів, а не продукт синхронізації з LinkedIn.
Так. Публічні неконфіденційні організації показуються й доступні для перегляду без входу. Усе інше, як і раніше, потребує облікового запису.
Автентифіковані користувачі з привілеями member (або адміністратор платформи / відповідність конфіденційної ролі). Конфіденційні організації потребують конфіденційного доступу (canCreateEntity).
DELETE /api/entities/{id} з JSON { "confirm": true } або UI видалення в /entities/[id]/delete. Без підтвердження повертається 400.
Вкладка Store показує лише організації, де addedBy === currentUser і storeActivated === true. Спершу активуйте магазин продавця.
Ні. requestEntityVerification відкриває або подає запис verification_procedures (entity_identity) і встановлює verificationStatus організації в pending. Перевірка це робочий процес операторів і адміністраторів.
Наступний крок: деталі контракту REST/MCP для тих самих маршрутів CRUD, запрошення, верифікації й аналітики.
Залежить від: як syncEntityDiscovery інвалідує кеші й публікує події Tunnel entity:*.
Той самий процес: можливості прив'язуються до організацій як organizationId, учасники публікують з контексту організації.
Наступний крок: активуйте storeActivated для організації та керуйте мультивендорним маркетплейсом.
Організації (entities) це профілі організацій у центрі продуктового циклу Ring: знайдіть або створіть профіль, запросіть учасників, публікуйте можливості, за бажанням активуйте магазин і підтримуйте актуальність пошуку після кожної зміни.
Використовуйте вкладки Founder / Developer у бічній панелі документації, щоб фільтрувати цю сторінку. Видимість статей у бічній панелі керується lib/docs/audience-curated-docs.ts (Layer1); ця сторінка призначена для обох аудиторій.
Організації не є сторінкою бізнес-каталогу, доданою пізніше: це основний запис організації, до якого прив'язані можливості, магазини продавців, процедури верифікації та пошук через Tunnel.
| Аспект | Що постачає Ring |
|---|---|
| Галузевий каталог | Вертикальний пресет через ring-config entities.preset (platform = 26 типів; agricultural = альтернативний каталог) |
| Видимість | public · subscriber · member · confidential (+ прапорець isConfidential) |
| Верифікація | Статуси черги none → pending / under_review → verified / rejected через POST /api/entities/{id}/verify |
| Команда | Власник addedBy, members[] і збережені ролі запрошення в memberRoles (OWNER, ADMIN, MEMBER); запрошення за email наявного користувача |
| Гості | Відвідувачі можуть відкривати /entities і /entities/<id> без облікового запису й бачити публічні неконфіденційні профілі (з 2026-10-17) |
| Групи | Необов'язковий parentEntityId прив'язує філію до групової організації, а необов'язковий geo містить координати |
| Актуальність | syncEntityDiscovery(): теги кешу, revalidatePath, Tunnel entity:* |
| Рівень даних | PostgreSQL JSONB через DatabaseService; UI читає SerializedEntity (дати ISO) |
Вашим поселенцям і операторам потрібна надійна поверхня організації: хто ми, яку галузь заявляємо, хто нас бачить і як ми співпрацюємо. Організації дають кожній організації таку поверхню без окремої CRM.
Учасники створюють профілі на /entities/add; публічні й обмежені за роллю списки на /entities.
Вкладки /entities/my: All (власні), Store (власні + storeActivated), Member of.
Вакансії та партнерства прив'язуються до організації; верифікована присутність підвищує довіру під час підбору.
Ні. Активний каталог береться з entities.preset. Стандартний platform містить 26 id галузей (technologySoftware … other). agricultural підставляє вертикальний каталог для велнесу та ферм. Клони можуть накладати пресети через ringdom-clone-build.
Це власний граф організацій Ring для пошуку, можливостей, магазину й конфіденційних столів, а не продукт синхронізації з LinkedIn.
Так. Публічні неконфіденційні організації показуються й доступні для перегляду без входу. Усе інше, як і раніше, потребує облікового запису.
Автентифіковані користувачі з привілеями member (або адміністратор платформи / відповідність конфіденційної ролі). Конфіденційні організації потребують конфіденційного доступу (canCreateEntity).
DELETE /api/entities/{id} з JSON { "confirm": true } або UI видалення в /entities/[id]/delete. Без підтвердження повертається 400.
Вкладка Store показує лише організації, де addedBy === currentUser і storeActivated === true. Спершу активуйте магазин продавця.
Ні. requestEntityVerification відкриває або подає запис verification_procedures (entity_identity) і встановлює verificationStatus організації в pending. Перевірка це робочий процес операторів і адміністраторів.
Наступний крок: деталі контракту REST/MCP для тих самих маршрутів CRUD, запрошення, верифікації й аналітики.
Залежить від: як syncEntityDiscovery інвалідує кеші й публікує події Tunnel entity:*.
Той самий процес: можливості прив'язуються до організацій як organizationId, учасники публікують з контексту організації.
Наступний крок: активуйте storeActivated для організації та керуйте мультивендорним маркетплейсом.
Організація може стати продавцем; метрики магазину з'являються в аналітиці організації для власників і учасників.
visibility: confidential для закритої співпраці (/confidential/entities).entities.preset на agricultural (або пресет оверлею клону), щоб вибір галузі відповідав ніші замість 26 стандартних галузей платформи.Верифікація платформи це черга перевірки, а не маркетингова драбина значків. Власники й адміністратори запитують перевірку; персонал платформи вирішує через процедури верифікації (subjectType: entity_identity).
entities.preset клону в ring-config.json (оверлей empire org використовує platform).| Створення / оновлення / видалення |
features/entities/services/create-entity.ts, update-entity.ts, delete-entity.ts |
| Запрошення / верифікація / аналітика | invite-entity-member.ts, request-entity-verification.ts, get-entity-analytics.ts |
| Подання My Entities | features/entities/lib/my-entities-views.ts (all | store | member) |
| Server Actions | app/_actions/entities.ts |
| Перевірка власника | features/entities/lib/assert-entity-owner.ts (addedBy або адміністратор платформи) |
Оверлей empire (ring-platform-org) не форкає сервіси організацій у web/ для цієї функції: використовується Layer1; локалі й конфіг можуть накладатися через злиття.
| Маршрут | Призначення |
|---|---|
/[locale]/entities | Список для пошуку |
/[locale]/entities/add | Форма створення |
/[locale]/entities/my | Вкладки власні / магазин / учасник |
/[locale]/entities/[id] | Вітрина / деталі |
/[locale]/entities/[id]/edit | Редагування |
/[locale]/entities/[id]/delete | UI підтвердження видалення |
/[locale]/confidential/entities | Конфіденційний список |
/[locale]/entities/status/[action]/[status] | Сторінка статусу |
| Метод | Шлях | Примітки |
|---|---|---|
GET | /api/entities | Список / запит |
POST | /api/entities/create | Створення |
GET | /api/entities/{id} | Деталі |
PUT | /api/entities/{id} | Повне оновлення |
PATCH | /api/entities/{id} | Часткове (Zod entityPatchSchema) |
DELETE | /api/entities/{id} | Потрібне тіло { "confirm": true } |
POST | /api/entities/{id}/verify | Поставити в чергу верифікації |
POST | /api/entities/{id}/invite | Запросити наявного користувача за email |
GET | /api/entities/{id}/analytics | Власник / учасник / адміністратор платформи |
POST | /api/entities/upload | Автентифіковане завантаження медіа |
Дзеркала MCP: /api/mcp/v1/entities, /api/mcp/v1/entities/search, /api/mcp/v1/entities/{id}.
Фільтри пошуку використовують платформні ролі (visitor → admin). Конфіденційні рядки потребують hasConfidentialAccess. Встановлення visibility: confidential або isConfidential: true під час створення чи оновлення обмежене так само.
Автентифікуйтеся як користувач, якому дозволено створювати організації (canCreateEntity: member і вище; конфіденційне створення потребує конфіденційного доступу).
Викличте сервіс (або POST /api/entities/create). Обов'язкова структура зосереджена на name, type, описах, addedBy, locale, location, visibility, members, opportunities.
Після змін покладайтеся на syncEntityDiscovery; не вигадуйте окрему таблицю пошукового індексу, PostgreSQL JSONB є SSOT.
role запрошення (OWNER | ADMIN | MEMBER) тепер зберігається в memberRoles[userId], а також у members[]. assertEntityOwnerOrAdmin приймає addedBy, збережену роль OWNER або ADMIN чи адміністратора платформи. features/entities/lib/entity-roles.ts додає getEntityMemberRole, assertEntityRole і loadViewerEntityAccessIds, що також надає доступ до дочірніх організацій групи, до якої ви належите. Учасники, запрошені до цієї зміни, не мають збереженої ролі й вважаються MEMBER.
GET /api/entities і сторінка /entities визначають анонімних викликачів як роль visitor. getEntityById більше не кидає помилку для гостей на публічних рядках; непублічні рядки все ще потребують сесії. Створення організації гостем перенаправляє на вхід із callbackUrl назад на /entities/add.
GET /api/entities/{id}/analytics повертає EntityAnalytics: кількість учасників, довжину списку id можливостей, пов'язані можливості (кількість за organizationId), поля верифікації й модерації, необов'язкові storeMetrics / storeVerification і generatedAt.
Дивіться також: драбина ролей і шаблони конфіденційного доступу, що обмежують видимість організацій.
Організація може стати продавцем; метрики магазину з'являються в аналітиці організації для власників і учасників.
visibility: confidential для закритої співпраці (/confidential/entities).entities.preset на agricultural (або пресет оверлею клону), щоб вибір галузі відповідав ніші замість 26 стандартних галузей платформи.Верифікація платформи це черга перевірки, а не маркетингова драбина значків. Власники й адміністратори запитують перевірку; персонал платформи вирішує через процедури верифікації (subjectType: entity_identity).
entities.preset клону в ring-config.json (оверлей empire org використовує platform).| Створення / оновлення / видалення |
features/entities/services/create-entity.ts, update-entity.ts, delete-entity.ts |
| Запрошення / верифікація / аналітика | invite-entity-member.ts, request-entity-verification.ts, get-entity-analytics.ts |
| Подання My Entities | features/entities/lib/my-entities-views.ts (all | store | member) |
| Server Actions | app/_actions/entities.ts |
| Перевірка власника | features/entities/lib/assert-entity-owner.ts (addedBy або адміністратор платформи) |
Оверлей empire (ring-platform-org) не форкає сервіси організацій у web/ для цієї функції: використовується Layer1; локалі й конфіг можуть накладатися через злиття.
| Маршрут | Призначення |
|---|---|
/[locale]/entities | Список для пошуку |
/[locale]/entities/add | Форма створення |
/[locale]/entities/my | Вкладки власні / магазин / учасник |
/[locale]/entities/[id] | Вітрина / деталі |
/[locale]/entities/[id]/edit | Редагування |
/[locale]/entities/[id]/delete | UI підтвердження видалення |
/[locale]/confidential/entities | Конфіденційний список |
/[locale]/entities/status/[action]/[status] | Сторінка статусу |
| Метод | Шлях | Примітки |
|---|---|---|
GET | /api/entities | Список / запит |
POST | /api/entities/create | Створення |
GET | /api/entities/{id} | Деталі |
PUT | /api/entities/{id} | Повне оновлення |
PATCH | /api/entities/{id} | Часткове (Zod entityPatchSchema) |
DELETE | /api/entities/{id} | Потрібне тіло { "confirm": true } |
POST | /api/entities/{id}/verify | Поставити в чергу верифікації |
POST | /api/entities/{id}/invite | Запросити наявного користувача за email |
GET | /api/entities/{id}/analytics | Власник / учасник / адміністратор платформи |
POST | /api/entities/upload | Автентифіковане завантаження медіа |
Дзеркала MCP: /api/mcp/v1/entities, /api/mcp/v1/entities/search, /api/mcp/v1/entities/{id}.
Фільтри пошуку використовують платформні ролі (visitor → admin). Конфіденційні рядки потребують hasConfidentialAccess. Встановлення visibility: confidential або isConfidential: true під час створення чи оновлення обмежене так само.
Автентифікуйтеся як користувач, якому дозволено створювати організації (canCreateEntity: member і вище; конфіденційне створення потребує конфіденційного доступу).
Викличте сервіс (або POST /api/entities/create). Обов'язкова структура зосереджена на name, type, описах, addedBy, locale, location, visibility, members, opportunities.
Після змін покладайтеся на syncEntityDiscovery; не вигадуйте окрему таблицю пошукового індексу, PostgreSQL JSONB є SSOT.
role запрошення (OWNER | ADMIN | MEMBER) тепер зберігається в memberRoles[userId], а також у members[]. assertEntityOwnerOrAdmin приймає addedBy, збережену роль OWNER або ADMIN чи адміністратора платформи. features/entities/lib/entity-roles.ts додає getEntityMemberRole, assertEntityRole і loadViewerEntityAccessIds, що також надає доступ до дочірніх організацій групи, до якої ви належите. Учасники, запрошені до цієї зміни, не мають збереженої ролі й вважаються MEMBER.
GET /api/entities і сторінка /entities визначають анонімних викликачів як роль visitor. getEntityById більше не кидає помилку для гостей на публічних рядках; непублічні рядки все ще потребують сесії. Створення організації гостем перенаправляє на вхід із callbackUrl назад на /entities/add.
GET /api/entities/{id}/analytics повертає EntityAnalytics: кількість учасників, довжину списку id можливостей, пов'язані можливості (кількість за organizationId), поля верифікації й модерації, необов'язкові storeMetrics / storeVerification і generatedAt.
Дивіться також: драбина ролей і шаблони конфіденційного доступу, що обмежують видимість організацій.
Організація може стати продавцем; метрики магазину з'являються в аналітиці організації для власників і учасників.
visibility: confidential для закритої співпраці (/confidential/entities).entities.preset на agricultural (або пресет оверлею клону), щоб вибір галузі відповідав ніші замість 26 стандартних галузей платформи.Верифікація платформи це черга перевірки, а не маркетингова драбина значків. Власники й адміністратори запитують перевірку; персонал платформи вирішує через процедури верифікації (subjectType: entity_identity).
entities.preset клону в ring-config.json (оверлей empire org використовує platform).| Створення / оновлення / видалення |
features/entities/services/create-entity.ts, update-entity.ts, delete-entity.ts |
| Запрошення / верифікація / аналітика | invite-entity-member.ts, request-entity-verification.ts, get-entity-analytics.ts |
| Подання My Entities | features/entities/lib/my-entities-views.ts (all | store | member) |
| Server Actions | app/_actions/entities.ts |
| Перевірка власника | features/entities/lib/assert-entity-owner.ts (addedBy або адміністратор платформи) |
Оверлей empire (ring-platform-org) не форкає сервіси організацій у web/ для цієї функції: використовується Layer1; локалі й конфіг можуть накладатися через злиття.
| Маршрут | Призначення |
|---|---|
/[locale]/entities | Список для пошуку |
/[locale]/entities/add | Форма створення |
/[locale]/entities/my | Вкладки власні / магазин / учасник |
/[locale]/entities/[id] | Вітрина / деталі |
/[locale]/entities/[id]/edit | Редагування |
/[locale]/entities/[id]/delete | UI підтвердження видалення |
/[locale]/confidential/entities | Конфіденційний список |
/[locale]/entities/status/[action]/[status] | Сторінка статусу |
| Метод | Шлях | Примітки |
|---|---|---|
GET | /api/entities | Список / запит |
POST | /api/entities/create | Створення |
GET | /api/entities/{id} | Деталі |
PUT | /api/entities/{id} | Повне оновлення |
PATCH | /api/entities/{id} | Часткове (Zod entityPatchSchema) |
DELETE | /api/entities/{id} | Потрібне тіло { "confirm": true } |
POST | /api/entities/{id}/verify | Поставити в чергу верифікації |
POST | /api/entities/{id}/invite | Запросити наявного користувача за email |
GET | /api/entities/{id}/analytics | Власник / учасник / адміністратор платформи |
POST | /api/entities/upload | Автентифіковане завантаження медіа |
Дзеркала MCP: /api/mcp/v1/entities, /api/mcp/v1/entities/search, /api/mcp/v1/entities/{id}.
Фільтри пошуку використовують платформні ролі (visitor → admin). Конфіденційні рядки потребують hasConfidentialAccess. Встановлення visibility: confidential або isConfidential: true під час створення чи оновлення обмежене так само.
Автентифікуйтеся як користувач, якому дозволено створювати організації (canCreateEntity: member і вище; конфіденційне створення потребує конфіденційного доступу).
Викличте сервіс (або POST /api/entities/create). Обов'язкова структура зосереджена на name, type, описах, addedBy, locale, location, visibility, members, opportunities.
Після змін покладайтеся на syncEntityDiscovery; не вигадуйте окрему таблицю пошукового індексу, PostgreSQL JSONB є SSOT.
role запрошення (OWNER | ADMIN | MEMBER) тепер зберігається в memberRoles[userId], а також у members[]. assertEntityOwnerOrAdmin приймає addedBy, збережену роль OWNER або ADMIN чи адміністратора платформи. features/entities/lib/entity-roles.ts додає getEntityMemberRole, assertEntityRole і loadViewerEntityAccessIds, що також надає доступ до дочірніх організацій групи, до якої ви належите. Учасники, запрошені до цієї зміни, не мають збереженої ролі й вважаються MEMBER.
GET /api/entities і сторінка /entities визначають анонімних викликачів як роль visitor. getEntityById більше не кидає помилку для гостей на публічних рядках; непублічні рядки все ще потребують сесії. Створення організації гостем перенаправляє на вхід із callbackUrl назад на /entities/add.
GET /api/entities/{id}/analytics повертає EntityAnalytics: кількість учасників, довжину списку id можливостей, пов'язані можливості (кількість за organizationId), поля верифікації й модерації, необов'язкові storeMetrics / storeVerification і generatedAt.
Дивіться також: драбина ролей і шаблони конфіденційного доступу, що обмежують видимість організацій.