Generador de API RESTful Completa

Eres un desarrollador backend experto con 10+ años de experiencia en Node.js, Express, MongoDB y arquitecturas RESTful escalables.

Tarea: Crea una API RESTful **COMPLETA Y FUNCIONAL** para la siguiente aplicación:

[DESCRIPCIÓN DETALLADA DE TU APP AQUÍ]

**Requisitos MANDATORIOS:**

🛠️ **Tech Stack:**
- Node.js v20+
- Express.js
- MongoDB + Mongoose (con conexión Atlas)
- JWT para autenticación
- bcryptjs para hash passwords
- dotenv para variables de entorno
- CORS habilitado
- Helmet para seguridad
- Validación con express-validator o Joi
- Logging con Winston o morgan

📁 **Estructura de carpetas EXACTA:**
```
project/
├── src/
│   ├── config/
│   │   └── database.js
│   ├── controllers/
│   ├── middleware/
│   │   ├── auth.js
│   │   └── validation.js
│   ├── models/
│   ├── routes/
│   ├── utils/
│   └── app.js
├── .env.example
├── .gitignore
├── package.json
└── README.md
```

🔐 **Autenticación COMPLETA:**
- Register (/api/auth/register)
- Login (/api/auth/login)
- Refresh token
- Protected routes con middleware
- Roles: user/admin si aplica

🚀 **CRUD Completo para entidades principales:**
Identifica 3-5 entidades clave de tu app y crea:
- GET list (paginación, filtros, search)
- GET one by ID
- POST create
- PUT/PATCH update
- DELETE

📊 **Features avanzadas:**
- Paginación (query params: page, limit)
- Filtros y búsqueda
- Ordenamiento
- Upload de archivos (multer + cloudinary si aplica)
- Rate limiting
- Error handling global
- Swagger/OpenAPI docs

📦 **Entregables OBLIGATORIOS:**
1. **package.json** completo con todas las dependencias
2. **Código COMPLETO** de TODOS los archivos
3. **.env.example** con todas las variables
4. **README.md** con:
   - Instalación paso a paso
   - Endpoints documentados
   - Ejemplos de requests (Postman/Insomnia)
   - Seed de DB opcional
5. **Script de inicio:** npm run dev

💡 **Bonus (si aplica a tu app):**
- WebSockets (Socket.io)
- Email (nodemailer)
- Payments (Stripe)
- Cache (Redis)

**IMPORTANTE:** Código production-ready, limpio, comentado en inglés, con manejo de errores robusto. ¡NO shortcuts!

¡Genera TODO el código ahora! 🚀