# Manual de usuario

> Guía visual de Mi Ruta Limpia para los tres perfiles: ciudadano, empleado operativo y administrador.

---

## 1. Antes de empezar

### ¿Cómo se entra a la app?

1. Abre **Mi Ruta Limpia** desde el ícono en tu teléfono
2. En la pantalla de inicio de sesión, escribe tu **correo** y tu **contraseña**
3. Toca **Iniciar sesión**

> 💡 También puedes entrar con tu cuenta de **Google** o **Facebook** si las vinculaste al registrarte.

### ¿No tienes cuenta?
Toca **"¿No tienes cuenta? Regístrate"** en la pantalla de login.
Necesitarás:
- Tu nombre completo
- Un correo o teléfono
- Una contraseña segura (mínimo 6 caracteres)

### ¿Olvidaste tu contraseña?
Toca **"¿Olvidaste tu contraseña?"** y sigue las instrucciones que llegarán a tu correo.

---

## 2. Vista CIUDADANO 🧑

Después de iniciar sesión, verás 5 pestañas en la parte inferior:

```
[ Inicio ] [ Horarios ] [ 🌱 ] [ Reportes ] [ Perfil ]
```

### 2.1 Pestaña INICIO

Es la pantalla principal. Muestra:

- **Cabecera guinda** con "Mi Ruta Limpia"
- **Logo del Gobierno de Celaya** centrado
- **Selector de domicilio** (chips horizontales): toca el lugar del que quieres ver información
- **Tarjeta de ETA**: tu próxima recolección
  - Mensaje con la ventana horaria (ej. *"Entre las 7:20 y 7:35"*)
  - Si faltan menos de 30 min, también muestra los minutos exactos
  - Barra de progreso de la ruta
  - Ícono de camión
- **Botón "¿Ya pasó la basura? Sí"**: tócalo cuando confirmes que pasó

#### Al confirmar que pasó:
1. Aparece un **modal de calificación** (1-5 estrellas) con opción de comentario
2. Al enviar, la tarjeta cambia a verde con **"Ruta completada para hoy"**
3. Aparece un enlace **"↩ Deshacer confirmación"** por si te equivocaste

> ⚠️ Mensaje de seguridad: *"Por tu seguridad, no persigas al camión. ¡Saca tu basura con tiempo!"*

#### Generar reporte rápido
Más abajo hay un botón **"Generación de reportes..."** que te lleva a la pestaña Reportes.

#### Horarios de recolección
Al final ves el horario aproximado de tu domicilio (días y rango horario).

---

### 2.2 Pestaña HORARIOS

Muestra:

- **Hero guinda** con el día actual: *"Sábado 23 de mayo"*
- **Tarjeta por cada uno de tus domicilios** con:
  - Etiqueta (Casa, Trabajo, etc.) y dirección
  - Badge "Principal" si es tu domicilio default
  - Días de la semana de recolección (Lunes · Miércoles · Viernes)
  - Horario aproximado (06:00 - 08:00)
  - Nombre de la ruta asignada
- **Sección "Recuerda"** con 4 buenas prácticas:
  - Saca tu basura máximo 30 min antes
  - Separa orgánicos, reciclables y sanitarios
  - En días festivos el servicio puede modificarse
  - No persigas al camión

---

### 2.3 Pestaña EDUCACIÓN (la hojita verde central)

La pestaña más rica en contenido. Tiene:

#### Hero con foto eco
Imagen borrosa de naturaleza con mensaje *"Tu basura, nuestro futuro"*

#### Por qué importa
4 tarjetas explicando el impacto:
- 🌍 **Ambiental** — separar evita metano en rellenos
- ❤️ **Salud pública** — evita fauna nociva y enfermedades
- 💰 **Económico** — Celaya ahorra hasta $1,400 MXN por tonelada reciclada
- 🏛️ **Celaya limpio** — calles limpias y vecinos saludables

#### Tipos de residuos
4 categorías que puedes tocar para ver detalle:

