swaran21 opened a new pull request, #6475:
URL: https://github.com/apache/fineract/pull/6475

   ## Description
   
   FINERACT-2830 corrects the OpenAPI response schemas for:
   
   - `GET /v1/templates/template`
   - `GET /v1/templates/{templateId}/template`
   
   Both resource methods return `TemplateDetailsData`, but their OpenAPI 
annotations previously declared `TemplateData`.
   This change updates the two response annotations to `TemplateDetailsData`.
   The generated OpenAPI specification now correctly exposes:
   - `entities` as an array
   - `types` as an array
   - `template` as nested `TemplateData`
   
   No runtime behavior, business logic, database behavior, or API response 
payload has changed.
   
   ### Verification
   - Ran `:fineract-provider:test --tests 
org.apache.fineract.template.api.TemplatesApiResourceTest`
   - Ran `:fineract-provider:resolve`
   - Verified both operations in the generated OpenAPI specification reference 
`#/components/schemas/TemplateDetailsData`
   
   The client OpenAPI validation currently reports missing `default` response 
descriptions for these two operations. Those descriptions were absent before 
this schema correction. I will follow maintainer guidance on whether they 
belong in this ticket.
   
   ## Checklist
   
   Please make sure these boxes are checked before submitting your pull request 
- thanks!
   
   - [ ] Write the commit message as per [our 
guidelines](https://github.com/apache/fineract/blob/develop/CONTRIBUTING.md#pull-requests)
   - [ ] Acknowledge that we will not review PRs that are not passing the build 
_("green")_ - it is your responsibility to get a proposed PR to pass the build, 
not primarily the project's maintainers.
   - [ ] Create/update [unit or integration 
tests](https://fineract.apache.org/docs/current/#_testing) for verifying the 
changes made.
   - [ ] Follow our [coding 
conventions](https://cwiki.apache.org/confluence/display/FINERACT/Coding+Conventions).
   - [ ] Add required Swagger annotation and update API documentation at 
fineract-provider/src/main/resources/static/legacy-docs/apiLive.htm with 
details of any API changes
   - [ ] [This PR must not be a "code 
dump"](https://cwiki.apache.org/confluence/display/FINERACT/Pull+Request+Size+Limit).
 Large changes can be made in a branch, with assistance. Ask for help on the 
[developer mailing list](https://fineract.apache.org/#contribute).
   - [ ] If merging this PR resolves a JIRA issue, I will mark that issue as 
resolved and set "Fix Version/s" appropriately.
   - [ ] I followed the [AI 
Policy](https://github.com/apache/fineract/blob/develop/CONTRIBUTING.md#ai-policy).
   
   Your assigned reviewer(s) will follow our [guidelines for code 
reviews](https://cwiki.apache.org/confluence/display/FINERACT/Code+Review+Guide).
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to