feat: PAGOPA-2379 V3 API (#274)

* [PAGOPA-2379] feat: GPD options API

* [PAGOPA-2379] doc: Update README.md

* [PAGOPA-2379] fix

* [PAGOPA-2379] fix(swagger)

* [PAGOPA-2379] refactoring(swagger)

* [PAGOPA-2379] refactoring(swagger)

* [PAGOPA-2379] fix(swagger)

* feat: PAGOPA-2480 V3 API development (#285)

* feat: Add v3 API input mapper

[PAGOPA-2480]
- Mapping from v3 model to entity has been created

* feat: Add v3 API output mapper

[PAGOPA-2480]
- Mapping from entity to v3 response model has been created

* feat: Update v3 Update, Publish

[PAGOPA-2480]
- Update v3 Update CRUD
- Update v3 Publish Action
- Create IPaymentPositionModel interface
- Fix v1 with UNDEFINED_DEBTOR default values

* refactoring: Add Converter and extract class

[PAGOPA-2480]
- Converter PaymentPosition Entity to Model V3 has been added
- In UtilityMapper class have been added common methods to map common PaymentPosition objects

* refactoring: Extract methods

[PAGOPA-2480]

* test: Add JUnit

[PAGOPA-2480]
- Add DebtPositionControllerV3Test

* test: Add JUnit

[PAGOPA-2480]
- Fix ErrorHandler
- Add Create JUnit

* test: Add JUnit DebtPositionControllerV3Test

[PAGOPA-2480]
- Add CRUD test cases for DebtPositionControllerV3Test

* test: Fix JUnit test

[PAGOPA-2480]

* refactoring: Reformat

[PAGOPA-2480]

* refactoring: Resolve sonar issue

[PAGOPA-2480]

* Fix

[PAGOPA-2480]

* test: Add JUnit

[PAGOPA-2480]
- Add JUnit test cases GET debt-position to improve coverage on ConverterV3PPEntityToModelResponse

* test: Refactoring JUnit

[PAGOPA-2480]
- Extract method

* feat: Update GetByNAV response and refactoring

[PAGOPA-2480]
- Update GetByNAV: Add new condition on debtor fields
- Extract UNDEFINED_DEBTOR variable in utility
- Check for status coherence before set to PaymentPositionModelV3 response instance

* Bump to version 0.11.74-1-PAGOPA-2480

* fix: Update Model-Entity converter

[PAGOPA-2480]
- The case (Opzione Unica + Opzione Rateale) has been included

* Bump to version 0.11.74-2-PAGOPA-2480

* Bump to version 0.11.74-3-PAGOPA-2480

* fix: Update Response Converter

[PAGOPA-2480]
- Improperly created outputs: did not map correctly to the entity (caused by replace with setPaymentOption)

* Bump to version 0.11.74-4-PAGOPA-2480

* config(HELM): Decrease probe initial delay

[PAGOPA-2480]

* Bump to version 0.11.74-5-PAGOPA-2480

* config(HELM): Increase probe initial delay

[PAGOPA-2480]

* test(JUnit): Add metadata in test cases

[PAGOPA-2480]

* chore: Adjust v3 validation

[PAGOPA-2480]

* Bump to version 0.11.74-6-PAGOPA-2480

* Bump to version 0.11.75-1-PAGOPA-2480

* chore: Adjust input validation

[PAGOPA-2480]

* chore: Update Swagger config

[PAGOPA-2480]

* Bump to version 0.11.75-2-PAGOPA-2480

* chore: Enhance Null Safety

[PAGOPA-2480]

* Bump to version 0.11.75-3-PAGOPA-2480

* refactoring: Resolve todo

[PAGOPA-2480]
- Update debtor type variable

* Bump to version 0.11.75-4-PAGOPA-2480

---------

Co-authored-by: pagopa-github-bot <[email protected]>

* Bump to version 0.11.75-5-PAGOPA-2379

* refactoring: Update fullName constraint

[PAGOPA-2480]

* refactoring(logging): Sanitize log

[PAGOPA-2480]

* refactoring: Fix some issue

[PAGOPA-2379]

* refactoring: Improve quality

[PAGOPA-2379]
- Remove field injection java:S6813

* refactoring(logging): Sanitize log

[PAGOPA-2379]

* Bump to version 0.11.75-6-PAGOPA-2379

---------

Co-authored-by: Jacopo Carlini <[email protected]>
Co-authored-by: pagopa-github-bot <[email protected]>

README.md

@@ -4,7 +4,10 @@ PagoPA service to manage EC debtor positions
 ## Api Documentation 📖
 ### GPD
 See the internal swagger [OpenApi 3 here.](https://editor.swagger.io/?url=https://raw.githubusercontent.com/pagopa/pagopa-debt-position/main/openapi/openapi_internal.json)
-See the external swagger [OpenApi 3 here.](https://editor.swagger.io/?url=https://raw.githubusercontent.com/pagopa/pagopa-debt-position/main/openapi/openapi_external.json)
+
+See the external swagger version 1 [OpenApi 3 here.](https://editor.swagger.io/?url=https://raw.githubusercontent.com/pagopa/pagopa-debt-position/main/openapi/openapi_external.json)
+
+See the external swagger version 3 [OpenApi 3 here.](https://editor.swagger.io/?url=https://raw.githubusercontent.com/pagopa/pagopa-debt-position/main/openapi/openapi_external_v3.json)
 
 In local env typing following url on browser for ui interface: 
 ```

openapi/generate_openapi.sh

@@ -19,3 +19,5 @@ jq 'del(.paths["/organizations/{organizationfiscalcode}/debtpositions"] | .put,
 # v2: removing single create and get operations from external massive json
 jq 'del( .paths["/organizations/{organizationfiscalcode}/debtpositions"] | .post, .get ) | .paths["/organizations/{organizationfiscalcode}/debtpositions"].post = .paths["/organizations/{organizationfiscalcode}/debtpositions/bulk"].post | del( .paths["/organizations/{organizationfiscalcode}/debtpositions/bulk"])' ./openapi/openapi_external_massive.json > ./openapi/openapi_external_massive.json.temp && mv ./openapi/openapi_external_massive.json.temp ./openapi/openapi_external_massive.json
 
+# external openapi v3
+