readme

# api-swagger-docs

Documentación interactiva de una API (Products & Carts) usando **OpenAPI/Swagger** sobre Node.js/Express.

## 📚 Características
- Definición OpenAPI centralizada (`swagger.yaml`).
- Swagger UI servido en `/api/docs`.
- Esquemas de modelos (`Product`, `Cart`), parámetros, respuestas y ejemplos.
- Soporte para auth (Bearer) listo para ampliar.

## 🤞 Stack
- Node.js, Express
- swagger-ui-express
- YAML (OpenAPI 3)

## 🚀 Inicio rápido

    npm ci
    npm run dev
    # abre http://localhost:3000/api/docs

## 📜 Estructura

    /src
      /routes
      /middlewares
    /swagger.yaml

## ✍️ Mantenimiento de la spec
- Agrega/actualiza paths y schemas en `swagger.yaml`.
- Valida con un linter (ej. @redocly/cli) antes de hacer commit.

## 👍 Licencia
MIT