| Categoría | Color | Bolsa |
|-----------|-------|-------|
| 🌱 **Orgánicos** | Verde | Bolsa verde |
| ♻️ **Reciclables** | Azul | Bolsa azul/transparente |
| 🩹 **Sanitarios** | Naranja | Bolsa roja/negra |
| ⚡ **Especiales/RAEE** | Morado | Punto de acopio |

Al tocar una categoría se abre un **modal con detalle**:
- Descripción larga
- ✅ Lista de "Sí va aquí"
- ❌ Lista de "No va aquí"
- 💡 Consejo práctico
- 📊 Dato de impacto

#### Datos que impactan
4 estadísticas con números fuertes:
- 60% es orgánico
- 30% es reciclable
- 450 años tarda una botella en degradarse
- 17 árboles se salvan por tonelada de papel reciclado

#### Tips prácticos
5 consejos para implementar hoy:
1. En casa: ten 2 botes mínimo
2. Enjuaga envases primero
3. Saca a tiempo (no antes, no después)
4. No mezcles (pilas, medicamentos a puntos de acopio)
5. Composta casera si tienes patio

#### Puntos de acopio en Celaya
Lista con lugares reales para:
- 🔋 Pilas y baterías (Walmart, Soriana, Liverpool)
- 📱 Electrónicos (Office Depot, Best Buy)
- 💊 Medicamentos (SINGREM en farmacias)
- 🛢️ Aceite de cocina (Punto Limpio Municipal)

#### Preguntas frecuentes
7 preguntas plegables (toca para abrir).

#### Compromiso final
Banner guinda: *"Si todos los hogares de Celaya separaran su basura, reduciríamos el relleno sanitario en un 70%"*

---

### 2.4 Pestaña REPORTES

Para levantar quejas formales con folio oficial.

#### Pantalla principal
- **Hero guinda con foto borrosa** y mensaje motivador
- **Estadísticas rápidas**: número de pendientes, en proceso, resueltos
- **Botón "Levantar un reporte nuevo"** destacado
- **Historial filtrable**: Todos / Pendientes / En proceso / Resueltos

#### Crear un reporte (3 pasos)
1. **Domicilio afectado** (chips para elegir)
2. **Tipo de incidencia** (4 opciones):
   - 🚛 El camión no pasó
   - ⏰ Retraso en la ruta
   - 🗑️ Acumulación de basura
   - … Otro
3. **Descripción** (opcional, 500 caracteres máx)

Al enviar, recibes un **folio único** tipo `MRL-20260523-A4B5C6`.

#### Confirmación
Aparece una pantalla verde con:
- ✓ "Reporte enviado con éxito"
- Folio destacado
- Estado (PENDIENTE)
- Tipo de incidencia
- Domicilio
- Fecha
- Tu descripción
- Botón **"Compartir reporte"** que abre el menú nativo (WhatsApp, correo, copiar, etc.)

#### Ver reportes anteriores
- Toca cualquier reporte de la lista para ver el detalle
- Puedes compartirlos cuando quieras desde el detalle

---

### 2.5 Pestaña PERFIL

Para gestionar tus datos y domicilios.

#### Hero guinda con tu identidad
- Avatar circular con tu inicial
- Tu nombre y correo

#### Domicilios
- Lista de tus lugares registrados
- Cada uno con etiqueta, dirección y badge "Principal" si aplica
- **Botón ⭐** para marcar como principal
- **Botón 🗑️** para eliminar
- **Botón "Agregar"** para añadir uno nuevo

#### Agregar domicilio
Modal con:
- Etiqueta (Casa, Trabajo, Familia, Otro)
- Calle y número
- Colonia
- Coordenadas (opcional, para asignar ruta automáticamente)

#### Configuración
Tres opciones (próximamente conectadas):
- 🔔 Notificaciones
- 🛡️ Privacidad
- ❓ Ayuda y soporte

