Введение

Adwos CMS — движок для создания досок объявлений, маркетплейсов и классифайд-площадок на Go + Next.js. Из коробки поддерживает объявления, магазины с каталогом товаров, безопасную сделку (эскроу), чат, блог, истории, систему отзывов, монетизацию, импорт/экспорт и модульную архитектуру.

Для кого

• Доски объявлений (авто, недвижимость, работа, услуги)
• Маркетплейсы товаров и магазинов
• Фриланс-биржи и агрегаторы услуг
• Аренда жилья, авто, инструмента
• Любые классифайд-площадки с фильтрами и категориями

Ключевые возможности

Технологии

Установка

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

Быстрая установка

Выполните на сервере с правами root:

sudo bash -c "$(curl -sSL https://adwos.org/install.sh)"

LICENSE_KEY="ваш-ключ" sudo -E bash -c "$(curl -sSL https://adwos.org/install.sh)"

Веб-мастер установки

После запуска скрипта откроется веб-мастер установки на порту 8888. Откройте в браузере:

http://ваш-домен:8888

Мастер проведёт через все шаги:

• Проверка лицензионного ключа и домена
• Проверка системных требований сервера
• Настройка инфраструктуры (PostgreSQL, Redis, Manticore)
• Создание администратора и загрузка начальных данных
• Настройка хранилища файлов и SMTP
• Запуск CMS и настройка HTTPS через Caddy

Установщик проверит системные требования, запросит лицензионный ключ, скачает CMS и настроит всё автоматически: домен, БД, Redis, Manticore, SMTP, данные администратора. По завершении будет сгенерирован файл .env со всей конфигурацией.

Ручная установка

# 1. Создайте базу данных
createdb -U postgres adwos_cms

# 2. Разместите бинарник и фронтенд
mkdir -p /opt/adwos-cms
cp adwos-cms /opt/adwos-cms/
cp -r .next /opt/adwos-cms/

# 3. Скопируйте лицензию
cp license.lic /opt/adwos-cms/

# 4. Сконфигурируйте .env
cp .env.example /opt/adwos-cms/.env
nano /opt/adwos-cms/.env

# 5. Примените миграции
cd /opt/adwos-cms && ./adwos-cms migrate up

# 6. Запустите
./adwos-cms serve

Конфигурация (.env)

Дашборд

Главная страница админ-панели отображает ключевые метрики: количество пользователей, объявлений, последние регистрации и новые объявления. Доступ по адресу /admin.

Управление объявлениями

Раздел «Объявления» позволяет просматривать, модерировать и управлять всеми объявлениями на площадке.

Жизненный цикл объявления

• Просмотр всех объявлений с фильтрацией по статусу, категории, пользователю
• Одобрение или отклонение объявлений на модерации
• Архивация и восстановление объявлений
• Удаление объявлений
• Просмотр жалоб на объявления

Типы цен

Категории и кастомные поля

Категории организуют объявления. Поддерживается иерархия (родительская → дочерние). К каждой категории привязываются кастомные поля, которые определяют характеристики объявлений.

Управление категориями

• Создание, редактирование, удаление категорий
• Иерархия: категория может иметь подкатегории
• Иконки и порядок сортировки
• Импорт и экспорт структуры категорий

Типы полей

Настройки полей

• Обязательное — поле должно быть заполнено при создании объявления
• Фильтруемое — поле доступно в фильтрах поиска
• Поисковое — значение индексируется для полнотекстового поиска
• Группа — объединение полей в визуальную группу
• Стиль отображения — chips, checkboxes, radio, color_picker, range_slider
• Зависимость — поле показывается только при определённом значении другого поля

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

Управление зарегистрированными пользователями площадки.

Роли

Возможности

• Просмотр списка пользователей с фильтрацией и поиском
• Изменение роли пользователя
• Блокировка и разблокировка аккаунтов
• Удаление пользователей
• Модерация аватаров (одобрение / отклонение)

Магазины

Раздел «Магазины» позволяет управлять витринами продавцов, тарифными планами и подписками. Доступ: /admin/shops и /admin/shop-tariffs.

Управление магазинами

