Simplify OpenAPI generation

This commit is contained in:
gabdevele
2026-06-03 02:04:56 +02:00 Unverified
parent 21883a4a8f
commit 25c280f38b
25 changed files with 2695 additions and 1944 deletions
+3 -6
View File
@@ -8,16 +8,13 @@
- Added report media uploads at `POST /api/v1/reports/{id}/media`.
- Supported JPEG, PNG, WebP, MP4, WebM and QuickTime uploads.
- Report attachments now use the `/media` upload path.
- Added generated OpenAPI JSON through `scripts/swagger-drogon/`, combining
Drogon route macros, adjacent metadata blocks, C++ inference and the Visione
schema registry.
- Added generated OpenAPI JSON from Drogon route macros plus the manual
`docs/openapi/visione.openapi.yaml` contract.
- Exposed `/api/v1/openapi.json` and `/api/v1/docs`.
- Added a small Streamlit API lab for visual endpoint testing.
## To do next
- Expand OpenAPI schema coverage as endpoints evolve.
- Consider extracting `scripts/generate_openapi.py` into an open-source standalone
project once the conventions stabilize.
- Expand the manual OpenAPI contract as endpoints evolve.
- Add minimal media upload integration tests after endpoint contracts settle.
- Keep API and docs on `media` terminology only.
- Keep the Streamlit lab small and replace it with the real frontend later.