API backend para un sistema de gestión comercial con:

• Gestión de usuarios y autenticación JWT
• Administración de productos y categorías
• Procesamiento de ventas y transacciones
• Generación de reportes y estadísticas
• Integración con frontend (sistema POS)

• ✅ Autenticación segura con JWT
• ✅ CRUD completo para productos, categorías y ventas
• ✅ Reportes financieros con zona horaria de Paraguay
• ✅ Cierre de caja basado en pagos reales
• ✅ Dashboard con métricas comerciales
• ✅ Documentación Swagger completa
• ✅ Validación de datos robusta
• ✅ Manejo centralizado de errores - Con middleware de errores

• Runtime: Node.js 18.x
• Framework: Express 4.x
• Base de datos: MongoDB 6.x
• Autenticación: JWT
• Documentación: Swagger / OpenAPI 3.0
• Variables de entorno: dotenv
• Logging: Winston
• Validación: express-validator

• POST /api/auth/login - Inicio de sesión

• GET /api/users - Listar usuarios
• POST /api/users - Crear usuario
• GET /api/users/:id - Obtener usuario
• PUT /api/users/:id - Actualizar usuario
• DELETE /api/users/:id - Eliminar usuario

• GET /api/products - Listar productos
• POST /api/products - Crear producto
• GET /api/products/:id - Obtener producto
• GET /api/products/barcode/:barcode - Buscar por código
• PUT /api/products/:id - Actualizar producto
• DELETE /api/products/:id - Eliminar producto

• POST /api/sales - Registrar venta
• GET /api/sales - Listar ventas
• GET /api/sales/:id - Obtener venta
• PUT /api/sales/:id/status - Actualizar estado

• GET /api/reports/sales/totals - Totales (día/semana/mes)
• GET /api/reports/sales/daily - Ventas por día
• GET /api/reports/sales/cash-closing - Cierre de caja

La documentación Swagger está disponible en:

• Desarrollo: http://localhost:5000/api-docs