Raiju/AGENTS.md

Raiju CMS - Структура и Логика

Архитектура

Flat-file CMS без базы данных - всё хранится в JSON файлах:

• content/pages/*.json - страницы с секциями контента
• content/settings.json - глобальные настройки
• content/users.json - пользователи (multi-user система)
• content/events.json - события/мероприятия
• content/analytics.json - локальная аналитика

Структура директорий

• admin/ - админ-панель и API эндпоинты
• includes/ - хелперы (content-loader, footer, header, ai, backup)
• api/ - публичные API (контакт, лайки, поиск)
• cli/ - CLI инструменты для бэкапов и обслуживания
• assets/ - медиа файлы (images, audio, video, documents)
• css/ - стили (локальные, без CDN)
• content/ - JSON контент
• backups/ - ZIP бэкапы

Модель контента

Каждая страница - JSON с массивом sections[]:

• heading, text, image, quote, list, card
• youtube, soundcloud (embed)
• divider, spacer (layout blocks)

Рендеринг через PHP хелперы из includes/content-loader.php.

Пользователи

Multi-user система в users.json:

• id, username, passwordHash, role (admin/editor), email
• Аутентификация через admin/users.php
• Сессии с CSRF защитой в includes/session-helper.php

Настройки

settings.json содержит:

• branding (логотип, название)
• theme (цвета, шрифты)
• backup (удалённые цели, токены)
• modules (AI, новости, события)
• privacy (аналитика, email obfuscation)

Маршрутизация

.htaccess + route.php как front controller:

• Перенаправляет несуществующие файлы на route.php
• route.php загружает страницы по маппингу из nav-config.php
• Поддержка многоязычности (/en/, /de/ и т.д.)

Интеграции

• AI: OpenAI, Anthropic, KIE.ai, Fal.ai, Comet для чата и генерации изображений
• Бэкапы: Dropbox, Google Drive, OneDrive, S3, FTP, WebDAV
• Аналитика: полностью локальная, без внешних запросов
• Агент: AI-агент для контент-операций с sandboxed безопасностью

Безопасность

• CSRF токены для всех форм
• Password hash (bcrypt) для паролей
• Защита от SSRF в AI-агенте (raijuNetSafeFetch)
• Sanitization HTML для контента
• Dev login только с loopback

Что важно для сайта:

• JSON - источник истины для контента
• Не редактировать core файлы (admin/, includes/, css/) при адаптации сайта
• Использовать css/website.css для кастомных стилей
• $basePath для путей к ассетам
• $contentPage для admin bar

Система хорошо продумана для локального self-hosted использования без внешних зависимостей.