• Просмотр всех магазинов с фильтрацией по статусу и тарифу
• Одобрение, блокировка и удаление магазинов
• Просмотр страниц, баннеров и статистики магазина
• Привязка магазина к пользователю

Тарифные планы магазинов

Администратор создаёт тарифные планы, которые продавцы подключают через личный кабинет.

Импорт и экспорт

Импорт объявлений

Система импорта позволяет автоматически загружать объявления из внешних источников. Доступ: /admin/import.

• Создание источника импорта с URL фида
• Запуск импорта вручную или по расписанию
• Просмотр истории запусков с результатами (создано, обновлено, ошибки)
• Маппинг полей фида на кастомные поля категорий

Экспорт данных

Выгрузка данных площадки в различных форматах для аналитики или переноса.

Истории

Истории (Stories) — вертикальные медиа-карточки на главной странице. Доступ: /admin/stories.

• Создание историй: загрузка изображения или видео, заголовок, ссылка
• Настройка порядка отображения
• Ограничение по сроку показа (дата истечения)
• Привязка к категории или объявлению
• Просмотр статистики просмотров каждой истории
• Публикация и снятие с публикации

Блог

Встроенная блог-платформа для публикации новостей, статей и обновлений. Контент создаётся в блочном редакторе Editor.js.

• Создание и редактирование статей с обложкой
• Блочный редактор: параграфы, заголовки, списки, цитаты, код, изображения, таблицы
• Категории и теги
• Статусы: черновик, опубликован
• Комментарии с модерацией
• Лайки на постах и комментариях
• Связанные посты

Модерация

Система модерации контента обеспечивает качество площадки.

Режимы модерации

Что модерируется

• Объявления — одобрение, отклонение с причиной
• Жалобы на объявления — просмотр, рассмотрение, отклонение
• Аватары пользователей — одобрение или отклонение загруженных фото
• Комментарии в блоге — удаление, обработка жалоб
• Отзывы — удаление, обработка апелляций

Объявления

Основная сущность CMS. Пользователи создают объявления с фотографиями, описанием и характеристиками, специфичными для выбранной категории.

Создание объявления

• Выбор категории (с подкатегориями)
• Загрузка изображений с drag-and-drop, выбор обложки
• Заполнение кастомных полей категории
• Указание цены (фиксированная, договорная, бесплатно, обмен)
• Выбор местоположения на карте
• Контактные данные

Личный кабинет

• Список своих объявлений с фильтрацией по статусу
• Редактирование и удаление
• Продвижение объявлений (платные услуги)
• Статистика просмотров и контактов

Магазины и каталог

Продавцы могут создать собственную витрину — магазин с каталогом товаров, страницами и баннером. Покупатели видят все предложения продавца в едином пространстве.

Создание магазина

• Название, описание, логотип и баннер магазина
• Выбор тарифного плана (с функциями и лимитами)
• Кастомные страницы: «О магазине», «Доставка», «Контакты»
• Публичная витрина со всеми объявлениями продавца

Тарифные планы

Администратор площадки настраивает тарифы с различными возможностями и лимитами. Продавец выбирает подходящий план и оплачивает подписку через кошелёк.

Управление в личном кабинете

• Список моих магазинов
• Управление объявлениями магазина
• Статистика просмотров витрины
• Продление и смена тарифа

Безопасная сделка

Механизм эскроу защищает обе стороны сделки. Покупатель переводит деньги на резервный счёт, продавец получает их только после подтверждения получения товара.

Как работает

Статусы сделки

Управление

• Покупатель и продавец: личный кабинет → Сделки (/dashboard/deals)
• Администратор: /admin/deals — арбитраж, ручное завершение, история

Корзина и заказы

Покупатели добавляют товары из магазинов в корзину и оформляют заказы. Продавцы обрабатывают заказы из личного кабинета.

Корзина

• Добавление товаров (объявлений из магазина) в корзину
• Изменение количества и удаление позиций
• Расчёт итоговой суммы
• Оформление заказа с указанием адреса доставки

Статусы заказа

Доставка

