💻 RU CMS для разработчиков

1. Ключевые преимущества

• Модульность (HMVC) — функциональные блоки независимы: подключайте/отключайте без правок ядра.
• Шаблонность — темы и секции на Blade; быстро меняем витрину без переписывания бэка.
• Децентрализация — нет «жёсткой монолитной админки»: модули приносят свои маршруты, виды, миграции и политики.
• Понятный код — чистая архитектура Laravel, минимум «магии», строгая валидация и типы.
• Безопасность — CSRF, строгая серверная валидация, капчи Turnstile, honeypot, rate-limit, очереди писем.
• Скорость — Vite, кэширование, пагинации, ленивые компоненты, минимальная нагрузка на DOM.
• Открытая к расширению — события/хуки, слоты шаблонов и стандартизированный каркас модуля.
• Поддержка автором — исходники недоступны публично; любые доработки — по согласованию с разработчиком.

2. Стек и системные требования

• PHP 8.4+, расширения: mbstring, openssl, pdo, json, fileinfo.
• СУБД: MySQL/MariaDB
• Node.js (Vite/Tailwind) и Composer.
• Веб-сервер nginx/Apache; очереди (redis) — по необходимости.

3. Архитектура HMVC

Каждый функциональный блок — автономный модуль в modules/ со своими провайдерами, роутами, контроллерами, миграциями, моделями и Blade-видами.

modules/
└─ Blog/
   ├─ module.json
   ├─ Providers/BlogServiceProvider.php
   ├─ Routes/web.php
   ├─ Http/Controllers/Frontend/PostController.php
   ├─ Http/Controllers/Admin/PostController.php
   ├─ Models/Post.php
   └─ Resources/views/{frontend,admin}/*.blade.php

4. Модули и расширение

• Регистрация: module.json + ServiceProvider (подключает роуты, миграции, ресурсы).
• Валидация: FormRequest с сообщениями на русском и проверками бизнес-логики.
• Слоты/хуки: секции фронтенда имеют слоты для вставки виджетов (например, баннеры/ленты).
• Медиа: загрузки через файловый модуль; публичная раздача — storage:link.
• Переносимость: модуль можно упаковать архивом и разворачивать на другом проекте без конфликта с ядром.

5. Шаблоны, темы и токены UI

• Темизация через CSS-переменные: --color-primary, --radius, --bg, --fg и др.
• Секции главной — в resources/views/frontend/templates/*; можно переименовать ленты («Новости → Наши работы») и собрать витрину из блоков.
• Иконки через вспомогатель (lucide/tabler/и пр.).

6. Контент-редактор TinyMCE 7

• Комфортная верстка контента: заголовки, таблицы, галереи, вставки видео.
• Очистка HTML при превью на фронте: Str::limit(strip_tags(...)).
• Автоматическое определение обложек/видео в лентах (регулярные выражения).

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

• CSRF, строгая серверная валидация, email:rfc,dns, нормализация входных данных.
• Антиспам: Turnstile, honeypot, проверка времени заполнения, throttle на маршрутах.
• Очереди почты и логирование событий.
• Права доступа к админке: auth + политика «admin».
• Файлы: валидация mime/размеров, хранение в storage.

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

• Сборка фронта Vite, критические стили, ленивые части UI.
• Кэширование выборок, пагинация, компактные запросы Eloquent.
• Минимум JS в публичных страницах; graceful degradation при отключенном JS.

9. Развёртывание и обновления

Исходный код в открытом доступе отсутствует. Готовая сборка и инструкции выдаются автором после согласования.

# Базовые шаги (поставляются вместе со сборкой)
composer install
cp .env.example .env && php artisan key:generate
php artisan migrate --force
php artisan storage:link
npm ci && npm run build
php artisan optimize:clear

• Обновления ставятся пакетами от автора; ядро остаётся стабильным, изменяются только версии модулей/тем.
• Совместимость: следуем семантическому версионированию; критические изменения документируются.

10. Рабочий процесс и доработки

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

11. Контакты и поддержка

• Разработчик: Булавацкий Д.О.
• E-mail: visitorsec@internet.ru
• Телефон: +7 925 652 06 39
• График: будни 09:00–17:00 (Московская область, г. Королёв)