feat: Add Swagger UI integration

[najuna-brian]

Add Swagger UI Integration

Adds interactive API documentation at /openapi/swagger. Closes #21

• Serves Swagger UI from /openapi route
• Redirects /openapi/swagger to /openapi/swagger-ui.html
• Updates Dockerfile to include openapi directory

All tests pass.

Test Swagger UI endpoints locally

curl http://localhost/openapi/swagger or curl http://localhost/openapi/swagger-ui.html

[najuna-brian]

Hi @r0ssing , @Ndacyayisenga-droid,

There is a CI/CD build failure is due to an invalid Docker tag format (unrelated to this PR). The SHA tag generation on line 70 creates tags starting with a dash (:-035e261), which is invalid.

Suggested fix: Update line 70 to use a fixed prefix and exclude PRs:

type=sha,prefix=sha-,enable=${{ github.event_name != 'release' && github.event_name != 'pull_request' }}

PRs already get pr-22 tags, so SHA tagging can be skipped for them.

[r0ssing]

This looks great!
And thanks for fixing the pipeline as well - this is the first "official" merge we do from a PR! 🥇 🥳

[r0ssing]

Not sure what practice we should follow - but I've have approved the PR, then I will leave it for you to merge (or rebase) - we can discuss the best approach at our next weekly meeting 🗣️

[najuna-brian]

Thanks @r0ssing,

we can discuss the best approach at our next weekly meeting 🗣️

We may be shall merge the PR during our meeting or after it? 😃

[najuna-brian]

We may be shall merge the PR during our meeting or after it? 😃

Now merged after meeting