You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
TASK: Add OpenAPI and Swagger UI standard for Spring services #82
Parent: STORY: Establish API contract and documentation standards
Define the Sprint 1 OpenAPI baseline for Spring Boot REST services.
Acceptance criteria
Spring Boot services use the approved springdoc-openapi integration.
Each contract has an explicit title, description, and semantic contract version.
Each service exposes its contract at /v3/api-docs inside the cluster.
API Gateway exposes the contract through /admin/docs/{service}/v3/api-docs.
Documented error responses use application/problem+json.
Pagination and monetary fields follow the platform conventions.
Examples use synthetic data and contain no credentials or customer information.
Security schemes and environment-specific production access controls are covered by .github#85 in Sprint 4. Kafka/AsyncAPI contracts are covered by .github#86 and .github#104 in Sprint 3.
Spring REST/OpenAPI baseline completed. Customer and Account Services now publish explicit OpenAPI metadata and tests through customer-service#34 and account-service#32.
Activity
ramioooz commentedon Aug 3, 2026
Implementation PRs:\n- Organization OpenAPI conventions: https://github.com/digital-bank-java/.github/pull/129\n- Customer Service: https://github.com/digital-bank-java/customer-service/pull/34\n- Account Service: digital-bank-java/account-service#32
ramioooz commentedon Aug 3, 2026
Spring REST/OpenAPI baseline completed. Customer and Account Services now publish explicit OpenAPI metadata and tests through customer-service#34 and account-service#32.