Hotel "Duerme Bien" · Gestión de pasajeros y habitaciones
Prototipo de la Unidad 3 de Ingeniería de Software (INACAP): un sistema para que un hotel registre habitaciones, asigne pasajeros, calcule el costo de la estadía y consulte reportes de ocupación.
▶ Ver demo
Funcionalidades
Hay dos roles, con un panel propio cada uno (RN-01):
| Rol | Puede |
|---|
| Administrador | Gestionar usuarios, revisar la auditoría de acciones y ver el panel general |
| Encargado de hotel | Gestionar habitaciones, asignar uno o varios pasajeros, registrar salidas y consultar reportes |
- Habitaciones: número único (RN-03), orientación y baja lógica para no perder el historial (RN-05).
- Asignaciones: individual o múltiple, una línea por pasajero con el formato
Nombre;RUT; el RUT se valida con su dígito verificador.
- Costo de la estadía: pasajeros × noches × valor fijo por pasajero (RN-07).
- Reportes: estado de las habitaciones, pasajeros hospedados e historial de ocupación.
Las reglas de negocio (RN-01 a RN-10) viven en hotel/reglas.py como funciones puras, sin depender de Django, para probarlas de forma aislada.
Seguridad
- Bloqueo por intentos fallidos: 5 intentos y la cuenta queda bloqueada 15 minutos (PS-06).
- Expiración por inactividad: la sesión vence a los 15 minutos sin uso; se verifica en el servidor (SEG-06).
- Control de acceso por rol en cada vista, y auditoría de las acciones del panel.
- Cabeceras: CSP nativa de Django 6,
X-Frame-Options: DENY y HSTS en producción; CSRF y autoescape de plantillas activos.
- Sin el admin genérico de Django: el caso define dos roles con panel propio, así que no se expone
/admin.
- Secretos por entorno:
SECRET_KEY, DATABASE_URL y las claves de los usuarios demo se leen de variables de entorno. En producción, sin SECRET_KEY la app no arranca.
Stack
| Capa | Tecnología |
|---|
| Backend | Python 3.12 + Django 6 (WhiteNoise para estáticos) |
| Base de datos | SQLite en desarrollo y PostgreSQL en producción (dj-database-url + psycopg 3) |
| Tests | pytest + pytest-django (52 pruebas) |
| Despliegue | Vercel, runtime de Python (api/index.py) |
Ejecutar en local
python -m venv .venv
.venv\Scripts\activate # Windows (en macOS/Linux: source .venv/bin/activate)
pip install -r requirements-dev.txt
python manage.py migrate
python manage.py seed_demo # crea los usuarios "admin" y "encargado"
python manage.py runserver # http://127.0.0.1:8000
seed_demo usa las claves de DEMO_ADMIN_PASSWORD y DEMO_ENCARGADO_PASSWORD. Si no las defines, genera claves al azar y las muestra en la consola. Las variables disponibles están en .env.example.
pytest # pruebas unitarias y de integración
Licencia
MIT
