💻 Разработчикам RU CMS

🧭 Коротко о системе

• Модульность (HMVC): функционал разделён на автономные модули без правок ядра.
• Шаблонность: витрина собирается из секций на Blade; темы меняются без переписывания логики.
• Децентрализация: модули приносят свои маршруты, миграции, политики, UI и админские экраны.
• Понятная база: минимум «магии», строгая валидация, чистые контроллеры/сервисы.

🧠 Стек и требования

• PHP 8.3+ / 8.4, Laravel 12.x
• БД: MySQL/MariaDB
• Фронтенд: Vite, Tailwind; шаблоны — Blade
• Очереди/кэш: Redis (по необходимости)
• Веб-сервер: nginx/Apache

🧩 Архитектура модулей

Каждый модуль автономен и располагается в /modules/<ModuleName>. Регистрация — через ServiceProvider и module.json.

modules/
└─ Blog/
   ├─ module.json
   ├─ Providers/BlogServiceProvider.php   ← регистрирует роуты/ресурсы
   ├─ Routes/web.php                      ← публичные/админ-маршруты
   ├─ Http/Controllers/{Frontend,Admin}/…
   ├─ Models/…                            ← Eloquent-модели
   ├─ Database/{migrations,seeders}/…
   └─ Resources/views/{frontend,admin}/*.blade.php

• Жизненный цикл: провайдер грузит роуты, миграции, вьюшки и публикуемые ассеты.
• Контракты: единые интерфейсы/события для интеграции между модулями.

🧱 Принципы разработки

• PSR-12, строгие типы, небольшие контроллеры; бизнес-логика — в сервисах/доменных классах.
• Серверная валидация FormRequest; читабельные сообщения об ошибках.
• Переиспользуемые Blade-компоненты и токены темы (радиусы, цвета, тени, интервалы).
• Документация модулей рядом с кодом (README, примеры вызовов, события/хуки).

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

• CSRF, XSS-санитайз, строгая проверка файлов (MIME/размеры), хранение в storage.
• Антиспам на формах: Cloudflare Turnstile, honeypot, проверка времени, throttle.
• Аутентификация/роли: доступ к админке по политике admin + аудит действий.
• Почта через очереди, защита от header-injection, логирование инцидентов.

⚡ Производительность

• Vite-сборка, критические стили, lazy-инициализация скриптов.
• Кэширование выборок, пагинации, компактные запросы.
• Грейсфул деградация: UI остаётся рабочим без JS на ключевых страницах.

⚙️ Быстрый старт (закрытая поставка)

1. Получите сборку у автора (исходники публично недоступны).
2. Создайте .env, выполните composer install и php artisan key:generate.
3. Запустите миграции php artisan migrate --force, при необходимости — сидеры.
4. Соберите фронт npm ci && npm run build, создайте симлинк php artisan storage:link.
5. Включите нужные модули и тему в админке, проверьте права/кэш.

Обновления поставляются пакетами от автора; ядро стабильно, модули версионируются семантически.

🤝 Как подключиться к разработке/доработкам

1. Заявка: опишите задачу (модуль/интеграция/тема), приложите макеты/примеры.
2. Согласование: оценка сроков и бюджета, поэтапный план, при необходимости — NDA.
3. Разработка: сборка на стейдже, тесты, демонстрация.
4. Поставка: деплой пакета/модуля и инструкция по обновлению.
5. Сопровождение: гарантийные фиксы, плановые апдейты.

Все доработки выполняются только по согласованию с автором проекта.