> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Управление контентом Типизированные CMS-записи со свободным жизненным циклом и публичной границей чтения. ## Прохождение для начинающих Предварительные требования: прочтите два приведенных ниже руководства для начинающих, завершите локальную веб-настройку и откройте этот монорепозиторий в корневой папке вашего редактора. Веб-настройки принадлежат `apps/web/.env.local`; Next.js не читает корень `.env`. `/dashboard` в поддельном режиме по умолчанию представляет собой демонстрацию без базы данных; `/auth` требуется перенесенная база данных. Вкратце: рабочее пространство — это отдельные пользователи, данные и настройки одной команды. Сервер является доверенным сервером; не допускайте попадания ключей провайдера в код браузера и телефона. Миграция — это изменение версии базы данных, при котором создаются или обновляются таблицы. Модель ИИ — это механизм, который отвечает; Каталог моделей — это список доступных идентификаторов моделей и цен на сервере. Поставщик — это внешняя служба, такая как служба искусственного интеллекта, электронной почты или службы выставления счетов. Право — это грант, который позволяет рабочей области использовать функцию. Вебхук — это сообщение, которое одна служба отправляет на URL другой службы. 1. Войдите в систему как владелец или администратор рабочей области, откройте `/content` и используйте форму для создания публикации, страницы, документа или отчета с уникальным ярлыком. Сохраните его как черновик, а затем опубликуйте. 2. Подтвердите изменение статуса на «Опубликовано»; дубликат пула или члена без доступа к управлению должен привести к сбою. 3. Для закрытого теста используйте `required_entitlement=ai.reference-task`; без подтвержденного разрешения на странице должен отображаться только тизер. Для пользовательского кода начните с предоставленного `prompts/README.md` и скопируйте ближайшее приглашение: `prompts/new-app-screen.md` для экрана приложения или `prompts/new-landing-page.md` для общедоступной страницы. Для работы с сервером, базой данных или провайдером дайте своему агенту кодирования задание из этого руководства и попросите его прочитать `AGENTS.md`, `.ai/PROJECT_CONTEXT.md` и соответствующие зеркала `.ai/`; проверьте точные исходные файлы, указанные здесь; список файлов и проверки перед редактированием; сохранять права собственности на рабочую область и секреты, доступные только серверу; и покажу вам разницу. Сообщите ему желаемое поведение, поля ввода и вывода, разрешенные роли, ожидаемые успехи и ошибки, а также тестовую учетную запись, поставщика или устройство. Используйте выборочные значения; никогда не вставляйте настоящий секрет. [Прежде чем начать](https://supastack.dev/ru/docs/web/before-you-start.md) [Основные сведения о терминале](https://supastack.dev/ru/docs/web/terminal-basics.md) [Локальная веб-настройка](https://supastack.dev/ru/docs/web/ship-in-5-minutes.md) [Подсказки агента и память проекта](https://supastack.dev/ru/docs/web/agents.md) ## Создание записей рабочей области Менеджер `/content` обрабатывает записи `post`, `page`, `doc` и `report`. Строки `content_entry` имеют состояние черновик/опубликовано/архив, фрагменты рабочей области и авторство. Для действий управления требуется соответствующая роль владельца/администратора. Этот CMS отделен от общедоступного каталога docs/blog комплекта в `src/resources`. Продукт может отображать записи CMS посредством собственной композиции страницы. ## Гейт тела на сервере `required_entitlement` имеет значение NULL: неустановленные записи не регулируются. Для закрытых записей `content-queries.ts`, предназначенный только для сервера, проецирует читаемый контент или заблокированный тизер с пустым телом. `content-access.ts` владеет проекцией; никогда не доверяйте заявлениям о предоставлении прав, предоставленным клиентом. Публикация выдает `content.published`; запланированные дайджесты могут суммировать последние записи издательской группы. Авторский контент также участвует в экспорте аккаунта. ## Проверка публикации и доступа Проверьте видимость черновиков, переходы публикации/архивирования, дублирующиеся фрагменты, неправильное рабочее пространство, бесплатные записи и неактивные платные гранты. Используйте блок платного доступа для представления, в то время как сервер остается ответственным за доступ. [Учебное пособие по платному контенту](https://supastack.dev/ru/docs/web/setup-ai.md) [Дайджесты контента](https://supastack.dev/ru/docs/web/project-structure.md) [Презентация платного доступа](https://supastack.dev/ru/docs/web/project-structure.md) ## Настройка и конфигурация Поверхность /content управляет CMS-записями рабочего пространства — post, page и doc это предлагаемые типы, но колонка принимает любой URL-безопасный тип продукта (строчные буквы, цифры, дефисы, подчёркивания, до 64 символов). Таблица content_entry ограничивает каждую строку по workspaceId, проставляет createdBy и держит slug уникальными в пределах workspace и типа. Записи движутся по свободному жизненному циклу draft ↔ published ↔ archived — evaluateContentStatusChange в src/content.ts отклоняет недопустимые или неизменённые переходы, а publishedAt проставляется при первой публикации и переживает последующие снятия с публикации, так что читатели сохраняют исходную дату. ``` /content workspace CMS surface src/content.ts input + lifecycle rules src/content-actions.ts member+ mutations content_entry workspaceId, type, slug, status ``` ## Рабочий процесс внедрения Участники и выше создают записи — каждая мутация разрешает сессию, активный workspace и как минимум роль member через requireWorkspaceWriter (workspace-access.ts), поэтому гости остаются read-only. normalizeContentEntryInput проверяет тип, заголовок 1–255 символов и URL-безопасный slug до любой записи. listPublishedContentEntries — осознанная публичная граница чтения: принимает явный workspaceId, не требует сессии и возвращает только опубликованные строки — путь, которым витринные страницы, блоги и документация рендерят контент workspace. Публикация испускает исходящий вебхук content.published, а созданные записи попадают в GDPR-экспорт данных. ## Проверка и устранение неполадок Прогоните полный цикл draft → publish → archive, дублирующийся slug внутри одного типа и кросс-workspace чтение. Убедитесь, что публичная граница никогда не возвращает черновики или строки другого workspace, и что content.published срабатывает один раз на действие публикации. ## Вперёд [Коммерция](https://supastack.dev/ru/docs/web/commerce.md)