SelfCare BackOffice

Microservice to manage PagoPA Backoffice

• SelfCare BackOffice
  • Api Documentation 📖
  • Technology Stack
  • Develop Locally 💻
    • Prerequisites
    • Run the project
    • Spring Profiles
    • Testing 🧪
      • Unit testing
      • Integration testing
  • Contributors 👥
    • Maintainers

---

Api Documentation 📖

See the OpenApi 3 here.

---

Technology Stack

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

---

Develop Locally 💻

Prerequisites

• git
• maven
• jdk-17

Run the project

Start the springboot application with this command:

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

Local Environment

👀 You need to put in your local environment some variables

If you have access to azure dev, you can use ./infra/sops.sh script to decrypt ./infra/env/dev/encrypted_env to create a valid env file. You need to have sops installed.

An example:

API_CONFIG_SERVICE_URL=https://api.dev.platform.pagopa.it
AWS_ACCESS_KEY_ID=***
AWS_REGION=eu-south-1
AWS_SECRET_ACCESS_KEY=***
AWS_SES_USER=noreply@selfcare.pagopa.it
AZURE_CLIENT_ID=***
AZURE_CLIENT_SECRET=****
RESOURCE_GROUP=pagopa-d-api-rg
SERVICE_NAME=pagopa-d-apim
AZURE_SID=***
SUBSCRIPTION_ID=***
TENANT_ID=***
ENV=local
EXTERNAL_API_SERVICE_URL=https://api.dev.selfcare.pagopa.it
JIRA_PASSWORD=***
MONGODB_CONNECTION_URI=***
PAGOPA_APIM_API_CONFIG_API_KEY_PAGOPA=***
PAGOPA_APIM_API_CONFIG_SELFCARE_INTEGRATION_API_KEY_PAGOPA=***
PAGOPA_APIM_SERVICE_URL=https://api.dev.platform.pagopa.it
PAGOPA_SELFCARE_INTEGRATION_APIM_SERVICE_URL=https://api.dev.platform.pagopa.it
PAPGOPA_APIM_GEC_API_KEY_PAGOPA=***
PAPGOPA_APIM_GPD_API_KEY_PAGOPA=***
PAPGOPA_APIM_TAXONOMY_API_KEY_PAGOPA=***
SELFCARE_APIM_API_CONFIG_API_KEY_PAGOPA=***
SELFCARE_APIM_EXTERNAL_API_KEY_PAGOPA=***
TEST_EMAIL=***

Spring Profiles

• local: to develop locally.
• 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

---

Contributors 👥

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

Maintainers

See CODEOWNERS file