Doc-Portal

Шаблон портала документации Reactive Engineering — назначение, состав и порядок работы.

Doc-Portal — шаблон для быстрого развертывания порталов документации Reactive Engineering. Из репозитория разворачивается готовый сайт: брендированный интерфейс, поиск, машиночитаемые представления страниц, CI и Docker-сборка. Остается наполнить его содержимым.

Что входит в шаблон

Быстрый старт

Требования, установка, структура репозитория и первый запуск.

Архитектура

Модель контента, конвейер сборки MDX, маршруты и слои конфигурации.

Руководства

Добавление продукта, раздела и страницы, настройка портала, публикация.

Бренд и стили

Палитра, градиент, типографика и ассеты Reactive Engineering.

Технологический стек

Слой	Решение
Фреймворк	Next.js 16, App Router, React 19
Движок документации	Fumadocs 16 (`fumadocs-core`, `fumadocs-mdx`, `@fumadocs/base-ui`)
Формат контента	MDX с поддержкой Mermaid
Стили	Tailwind CSS 4, брендовые токены Reactive Engineering
Шрифты	Nunito Sans (текст), Ubuntu (заголовки и выделения)
Сборка и публикация	Docker (standalone-режим Next.js), GitHub Actions, Dokploy

Принцип наполнения

Один продукт — один каталог верхнего уровня в content/docs/ с признаком "root": true. Такой каталог становится отдельным пунктом выпадающего списка над боковым меню, а его вложенные каталоги — разделами документации этого продукта.

content/docs/
├── meta.json              порядок продуктов
├── index.mdx              обзорная страница /docs
└── doc-portal/            продукт: "root": true → пункт дропдауна
    ├── meta.json
    ├── index.mdx
    ├── getting-started/   раздел
    ├── architecture/      раздел
    ├── how-to/            раздел
    └── brand-and-styles/  раздел

Источник правды

Репозиторная документация в каталоге docs/ и страницы этого раздела описывают одно и то же. При изменении шаблона обновляйте оба места — правило зафиксировано в AGENT.md.