Задание

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

Требования

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

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

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

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

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

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

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

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

DEFAULT - в данном режиме используется база данных postgresql с настройками по умолчанию, а именно url:jdbc:postgresql://localhost/test, username: test, password: test. Для запуска используем следующие параметры java -jar dfops.jar
DEMO - в данном режиме используется база данных H2 DB. Для запуска используем следующие параметры java -jar dfops.jar --spring.profiles.active=demo
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

Прочее

Точка входа http://localhost:8080/rest/v1/
Документацию по 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
В каталоге docker при наличии docker и docker compose можно запустить docker-образ с postgresql версии 10.
В gitlab настроен CI/CD. Есть возможность скачать последнюю версию артефакта по ссылке https://gitlab.com/Aleksandrov/dfops-rest-service/-/pipelines

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

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

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

5.2 KiB Raw Blame History Unescape Escape