Банковский справочник

Веб-приложение для администрирования справочной информации о кредитно-финансовых учреждениях. (backend-part)

Содержание

• Стек технологий
• Описание проекта
• Инструкция для запуска

Стек технологий

Основной backend-стек:

• Java 17
• H2-Database
• Spring Boot
• Spring Data JPA
• Spring Web
• MapStruct
• Lombok
• JAXB

Для развертывания и тестирования:

• Docker / Docker-Compose
• SwaggerHub / SwaggerEditor

Описание проекта

Данный проект разработан для администрирования справочной информации о кредитно-финансовых учреждениях.

• Общий функционал
• Сборник справочников
• Электронные сообщения

Общий функционал

• Использован архитектурный подход Spring MVC.
• Аудирование. При создании/изменении информации, сохраняются данные о дате и времени проведенных операций.

Сборник справочников

• Возможность хранения, добавления, изменения справочной информации в форматах описанных в "ОБМЕН С КЛИЕНТАМИ БАНКА РОССИИ. КОДОВЫЕ ЗНАЧЕНИЯ РЕКВИЗИТОВ ЭС"
• Интерфейс

---

Сборник справочников:

---

Добавление информации в справочник:

---

• Схема базы данных для справочника

---

Схема справочника:

---

Электронные сообщения

• Механизм пакетного обновления. Обновление справочных данных на основе предоставляемых сведений ЦБ РФ, публикуемого по адресу: http://cbr.ru/Psystem/system_p/ (Справочник БИК – файл в формате XML).
• Механизм ручного добавления xml-файлов. Возможность добавлять собственные xml-файлы соответсвующие формату электронных сообщений ЦБ РФ.
• Интерфейс

---

Электронные сообщения:

---

Добавление информации:

---

Отображение содержимого электронного сообщения:

---

• Cхема базы данных для электронных сообщений

---

Схема электронных сообщений:

---

Исходный код проекта:

• Backend(server) репозиторий
• Frontend(client) репозиторий

Инструкция для запуска

Тестирование на удалённом сервере

Для нашего проекта запущен и доступен онлайн прототип веб-приложения(устарело).

Прототип больше не доступен

Для тестирования бэкенд-сервиса вы можете воспользоваться документацией OpenAPI 3.0 на SwaggerHub

Ссылка на OpenAPI

Тестирование на локальной машине

---

Документация OpenAPI 3.0

Для нашего проекта доступна документация формата OpenAPI 3.0. Ссылка на онлайн документацию

Для локального просмотра документации склонируйте openapi.yaml, а затем импортируйте его в SwaggerEditor.

---

Запуск контейнеров Docker-Compose

Вы можете воспользоваться созданными контейнерами docker:

• Установите docker и docker-compose
• Склонируйте файл docker-compose.yml
• Запустите docker-compose файл(из командной строки находясь в той же директории что и файл) командой docker compose up -d

После этого у вас будут запущены оба контейнера client-server и вы сможете подключиться к ним по адресу http://localhost:3000/

(для доступа только к backend-сервису по адресу http://localhost:8081/)

---

Ручной запуск

Запуск backend(server)

Запуск frontend(client)