Пакеты и образы обеспечивающие функционал КЦ
КЦ состоит из набора сервисов, каждый из которых обеспечивает решение одной или нескольких задач пользователя. Одни сервисы распространяются в составе пакетов, другие в виде docker образов.
Базовые пакеты
Сервисы регистрируются в системе, и ими можно управлять через service, доступны команды start|stop|force-stop|restart|force-reload|status|run, например:
service artixcs-rest-routing 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-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-config | Конфигурирование MySQL под нужды КЦ | |||
| artix-cs-db-trimmer | Подрезка продаж и отложенных чеков в БД | |||
| artixcs-processed | Подрезка продаж на файловой системе | |||
| artix-cs-zabbix | Конфигурирование метрик для zabbix-агента | |||
| 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 | Подрезка бонусных транзакций и их статусов за произвольный период времени | Работает напрямую с бонусным сервером | |
| artixcs-maint-prices | artixcs-maint-prices | Подрезка переоценок и дополнительных цен | Подрезка данных доступна только в MySQL | |
| artixcs-messaging-service | artixcs-messaging-service | 12023 | Отправка сообщений через telegram-бот и СМС шлюз по номеру телефона |
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 dockerregistry.artix.su:2443/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 dockerregistry.artix.su:2443/artixcs-vnc-support: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" dockerregistry.artix.su:2443/ticket-editor:latest |
| sale-renderer | Отображение печатного образа чека в Artix Control Center, Artix Loyalty Managment и в telegram-боте | sudo docker run -d --restart always --log-opt max-size=50m --log-opt max-file=2 --name sale-renderer --net=host -v /opt/artixcs-sale-renderer/config.json:/opt/artixcs-sale-renderer/config.json -v /var/log/artix/artixcs-sale-renderer:/var/log/artix/artixcs-sale-renderer dockerregistry.artix.su:2443/sale-renderer: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 | |
| artix-nginx-config | nginx | 8084 | Сервис nginx для передачи справочников на кассы и/или МКС'ы |
Puppet
Связи контейнеров и сами контейнеры описаны в docker-compose файле, который копируется при установке puppet, отдельно запускать контейнеры не имеет смысла, так как им необходимо взаимодействовать друг с другом.
| Образ | Назначение |
|---|---|
| puppetdb | Хранилище данных формируемые puppet сервером |
| postgres | База данных PostgreSQL необходимая для работы puppetdb |
| puppet-artixmod | Puppet сервер c дополнительным поведением для взаимодействия с КЦ |
| rsync-artixmod | Синхронизация классов и фактов созданных в КЦ с puppet сервером |