docs: add OpenAPI documentation with Scalar UI

Browse Source

- Add swaggo annotations to all HTTP handlers
- Add Swagger/OpenAPI spec generation with swag
- Create separate docs server binary (drexa-docs)
- Add Makefile with build, run, and docs targets
- Configure Scalar as the API documentation UI

Run 'make docs' to regenerate, 'make run-docs' to serve.

...

This commit is contained in:

Kenneth

2025-12-13 22:44:37 +00:00

parent 918b85dfd5

commit 7b13326e22

18 changed files with 4853 additions and 59 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

1601

apps/backend/docs/docs.go Normal file

File diff suppressed because it is too large Load Diff

1577

apps/backend/docs/swagger.json Normal file

File diff suppressed because it is too large Load Diff

1078

apps/backend/docs/swagger.yaml Normal file

File diff suppressed because it is too large Load Diff