Задание

Напишите Spring-приложение, предоставляющее REST-сервис для приема и регистрации операций в базе данных по расчетам с водителями. У каждого водителя может быть несколько лицевых счетов.

Требования

СУБД PostgreSQL 10; создать структуру БД самостоятельно. Доступ к данным реализовать с помощью Hibernate.

Реализовать операции REST-сервиса; прием параметров и возврат данных – в JSON:

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

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

Дополнительные требования

• Создать Gradle-проект.
• Хранение исходников – в GIT (например, на gitlab.com).
• Дополнительным плюсом будет реализации unit-тестов.

Комментарий к выполненной работе

Программу можно запустить в нескольких режимах используя профили spring boot

1. DEFAULT - в данном режиме используется база данных postgresql с настройками по умолчанию, а именно url:jdbc:postgresql://localhost/test, username: test, password: test. Для запуска используем следующие параметры java -jar dfops.jar
2. DEMO - в данном режиме используется база данных H2 DB. Для запуска используем следующие параметры java -jar dfops.jar --spring.profiles.active=demo
3. PRODUCTION - в данном режиме используется база данных postgresql c альтернативными настройками прописанными в файле application-prod.properties, данный файл должен находиться в том же каталоге где и запускаемый jar-файл программы. Для запуска используем следующие параметры java -jar dfops.jar --spring.profiles.active=prod

Пример содержимого файла application-prod.properties

DFOPS_PGSQL_DB_HOST=jdbc:postgresql://localhost
DFOPS_PGSQL_DB_PORT=5432
DFOPS_PGSQL_DB_NAME=test
DFOPS_PGSQL_DB_USER=test
DFOPS_PGSQL_DB_PASSWORD=test

Так же для запуска программы в linux, можно воспользоваться скриптом dfops_linux.sh , при этом запускаемый jar-файл должен называться dfops.jar и находиться в том же каталоге, где и скрипт. Выполните dfops_linux.sh --help для получения помощи. При запуске в режиме PRODUCTION будет выполнена проверка на наличие файла application-prod.properties, если он не найден, то запустится интерактивный режим, где будет предложено заполнить необходимые данные.

Работа с программой

Инициализация БД

Если работа ведётся с postgresql можно воспользуйтесь файлами ddl-postgresql.sql, schema-postgresql.sql, data-postgresql.sql для инициализации БД см. каталог init_postgresql_db

Прочее

1. Точка входа http://localhost:8080/rest/v1/
2. Документацию по API использует OpenApi c ui. Для доступа к ui используем адрес http://localhost:8080/rest/v1/swagger-ui/index.html?configUrl=/rest/v1/v3/api-docs/swagger-config , в представлении json используем http://localhost:8080/rest/v1/v3/api-docs
3. В каталоге docker при наличии docker и docker compose можно запустить docker-образ с postgresql версии 10.
4. В gitlab настроен CI/CD. Есть возможность скачать последнюю версию артефакта по ссылке https://gitlab.com/Aleksandrov/dfops-rest-service/-/pipelines

---

Тестовое задание выполнил

Александров А.А. (alexandrov@resprojects.ru)

ссылка на профиль hh.ru - https://hh.ru/resume/7cdada75ff015e78530039ed1f366c4b4a5273