Движок для тематической энциклопедии, справочника или базы знаний, которую пишет редакция. Статьи связаны ссылками, у каждой есть источники с лицензиями и история правок. Новые материалы и правки проходят очередь проверки: рецензент решает, что попадёт на сайт. Парсеры собирают материалы из разрешённых источников, ИИ-помощники предлагают тексты и правки, реклама и счётчики включаются после согласия посетителя. Основной сайт работает без ключей и сетей: парсеры, ИИ и реклама включаются вашей настройкой.
Сайт для посетителей
- Главная. Статья дня, свежие правки, разделы, поиск. Статья дня выбирается вручную или по расписанию, прошлые лежат в архиве.
- Статья. Оглавление, карточка справа по шаблону, сноски, список источников с лицензией, «Что ссылается сюда», «См. также», печатная версия без меню и рекламы.
- Ссылки между статьями. Запись `[[Название]]` превращается в ссылку, а если статьи нет, ссылка красная и подсказывает, что написать дальше.
- История и сравнение. Каждая правка хранится версией, две версии сравниваются построчно, откат создаёт новую версию.
- Поиск. Полнотекстовый поиск MariaDB с подсказками по заголовкам, фильтрами по категории и типу, работает и без JavaScript.
- Категории, теги, лента изменений, случайная статья, обсуждения с модерацией. Читатели входят через `/login`.
- SEO. Мета-теги, Open Graph, JSON-LD, canonical, sitemap.xml, robots.txt, переадресация при смене адреса статьи.
- Места под изображения. Вместо фотографий стоит блок «Здесь будет изображение», пока вы не загрузили свои.
- Тёмная тема переключается у посетителя, файловый кеш ускоряет страницы и сбрасывается при правках.
Парсеры
Источники: RSS и Atom, XML sitemap, список адресов, JSON API, загруженный файл (CSV, JSON, Markdown). Правила извлечения на CSS, XPath и JSONPath с кнопкой «Проверить правило». Лицензия источника обязательна; режим «только разрешённые» принимает собственные материалы, общественное достояние, CC0, CC BY и CC BY-SA и только с указанных доменов. Запросы идут по https на публичные адреса, соблюдают `robots.txt`, паузы и лимиты размера и времени. Пробный запуск ничего не записывает. Найденное попадает в очередь проверки вместе с источником и лицензией, автоматической публикации нет. Запуск по расписанию: `php bin/psy parsers:run --due`.
ИИ-помощники в админке
Три роли включаются по отдельности: «Автор» пишет материал по теме, плану и загруженным источникам, «Редактор» вычитывает, упрощает, сокращает и предлагает категории и ссылки, «Модератор» проверяет спам, правила, разметку и источники. Провайдеры: Gemini, Anthropic, OpenAI-совместимый и локальный сервер; ключи хранятся зашифрованными. Режимы «предлагает», «по порогу» и «полный авто» (с отдельным подтверждением). Лимиты на день и месяц, общий бюджет в рублях, версии промптов, песочница, журнал действий и откат любого результата. Ссылки и цитаты берутся только из загруженных материалов. Запуск по расписанию: `php bin/psy ai:run --due`.
Реклама
- Восемь мест. Шапка, перед статьёй, внутри текста после выбранного абзаца, боковая колонка, низ статьи, между карточками списков, результаты поиска и липкий блок для телефона.
- Правила показа. Устройства, типы страниц, категории и статьи, исключения, лимит на страницу и число показов одному посетителю в день.
- Без сдвига страницы. Высота для компьютера и телефона резервируется заранее, блоки грузятся лениво, пустое место сворачивается.
- Сети и блоки. Рекламная сеть Яндекса, Google AdSense, произвольный код сети, собственные баннеры (изображение или текст, ссылка, рекламодатель, даты, ERID, пометка) и партнёрские блоки.
- A/B-варианты. Несколько вариантов в одном месте делят показы по весам, посетитель видит свой вариант при каждом заходе, показы и клики считаются по вариантам.
- Пометка «Реклама». Рядом с каждым блоком стоит пометка, рекламодатель и ERID.
- Безопасность чужого кода. Код сетей запускается только после согласия на рекламу, адреса разрешаются в политике безопасности страницы, встроенные скрипты проходят по контрольной сумме.
- ads.txt и app-ads.txt. Редактор проверяет каждую строку и публикует файл по адресу `/ads.txt` как простой текст.
- Предпросмотр. Реальная статья с отмеченными рекламными местами.
Аналитика и согласие
- Баннер cookie. Принять всё, отклонить необязательное или выбрать категории: необходимые, аналитика, реклама. Журнал согласий хранит хэш браузера, категории, версию политики и время без IP-адреса.
- Счётчики. Яндекс Метрика (с вебвизором), Google Analytics 4, свои счётчики и пиксели с выбором категории согласия. Всё запускается после согласия.
- События. Просмотр статьи, поиск, прокрутка, показ слота, клик по собственному или партнёрскому блоку. Клики внутри чужих рекламных блоков не перехватываются.
- Собственная статистика без сторонних сервисов. Просмотры и посетители, график по дням, популярные статьи и категории, источники переходов, запросы поиска и запросы без результата, показы, клики и CTR слотов. IP-адрес не записывается, посетитель — хэш с солью на сутки. Срок хранения и очистка: `php bin/psy analytics:clean`.
- Доход по местам. Суммы вносятся вручную или загружаются отчётом CSV из кабинета сети. Выгрузка отчётов в CSV.
- Политика конфиденциальности. Образец с полями в квадратных скобках; пока поля не заполнены, реклама и сторонние счётчики на сайте закрыты, а в админке виден предупреждающий блок.
Оформление
- Шрифты Literata, PT Sans и PT Mono лежат в комплекте и грузятся с вашего сайта. Лицензии шрифтов указаны в THIRD-PARTY.txt.
- Мобильная версия. Меню, статья, поиск и баннер cookie без горизонтальной прокрутки, липкий рекламный блок для телефона.
- Печатная версия статьи без меню и рекламы.
Фирменная админ-панель ARCHIVE0
Панель студии, общая для продуктов ARCHIVE0. Обзор, статьи с редактором (визуальный режим, разметка, предпросмотр, автосохранение), версии и откат, очередь проверки, категории, теги, шаблоны с карточкой, граф связей и красные ссылки, обсуждения, статья дня, импорт и экспорт (JSON, Markdown), страницы, меню, медиатека, оформление, SEO, редиректы, парсеры, ИИ, рекламные места, кампании, аналитика и доход, пользователи и роли (владелец, администратор, рецензент, редактор, читатель), журнал, резервные копии, настройки, интеграции с почтой и Telegram для уведомлений об очереди.
Демо-данные
В комплекте демонстрационная энциклопедия «Морские маяки»: пятнадцать статей с вымышленными названиями и фактами, семь категорий, три шаблона, история правок, статья дня, два материала в очереди. Всё помечено словом «демо» и удаляется одним действием в разделе «О продукте» или командой `php bin/psy demo:clear`.
Документация
Подробный README, руководство владельца (`docs/GUIDE.md`: установка, первый запуск, парсеры, ИИ, рекламные сети, метрики, cron, резервные копии, ads.txt, политика) и юридическая памятка (`docs/LEGAL.md`: рекламные сети, маркировка рекламы, лицензии содержимого, персональные данные, ответственность владельца).
Для запуска нужно
Сервер или хостинг с PHP 8.3 или новее и MariaDB 10.5+ (или MySQL 8), nginx или Apache, домен с HTTPS, доступ к cron для запуска парсеров, ИИ и чистки статистики. Node.js и Composer не нужны. Для парсеров и ИИ нужны свои источники и ключи провайдеров, для рекламы — аккаунты сетей.
