1. Общие сведения
Настоящая инструкция описывает установку и запуск проверочного экземпляра программного комплекса автоматизации и контроля процесса подбора и учета продукции «АКС Комплекс» (далее — Комплекс).
Экземпляр предназначен для проверки экспертом функциональных характеристик Комплекса без подключения реального складского оборудования: PTL-модули, информационные дисплеи и световые колонны имитируются встроенными эмуляторами и демо-режимами.
1.1. Состав Комплекса
| Компонент | Назначение | Технология |
|---|---|---|
ascs_api |
Диспетчеризация, маршруты, заказы, очередь наборки, печать, статистика, REST API | Python 3.11, FastAPI, PostgreSQL, Redis |
ascs_ui |
Автоматизированное рабочее место диспетчера | React 19, TypeScript, nginx |
ptl_api |
Управление PTL-модулями по Modbus TCP | Go, Modbus TCP, Redis |
rid_api |
Управление информационными LED-дисплеями по Modbus TCP | Go, Modbus TCP, Redis |
lighthouse_api |
Управление световыми колоннами через HTTP-реле | Go, HTTP CGI, Redis |
display_emulator |
Эмулятор LED-дисплея (3 экземпляра) | Go |
relay_emulator |
Эмулятор HTTP-реле (16 выходов) | Go |
1.2. Проверочный экземпляр
Проверочный экземпляр поставляется в виде набора файлов для ручной установки:
- архив
aks-complex-1.0-offline.tar.gzс Docker-образами; docker-compose.yml;- конфигурации сервисов в каталоге
configs/; - сценарий наполнения демо-данными в каталоге
seed/; - установочный скрипт
install.sh; - настоящая инструкция и руководство пользователя.
Экземпляр разворачивается на виртуальной машине или сервере эксперта. Доступ к операционной системе осуществляется под учётной записью, созданной экспертом при установке Ubuntu; предустановленных паролей ОС в комплект не включается. Для входа в АРМ диспетчера предсоздана учётная запись (см. раздел 5).
2. Требования к среде
2.1. Минимальные требования
| Параметр | Значение |
|---|---|
| ОС | Ubuntu 24.04 LTS, x86_64 |
| CPU | 4 ядра |
| RAM | 8 ГБ |
| Диск | 20 ГБ свободного места |
| Docker Engine | 24.0 или новее |
| Docker Compose | v2 (docker compose) |
| Браузер | Chrome, Firefox, Edge, Safari актуальных версий |
Допускается использование другой Linux-совместимой ОС при наличии Docker Engine и Docker Compose v2. Для проверочного экземпляра рекомендуется Ubuntu 24.04 LTS.
2.2. Сетевые порты
| Порт | Назначение | Доступ |
|---|---|---|
| 8080 | АРМ диспетчера (UI + прокси /api) |
снаружи |
| 8001 | Веб-интерфейс PTL API | снаружи |
| 8002 | Веб-интерфейс RID API | снаружи |
| 8010 | Веб-интерфейс Lighthouse API | снаружи |
| 8091–8093 | Веб-интерфейсы эмуляторов дисплеев | снаружи |
| 8094 | Веб-интерфейс эмулятора реле | снаружи |
| 5432 | PostgreSQL | только внутри Docker-сети |
| 6379 | Redis | только внутри Docker-сети |
Если порт 8010 занят, его можно переопределить переменной LIGHTHOUSE_PORT при запуске.
3. Установка offline-экземпляра
3.1. Подготовка
- Установите Docker Engine и Docker Compose v2 согласно официальной документации Docker.
- Проверьте установку:
docker --version
docker compose version
- Распакуйте архив:
tar -xzf aks-complex-1.0-offline.tar.gz
cd aks-complex-1.0
3.2. Запуск
sudo ./install.sh --offline
Скрипт выполняет следующие действия:
- загружает Docker-образы из каталога
images/; - запускает контейнеры без сборки;
- ожидает готовности API;
- наполняет базу демонстрационными данными;
- снимает паузу, которая устанавливается при старте backend;
- выводит адреса и учётные данные.
Ожидаемый результат в конце установки:
АКС Комплекс запущен.
АРМ диспетчера: http://localhost:8080/
...
Вход в АРМ:
роль: Диспетчер
пароль: AksDemo2026
3.3. Установка из исходников
Для сборки из исходников используется тот же скрипт без флага --offline:
sudo ./install.sh
В этом случае Docker Compose собирает образы из соседних каталогов ascs_api, ascs_ui, ptl_api, rid_api, lighthouse_api, display_emulator, relay_emulator. Данный режим предназначен для разработки и не требуется эксперту при наличии offline-архива.
4. Проверка работоспособности
4.1. Проверка API
curl http://localhost:8080/api/_health
Ожидаемый ответ:
{"postgres": true, "redis": true, "ptl": true, "rid": true}
4.2. Проверка веб-интерфейсов
| Адрес | Что должно открыться |
|---|---|
http://<host>:8080/ |
Экран входа в АРМ «АКС Комплекс» |
http://<host>:8001/ |
Веб-интерфейс PTL API, вкладка «Обзор» |
http://<host>:8002/ |
Веб-интерфейс RID API, вкладка «Обзор» |
http://<host>:8010/ |
Веб-интерфейс Lighthouse API, вкладка «Обзор» |
http://<host>:8091/ |
Эмулятор дисплея № 1 |
http://<host>:8094/ |
Эмулятор реле |
4.3. Проверка состояния оборудования
- Войдите в АРМ под ролью «Диспетчер».
- Откройте «Управление» → «Состояние оборудования».
- Убедитесь, что контроллеры PTL, дисплеи и реле отображаются как онлайн.
- Откройте «Состояние индикаторов» — должны отображаться 26 PTL-модулей.
5. Учётные данные
| Роль | Логин | Пароль | Права |
|---|---|---|---|
| Диспетчер | выбор роли «Диспетчер» | AksDemo2026 |
полный доступ |
| Оператор | выбор роли «Оператор» | не требуется | чтение и тестирование оборудования |
Пароль диспетчера хранится в базе в виде bcrypt-хэша. Для смены пароля:
docker compose exec ascs-api python manage.py set-password 'НовыйПароль'
6. Демонстрационный сценарий
В базу заранее загружены:
- 3 маршрута:
ДЕМО-1,ДЕМО-2,ДЕМО-3; - 10 заказов (
1001–1010); - 26 PTL-модулей на трёх контроллерах;
- 3 информационных дисплея;
- 5 световых колонн;
- 3 сотрудника, 2 АРМа, зоны и секции.
6.1. Запуск маршрута
- Войдите в АРМ как диспетчер.
- На экране «Очередь комплектации» выберите маршрут
ДЕМО-1. - Нажмите «Пуск» (или откройте маршрут и нажмите «Запустить»).
- Убедитесь, что заказ
1001перешёл в статус «Комплектация», а на PTL-модулях 1–3 контроллера10.0.0.1загорелся синий цвет. - Откройте «Управление» → «Состояние индикаторов» — активные PTL должны быть отмечены как «Активен», цвет «Синий».
6.2. Работа с заказом
- Откройте заказ
1001из маршрута. - Проверьте позиции, ячейки, количество ящиков и штук.
- Введите фактическое количество подобранного, если оно отличается от планового.
- Подтвердите тару и опт (кнопки «Стеллаж» / «Опт»).
- Завершите заказ. Система перейдёт к следующему заказу маршрута.
6.3. Дисплеи и световые колонны
При активной секции Комплекс отправляет текст на информационные дисплеи и включает световые колонны. Проверить результат можно:
- в веб-интерфейсе RID API (
:8002) — вкладка «Обзор»; - в веб-интерфейсе Lighthouse API (
:8010) — вкладка «Обзор»; - в эмуляторах дисплеев (
:8091–:8093) и реле (:8094).
6.4. Пауза, сброс и повторный запуск
- «На паузу» — приостанавливает маршрут с сохранением состояния;
- «Запустить» — возобновляет маршрут;
- «Сбросить» — возвращает заказы в исходное состояние и гасит оборудование;
- «Полный сброс комплектации» — доступен в разделе «Управление» и сбрасывает все маршруты.
7. Остановка, обновление и удаление
7.1. Остановка
./install.sh --down
7.2. Просмотр логов
./install.sh --logs
Или отдельно:
docker compose logs -f ascs-api
docker compose logs -f ptl-api
7.3. Обновление
- Остановите Комплекс.
- Распакуйте новый архив в отдельный каталог.
- Выполните
sudo ./install.sh --offline.
Конфигурации и данные хранятся в Docker-томах aks-complex_aks_pgdata и aks-complex_aks_logs и сохраняются при обновлении. Перед обновлением рекомендуется сделать резервную копию базы:
docker compose exec -T db pg_dump -U aks aks > backup_$(date +%F).sql
7.4. Полное удаление
./install.sh --reset
Команда удаляет контейнеры и тома с данными. Действие необратимо.
8. Диагностика типовых проблем
| Симптом | Причина | Решение |
|---|---|---|
address already in use |
занят порт 8010 или 8080 | остановить конфликтующий сервис или задать LIGHTHOUSE_PORT |
ascs-api is unhealthy |
ошибка миграции или нехватка памяти | docker compose logs ascs-api, проверить RAM и диск |
| PTL/RID/Lighthouse offline | контейнер не запущен или нет Redis | docker compose ps, docker compose logs <service> |
| Не удаётся войти | неверный пароль | docker compose exec ascs-api python manage.py set-password '...' |
| Демо-данные не появились | импорт CSV не завершился | docker compose exec ascs-api python /seed/seed_demo.py |
| Экран «Наборка поставлена на паузу» | backend перезапускался | нажать «Понял» или curl -X POST http://localhost:8080/api/system/paused_state/ack |
9. Контакты технической поддержки
| Техническая поддержка | support@whsoft.ru |
| Общие вопросы | info@whsoft.ru |
| Сайт | https://whsoft.ru/ |
| Документация | https://whsoft.ru/docs/ascs/ |
| Правообладатель | ИП Краснов Владимир Андреевич, ИНН 781422796858 |
Для консультации по развёртыванию и настройке экземпляра рекомендуется обращаться на support@whsoft.ru с темой «Проверочный экземпляр АКС Комплекс».