#### Cerrar sesión
Botón rojo al final.

---

## 3. Vista EMPLEADO 👮

Después de iniciar sesión con una cuenta `EMPLEADO`, verás solo **3 pestañas**:

```
[ Inicio ] [ Reportes ] [ Cuenta ]
```

> ❌ Los empleados **NO** pueden ver ni gestionar reportes ciudadanos. Solo pueden levantar reportes operativos sobre el funcionamiento del camión y la ruta.

### 3.1 Pestaña INICIO (Dashboard del empleado)

#### Hero guinda con tu identidad
- Avatar con casco
- "¡Buen turno!" y tu nombre
- Badge con tu desempeño: **EXCELENTE / MUY BUENO / BUENO**

#### Racha de puntualidad
Tarjeta naranja con:
- 🔥 Días consecutivos puntuales (ej. *"19 días seguidos"*)
- Mensaje motivador: *"¡Sigue así! No rompas la racha."*

#### KPIs
Dos tarjetas:
- 🎯 **Puntualidad mensual** (porcentaje)
- 💰 **Bono acumulado** (en pesos)

#### Próximo bono
Tarjeta amarilla destacada:
- *"Te faltan **N días** puntuales para desbloquear **+$500 MXN**"*
- Trofeo dorado

#### Tu horario
Tarjeta con:
- Nombre del turno (Turno Matutino)
- Horario completo (05:30 → 09:00)
- Bloque de ruta destacado (06:00 - 08:00)
- **Descansos preestablecidos**:
  - ☕ Descanso técnico: 07:00 · 10 min
  - 🧘 Pausa estiramiento: 08:00 · 5 min
- Días de la semana (Lunes a sábado) y descanso (Domingo)
- Nota motivacional sobre puntualidad

#### Mensaje motivacional del día
Tarjeta verde con una frase rotativa:
- *"Tu puntualidad permite que miles de familias planifiquen su día"*
- *"Cada salida a tiempo es un acto de servicio que transforma a Celaya"*
- *"Eres la cara del Gobierno de Celaya en cada colonia"*

#### Por qué importa tu puntualidad
4 cards explicando el impacto cívico:
- Cientos de vecinos planifican su día
- Evita basura en la calle y fauna nociva
- Hace más confiables las predicciones de la app
- Eres la imagen del Gobierno de Celaya

---

### 3.2 Pestaña REPORTES (operativos)

Para reportar incidentes con el camión o la ruta.

#### Pantalla principal
- Hero guinda con mensaje
- Botón "Nuevo reporte operativo"
- Lista de tus reportes anteriores con: folio, categoría, severidad, ruta, fecha y estado

#### Crear un reporte operativo (4 pasos)

**1. ¿Qué pasó?** Grid de 8 categorías con icono:
- 🔧 No arrancó (camión)
- ⚙️ Falla mecánica
- 🚨 Accidente vial
- 🚧 Obstáculo bloqueando ruta
- 🚦 Tráfico intenso
- ⛽ Combustible bajo
- 🌧️ Clima adverso
- ··· Otro

**2. Severidad**:
- 🟢 Baja
- 🟡 Media
- 🔴 Alta

**3. Ruta y unidad** (opcional)
- RUTA-XX
- Número de unidad

**4. Descripción** (500 caracteres)

Al enviar, recibes un **folio operativo** tipo `OP-20260523-CC35B3`.

#### Compartir reporte
Igual que los reportes ciudadanos: botón **"Compartir folio"** abre el menú nativo del sistema.

---

### 3.3 Pestaña CUENTA

Vista de perfil con:
- Tarjeta de identidad con badge "EMPLEADO OPERATIVO"
- **Tus permisos** (lista con ✓ verdes y ✗ grises):
  - ✓ Ver dashboard y estadísticas (las tuyas)
  - ✓ Gestionar reportes ciudadanos → **✗** (no permitido)
  - ✓ Cambiar estado de incidencias → **✗** (no permitido)
  - ✓ Gestionar usuarios y roles → **✗**
