Пакеты и образы обеспечивающие функционал КЦ
КЦ состоит из набора сервисов, каждый из которых обеспечивает решение одной или нескольких задач пользователя. Одни сервисы распространяются в составе пакетов, другие в виде docker образов.
Базовые пакеты
Сервисы регистрируются в системе, и ими можно управлять через service
, доступны команды start|stop|force-stop|restart|force-reload|status|run
, например:
service artixcs-web restart
Пакет | Сервисы | Порты по умолчанию, на которых запускается сервис | Назначение | Примечания |
---|---|---|---|---|
artixcs-rest-routing | artixcs-rest-routing | 8080 | Роутинг запросов | Помогает все необходимое разместить на одном порту |
artixcs-rest | artixcs-rest | 38051 | Хранение и выдача данных об архитектуре сети, формирование логики генерации справочников. Загрузка продаж | Ядро КЦ устанавливается вместе с БД на локальном хосте |
artixcs-rest-split | 38051 | Ядро КЦ устанавливается отдельно от БД. При этом БД могут быть установлены на других хостах | ||
artixcs-controlcenter | artixcs-controlcenter | 18090 | Веб интерфейс КЦ | |
artixcs-clickhouse-rest | artixcs-clickhouse-rest | 8088 | Выдача информации о продажах для отображения в КЦ | |
artixcs-sale-renderer | artixcs-sale-renderer | 38067 | Отображение печатного образа чека продажи в WEB-интерфейсе | |
artixcs-sale-renderer-additional-ui | artixcs-sale-renderer-additional-ui | 38068 | Отображение детальной информации о чеке продажи | Пакет является устаревшим |
artixcs-accounting-bonuses | artixcs-accounting-bonuses | 38055 (REST), 7760 (Thrift для администрирования), 7761 (Thrift для основной логики) | Процессинг бонусов | |
artixcs-accounting-bonuses-certificates | artixcs-accounting-bonuses-certificates | 38056 (REST), 7770 (Thrift для администрирования), 7771 (Thrift для основной логики) | Комбинированный процессинг бонусов и сертификатов | |
artixcs-accounting-certificates | artixcs-accounting-certificates | 38057 (REST), 7780 (Thrift для администрирования), 7781 (Thrift для основной логики) | Процессинг сертификатов | |
artixcs-accounting-coupons | artixcs-accounting-coupons | 38058 (REST), 7790 (Thrift для администрирования), 7791 (Thrift для основной логики) | Процессинг купонов | |
artixcs-accounting-scheduled-impacts | artixcs-accounting-scheduled-impacts | 8093 | Расчет периодических бонусов | |
artixcs-counter | artixcs-counter | 39021 | Процессинг накоплений для лояльности (сервис счетчиков) | |
artixcs-private-office | artixcs-private-office | 38022 | Агрегация работы с дисконтными картами и клиентами, согласно бизнес кейсам клиента Улыбка Радуги | |
artixcs-web | artixcs-web | 38062 | Веб интерфейс КС версии 3.0 (базовая поддержка совместимости) | |
artixcs-sco-assistant-web | artixcs-sco-assistant-web | 8082 | Отображение состояний касс самообслуживания и отправка команд на них (например, подтверждение, что покупатель старше 18 лет) | Представляет собой WEB-сервис |
artixcs-config | Конфигурирование MySQL под нужды КЦ | |||
artix-cs-db-trimmer | Подрезка продаж и отложенных чеков в БД | |||
artixcs-processed | Подрезка продаж на файловой системе | |||
artix-cs-zabbix | Конфигурирование метрик для zabbix-агента | |||
artix-nginx-config | Конфигурирование nginx под нужды КЦ | |||
artix-postgresql-config | Конфигурирование postgresql под нужды КЦ | Используется для хранения продаж в PostgreSQL | ||
artixcs-puppet-objects | Хранение классов и фактов для централизованного конфигурирования касс и МКС | Классы и факты импортируются в КЦ при установке пакета | ||
artixcs-accounting-event-notifier | artixcs-accounting-event-notifier | 39011 | Оповещение о движении бонусов | |
artixcs-online-card | artixcs-online-card | 8096 | Отправка информации о картах и клиентах в ответ на обращение кассы | Используется, когда нет необходимости загружать справочники карт и клиентов на каждую кассу |
artixcs-online-shop | artixcs-online-shop | 9010 | Организация работы интернет магазина – расчет скидок и формирования чека для последующей оплаты на кассе | |
artixcs-issuance-card | artixcs-issuance-card | 8094 | Выдача карт | |
artixcs-mongo-dump | Бэкапирование и восстановление MongoDB | |||
artixcs-mysql-dump | Бэкапирование и восстановление всех БД MySQL | |||
artixcs-central | Трансформация КЦ в ЦКС | |||
artixcs-middle | Трансформация КС в МКЦ | |||
artixcs-report | artixcs-report | 8077 | Формирование отчетов | |
artixcs-undercut-asset | artixcs-undercut-asset | 3306 | Подрезка бонусных транзакций и их статусов за произвольный период времени | Работает напрямую с бонусным сервером |
Docker образы
Образ | Назначение | Команда запуска (размещение на одной машине с КЦ) |
---|---|---|
artixcs-ssh-support | Организация доступа по ssh до кассы из веб интерфейса КЦ | sudo docker run -d --restart always --log-opt max-size=50m --log-opt max-file=2 --name ssh -p 4201:4200 cashserver.artix.su:1443/artixcs-ssh-support:latest |
artixcs-vnc-support | Организация доступа по vnc до кассы из веб интерфейса КЦ | sudo docker run -d --restart always --log-opt max-size=50m --log-opt max-file=2 --name vnc -p 6080:6080 cashserver.artix.su:1443/artixcs-vnc-support:latest |
sale-renderer-api | Отображение печатного образа чека продажи | sudo docker run -d --restart always --name sale-renderer -p 38067:8010 -e "CS_SERVER_HOST=$(ip -4 addr show docker0 | grep -Po 'inet \K[\d.]+')" -e CS_SERVER_PORT="38051" cashserver.artix.su:1443/sale-renderer-api:latest |
clockworksoul/docker-gc-cron | Удаления неиспользуемых образов контейнеров | sudo docker run -d --restart always --log-opt max-size=50m --log-opt max-file=2 --name cron-docker-trimmer -v /var/run/docker.sock:/var/run/docker.sock -e CRON="0 0 * * *" clockworksoul/docker-gc-cron |
ticket-editor | Редактор ценников | sudo docker run -d --restart always --log-opt max-size=50m --log-opt max-file=2 --name ticket-editor -p 38069:38069 -e "CS_SERVER_HOST=$(ip -4 addr show docker0 | grep -Po 'inet \K[\d.]+')" -e CS_SERVER_PORT="38051" cashserver.artix.su:1443/ticket-editor:latest |
Обмен
Пакет | Сервисы | Порт по умолчанию | Назначение | Примечания |
---|---|---|---|---|
artix-cs-exchangers | exchangers-upload | Загрузка справочников файлового формата | Отвечает за стыковку КЦ и АСТУ | |
exchangers-soap-upload | 18080 | Загрузка справочников по протоколу SOAP | ||
exchangers-rest-upload | 28080 | Загрузка справочников по протоколу REST | ||
exchangers-unload | 28082 | Выгрузка продаж | ||
exchangers-rest-service | 8998 | Формирование файла с обновляемой информацией о статусах прогрузки справочника | Используется для оповещения АСТУ при файловом обмене | |
artix-cs-nes | nes | 28081 | Загрузка справочников в БД | Нужен для работы сервисов загрузки справочников из пакета artix-cs-exchangers |
artixcs-sync | sync-core2 | 7795 | Обмен справочниками и продажами между ЦКС и МКС в двухуровневой архитектуре | Устанавливается на магазинные сервера (МКС) |
artixcs-datatransfer | artixcs-datatransfer | 38066 | Обмен справочниками и продажами между КС и АСТУ через транзитную БД, изменение баланса, статуса и привязки карт на БС | |
artixcs-sales-loader | artixcs-sales-loader | 38065 (REST для администрирования), 10001 (GRPC для передачи продаж) | Загрузка продаж с касс | |
artixcs-sales-ws | artixcs-sales-ws | 38059 | Выгрузка продаж по SOAP |
Puppet
Связи контейнеров и сами контейнеры описаны в docker-compose
файле, который копируется при установке puppet, отдельно запускать контейнеры не имеет смысла, так как им необходимо взаимодействовать друг с другом.
Образ | Назначение |
---|---|
puppetdb | Хранилище данных формируемые puppet сервером |
postgres | База данных PostgreSQL необходимая для работы puppetdb |
puppet-artixmod | Puppet сервер c дополнительным поведением для взаимодействия с КЦ |
rsync-artixmod | Синхронизация классов и фактов созданных в КЦ с puppet сервером |