
Служба приема телеграмм и рекламных объявлений 

В состав службы входят:
- десктоп клиенты (АРМы операторов и администраторов)
- сервер приложений
- база данных


ДЕСКТОП КЛИЕНТЫ:
-------------------------

Состав:
TlxAdminADV.zip - АРМ администратора приема рекламных сообщений (исполняемый файл: TlxAdminADV.exe)
TlxAdminARM.zip - АРМ администратора службы приема телеграмм (исполняемый файл: TlxAdminARM.Desktop.exe)
TlxKSSARM.zip - АРМ контрольно-справочной службы (исполняемый файл: TlxKSSARM.Desktop.exe)
TlxOperARM.zip - АРМ оператора службы приема телеграмм (исполняемый файл: TlxOperARM.exe)

Системные требования: для работы приложений необходим NET 8 Desktop Runtime

Для входа использовать следующие логин и пароль
 - логин: 1
 - пароль: 3cdbcbe119058a77e1b3fe1318c42a68
 
Установка и запуск

1. Развернуть соответствующий архив каждый в отдельный каталог.
2. Настроить подключение к серверу приложений (см.ниже). Для этого в файле userprefs.ini 
	указать в параметре apiAddress адрес по которому доступен сервер приложений.
	по умолчанию указан адрес сервера приложений на тестовой площадке на нашем сервере - https://telex.a-sw.ru.
3. Запустить соответствующий exe файл и ввести указанные выше логин и пароль.



СЕРВЕР ПРИЛОЖЕНИЙ:
-------------------------


Инструкция по настройке и запуску telegram-module
=================================================

Файл конфигурации
-----------------
Имя файла: application.yml

Расположите файл в одной директории с исполняемым файлом:

/opt/telegram-module/
├── telegram-module.jar
├── application.yml
└── migration.sql


Требования
----------
- Java: OpenJDK 17
- PostgreSQL: клиент psql для выполнения миграций


Порт приложения
---------------
server:
    port: 8082

Приложение запускается на порту 8082. Для изменения замените значение на нужный порт.


Подключение к базе данных (DataSource)
--------------------------------------
spring:
    datasource:
        url: ${DATASOURCE_URL:jdbc:postgresql://<DB_HOST>:<DB_PORT>/<DB_NAME>}
        username: <DB_USER>
        password: <DB_PASSWORD>

Замените placeholders на реальные значения:
- <DB_HOST> — хост базы данных
- <DB_PORT> — порт базы данных
- <DB_NAME> — имя базы данных
- <DB_USER> — имя пользователя БД
- <DB_PASSWORD> — пароль пользователя БД

URL можно переопределить через переменную окружения:
export DATASOURCE_URL=jdbc:postgresql://<DB_HOST>:<DB_PORT>/<DB_NAME>


Миграция базы данных
--------------------
Перед первым запуском приложения выполните скрипт миграции:

PGPASSWORD=<DB_PASSWORD> psql -h <DB_HOST> -p <DB_PORT> -U <DB_USER> -d <DB_NAME> -f migration.sql
Или, если скопировать файл на сервер СУБД, выполнить под пользователем postgres
psql <DB_NAME>  < migrations.sql


Пример запуска
--------------
cd /opt/telegram-module

# 1. Выполнить миграцию БД (только перед первым запуском)
PGPASSWORD=<DB_PASSWORD> psql -h <DB_HOST> -p <DB_PORT> -U <DB_USER> -d <DB_NAME> -f migration.sql
Или, если скопировать файл на сервер СУБД, выполнить под пользователем postgres
psql <DB_NAME>  < migrations.sql

# 2. Запустить приложение
java -jar telegram-module.jar

После запуска приложение будет доступно по адресу: http://localhost:8082
```