Commit graph

24 commits

Author SHA1 Message Date
senke
7a8a6973e3 data-flow: verify backend filter parameter handling
- Completed Action 2.2.1.2: Verified backend handles filter parameters
- Created BACKEND_FILTER_PARAMS_AUDIT.md documenting backend filter support
- Verified backend /tracks endpoint handles: page, limit, user_id, genre, format, sort_by, sort_order
- Identified issue: search parameter not handled in ListTracks (frontend sends 'search', backend doesn't process)
- Separate /tracks/search endpoint exists but uses 'q' parameter
- Recommendation: Add search support to ListTracks or align frontend to use search endpoint
2026-01-11 16:52:29 +01:00
senke
09d7648c61 data-flow: design dashboard aggregation endpoint contract
- Completed Action 2.1.1.1: Designed dashboard endpoint contract
- Created DASHBOARD_ENDPOINT_CONTRACT.md with complete specification
- Defined GET /api/v1/dashboard endpoint consolidating 4+ API calls
- Response structure: stats, recent_activity, library_preview
- Query parameters: activity_limit, library_limit, stats_period
- Documented data sources, error handling, performance considerations
- Migration strategy outlined for phased rollout
- Ready for backend implementation (Action 2.1.1.2)
2026-01-11 16:43:14 +01:00
senke
2e9f05aa4b api-contracts: verify backend response helpers use wrapped format
- Completed Action 1.3.2.4: Audited all response helper functions
- Created RESPONSE_HELPERS_AUDIT.md documenting all helpers
- Verified all helpers use wrapped format: Success(), Created(), Error(), RespondWithAppError(), RespondSuccess()
- Found two implementation approaches (gin.H vs APIResponse struct) - both produce wrapped format
- No changes needed - backend already compliant with wrapped format requirement
2026-01-11 16:36:45 +01:00
senke
389e855440 api-contracts: categorize endpoints by response format type
- Completed Action 1.3.1.3: Categorized all tested endpoints
- Created 4 categories: wrapped (2), auth_required (22), errors (12), path_params
- Documented format consistency: 2/36 verified (5.6%), both use wrapped format
- Identified 34 unverified endpoints requiring auth or specific IDs
- Updated ENDPOINT_FORMAT_AUDIT.md with detailed categorization
2026-01-11 16:36:28 +01:00
senke
291d218235 api-contracts: identify endpoint response formats
- Completed Action 1.3.1.2: Tested 36 endpoints for response format consistency
- Fixed test script to handle subshell issues with RESULTS array
- Created ENDPOINT_FORMAT_AUDIT.md documenting findings
- Found 2 endpoints using wrapped format, 0 direct format
- Most endpoints require auth (22) or have errors (12)
- Limited coverage due to authentication requirements and path parameters
2026-01-11 16:36:13 +01:00
senke
2fce619940 api-contracts: install openapi-generator-cli and create type generation script
- Completed Action 1.1.2.1: Installed @openapitools/openapi-generator-cli
- Completed Action 1.1.2.2: Created generate-types.sh script
- Added swagger annotations to cmd/modern-server/main.go
- Regenerated swagger.yaml with proper info section
- Successfully generated TypeScript types to src/types/generated/

The script generates types from veza-backend-api/openapi.yaml using
typescript-axios generator and creates barrel exports.
2026-01-11 16:30:43 +01:00
senke
d171f29847 api-contracts: audit OpenAPI spec and generate/export to openapi.yaml
- Completed Action 1.1.1.1: Audited existing OpenAPI spec (56 endpoints documented)
- Completed Action 1.1.1.2: Generated swagger.json using swag init
- Completed Action 1.1.1.3: Exported to openapi.yaml (Swagger 2.0 format)
- Created OPENAPI_AUDIT_REPORT.md documenting findings

Note: Spec is in Swagger 2.0 format. Consider upgrading to OpenAPI 3.0 in future.
2026-01-11 16:29:31 +01:00
senke
7452bd637a stabilisation commit A 2026-01-07 19:39:21 +01:00
senke
ffabb99b54 [INT-011] int: Add API versioning strategy 2025-12-25 15:25:33 +01:00
senke
2bed10a018 [DOC-006] doc: Write troubleshooting guide 2025-12-25 11:02:37 +01:00
senke
0efc3d5afd [DOC-005] doc: Write user guide 2025-12-25 10:56:24 +01:00
senke
82cceed173 [DOC-004] doc: Write architecture documentation 2025-12-25 02:57:10 +01:00
senke
a2443e0326 [DOC-003] doc: Write development setup guide 2025-12-25 02:54:47 +01:00
senke
032f7a198f [DOC-002] doc: Write deployment guide 2025-12-25 02:52:14 +01:00
senke
664d1e02af [DOC-001] doc: Write API documentation 2025-12-25 02:48:06 +01:00
senke
8016058ccf [BE-DB-016] be-db: Add database backup strategy 2025-12-24 15:55:46 +01:00
senke
980858b17e stabilizing veza-backend-api: LAST REMEDIATION 2025-12-16 14:07:36 -05:00
senke
d0fe8c8ad7 stabilizing veza-backend-api: phase 1 2025-12-16 11:23:49 -05:00
senke
d33c351ac6 refonte: backend-api go first; phase 1 2025-12-12 21:34:34 -05:00
okinrev
fc1807ea15 refactor(marketplace): enforce unified api response envelope 2025-12-06 17:39:04 +01:00
okinrev
c14c647581 feat(api): remediate missing openapi spec and annotate handlers 2025-12-06 17:34:18 +01:00
okinrev
8caa2fd7ca STABILISATION: phase 3–5 – API contract, tests & chat-server hardening 2025-12-06 17:21:59 +01:00
okinrev
5ffcd50e0a P0: stabilisation backend/chat/stream + nouvelle base migrations v1
Backend Go:
- Remplacement complet des anciennes migrations par la base V1 alignée sur ORIGIN.
- Durcissement global du parsing JSON (BindAndValidateJSON + RespondWithAppError).
- Sécurisation de config.go, CORS, statuts de santé et monitoring.
- Implémentation des transactions P0 (RBAC, duplication de playlists, social toggles).
- Ajout d’un job worker structuré (emails, analytics, thumbnails) + tests associés.
- Nouvelle doc backend : AUDIT_CONFIG, BACKEND_CONFIG, AUTH_PASSWORD_RESET, JOB_WORKER_*.

Chat server (Rust):
- Refonte du pipeline JWT + sécurité, audit et rate limiting avancé.
- Implémentation complète du cycle de message (read receipts, delivered, edit/delete, typing).
- Nettoyage des panics, gestion d’erreurs robuste, logs structurés.
- Migrations chat alignées sur le schéma UUID et nouvelles features.

Stream server (Rust):
- Refonte du moteur de streaming (encoding pipeline + HLS) et des modules core.
- Transactions P0 pour les jobs et segments, garanties d’atomicité.
- Documentation détaillée de la pipeline (AUDIT_STREAM_*, DESIGN_STREAM_PIPELINE, TRANSACTIONS_P0_IMPLEMENTATION).

Documentation & audits:
- TRIAGE.md et AUDIT_STABILITY.md à jour avec l’état réel des 3 services.
- Cartographie complète des migrations et des transactions (DB_MIGRATIONS_*, DB_TRANSACTION_PLAN, AUDIT_DB_TRANSACTIONS, TRANSACTION_TESTS_PHASE3).
- Scripts de reset et de cleanup pour la lab DB et la V1.

Ce commit fige l’ensemble du travail de stabilisation P0 (UUID, backend, chat et stream) avant les phases suivantes (Coherence Guardian, WS hardening, etc.).
2025-12-06 11:14:38 +01:00
okinrev
2425c15b09 adding initial backend API (Go) 2025-12-03 20:29:37 +01:00