[Good First Issue] Add API documentation with Swagger/OpenAPI

[pixelstrade-dev]

Description

The CAIMS API needs proper documentation. Adding Swagger/OpenAPI docs would help developers understand and use the API.

What to do

1. Install next-swagger-doc or swagger-jsdoc
2. 2. Add OpenAPI annotations to all API routes (/api/chat, /api/debate, /api/sessions, /api/scores)
3. 3. Create a /api/docs page with Swagger UI
4. 4. Document request/response schemas using existing Zod schemas
5. 5. Add example requests and responses

Skills needed

• TypeScript
• • OpenAPI/Swagger
• • • REST API design

References

• API routes: apps/web/app/api/
• • Zod schemas in each route file