README.md

pagoPa Api Config - SelfCare integration

Spring Application that exposes a subset of the APIs to manage configuration for EC/PSP on the Nodo dei Pagamenti, needed by PagoPA SelfCare application.

• pagoPa Api Config - SelfCare integration
  • Api Documentation 📖
  • Technology Stack
  • Start Project Locally 🚀
    • Prerequisites
    • Run docker container
  • Develop Locally 💻
    • Prerequisites
    • Run the project
    • Spring Profiles
    • Testing 🧪
      • Unit testing
      • Integration testing
      • Performance testing
  • Contributors 👥
    • Maintainers

---

Api Documentation 📖

See the OpenApi 3 here.

---

Technology Stack

• Java 17
• Spring Boot
• Spring Web
• Hibernate
• JPA

---

Start Project Locally 🚀

Prerequisites

• docker

Run docker container

from ./docker directory

sh ./run_docker.sh dev

ℹ️ Note: for PagoPa ACR is required the login az acr login -n <acr-name>

---

Develop Locally 💻

Prerequisites

• git
• maven
• jdk-11

Run the project

Start the springboot application with this command for local test:

mvn spring-boot:run -Dspring.profiles.active=local

or, for H2 tests:

mvn spring-boot:run -Dspring.profiles.active=h2

Using the spring profile local, the Spring application connects to the H2 in-memory DB.
For access to H2 console, use this url: http://localhost:8080/h2-console/

Spring Profiles

• local: to develop locally, pointing to DEV database.
• h2: to develop locally, pointing to local H2 database.
• default (no profile set): The application gets the properties from the environment (for Azure).

Testing 🧪

Unit testing

To run the Junit tests:

mvn clean verify

Integration testing

From ./integration-test/src

1. yarn install
2. yarn test

Performance testing

install k6 and then from ./performance-test/src

1. k6 run --env VARS=local.environment.json --env TEST_TYPE=./test-types/load.json main_scenario.js

---

Contributors 👥

Made with ❤️ by PagoPa S.p.A.

Maintainers

See CODEOWNERS file