Документация
Введение
Genesis Construction CMS — self-hosted Enterprise CMS на PHP/MySQL для строительных компаний, генподрядчиков, архитектурных студий и компаний по реновации. Объединяет корпоративный сайт, клиентскую CRM, строительные объекты, проекты, сметы, этапы работ, ассистента IuVeAI, аналитику и управление компанией. Разворачивается на инфраструктуре заказчика; IuVe Marketplace — источник истины по лицензиям.
Возможности
Полностью реализовано: Dashboard, клиентская CRM, строительные объекты, проекты, этапы проектов, каталог услуг, сметы, портфолио, документы, Website Builder, Brand & Design, AI Construction Center, ассистент IuVeAI, аналитика сайта, контакты, партнёры, виджеты и коды, переводы, Marketplace Pairing, IuVe Identity, Update Center, Users & Security, Cron, Security Center.
Архитектура
Genesis Core → Security → IuVe Identity → Marketplace Pairing → Update Center → IuVeAI → Construction CRM → Construction Objects → Projects → Project Stages → Estimate Manager → Portfolio → Website.
Установка
Требования: PHP 8.1/8.2/8.3 (PDO, PDO MySQL, OpenSSL, JSON, cURL, mbstring, fileinfo), Apache или Nginx, MySQL 8+ / MariaDB 10.4+, HTTPS. Установщик проверяет окружение, создаёт схему БД, пользователя Owner, runtime-конфиг и installed.lock.
Dashboard
Показывает новые заявки, активные проекты, объекты, сметы, просроченные этапы, последние отзывы и обращения, состояние системы, Marketplace, IuVeAI, PHP и базу данных.
Заявки на услуги
Полный CRUD: клиент, телефон, email, объект, площадь, адрес, бюджет, описание, статус, менеджер.
Клиенты
Полный CRUD по клиентам. Поддерживаются физические и юридические лица.
Проекты
Полный CRUD: номер, заказчик, объект, статус, бюджет, сроки, ответственный, фото, документы.
Сметы
Смета включает проект, позиции работ, материалы, затраты и итоговую сумму.
Портфолио
Карточка: фото, описание, таймлайн, площадь, выполненные работы, отзыв клиента.
Документы
Хранение договоров, проектных файлов, актов, сертификатов, чертежей и PDF.
CRM
Управляет клиентами, объектами, заявками, проектами, сметами и документами.
Аналитика
Аналитика сайта, строительная аналитика, аналитика проектов, лидов, экспорт CSV.
Сайт
Публичный сайт из CMS: Hero, услуги, проекты, портфолио, отзывы, контакты, формы заявок.
Маркетинг
Telegram, Email, уведомления, кампании.
Контакты
Телефоны, email, карта, часы работы, мессенджеры.
Партнёры
Логотипы и ссылки партнёров.
Виджеты и коды
Слоты HEAD, BODY, Footer, аналитика, сторонние скрипты.
Переводы
Полная многоязычность: RU, RO, EN, DE, FR, UA.
Cron
Уведомления, обновления, задачи AI, аналитика.
Бэкап
Перед обновлениями сохраняйте БД, config, uploads и installed.lock.
Восстановление
Восстановите БД, файлы, лицензию и ключ AI.
API
Публичные API: /api/ai-chat.php, /api/request.php, /api/analytics-track.php, /api/system/about.php. JSON-ответы в UTF-8.
Интеграции
IuVeAI, Marketplace, IuVe Identity, Telegram Bot API.
Производительность
Рекомендуется: OPcache, HTTPS, CDN, PHP 8.3.
Безопасность
password_hash(), CSRF, журнал аудита, защита загрузок, подписанные обновления, маскирование секретов.
Частые вопросы
Активация лицензии через Marketplace Pairing. AI через kai_live_*. Перенос сайта — после перепривязки лицензии.
Диагностика проблем
Ошибки установки: проверьте PHP, БД, storage, uploads. Ошибки лицензии: mp_live_* и домен. Ошибки AI: kai_live_*, HTTPS, доступ к https://www.iuve.eu/api.
Дорожная карта
v1.1: строительный калькулятор, таймлайн, менеджер материалов, менеджер поставщиков. v1.2: склад, сотрудники, техника, договоры. v1.3: Гант, мобильный Dashboard, AI Vision, строительные отчёты. v2.0: Enterprise ERP, мультикопания, мультифилиальность, складской AI, предиктивная аналитика, цифровые двойники объектов.
AI-ассистент
/api/ai-chat.php через IuVeAI с контекстом строительной компании. Требуется HTTPS.
AI Construction Center
AI использует kai_live_*. Консультации клиентов, черновики статей, написание SEO, генерация описаний услуг, помощь менеджерам, создание FAQ.
Бренд и дизайн
Логотип, цвета, favicon, SEO, Hero, контакты, изображения.
Строительные объекты
Карточка объекта: адрес, площадь, тип, этажи, описание, фото, документы, связанные проекты.
Первоначальная настройка
После установки: загрузите логотип; настройте бренд; заполните контакты; добавьте услуги и категории; добавьте персонал; создайте первый строительный объект; создайте первый проект; настройте AI.
IuVe Identity
Вход по OIDC. Поддержка единого входа.
Активация лицензии
Ключи лицензии в формате mp_live_* из Marketplace (Мои покупки). Активация создаёт защищённый паринг между Marketplace и CMS. AI использует отдельный ключ kai_live_*.
Marketplace Pairing
Использует mp_live_*. Проверяет лицензию, домен и entitlement.
Медиатека
Единый файловый менеджер. Поддержка JPG, PNG, WEBP, SVG, PDF. Используется во всех модулях CMS.
Этапы проектов
Этапы: подготовка, демонтаж, фундамент, коробка, кровля, инженерные сети, отделка, благоустройство, сдача.
Быстрый старт
1) Создайте пустую базу MySQL/MariaDB. 2) Загрузите пакет CMS. 3) Откройте /install.php. 4) Введите код покупки (mp_live_*). 5) Создайте аккаунт Owner. 6) Войдите в /admin. 7) Активируйте паринг Marketplace. 8) Сохраните ключ IuVeAI (kai_live_*). 9) Добавьте первую услугу. 10) Создайте первый проект.
Security Center
Проверки HTTPS, PHP, базы данных, загрузок, сессий, CSRF, журнала аудита.
Категории услуг
Полный CRUD по категориям строительных услуг.
Каталог услуг
Каждая услуга: название, описание, цена, длительность, фото, SEO, FAQ.
Update Center
Подписанные обновления. Проверка манифеста, подписи, SHA-256 и версии.
Пользователи и безопасность
CRUD пользователей. Роли: Owner, Admin, Manager, Editor, Viewer.
