Skip to content

QoS B: Alignment with Commonalities r4.3#97

Merged
Masa8106 merged 14 commits into
camaraproject:mainfrom
Masa8106:Masa8106-align-comm-r4.3
Jul 1, 2026
Merged

QoS B: Alignment with Commonalities r4.3#97
Masa8106 merged 14 commits into
camaraproject:mainfrom
Masa8106:Masa8106-align-comm-r4.3

Conversation

@Masa8106

Copy link
Copy Markdown
Contributor

What type of PR is this?

  • correction

What this PR does / why we need it:

  • Align specifications and test plans with the latest guidelines for our next release.

Which issue(s) this PR fixes:

Fixes #84

Special notes for reviewers:

  • This is a continuation of the closed PR#85 with unmerged commits.
  • This is implementation to resolve the warnings detected in PR#93 without CloudEvent-related warnings.

Changelog input

- Align QoS Booking API descriptions to latest guidelines

@Masa8106 Masa8106 requested a review from jlurien as a code owner June 12, 2026 07:57
Comment thread code/Test_definitions/qos-booking.feature Outdated

@jlurien jlurien left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @Masa8106, I amde some suggestions.
We probably should consider replacing schemas available in CAMARA_common.yaml with $ref.

Directly replaceable — equivalent after this PR's changes

Schema Notes
ErrorInfo PR adds format: int32, minimum/maximum on status, maxLength on code/message — same values as common
XCorrelator PR adds description and maxLength: 256 — matches common
Device Structurally equivalent; common has an updated NOTE2 referencing the current Commonalities release
DeviceResponse Equivalent structure
DeviceIpv4Address PR renames from DeviceIpv4Addr and adds the same constraints as common
SingleIpv4Address PR renames from SingleIpv4Addr and adds maxLength: 15 — matches common
DeviceIpv6Address PR adds maxLength: 45 — matches common
PointList, Point, Latitude, Longitude Identical
x-correlator parameter and header Equivalent
Generic400, Generic401, Generic404, Generic410, Generic422, Generic429 Equivalent

PR introduces values that contradict CAMARA_common.yaml

Schema This PR CAMARA_common.yaml Issue
PhoneNumber.maxLength 20 16 E.164 max is + + 15 digits = 16 chars; 20 is incorrect
NetworkAccessIdentifier.maxLength 256 2048 NAI format allows up to 2048 chars; 256 is too restrictive

I have make the suggestions as comments, but replacing these with $ref to the common file would apply the correct values automatically.

We should merge #70 prior to this one and sync this with master.

minItems: 0
maxItems: 100

SinkCredential:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Any reason not to replace this with $ref: "../common/CAMARA_event_common.yaml#/components/schemas/SinkCredential"?

@Masa8106 Masa8106 Jun 30, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When this PR was opened, target release was alpha release and it was not warning not to use $ref;. This is a reason.
Now I know it is warning not to use $ref: for RC release. So let me update it to use $ref: after merging this PR.

Comment thread code/API_definitions/qos-booking.yaml Outdated
Comment thread code/API_definitions/qos-booking.yaml Outdated
Comment thread code/API_definitions/qos-booking.yaml Outdated
Masa8106 and others added 3 commits June 30, 2026 17:14
Co-authored-by: Jose Luis Urien <jlurien@gmail.com>
Co-authored-by: Jose Luis Urien <jlurien@gmail.com>
Co-authored-by: Jose Luis Urien <jlurien@gmail.com>
@Masa8106

Copy link
Copy Markdown
Contributor Author

Hi @jlurien, thank you for raising some suggestions. I am ok with all suggestions from you.
Please review it again. And let me update it to use $ref: after merging this PR, if you are ok.

@jlurien jlurien self-requested a review July 1, 2026 07:20
jlurien
jlurien previously approved these changes Jul 1, 2026

@jlurien jlurien left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please sync this one with master to remove the deprecated feature file. After taht, we can merge this one and open a new one for the external references. I have just done that for qos-provisioning so I can take over the task if you prefer.

@Masa8106

Masa8106 commented Jul 1, 2026

Copy link
Copy Markdown
Contributor Author

Hi @jlurien, thank you for merging other PR about test scenario.
If you are ok, may I ask you that you take over this task?
Or do I need to resolve the conflicts from my side at least?

@jlurien

jlurien commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

For the feature file, it is better to solve it here before merging. For the task of alignment and $ref to CAMARA_common.yaml, I can do it in a separate PR after this one is merged.

@Masa8106

Masa8106 commented Jul 1, 2026

Copy link
Copy Markdown
Contributor Author

To solve the conflicet requires to use the command line (we cannot use Web UI). So let me give some time to solve it.

- qos-booking.yaml: auto-merged cleanly (Commonalities r4.3 constraints
  from PR camaraproject#97 combined with CloudEvent alignment from PRs camaraproject#98 and camaraproject#102)
- qos-booking.feature (monolithic): deleted, superseded by split files
  introduced in PR camaraproject#70; $.device assertion updated in
  qos-booking-getBookingById.feature and
  qos-booking-retrieveBookingByDevice.feature to match PR camaraproject#97 intent
@jlurien jlurien self-requested a review July 1, 2026 11:36
@jlurien

jlurien commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

@Masa8106, I have resolved the conflict myself. Please review everything is fine with the latest changes and merge if it is fine for you

@Masa8106

Masa8106 commented Jul 1, 2026

Copy link
Copy Markdown
Contributor Author

Hi @jlurien, much appreciated that you have kindly resoleved conflicts. Please let me do final review before merge.

@Masa8106 Masa8106 merged commit 9d86dd1 into camaraproject:main Jul 1, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

QoS B: Alignment with Commonalities r4.1

2 participants