# Manual de uso — El Bajo Manager

Guía operativa para el **administrador** del bajo.  
La aplicación es solo para ti: no hay acceso para huéspedes.

---

## 1. ¿Para qué sirve?

Centralizar el día a día de un inmueble con habitaciones en alquiler:

- Ver ocupación de un vistazo  
- Llevar fichas de huéspedes  
- Controlar cobros y gastos (EUR y COP, caja digital/físico)  
- Programar y seguir limpiezas  

Todos los datos viven en **Notion**. La web es el panel rápido; Notion es el archivo maestro.

---

## 2. Primeros minutos

### 2.1 Entrar

1. Abre la URL local (`http://localhost/ElBajoManager/public/`) o la de producción.
2. Introduce la **contraseña de administrador** (definida en `.env` → `ADMIN_PASSWORD`).
3. Verás el menú lateral (en móvil: botón Menú arriba).
4. Empieza siempre por el **Dashboard**.

Para salir: botón **Salir** al pie del menú.

### 2.2 Datos demo vs datos reales

| Modo | Cuándo | Qué ves |
|------|--------|---------|
| Demo (`USE_MOCK_DATA=true`) | Desarrollo / pruebas | Habitaciones y cobros de ejemplo |
| Producción (`false`) | Uso real | Contenido de tus bases Notion |

Si ves nombres inventados (Ana López, etc.) estás en demo.

### 2.3 Dónde editar datos hoy

En Fase 1 la app está orientada a **consulta y seguimiento visual**.  
La fuente de verdad para crear/editar registros es **Notion** (hasta que se activen formularios de escritura en la app).

Flujo recomendado:

```text
Notion (crear/editar)  →  App (consultar, filtrar, decidir)
```

Tras un cambio en Notion, recarga la página (F5).

---

## 3. Navegación

| Menú | Ruta | Uso principal |
|------|------|----------------|
| Dashboard | `/` | Resumen del día / mes |
| Habitaciones | `/habitaciones` | Estado y precios |
| Huéspedes | `/huespedes` | Contacto y ciclo de vida |
| Cobros y Caja | `/finanzas` | Dinero que entra y sale |
| Limpieza | `/limpieza` | Calendario de aseo |

En móvil el menú se abre en un panel lateral.

---

## 4. Dashboard

### Qué muestra

1. **Habitaciones** — contadores: Disponibles / Ocupadas / Reservadas / Mantenimiento.  
2. **Resumen financiero del mes** — por moneda (EUR, COP): ingresos, gastos, neto, y desglose Digital vs Físico (solo movimientos **Pagado** del mes).  
3. **Próximos cobros** — pendientes o vencidos próximos.  
4. **Gastos recientes** — últimas salidas.  
5. **Próximas limpiezas** — programadas desde hoy.

### Cómo usarlo cada mañana (rutina de 3 minutos)

1. ¿Hay habitaciones en **Mantenimiento** que bloqueen ingresos?  
2. ¿Hay cobros **Vencido** o **Pendiente** en la columna de cobros?  
3. ¿Hay limpiezas hoy/mañana?  
4. Mira el neto del mes en EUR y COP por separado (no los mezcles mentalmente).

### Enlaces rápidos

“Ver todas” / “Ver” saltan al módulo correspondiente.

---

## 5. Habitaciones

### Estados

| Estado | Significado operativo |
|--------|------------------------|
| **Disponible** | Lista para mostrar / alquilar |
| **Reservada** | Comprometida; ingreso futuro |
| **Ocupada** | Hay huésped activo |
| **Mantenimiento** | No alquilar hasta cerrar trabajo |

### Vistas

- **Tarjetas** — ideal en móvil y para “foto” de estado.  
- **Tabla** — comparar precios y fechas rápido.

### Filtros

Pulsa los chips: Todas / Disponible / Reservada / Ocupada / Mantenimiento.

### Campos que debes mantener en Notion

- Nombre, estado, precio mensual, depósito, moneda  
- Huésped actual (relación) + fechas ingreso/salida  
- Observaciones (ej. “cerca del baño”, “persiana rota”)  
- Fotografías (archivos en Notion)

### Buenas prácticas

