Setup OpenAPI/Swagger Documentation

Description

Add OpenAPI annotations and generate Swagger documentation for all endpoints.

Acceptance Criteria

  • l5-swagger configured
  • @OA annotations on Controller base class
  • @OA annotations on all endpoints
  • Schema definitions for models
  • Documentation generated and accessible
  • Interactive API docs at /api/documentation

Implementation Steps

  1. Publish swagger config
  2. Add @OA\Info to Controller.php
  3. Add @OA annotations to EventController
  4. Add @OA annotations to other controllers
  5. Add schema definitions
  6. Generate: php artisan l5-swagger:generate
  7. Test at http://localhost:8000/api/documentation

Reference

  • Roadmap: docs/roadmaps/Implementation_Roadmap_Backend.md Phase 6, Step 11
  • Standards: backend/CLAUDE.md - OpenAPI section

Related Issues