- **Sistema** (API conectada, BD SQLite, versión)
- Botón cerrar sesión

---

## 4. Vista ADMINISTRADOR 🛡️

Después de iniciar sesión con una cuenta `ADMIN`, verás **4 pestañas**:

```
[ Dashboard ] [ Reportes ] [ Usuarios ] [ Cuenta ]
```

### 4.1 Pestaña DASHBOARD

KPIs en vivo de toda la ciudad:

#### Encabezado
Logo de Celaya, tu nombre, badge "🛡️ Administrador"

#### Resumen general
6 tarjetas con números:
- 👥 Ciudadanos totales
- 🏠 Domicilios registrados
- 📋 Reportes totales
- ⏰ Reportes en últimas 24h
- 🚛 Rutas activas
- ⭐ Calificación promedio

#### Reportes por estado
Gráfica de barras con conteo y porcentaje:
- PENDIENTE (naranja)
- EN_PROCESO (azul)
- RESUELTO (verde)
- CERRADO (gris)

#### Reportes por tipo
Lista con conteo:
- ACUMULACION
- NO_PASO
- OTRO
- RETRASO

---

### 4.2 Pestaña REPORTES

Gestión completa de reportes ciudadanos.

#### Filtros (chips horizontales)
- Todos | Pendientes | En proceso | Resueltos | Cerrados

#### Lista de reportes
Cada tarjeta muestra:
- Folio
- Tipo (ej. "El camión no pasó")
- Badge de estado con color
- 👤 Nombre del ciudadano
- 📍 Domicilio + calle
- 🚛 Ruta asignada
- 💬 Descripción del ciudadano
- 📅 Fecha y hora
- **Botones de acción** (transición de estado):
  - PENDIENTE → EN_PROCESO / CERRADO
  - EN_PROCESO → RESUELTO / CERRADO
  - RESUELTO → CERRADO

Al tocar un botón, el estado cambia inmediatamente y el ciudadano ve la actualización en su app.

---

### 4.3 Pestaña USUARIOS (solo ADMIN)

Para gestionar toda la base de usuarios.

#### Filtros por rol
- Todos | Ciudadanos | Empleados | Administradores

#### Lista de usuarios
Cada tarjeta muestra:
- Avatar con ícono según rol
- Nombre completo
- Email
- Badge con su rol
- 🏠 Total domicilios · 📋 Total reportes

#### Cambiar rol
Al tocar un usuario (que no sea tú mismo), aparece un modal:
- Su nombre y email
- 3 opciones de rol con su ícono y color
- Botón "Confirmar" para aplicar el cambio
- Confirmación con alerta nativa

> ⚠️ No puedes cambiar tu propio rol (medida de seguridad)

---

### 4.4 Pestaña CUENTA

Igual que la del empleado pero con badge **ADMINISTRADOR**:
- Todos los permisos en ✓ verde
- Sistema (API, BD, versión)
- Cerrar sesión

---

## 5. Recomendaciones finales

### Para ciudadanos
- 📅 Saca la basura **máximo 30 min antes** del horario indicado
- 🌱 Separa **orgánicos, reciclables y sanitarios** en bolsas distintas
- 🔋 Lleva pilas, electrónicos y medicamentos a **puntos de acopio**
- 🚫 No persigas al camión ni saques basura fuera del horario
- 📝 Si hay un problema, **levanta un reporte**: ayuda a mejorar el servicio

### Para empleados
- ⏰ Sé puntual: cada minuto cuenta para los vecinos
- 🚧 Reporta cualquier incidencia (mecánica, vial, climática) al instante
- 🤝 Eres la cara del Gobierno de Celaya — trato amable hace la diferencia

### Para administradores
- 📊 Revisa el dashboard diariamente
- ⚡ Atiende los reportes pendientes en máximo 24-48h
- 👥 Gestiona los roles con cuidado, no degradas administradores por error