- Al entrar un huésped: Estado → **Ocupada** + relación al huésped.  
- Al salir: Estado → **Disponible** o **Mantenimiento** + quitar relación.  
- Usa **Reservada** solo con fecha de ingreso clara.  
- El precio en la ficha debe coincidir con lo pactado (evita sorpresas en cobros).

---

## 6. Huéspedes

### Estados

| Estado | Cuándo |
|--------|--------|
| **Pendiente ingreso** | Contrato/reserva hecha; aún no vive ahí |
| **Activo** | Vive en el bajo ahora |
| **Finalizado** | Ya se fue (histórico) |

### Qué consultar aquí

- Teléfono y correo para cobros o avisos  
- Documento (DNI/NIE/CC)  
- Habitación asignada  
- Fechas y notas (“prefiere Bizum”, “alergia a…”, etc.)

### Rutina al dar de alta (en Notion)

1. Crear página en **Huéspedes** con datos completos.  
2. Estado = Pendiente ingreso (o Activo si ya entra).  
3. Relacionar **Habitación**.  
4. Actualizar la habitación a Reservada/Ocupada.  
5. Crear cobro de **Depósito** y/o primer **Alquiler** en Cobros y Caja.

### Rutina al dar de baja

1. Huésped → Finalizado + fecha salida.  
2. Habitación → Disponible o Mantenimiento.  
3. Revisar depósito (devolución = Salida o Entrada según cómo lo registres; sé consistente).  
4. Programar limpieza de salida.

---

## 7. Cobros y Caja

Este módulo fusiona **ingresos** y **gastos**.

### Tipos

| Tipo | Ejemplos |
|------|----------|
| **Entrada** | Alquiler, depósito, reembolso de un gasto |
| **Salida** | Luz, agua, limpieza, reparaciones, compras |

### Monedas y cajas

- **EUR** y **COP** se gestionan **por separado** (no hay conversión automática).  
- **Digital** = transferencia, Bizum, cuenta bancaria, app.  
- **Físico** = efectivo en caja.

### Estados de pago

| Estado | Uso |
|--------|-----|
| **Pagado** | Dinero ya movido (entra en el resumen del mes) |
| **Pendiente** | Previsto; aún no cobrado/pagado |
| **Vencido** | Pasó la fecha de vencimiento sin liquidar |

### Categorías sugeridas

Agua, Luz, Internet, Gas, Arriendo, Limpieza, Reparaciones, Compras, Imprevistos, Alquiler habitación, Depósito, Otro.

### Alertas

Si hay movimientos Pendiente/Vencido, verás un aviso amarillo arriba.  
Úsalo como lista de “llamar / transferir hoy”.

### Filtros

- Tipo: Todas / Entrada / Salida  
- Estado: Todos / Pagado / Pendiente / Vencido  

### Cómo registrar un alquiler mensual (Notion)

1. Concepto: `Alquiler marzo — Nombre Huésped`  
2. Tipo: Entrada · Categoría: Alquiler habitación  
3. Huésped: relación · Valor + Moneda · Cuenta Digital/Físico  
4. Fecha + Fecha vencimiento (ej. día 5)  
5. Estado: Pendiente → al cobrar, Pagado + enlace de comprobante si lo tienes  

### Cómo registrar un gasto

1. Tipo: Salida · Categoría adecuada · Proveedor (ej. Iberdrola)  
2. Valor en la moneda real del pago  
3. Cuenta correcta (Digital/Físico)  
4. Comprobante: URL a Drive/Notion file si aplica  

### Errores frecuentes

- Mezclar COP y EUR en la cabeza al “cuadrar” el mes → mira cada tarjeta de moneda.  
- Dejar cobros en Pendiente cuando ya están pagados → el dashboard no los cuenta en ingresos.  
- Olvidar Fecha vencimiento → peor priorización de alertas.

---

## 8. Limpieza y Aseo

### Vista calendario

- Mes actual con puntos en días que tienen tareas.  
- Al pulsar un día: detalle a la derecha (habitación, responsable, estado, notas).

### Estados

| Estado | Significado |
|--------|-------------|
| **Programada** | Pendiente de hacer |
| **Realizada** | Hecha |
| **Cancelada** | No se hizo / se anuló |