Интеграция с модулями доставки (CDEK, Boxberry, Почта России) позволяет рассчитывать стоимость и создавать заявки прямо из заказа.

• Покупатель: /dashboard/orders — список заказов
• Продавец: заказы в кабинете магазина
• Администратор: /admin/deals — все заказы площадки

Поиск и фильтры

Полнотекстовый поиск через Manticore Search с подсказками и динамическими фильтрами.

• Текстовый поиск с подсказками
• Фильтр по категории
• Фильтр по городу
• Диапазон цен
• Динамические фильтры по кастомным полям категории
• Сортировка: новые, старые, дешёвые, дорогие
• Режимы отображения: сетка, список, карта

Чат и сообщения

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

• Мгновенные сообщения через WebSocket
• Список диалогов с индикатором непрочитанных
• Привязка к объявлению
• Удаление сообщений и диалогов
• Уведомления о новых сообщениях

Отзывы

Система отзывов позволяет оценивать продавцов и формировать рейтинг доверия.

• Оценка продавца с рейтингом
• Текстовые отзывы с ответами продавца
• Публичный профиль продавца с рейтингом и объявлениями
• Апелляции на отзывы для модерации
• Распределение оценок и средний рейтинг

Избранное

Пользователи могут сохранять понравившиеся объявления в избранное для быстрого доступа из личного кабинета.

Уведомления

In-app уведомления в реальном времени через WebSocket. Пользователь получает уведомления о новых сообщениях, ответах на комментарии, изменениях статуса объявлений.

• Счётчик непрочитанных в шапке сайта
• Список уведомлений в личном кабинете
• Отметка как прочитанное

Продвижение объявлений

Платные услуги для выделения объявлений среди конкурентов. Настраиваются в админ-панели: название, цена, длительность, описание.

Типы услуг

Тарифы

Пакетные предложения: объединение нескольких услуг со скидкой.

Специальные предложения

Скидочные акции с ограничением по количеству использований.

Рекламные блоки

Система рекламных блоков позволяет размещать баннеры и скрипты в различных позициях сайта. Поддерживает таргетинг по городу, категории и языку.

Позиции

Форматы

• Баннер — изображение со ссылкой
• Скрипт — произвольный HTML/JS (Google Ads, Яндекс.Директ)
• Нативный — стилизованный блок под дизайн сайта

Отслеживаются показы и клики. Можно задать даты кампании и лимиты показов.

Кошелёк

Внутренний баланс пользователя для оплаты услуг продвижения. Работает при подключённом платёжном модуле.

• Пополнение через платёжные системы
• Списание при покупке услуг
• История операций
• Запросы на вывод средств (обрабатываются администратором)

Дизайн и брендинг

Внешний вид сайта настраивается через админ-панель в разделе «Дизайн» без необходимости правки кода. Доступ: /admin/design.

Логотипы и иконки

Шапка сайта

• Фиксированная шапка (sticky)
• Цвета: верхняя панель, основная панель, акцент, фон поиска
• Управление ссылками меню (раздел «Меню»)

Главная страница

• Боковая панель (вкл/выкл)
• Количество колонок объявлений (3–6)
• Режим загрузки: «Показать ещё», бесконечный скролл, пагинация
• Количество объявлений на странице (8–48)

Категории

• Режим отображения: сетка, карусель, компактный
• Размер карточек, скругление углов
• Цвета фона, текста, иконок
• Шрифты и размеры
• Эффекты при наведении, тени

Подвал (Footer)

Управление структурой подвала через раздел /admin/footer.

• Создание секций подвала (Компания, Поддержка, Социальные сети и др.)
• Добавление ссылок в каждую секцию
• Управление порядком секций и ссылок
• Текст копирайта

Ссылки на соцсети

Настройка отображаемых соцсетей в подвале и шапке.

• VK, Telegram, Instagram, YouTube, TikTok, WhatsApp и другие
• Иконки подставляются автоматически по типу сети

Водяной знак

Конструктор страниц

Модуль «Page Builder» позволяет создавать произвольные страницы (лендинги, «О компании», «Правила») через визуальный блочный конструктор. Доступ: /admin/pages.

