From fd4f89bcebcb1fb7e969d8efa9b7e66d40f95665 Mon Sep 17 00:00:00 2001 From: Alberto Ramos Monagas Date: Tue, 19 Aug 2025 12:19:44 +0200 Subject: [PATCH 01/15] Release r1.2 (Fall'25 M4) --- CHANGELOG.md | 41 ++++++++++++++++++- README.md | 11 +++-- .../predictive-connectivity-data.yaml | 4 +- .../predictive-connectivity-data.feature | 4 +- ...nnectivity-data-API-Readiness-Checklist.md | 8 ++-- 5 files changed, 53 insertions(+), 15 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 0fe312b..f72647d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,7 @@ # Changelog CAMARA Predictive Connectivity Data ## Table of Contents +- **[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.** @@ -10,6 +11,44 @@ The below sections record the changes for each API version in each release as fo * for subsequent release-candidate(s), only the delta to the previous release-candidate * for a public release, the consolidated changes since the previous public release +# r1.2 + +## Release Notes +This release contains the definition and documentation of +* predictive-connectivity-data v0.1.0 + +The API definition(s) are based on +* Commonalities v0.6.0 +* Identity and Consent Management v0.4.0 + +## predictive-connectivity-data v0.1.0 + +This is a release candidate for the CAMARA Meta Release Fall25 release of the Predictive Connectivity Data API, version v0.1.0. It contains mainly alignments with the Commonalities v0.6.0. + +- API definition **with inline documentation**: + - OpenAPI [YAML spec file](https://github.com/camaraproject/PredictiveConnectivityData/blob/r1.2/code/API_definitions/predictive-connectivity-data.yaml) + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/PredictiveConnectivityData/r1.2/code/API_definitions/predictive-connectivity-data.yaml&nocors) + - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/PredictiveConnectivityData/r1.2/code/API_definitions/predictive-connectivity-data.yaml) + +In the following there is the list of the modifications with respect to the previous release. + +### Added +* N/A + +### Changed +* Alignment with Commonalities r3.3 by @albertoramosmonagas in https://github.com/camaraproject/PredictiveConnectivityData/pull/33 + +### Fixed +* N/A + +### Removed +* N/A + + ### New Contributors +* @eric-murray made their first contribution in https://github.com/camaraproject/PredictiveConnectivityData/pull/30 + +**Full Changelog**: https://github.com/camaraproject/PredictiveConnectivityData/compare/r1.1...r1.2 + # r1.1 ## Release Notes @@ -22,7 +61,7 @@ The API definition(s) are based on ## predictive-connectivity-data v0.1rc1 -This is a release candidate for the CAMARA Meta Release Fall25 release of the Predictive Connectivity Data API, version v0.1rc1. It contains mainly alignments with the Commonalities v0.6.0-rc.1. +This is a pre-release candidate for the CAMARA Meta Release Fall25 release of the Predictive Connectivity Data API, version v0.1rc1. It contains mainly alignments with the Commonalities v0.6.0-rc.1. - API definition **with inline documentation**: - OpenAPI [YAML spec file](https://github.com/camaraproject/PredictiveConnectivityData/blob/r1.1/code/API_definitions/predictive-connectivity-data.yaml) diff --git a/README.md b/README.md index 492f1d7..401f77b 100644 --- a/README.md +++ b/README.md @@ -28,16 +28,15 @@ Sandbox API Repository to describe, develop, document, and test the PredictiveCo **Version Control Notice:** This project undergoes active development with frequent updates to the main branch. No backward compatibility is guaranteed for any code in development branches, including main, until an official release is published. Code changes, including potential reversions, may occur between commits. We recommend using the latest official release version. -**The first pre-release is [r1.1](https://github.com/camaraproject/PredictiveConnectivityData/releases/tag/r1.1) and cointains the version 0.1.0.** - -* **predictive-connectivity-data v0.1.0-rc.1 (release candidate)** - [[YAML]](https://github.com/camaraproject/PredictiveConnectivityData/blob/r1.1/code/API_definitions/predictive-connectivity-data.yaml) - [[View it on ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/PredictiveConnectivityData/r1.1/code/API_definitions/predictive-connectivity-data.yaml&nocors) - [[View it on Swagger Editor]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/PredictiveConnectivityData/r1.1/code/API_definitions/predictive-connectivity-data.yaml) +**The latest public release of Predictive Connectivity Data is [r1.2](https://github.com/camaraproject/PredictiveConnectivityData/releases/tag/r1.2) and cointains the version 0.1.0.** +- [[YAML]](https://github.com/camaraproject/PredictiveConnectivityData/blob/r1.2/code/API_definitions/predictive-connectivity-data.yaml) +- [[View it on ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/PredictiveConnectivityData/r1.2/code/API_definitions/predictive-connectivity-data.yaml&nocors) +- [[View it on Swagger Editor]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/PredictiveConnectivityData/r1.2/code/API_definitions/predictive-connectivity-data.yaml) +Other releases of this repository are available [here](https://github.com/camaraproject/PredictiveConnectivityData/releases) For changes see [CHANGELOG.md](https://github.com/camaraproject/PredictiveConnectivityData/blob/main/CHANGELOG.md) ## Contributing diff --git a/code/API_definitions/predictive-connectivity-data.yaml b/code/API_definitions/predictive-connectivity-data.yaml index 67e3113..41f5012 100644 --- a/code/API_definitions/predictive-connectivity-data.yaml +++ b/code/API_definitions/predictive-connectivity-data.yaml @@ -124,13 +124,13 @@ info: license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html - version: wip + version: 0.1 x-camara-commonalities: 0.6 externalDocs: description: Product documentation at CAMARA. url: https://github.com/camaraproject/PredictiveConnectivityData servers: - - url: "{apiRoot}/predictive-connectivity-data/vwip" + - url: "{apiRoot}/predictive-connectivity-data/v0.1" variables: apiRoot: default: https://localhost:9091 diff --git a/code/Test_definitions/predictive-connectivity-data.feature b/code/Test_definitions/predictive-connectivity-data.feature index 293fb68..bf21d0f 100644 --- a/code/Test_definitions/predictive-connectivity-data.feature +++ b/code/Test_definitions/predictive-connectivity-data.feature @@ -1,4 +1,4 @@ -Feature: CAMARA Predictive Connectivity Data API, vwip +Feature: CAMARA Predictive Connectivity Data API, v0.1 # Input to be provided by the implementation to the tester # # Implementation indications: @@ -21,7 +21,7 @@ Feature: CAMARA Predictive Connectivity Data API, vwip Background: Common retrieveConnectivity setup Given an environment at "apiRoot" - And the resource "/predictive-connectivity-data/vwip/retrieve" + And the resource "/predictive-connectivity-data/v0.1/retrieve" 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" diff --git a/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md b/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md index 59cabc9..c6a6c28 100644 --- a/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md +++ b/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md @@ -5,15 +5,15 @@ Checklist for predictive-connectivity-data v0.1.0-rc.1 in r1.1. | Nr | API release assets | alpha | release-candidate | initial
public | stable
public | Status | Reference information | |----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----:| | 1 | API definition | M | M | M | M | Y | [link](/code/API_definitions/predictive-connectivity-data.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) | -| 4 | API versioning convention applied | M | M | M | M | Y | v0.1.0-rc.1 | +| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/Commonalities/releases/tag/r3.2) | +| 3 | Guidelines from ICM applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/IdentityAndConsentManagement/releases/tag/r3.2) | +| 4 | API versioning convention applied | M | M | M | M | Y | v0.1.0 | | 5 | API documentation | M | M | M | M | Y | [inline in YAML](/code/API_definitions/predictive-connectivity-data.yaml) | | 6 | User stories | O | O | O | M | N | [link](/documentation/API_documentation/Predictive-Connectivity-Data_User_Story.mdd) | | 7 | Basic API test cases & documentation | O | M | M | M | Y | [link](/code/Test_definitions/predictive-connectivity-data.feature) | | 8 | Enhanced API test cases & documentation | O | O | O | M | Y | [link](/code/Test_definitions/predictive-connectivity-data.feature) | | 9 | Test result statement | O | O | O | M | N | TBC | -| 10 | API release numbering convention applied | M | M | M | M | Y | r1.1 | +| 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 | No | | 13 | API description (for marketing) | O | O | M | M | Y | [Wiki link](https://lf-camaraproject.atlassian.net/wiki/x/owAjBw) | From 020f8cde3c6e7ffdfd6c902989fbc1d9b7b19700 Mon Sep 17 00:00:00 2001 From: Alberto Ramos Monagas Date: Tue, 19 Aug 2025 14:02:55 +0200 Subject: [PATCH 02/15] Apply suggestions from code review Minor fixes in descriptions Co-authored-by: Eric Murray --- CHANGELOG.md | 6 +++--- code/API_definitions/predictive-connectivity-data.yaml | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index f72647d..79e619b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -14,7 +14,7 @@ The below sections record the changes for each API version in each release as fo # r1.2 ## Release Notes -This release contains the definition and documentation of +This public release contains the definition and documentation of * predictive-connectivity-data v0.1.0 The API definition(s) are based on @@ -23,7 +23,7 @@ The API definition(s) are based on ## predictive-connectivity-data v0.1.0 -This is a release candidate for the CAMARA Meta Release Fall25 release of the Predictive Connectivity Data API, version v0.1.0. It contains mainly alignments with the Commonalities v0.6.0. +This is the public release for the CAMARA Meta Release Fall25 release of the Predictive Connectivity Data API, version v0.1.0. It contains mainly alignments with the Commonalities v0.6.0. - API definition **with inline documentation**: - OpenAPI [YAML spec file](https://github.com/camaraproject/PredictiveConnectivityData/blob/r1.2/code/API_definitions/predictive-connectivity-data.yaml) @@ -47,7 +47,7 @@ In the following there is the list of the modifications with respect to the prev ### New Contributors * @eric-murray made their first contribution in https://github.com/camaraproject/PredictiveConnectivityData/pull/30 -**Full Changelog**: https://github.com/camaraproject/PredictiveConnectivityData/compare/r1.1...r1.2 +**Full Changelog**: https://github.com/camaraproject/PredictiveConnectivityData/commits/r1.2 # r1.1 diff --git a/code/API_definitions/predictive-connectivity-data.yaml b/code/API_definitions/predictive-connectivity-data.yaml index 41f5012..205a88c 100644 --- a/code/API_definitions/predictive-connectivity-data.yaml +++ b/code/API_definitions/predictive-connectivity-data.yaml @@ -124,7 +124,7 @@ info: license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html - version: 0.1 + version: 0.1.0 x-camara-commonalities: 0.6 externalDocs: description: Product documentation at CAMARA. From 2b8fce34ca45820407a5a397f793a3fd67dae086 Mon Sep 17 00:00:00 2001 From: Alberto Ramos Monagas Date: Tue, 19 Aug 2025 15:37:05 +0200 Subject: [PATCH 03/15] fix typo on checklist --- .../predictive-connectivity-data-API-Readiness-Checklist.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md b/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md index c6a6c28..45bb4e1 100644 --- a/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md +++ b/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md @@ -5,8 +5,8 @@ Checklist for predictive-connectivity-data v0.1.0-rc.1 in r1.1. | Nr | API release assets | alpha | release-candidate | initial
public | stable
public | Status | Reference information | |----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----:| | 1 | API definition | M | M | M | M | Y | [link](/code/API_definitions/predictive-connectivity-data.yaml) | -| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/Commonalities/releases/tag/r3.2) | -| 3 | Guidelines from ICM applied | O | M | M | M | Y | [r3.3](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 | v0.1.0 | | 5 | API documentation | M | M | M | M | Y | [inline in YAML](/code/API_definitions/predictive-connectivity-data.yaml) | | 6 | User stories | O | O | O | M | N | [link](/documentation/API_documentation/Predictive-Connectivity-Data_User_Story.mdd) | From e365badba62f4eb43d483a0103ac551a3f8c1187 Mon Sep 17 00:00:00 2001 From: Alberto Ramos Monagas Date: Sat, 30 Aug 2025 18:32:14 +0200 Subject: [PATCH 04/15] fix: add rest of changes from r1.1 to r1.2 --- CHANGELOG.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 79e619b..75bd422 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -33,10 +33,12 @@ This is the public release for the CAMARA Meta Release Fall25 release of the Pre In the following there is the list of the modifications with respect to the previous release. ### Added -* N/A +* Add precision, height and signal strenght to the wip version by @albertoramosmonagas in https://github.com/camaraproject/PredictiveConnectivityData/pull/25 ### Changed * Alignment with Commonalities r3.3 by @albertoramosmonagas in https://github.com/camaraproject/PredictiveConnectivityData/pull/33 +* Define first WIP version of Predictive Connectivity Data API by @albertoramosmonagas in https://github.com/camaraproject/PredictiveConnectivityData/pull/20 +* Align commonalities with v0.6-rc1 by @albertoramosmonagas in https://github.com/camaraproject/PredictiveConnectivityData/pull/21 ### Fixed * N/A @@ -46,6 +48,8 @@ In the following there is the list of the modifications with respect to the prev ### New Contributors * @eric-murray made their first contribution in https://github.com/camaraproject/PredictiveConnectivityData/pull/30 +* @hdamker made their first contribution in https://github.com/camaraproject/PredictiveConnectivityData/pull/3 +* @albertoramosmonagas made their first contribution in https://github.com/camaraproject/PredictiveConnectivityData/pull/5 **Full Changelog**: https://github.com/camaraproject/PredictiveConnectivityData/commits/r1.2 From eb1f8c5bea92e29decb44234f67d0ade75b28740 Mon Sep 17 00:00:00 2001 From: Alberto Ramos Monagas Date: Sun, 31 Aug 2025 09:32:11 +0200 Subject: [PATCH 05/15] omit new contributor line as an administrative PR Co-authored-by: Herbert Damker --- CHANGELOG.md | 1 - 1 file changed, 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 75bd422..46087d3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -48,7 +48,6 @@ In the following there is the list of the modifications with respect to the prev ### New Contributors * @eric-murray made their first contribution in https://github.com/camaraproject/PredictiveConnectivityData/pull/30 -* @hdamker made their first contribution in https://github.com/camaraproject/PredictiveConnectivityData/pull/3 * @albertoramosmonagas made their first contribution in https://github.com/camaraproject/PredictiveConnectivityData/pull/5 **Full Changelog**: https://github.com/camaraproject/PredictiveConnectivityData/commits/r1.2 From b3ae0322416ad88d44fca6f53703a5495c6f7165 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Wed, 3 Sep 2025 09:31:43 +0100 Subject: [PATCH 06/15] Update predictive-connectivity-data-API-Readiness-Checklist.md --- .../predictive-connectivity-data-API-Readiness-Checklist.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md b/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md index 45bb4e1..79fda7b 100644 --- a/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md +++ b/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md @@ -1,6 +1,6 @@ # API Readiness Checklist -Checklist for predictive-connectivity-data v0.1.0-rc.1 in r1.1. +Checklist for predictive-connectivity-data v0.1.0 in r1.2 | Nr | API release assets | alpha | release-candidate | initial
public | stable
public | Status | Reference information | |----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----:| From f9512b8a2350b407ee652c4820adbf5d7f48f136 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Wed, 3 Sep 2025 09:33:47 +0100 Subject: [PATCH 07/15] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 401f77b..5a6d1fe 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,7 @@ Sandbox API Repository to describe, develop, document, and test the PredictiveCo **Version Control Notice:** This project undergoes active development with frequent updates to the main branch. No backward compatibility is guaranteed for any code in development branches, including main, until an official release is published. Code changes, including potential reversions, may occur between commits. We recommend using the latest official release version. -**The latest public release of Predictive Connectivity Data is [r1.2](https://github.com/camaraproject/PredictiveConnectivityData/releases/tag/r1.2) and cointains the version 0.1.0.** +**The latest public release of Predictive Connectivity Data is [r1.2](https://github.com/camaraproject/PredictiveConnectivityData/releases/tag/r1.2) and contains version 0.1.0.** - [[YAML]](https://github.com/camaraproject/PredictiveConnectivityData/blob/r1.2/code/API_definitions/predictive-connectivity-data.yaml) - [[View it on ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/PredictiveConnectivityData/r1.2/code/API_definitions/predictive-connectivity-data.yaml&nocors) - [[View it on Swagger Editor]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/PredictiveConnectivityData/r1.2/code/API_definitions/predictive-connectivity-data.yaml) From f93216007b8421ad2cda274bf560cbba18411636 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Wed, 3 Sep 2025 09:34:54 +0100 Subject: [PATCH 08/15] Update README.md --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 5a6d1fe..526f992 100644 --- a/README.md +++ b/README.md @@ -37,6 +37,7 @@ Sandbox API Repository to describe, develop, document, and test the PredictiveCo Other releases of this repository are available [here](https://github.com/camaraproject/PredictiveConnectivityData/releases) + For changes see [CHANGELOG.md](https://github.com/camaraproject/PredictiveConnectivityData/blob/main/CHANGELOG.md) ## Contributing From 458d0468d38277dd196772b2cd1dee547e698f72 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Wed, 3 Sep 2025 09:37:41 +0100 Subject: [PATCH 09/15] Update predictive-connectivity-data.feature --- code/Test_definitions/predictive-connectivity-data.feature | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code/Test_definitions/predictive-connectivity-data.feature b/code/Test_definitions/predictive-connectivity-data.feature index 6c5030d..dd555eb 100644 --- a/code/Test_definitions/predictive-connectivity-data.feature +++ b/code/Test_definitions/predictive-connectivity-data.feature @@ -1,4 +1,4 @@ -Feature: CAMARA Predictive Connectivity Data API, v0.1 +Feature: CAMARA Predictive Connectivity Data API, v0.1.0 # Input to be provided by the implementation to the tester # # Implementation indications: From 6c4c7d4a3235fd926c7bb376e557126b09ab51f2 Mon Sep 17 00:00:00 2001 From: Alberto Ramos Monagas Date: Tue, 9 Sep 2025 11:28:27 +0200 Subject: [PATCH 10/15] fix: apply minor version changes --- code/API_definitions/predictive-connectivity-data.yaml | 2 +- code/Test_definitions/predictive-connectivity-data.feature | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/code/API_definitions/predictive-connectivity-data.yaml b/code/API_definitions/predictive-connectivity-data.yaml index 922c106..0c07441 100644 --- a/code/API_definitions/predictive-connectivity-data.yaml +++ b/code/API_definitions/predictive-connectivity-data.yaml @@ -124,7 +124,7 @@ info: license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html - version: 0.1.0 + version: 0.1 x-camara-commonalities: 0.6 externalDocs: description: Product documentation at CAMARA. diff --git a/code/Test_definitions/predictive-connectivity-data.feature b/code/Test_definitions/predictive-connectivity-data.feature index dd555eb..6c5030d 100644 --- a/code/Test_definitions/predictive-connectivity-data.feature +++ b/code/Test_definitions/predictive-connectivity-data.feature @@ -1,4 +1,4 @@ -Feature: CAMARA Predictive Connectivity Data API, v0.1.0 +Feature: CAMARA Predictive Connectivity Data API, v0.1 # Input to be provided by the implementation to the tester # # Implementation indications: From 78f42743f6a2727bcb9f4b4e0e4c7ce217697bd7 Mon Sep 17 00:00:00 2001 From: Alberto Ramos Monagas Date: Tue, 9 Sep 2025 11:32:28 +0200 Subject: [PATCH 11/15] revert last commit --- code/API_definitions/predictive-connectivity-data.yaml | 2 +- code/Test_definitions/predictive-connectivity-data.feature | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/code/API_definitions/predictive-connectivity-data.yaml b/code/API_definitions/predictive-connectivity-data.yaml index 0c07441..922c106 100644 --- a/code/API_definitions/predictive-connectivity-data.yaml +++ b/code/API_definitions/predictive-connectivity-data.yaml @@ -124,7 +124,7 @@ info: license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html - version: 0.1 + version: 0.1.0 x-camara-commonalities: 0.6 externalDocs: description: Product documentation at CAMARA. diff --git a/code/Test_definitions/predictive-connectivity-data.feature b/code/Test_definitions/predictive-connectivity-data.feature index 6c5030d..dd555eb 100644 --- a/code/Test_definitions/predictive-connectivity-data.feature +++ b/code/Test_definitions/predictive-connectivity-data.feature @@ -1,4 +1,4 @@ -Feature: CAMARA Predictive Connectivity Data API, v0.1 +Feature: CAMARA Predictive Connectivity Data API, v0.1.0 # Input to be provided by the implementation to the tester # # Implementation indications: From b109033195f98c656bccc46fa4f229feae442b37 Mon Sep 17 00:00:00 2001 From: Ludovic Robert <30499179+bigludo7@users.noreply.github.com> Date: Wed, 10 Sep 2025 09:42:04 +0200 Subject: [PATCH 12/15] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 526f992..09bf73d 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,7 @@ Sandbox API Repository to describe, develop, document, and test the PredictiveCo **Version Control Notice:** This project undergoes active development with frequent updates to the main branch. No backward compatibility is guaranteed for any code in development branches, including main, until an official release is published. Code changes, including potential reversions, may occur between commits. We recommend using the latest official release version. -**The latest public release of Predictive Connectivity Data is [r1.2](https://github.com/camaraproject/PredictiveConnectivityData/releases/tag/r1.2) and contains version 0.1.0.** +The **NEW** latest public release of Predictive Connectivity Data is [r1.2](https://github.com/camaraproject/PredictiveConnectivityData/releases/tag/r1.2) and contains version 0.1.0. - [[YAML]](https://github.com/camaraproject/PredictiveConnectivityData/blob/r1.2/code/API_definitions/predictive-connectivity-data.yaml) - [[View it on ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/PredictiveConnectivityData/r1.2/code/API_definitions/predictive-connectivity-data.yaml&nocors) - [[View it on Swagger Editor]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/PredictiveConnectivityData/r1.2/code/API_definitions/predictive-connectivity-data.yaml) From f17355df261ee7ed4a5ca0b499b811bef5e5b17d Mon Sep 17 00:00:00 2001 From: Alberto Ramos Monagas Date: Wed, 10 Sep 2025 12:00:49 +0200 Subject: [PATCH 13/15] fix: subscriptions APIs must include notificationsBearerAuth security scheme and remove date-time attribute description --- .../predictive-connectivity-data.yaml | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/code/API_definitions/predictive-connectivity-data.yaml b/code/API_definitions/predictive-connectivity-data.yaml index 922c106..7c59c2b 100644 --- a/code/API_definitions/predictive-connectivity-data.yaml +++ b/code/API_definitions/predictive-connectivity-data.yaml @@ -272,11 +272,19 @@ paths: $ref: '#/components/responses/Generic403' "410": $ref: "#/components/responses/Generic410" + security: + - {} + - notificationsBearerAuth: [] components: securitySchemes: openId: type: openIdConnect openIdConnectUrl: https://example.com/.well-known/openid-configuration + notificationsBearerAuth: + description: Bearer authentication for notifications + type: http + scheme: bearer + bearerFormat: '{$request.body#sinkCredential.credentialType}' headers: x-correlator: description: Correlation id for the different services. @@ -307,17 +315,13 @@ components: format: date-time description: >- Start date time. It must follow [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) - and must have time zone. Recommended format is - YYYY-MM-dd'T'HH:mm:ss.SSSZ (i.e. which allows - 2023-07-03T14:27:08.312+02:00 or 2023-07-03T12:27:08.312Z). + and must have time zone. endTime: type: string format: date-time description: >- End date time. It must follow [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) - and must have time zone. Recommended format is - YYYY-MM-dd'T'HH:mm:ss.SSSZ (i.e. which allows - 2023-07-03T14:27:08.312+02:00 or 2023-07-03T12:27:08.312Z). + and must have time zone. networkType: $ref: '#/components/schemas/NetworkType' precision: @@ -496,7 +500,6 @@ components: REQUIRED. An absolute (UTC) timestamp at which the token shall be considered expired. If the access token is a JWT and registered "exp" (Expiration Time) claim is present, the two expiry times should match. It must follow [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and must have time zone. - Recommended format is yyyy-MM-dd'T'HH:mm:ss.SSSZ (i.e. which allows 2023-07-03T14:27:08.312+02:00 or 2023-07-03T12:27:08.312Z) example: "2023-07-03T12:27:08.312Z" accessTokenType: description: REQUIRED. Type of the access token (See [OAuth 2.0](https://tools.ietf.org/html/rfc6749#section-7.1)). For the current version of the API the type MUST be set to `Bearer`. @@ -524,7 +527,6 @@ components: REQUIRED. An absolute (UTC) timestamp at which the token shall be considered expired. If the access token is a JWT and registered "exp" (Expiration Time) claim is present, the two expiry times should match. It must follow [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and must have time zone. - Recommended format is yyyy-MM-dd'T'HH:mm:ss.SSSZ (i.e. which allows 2023-07-03T14:27:08.312+02:00 or 2023-07-03T12:27:08.312Z) example: "2023-07-03T12:27:08.312Z" accessTokenType: description: REQUIRED. Type of the access token (See [OAuth 2.0](https://tools.ietf.org/html/rfc6749#section-7.1)). @@ -630,16 +632,14 @@ components: format: date-time description: >- Interval start time. It must follow [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) - and must have time zone. Recommended format is yyyy-MM-dd'T'HH:mm:ss.SSSZ - (i.e. which allows 2023-07-03T14:27:08.312+02:00 or 2023-07-03T12:27:08.312Z) + and must have time zone. example: "2023-07-03T10:00:00Z" endTime: type: string format: date-time description: >- Interval end time. It must follow [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) - and must have time zone. Recommended format is yyyy-MM-dd'T'HH:mm:ss.SSSZ - (i.e. which allows 2023-07-03T14:27:08.312+02:00 or 2023-07-03T12:27:08.312Z) + and must have time zone. example: "2023-07-03T11:00:00Z" cellConnectivityData: $ref: '#/components/schemas/CellConnectivityDataArray' From 02575309b2e9f470fa7d005ddb8f7ad1cbe63ab8 Mon Sep 17 00:00:00 2001 From: Alberto Ramos Monagas Date: Mon, 15 Sep 2025 14:40:48 +0200 Subject: [PATCH 14/15] fix: Add comment on CloudEvents compliance pending (ref #38) in readiness checklist --- .../predictive-connectivity-data-API-Readiness-Checklist.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md b/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md index 79fda7b..7ce1f5d 100644 --- a/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md +++ b/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md @@ -5,7 +5,9 @@ Checklist for predictive-connectivity-data v0.1.0 in r1.2 | Nr | API release assets | alpha | release-candidate | initial
public | stable
public | Status | Reference information | |----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----:| | 1 | API definition | M | M | M | M | Y | [link](/code/API_definitions/predictive-connectivity-data.yaml) | -| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/Commonalities/releases/tag/r3.3) | +| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/Commonalities/releases/tag/r3.3) - The asynchronous response currently does not follow the CloudEvents delivery format as required by Commonalities r3.3. +See Issue #38. +This will be addressed post-Fall’25 and released as v0.2.0 to ensure full compliance. | | 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 | v0.1.0 | | 5 | API documentation | M | M | M | M | Y | [inline in YAML](/code/API_definitions/predictive-connectivity-data.yaml) | From 7028ba6c4f0bca69c972906f96388e3f4c48d386 Mon Sep 17 00:00:00 2001 From: Alberto Ramos Monagas Date: Mon, 15 Sep 2025 15:00:39 +0200 Subject: [PATCH 15/15] fix: add better formating to the table --- .../predictive-connectivity-data-API-Readiness-Checklist.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md b/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md index 7ce1f5d..7238021 100644 --- a/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md +++ b/documentation/API_documentation/predictive-connectivity-data-API-Readiness-Checklist.md @@ -5,9 +5,7 @@ Checklist for predictive-connectivity-data v0.1.0 in r1.2 | Nr | API release assets | alpha | release-candidate | initial
public | stable
public | Status | Reference information | |----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----:| | 1 | API definition | M | M | M | M | Y | [link](/code/API_definitions/predictive-connectivity-data.yaml) | -| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/Commonalities/releases/tag/r3.3) - The asynchronous response currently does not follow the CloudEvents delivery format as required by Commonalities r3.3. -See Issue #38. -This will be addressed post-Fall’25 and released as v0.2.0 to ensure full compliance. | +| 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 | v0.1.0 | | 5 | API documentation | M | M | M | M | Y | [inline in YAML](/code/API_definitions/predictive-connectivity-data.yaml) | @@ -20,6 +18,8 @@ This will be addressed post-Fall’25 and released as v0.2.0 to ensure full comp | 12 | Previous public release was certified | O | O | O | M | N | No | | 13 | API description (for marketing) | O | O | M | M | Y | [Wiki link](https://lf-camaraproject.atlassian.net/wiki/x/owAjBw) | +*** *The asynchronous response currently does not follow the CloudEvents delivery format as required by Commonalities r3.3. See Issue [#38](https://github.com/camaraproject/PredictiveConnectivityData/issues/38). This will be addressed post-Fall’25 and released as v0.2.0 to ensure full compliance* + To fill the checklist: - in the line above the table, replace the api-name, api-version and the rx.y by their actual values for the current API version and release. - in the Status column, put "Y" (yes) if the release asset is available or fulfilled in the current release, a "N" (no) or a "tbd". Example use of "tbd" is in case an alpha or release-candidate API version does not yet provide all mandatory assets for the release.