### Rutina recomendada

1. Cada domingo: programa limpiezas de la semana en Notion.  
2. Día de limpieza: marca **Realizada** y anota incidencias (“faltaba trapo”, “mancha en pared”).  
3. Tras salida de huésped: limpieza profunda + foto si hace falta (Fase 2: Mantenimiento).  

### Campos

Fecha, habitación (relación), responsable, estado, observaciones.

---

## 9. Flujos de trabajo completos

### A) Nuevo huésped de punta a punta

```text
1. Habitación Disponible → Reservada (Notion)
2. Crear Huésped Pendiente ingreso + relación
3. Crear Entrada Depósito (Pendiente/Pagado)
4. Día de entrada: Huésped Activo, Habitación Ocupada
5. Crear Entradas de alquiler mensual (Pendiente)
6. Programar limpieza periódica
```

### B) Cierre de mes financiero

```text
1. Finanzas → filtro Entrada + Pendiente/Vencido → cobrar
2. Marcar Pagado lo cobrado
3. Revisar Salidas del mes (luz, internet…)
4. Dashboard → comparar neto EUR y COP
5. Anotar en Notion cualquier ajuste (notas del huésped)
```

### C) Salida de huésped

```text
1. Fecha salida en Huésped + Finalizado
2. Habitación → Mantenimiento (si hay que pintar) o Disponible
3. Liquidar depósito
4. Limpieza de salida Programada → Realizada
5. Subir fotos / notas para el siguiente alquiler
```

---

## 10. Trabajo en móvil

- Usa el menú hamburguesa.  
- En Habitaciones prefiere vista **Tarjetas**.  
- Dashboard cabe en una pantalla con scroll; prioriza alertas de cobros.  
- Para editar muchos campos, Notion móvil o escritorio suele ser más cómodo; la app brilla para **consultar**.

---

## 11. Buenas prácticas de datos

1. **Un solo nombre de habitación** en todas las bases (evita “Hab 1” vs “Habitación 1”).  
2. Relaciona siempre huésped ↔ habitación; no confíes solo en texto suelto.  
3. Conceptos de cobro descriptivos: incluyen mes + nombre.  
4. No borres huéspedes finalizados: archívalos como Finalizado (histórico y fiscal).  
5. Revisa comprobantes de gastos altos (reparaciones).  

---

## 12. Preguntas frecuentes

**¿Por qué el resumen del mes no cuadra con lo que cobré ayer?**  
Solo entran movimientos con estado **Pagado** y fecha dentro del mes calendario.

**¿Puedo tener dos monedas en la misma caja mental?**  
No. El panel las separa a propósito. Convierte fuera si necesitas un total único.

**Cambié algo en Notion y no se ve.**  
Recarga forzada (Ctrl+F5) o espera a que expire la caché (~30 s).

**¿Los huéspedes pueden entrar?**  
No. No hay portal de huésped en Fase 1.

**¿Dónde están los módulos de mantenimiento / incidencias?**  
Fase 2 — ver `PHASE2.md`. No aparecen en el menú activo.

**¿Se puede usar sin Hostinger?**  
Sí: local, Vercel u otro host Node. El manual de Hostinger es una opción de despliegue.

---

## 13. Glosario rápido

| Término | Significado |
|---------|-------------|
| Bajo | El inmueble completo con varias habitaciones |
| Caja digital | Dinero en cuentas / apps |
| Caja físico | Efectivo |
| Data source | Identificador Notion que usa la API v5 |
| Mock / demo | Datos ficticios para probar la UI |

---

## 14. Soporte y documentación técnica

- Instalación Hostinger: [`MANUAL_INSTALACION_HOSTINGER.md`](./MANUAL_INSTALACION_HOSTINGER.md)  
- Schema Notion: [`NOTION_SCHEMA.md`](./NOTION_SCHEMA.md)  
- Arquitectura: [`ARCHITECTURE.md`](./ARCHITECTURE.md)  
- Ideas futuras: [`BRAINSTORMING.md`](./BRAINSTORMING.md)  

---

*Manual de uso — Fase 1. Actualizar cuando existan formularios de escritura en la app.*