• Блоки: герой, текст, изображение, галерея, карточки, CTA, форма
• Перетаскивание блоков (drag & drop)
• Кастомный URL (slug) для каждой страницы
• SEO-настройки для каждой страницы

Модули

Модульная архитектура позволяет расширять функциональность CMS без изменения ядра. Модули устанавливаются из маркетплейса Adwos или загружаются вручную через /admin/marketplace.

Карты

Адреса

SMS и верификация

Платёжные системы

Социальная авторизация

Доставка

Email-провайдеры

Уведомления

Дополнительные модули

Капча

Управление модулями

• Просмотр доступных и установленных модулей в маркетплейсе
• Установка в один клик — модуль скачивается и активируется автоматически
• Настройка API-ключей и параметров каждого модуля
• Обновление до новых версий из маркетплейса
• Деактивация и удаление модулей

Пресеты полей

Пресеты — готовые наборы кастомных полей для типовых ниш. Позволяют за секунду настроить категорию с правильными характеристиками.

Доступные пресеты

Применение

Перейдите в категорию → «Применить пресет». Два режима:

Настройки

Все настройки CMS управляются через раздел «Настройки» в админ-панели.

Основные настройки

Доступ к сайту

Хранилище файлов

Почта (SMTP)

Настройка SMTP-сервера для отправки писем. Используется для: подтверждения email при регистрации, сброса пароля, уведомлений о заказах и сделках, тикетов поддержки.

Подтверждение email

При включённом SMTP новые пользователи получают письмо со ссылкой для подтверждения email. Войти в аккаунт можно только после перехода по ссылке. Ссылка действительна 24 часа. Администратор может подтвердить email пользователя вручную в разделе «Пользователи».

Лицензия

Информация о текущей лицензии: ключ, домен, редакция, срок действия. CMS периодически проверяет лицензию через heartbeat-запрос к платформе Adwos.

SEO и Вебмастер

Расширенные инструменты SEO-оптимизации и интеграция с сервисами вебмастеров. Доступ: /admin/seo.

SEO-шаблоны

Шаблоны мета-тегов по типам страниц с поддержкой переменных. Переменные подставляются автоматически при генерации страницы.

Счётчики аналитики

Интеграция с вебмастерами

Мультиязычность

CMS поддерживает несколько языков интерфейса. Переводы управляются через админ-панель без правки кода. Доступ: /admin/translations.

Управление переводами

• Добавление новых локалей (язык + код, например ru, en, kz)
• Редактирование строк перевода через интерфейс — без правки файлов
• Экспорт и импорт переводов в JSON
• Переключатель языка в шапке сайта (если активно несколько локалей)

Перевод контента

Помимо перевода интерфейса, CMS поддерживает перевод контентных сущностей — объявлений, категорий, страниц блога. Переводы добавляются вручную или через автоматический перевод (при подключённом модуле).

Медиатека и резервные копии

Медиатека

Просмотр и управление всеми загруженными файлами. Доступ: /admin/storage.

• Просмотр файлов с фильтрацией по типу (изображения, документы, прочие)
• Удаление отдельных файлов
• Очистка неиспользуемых файлов (orphaned files)
• Статистика использования дискового пространства

Резервные копии

Создание резервных копий базы данных и загруженных файлов. Доступ: /admin/settings → Бэкапы.

Обновления

CMS поддерживает автоматическое обновление через подписанные пакеты. Обновления выпускаются командой Adwos и доступны через админ-панель.

Как обновить

• Перейдите в Настройки → Обновление системы
• Нажмите «Проверить обновления»
• Прочитайте список изменений
• Нажмите «Обновить»

Процесс обновления

[1] Создание записи (status: pending)
[2] Полный бэкап: pg_dump БД + tar.gz файлов
[3] Скачивание пакета с Platform
[4] Верификация: RSA-4096 подпись + SHA-256 хеш каждого файла
[5] Применение SQL-миграций (goose up)
[6] Замена файлов: бинарник, фронтенд, VERSION
[7] Обновление статуса (status: completed)

Что сохраняется

Версионирование

Используется Semantic Versioning: MAJOR.MINOR.PATCH