Backend: Generate and publish OpenAPI from backend route schemas

[Princess-peekay]

Problem

Backend routes/validation live in code while spec maintenance appears separate.

Impact

Spec drift can break frontend integration and external consumers.

Acceptance Criteria

• Introduce a workflow to generate/update OpenAPI from route schemas or route metadata.
• Add CI check to detect spec drift.
• Document regeneration and publishing workflow.

[Obiajulu-gif]

@Obiajulu-gif has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

My Cheif, I am a full stack dev, I will love to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Obiajulu-gif to this issue.

[yusstyle]

@yusstyle has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

hello can i work on this

ℹ️ Repo Maintainers: To accept this application, review their application or assign @yusstyle to this issue.

[Elite-tch]

@Elite-tch has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

Please can i work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Elite-tch to this issue.

[jahrulezfrancis]

@jahrulezfrancis has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

I’d like to work on generating and publishing OpenAPI from backend route schemas.

I have experience aligning backend validation with API documentation to prevent spec drift. I’ll implement a workflow to generate OpenAPI directly from route schemas/metadata, add a CI check to catch drift early, and document the regeneration and publishing process for consistency across the team.

I’ll keep the setup simple, maintainable, and easy to extend as new routes are added.

ETA: 6–8 hours

ℹ️ Repo Maintainers: To accept this application, review their application or assign @jahrulezfrancis to this issue.

[iGEORGE17]

@iGEORGE17 has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

I'd like to work on this issue.
thank you for your consideration 🙏🏻

ℹ️ Repo Maintainers: To accept this application, review their application or assign @iGEORGE17 to this issue.