FlaskProyect — Development skill for Claude Code

Proyecto Vierne

Sistema de préstamo de videojuegos desarrollado en Flask con Python y SQLite. El proyecto implementa la lógica de negocio del dominio de préstamos, multas y disponibilidad, siguiendo las reglas definidas en `rules/CLAUDE.md`.

Resumen del proyecto

La aplicación permite:

• registrar usuarios
• registrar juegos
• crear préstamos de juegos
• devolver juegos
• generar multas por retraso en la devolución
• pagar multas
• consultar historial de préstamos por usuario
• consultar disponibilidad de un juego

El enfoque del proyecto fue separar la lógica de negocio en un servicio, mantener los modelos como entidades del dominio y exponer la funcionalidad a través de endpoints REST.

---

Cambios realizados

Durante la implementación y revisión final se consolidó esta estructura:

• app/__init__.py: fábrica de la aplicación Flask y configuración de SQLAlchemy
• app/exceptions.py: excepciones tipadas del dominio para errores de negocio
• app/models/usuario.py: modelo Usuario
• app/models/juego.py: modelo Juego
• app/models/prestamo.py: modelo Prestamo con cálculo de vencimiento y multa
• app/models/multa.py: modelo Multa con control de pago
• app/models/__init__.py: exportación de los modelos
• app/services/servicio_prestamos.py: lógica central de negocio con validaciones tipadas
• app/routes/prestamos.py: endpoints API REST con mapeo HTTP correcto
• tests/test_servicio_prestamos.py: pruebas del flujo principal del negocio y regresiones
• requirements.txt: dependencias del proyecto
• rules/CLAUDE.md: documento base con las reglas del negocio

Lógica de negocio implementada

Se validaron y aplicaron las reglas clave:

• RN-01: validación de existencia de usuario, juego, préstamo y multa
• RN-02: bloqueo de préstamos si el usuario tiene multas pendientes
• RN-03: plazo fijo de préstamo de 7 días
• RN-04: no se presta un juego si está no disponible
• RN-05: al devolver, el juego vuelve a estar disponible
• RN-06: la mu