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.
См. также: лестница ролей и шаблоны конфиденциального доступа, ограничивающие видимость организаций.