Release r1.2 (Fall'25 M4)

CHANGELOG.md

@@ -3,7 +3,8 @@
 
 ## Table of Contents
 
-- **[r1.1](#r11)**
+- **[r1.2](#r12)**
+- [r1.1](#r11)
 
 **Please be aware that the project will have frequent updates to the main branch. There are no compatibility guarantees associated with code in any branch, including main, until it has been released. For example, changes may be reverted before a release is published. For the best results, use the latest published release.**
 
@@ -16,6 +17,41 @@ The below sections record the changes for each API version in each release as fo
 
 **A previous changelog for this API can be found here: https://github.com/camaraproject/KnowYourCustomer/blob/main/CHANGELOG.md**
 
+# r1.2
+
+## Release Notes
+
+This public release contains the definition and documentation of:
+* know-your-customer-match v0.4.0 
+
+The API definition(s) are based on
+* Commonalities v0.6.0 [r3.3](https://github.com/camaraproject/Commonalities/releases/tag/r3.3)
+* Identity and Consent Management v0.4.0 [r3.3](https://github.com/camaraproject/IdentityAndConsentManagement/releases/tag/r3.3)
+
+## know-your-customer-match v0.4.0
+This is the latest public release for the CAMARA KnowYourCustomer Match API, updating the previous release to the CAMARA Guidelines and Identity & Consent Management for the Meta Release Fall25. Some new input paramenters, to be matched, have been introduced.
+
+- API definition **with inline documentation**:
+  - OpenAPI [YAML spec file](https://github.com/camaraproject/KnowYourCustomerMatch/blob/r1.2/code/API_definitions/kyc-match.yaml)
+  - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/KnowYourCustomerMatch/r1.2/code/API_definitions/kyc-match.yaml&nocors)
+  - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/KnowYourCustomerMatch/r1.2/code/API_definitions/kyc-match.yaml)
+
+### Added
+ * N/A
+
+### Changed
+ * N/A
+
+### Fixed
+ * Fixed the new issues post M3 to meet M4 by @FabrizioMoggio in PR#28 (Wip for M4) https://github.com/camaraproject/KnowYourCustomerMatch/pull/28
+
+### Removed
+ * Removed wrong value in test plan by @fernandopradocabrillo in PR#26 https://github.com/camaraproject/KnowYourCustomerMatch/pull/26
+
+**Full Changelog**: https://github.com/camaraproject/KnowYourCustomerMatch/commits/r1.1...r1.2
+
+
+
 # r1.1
 
 ## Release Notes

README.md

@@ -26,11 +26,16 @@ Incubating API Repository to evolve and maintain the definitions and documentati
 
 * Note: Please be aware that the project will have updates to the main branch. There are no compatibility guarantees associated with code in any branch, including main, until a new release is created. For example, changes may be reverted before a release is created. For best results, use the latest available release.
 
-* **NEW:  Pre-release of CAMARA KYC Match is [r1.1](https://github.com/camaraproject/KnowYourCustomerMatch/tree/r1.1)**. The Release Tag is [r1.1](https://github.com/camaraproject/KnowYourCustomerMatch/releases/tag/r1.1).
+* **NEW:  The latest public release of CAMARA KYC Match is [r1.2](https://github.com/camaraproject/KnowYourCustomerMatch/tree/r1.2)**. The Release Tag is [r1.2](https://github.com/camaraproject/KnowYourCustomerMatch/releases/tag/r1.2).
 
-**Releases of the KnowYourCustomerMatch API until Spring25 are available in [KnowYourCustomer](https://github.com/camaraproject/KnowYourCustomer).**
+* API definition **with inline documentation**:
+  - OpenAPI [YAML spec file](https://github.com/camaraproject/KnowYourCustomerMatch/blob/r1.2/code/API_definitions/kyc-match.yaml)
+  - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/KnowYourCustomerMatch/r1.2/code/API_definitions/kyc-match.yaml&nocors)
+  - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/KnowYourCustomerMatch/r1.2/code/API_definitions/kyc-match.yaml&nocors)
 
-For changes see [CHANGELOG.md](https://github.com/camaraproject/KnowYourCustomerMatch/blob/main/CHANGELOG.md)
+* **Releases of the KnowYourCustomerMatch API until Spring25 are available in [KnowYourCustomer](https://github.com/camaraproject/KnowYourCustomer).**
+
+* For changes see [CHANGELOG.md](https://github.com/camaraproject/KnowYourCustomerMatch/blob/main/CHANGELOG.md)
 
 ## Contributing
 

code/API_definitions/kyc-match.yaml

@@ -25,7 +25,7 @@ info:
 
     The following figure is the generic high-level flows of this API.
 
-    <img width="848" alt="KYC_Match_flow" src="https://raw.githubusercontent.com/camaraproject/KnowYourCustomerMatch/r1.1/documentation/API_documentation/assets/kyc-match_flow.png">
+    <img width="848" alt="KYC_Match_flow" src="https://raw.githubusercontent.com/camaraproject/KnowYourCustomerMatch/r1.2/documentation/API_documentation/assets/kyc-match_flow.png">
 
     Note:
 
@@ -67,12 +67,12 @@ info:
   license:
     name: Apache 2.0
     url: https://www.apache.org/licenses/LICENSE-2.0.html
-  version: wip
+  version: 0.4.0
 
   x-camara-commonalities: 0.6
 
 servers:
-  - url: '{apiRoot}/kyc-match/vwip'
+  - url: '{apiRoot}/kyc-match/v0.4'
     variables:
       apiRoot:
         default: http://localhost:9091

code/Test_definitions/kyc-match.feature

@@ -1,4 +1,4 @@
-Feature: CAMARA Know Your Customer Match API, vwip - Operation KYC_Match
+Feature: CAMARA Know Your Customer Match API, v0.4.0 - Operation KYC_Match
   # Input to be provided by the implementation to the tester
   #
   # Implementation indications:
@@ -7,11 +7,11 @@ Feature: CAMARA Know Your Customer Match API, vwip - Operation KYC_Match
   # Testing assets:
   # * A mobile line identified by its phone number "phoneNumber"
   #
-  # References to OAS spec schemas refer to schemas specifies in kyc-match.yaml, version wip
+  # References to OAS spec schemas refer to schemas specifies in kyc-match.yaml, version 0.4.0
 
   Background: Common KYC_Match setup
     Given an environment at "apiRoot"
-    And the resource "/kyc-match/vwip/match"
+    And the resource "/kyc-match/v0.4/match"
     And the header "Content-Type" is set to "application/json"
     And the header "Authorization" is set to a valid access token
     And the header "x-correlator" complies with the schema at "#/components/schemas/XCorrelator"
@@ -341,4 +341,4 @@ Feature: CAMARA Know Your Customer Match API, vwip - Operation KYC_Match
     Then the response status code is 422
     And the response property "$.status" is 422
     And the response property "$.code" is "SERVICE_NOT_APPLICABLE"
-    And the response property "$.message" contains a user friendly text
+    And the response property "$.message" contains a user friendly text

documentation/API_documentation/kyc-match-API-Readiness-Checklist.md

@@ -1,19 +1,19 @@
 # API Readiness Checklist
 
-Checklist for kyc-match 0.4.0-rc.1 in release r1.1
+Checklist for kyc-match 0.4.0 in release r1.2
 
 | Nr | API release assets  | alpha | release-candidate |  initial<br>public | stable<br> public | Status | Reference information |
 |----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----:|
 |  1 | API definition                               |   M   |         M         |    M    |    M   |  Y   | [link](/code/API_definitions/kyc-match.yaml) |
-|  2 | Design guidelines from Commonalities applied |   O   |         M         |    M    |    M   |  Y   | [r3.2](https://github.com/camaraproject/Commonalities/releases/tag/r3.2) |
-|  3 | Guidelines from ICM applied                  |   O   |         M         |    M    |    M   |  Y   | [r3.2](https://github.com/camaraproject/IdentityAndConsentManagement/releases/tag/r3.2) |
+|  2 | Design guidelines from Commonalities applied |   O   |         M         |    M    |    M   |  Y   | [r3.3](https://github.com/camaraproject/Commonalities/releases/tag/r3.3) |
+|  3 | Guidelines from ICM applied                  |   O   |         M         |    M    |    M   |  Y   | [r3.3](https://github.com/camaraproject/IdentityAndConsentManagement/releases/tag/r3.3) |
 |  4 | API versioning convention applied            |   M   |         M         |    M    |    M   |  Y   |      |
 |  5 | API documentation                            |   M   |         M         |    M    |    M   |  Y   | Embedded documentation into API spec - [link](/code/API_definitions/kyc-match.yaml) |
 |  6 | User stories                                 |   O   |         O         |    O    |    M   |  Y   | [link](/documentation/API_documentation/KnowYourCustomer_User_Story.md) |
 |  7 | Basic API test cases & documentation         |   O   |         M         |    M    |    M   |  Y   | [link](/code/Test_definitions/kyc-match.feature) |
 |  8 | Enhanced API test cases & documentation      |   O   |         O         |    O    |    M   |  Y   | [link](/code/Test_definitions/kyc-match.feature) |
 |  9 | Test result statement                        |   O   |         O         |    O    |    M   |  N   |      |
-| 10 | API release numbering convention applied     |   M   |         M         |    M    |    M   |  Y   |      |
+| 10 | API release numbering convention applied     |   M   |         M         |    M    |    M   |  Y   | r1.2 |
 | 11 | Change log updated                           |   M   |         M         |    M    |    M   |  Y   | [link](/CHANGELOG.md) |
 | 12 | Previous public release was certified        |   O   |         O         |    O    |    M   |  N   |      |
 | 13 | API description (for marketing)              |   O   |         O         |    M    |    M   |  Y   | [wiki link](https://lf-camaraproject.atlassian.net/wiki/x/RwAzC) |