release(v1.0.0): entrega oficial segundo parcial - Sistema EcuRutas

.env.example

@@ -0,0 +1,6 @@
+# Variables de entorno públicas de Supabase (copiar a .env.local y completar con las credenciales reales)
+NEXT_PUBLIC_SUPABASE_URL=https://tu-proyecto.supabase.co
+NEXT_PUBLIC_SUPABASE_ANON_KEY=tu-clave-publica-anon-key
+
+# Secreto del servidor para firma HMAC-SHA256 de códigos QR (mínimo 32 caracteres)
+QR_SECRET=reemplazar-por-secreto-seguro-de-al-menos-32-caracteres

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,48 @@
+---
+name: "Reporte de Error (Bug)"
+about: "Reporta un fallo reproducible en el sistema EcuRutas"
+title: "[BUG] <módulo>: <descripción corta>"
+labels: ["tipo:bug", "bug"]
+assignees: ""
+---
+
+### 1. Módulo Afectado
+- [ ] auth
+- [ ] cooperativas
+- [ ] buses
+- [ ] frecuencias
+- [ ] busqueda
+- [ ] ventas
+- [ ] pagos
+- [ ] boletos
+- [ ] escaneo
+- [ ] notificaciones
+- [ ] configuracion
+- [ ] reportes
+
+### 2. Rol con el que Ocurre el Error
+- [ ] admin
+- [ ] cooperativa
+- [ ] oficinista
+- [ ] chofer
+- [ ] usuario
+- [ ] público (no autenticado)
+
+### 3. Descripción del Fallo
+Explicación clara y concisa de lo que ocurre inesperadamente.
+
+### 4. Pasos para Reproducir
+1. Ir a '...'
+2. Hacer clic en '...'
+3. Ingresar el valor '...'
+4. Ver el error en '...'
+
+### 5. Comportamiento Esperado
+Lo que debió haber ocurrido según los requisitos del sistema.
+
+### 6. Capturas o Registros de Consola
+Si aplica, adjunta capturas de pantalla o mensajes de error de la consola del navegador / terminal.
+
+### 7. Entorno
+- **Navegador**: [ej. Chrome 130, Firefox, Edge]
+- **Dispositivo**: [ej. PC Windows, Móvil Android]

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,43 @@
+---
+name: "Nueva Funcionalidad (Propuesta)"
+about: "Propuesta de una nueva característica o requerimiento funcional"
+title: "[MEJORA] <módulo>: <descripción de la funcionalidad>"
+labels: ["tipo:tarea", "enhancement"]
+assignees: ""
+---
+
+### 1. Módulo del Sistema
+- [ ] auth
+- [ ] cooperativas
+- [ ] buses
+- [ ] frecuencias
+- [ ] busqueda
+- [ ] ventas
+- [ ] pagos
+- [ ] boletos
+- [ ] escaneo
+- [ ] notificaciones
+- [ ] configuracion
+- [ ] reportes
+
+### 2. Rol Beneficiario
+- [ ] admin
+- [ ] cooperativa
+- [ ] oficinista
+- [ ] chofer
+- [ ] usuario
+
+### 3. Descripción de la Funcionalidad
+¿Qué problema o necesidad resuelve esta funcionalidad?
+
+### 4. Criterios de Aceptación
+- [ ] Dado que... Cuando... Entonces...
+- [ ] Validación de permisos por rol en RLS / middleware.
+- [ ] Componente visual responsivo con Tailwind CSS.
+
+### 5. Elementos de Configuración Afectados
+- [ ] Interfaz de Usuario (`src/modules/*` o `src/app/*`)
+- [ ] Esquema de Base de Datos (`supabase/schema_supabase.sql`)
+- [ ] Políticas RLS
+- [ ] Supabase Storage
+- [ ] Dependencias (`package.json`)

.github/ISSUE_TEMPLATE/peticion_de_cambio.md

@@ -0,0 +1,42 @@
+---
+name: "Petición de Cambio (RFC / ITIL Change Request)"
+about: "Solicitud formal de modificación a elementos de configuración existentes"
+title: "[RFC] <alcance>: <motivo del cambio>"
+labels: ["change-request", "itil"]
+assignees: ""
+---
+
+### 1. Información General de la Solicitud
+- **Solicitante**: 
+- **Fecha de Solicitud**: 
+- **Tipo de Cambio (ITIL)**: 
+  - [ ] Estándar (Rutinario preaprobado)
+  - [ ] Normal (Requiere evaluación y 2 aprobaciones)
+  - [ ] Mayor / Crítico (Impacto en esquema BD, RLS o middleware)
+  - [ ] Emergencia (Hotfix inmediato)
+
+### 2. Justificación del Cambio
+¿Por qué es necesario este cambio y qué impacto tiene si no se implementa?
+
+### 3. Elementos de Configuración (CI) Impactados
+- [ ] Esquema SQL / Migración (`supabase/schema_supabase.sql`)
+- [ ] Tipos TypeScript (`src/types/database.types.ts`)
+- [ ] Middleware / Reglas de Acceso (`src/middleware.ts`)
+- [ ] Dependencias (`package.json`)
+- [ ] Módulo específico: 
+
+### 4. Evaluación de Riesgos e Impacto
+- **Nivel de Riesgo**: [Bajo / Medio / Alto]
+- **Posibles efectos secundarios**: 
+
+### 5. Plan de Pruebas
+¿Cómo se verificará que el cambio funciona correctamente sin romper otros módulos?
+
+### 6. Plan de Rollback (Reversión)
+En caso de fallo en `develop` o `main`, ¿cuál es el procedimiento exacto para revertir el cambio?
+- Script SQL inverso (`DOWN`):
+- Procedimiento Git (`git revert`):
+
+### 7. Aprobaciones Requeridas (Mínimo 2 aprobadores)
+- [ ] Revisor 1 (Desarrollador par): 
+- [ ] Revisor 2 (Configuration Manager / Tech Lead): 

.github/ISSUE_TEMPLATE/rfc_change.md

@@ -0,0 +1,77 @@
+---
+name: "RFC – Propuesta de Cambio (CCB)"
+about: "Solicitud formal de cambio para el Comité de Control de Cambios (CCB)"
+title: "[RFC-NNN] <Título descriptivo del cambio propuesto>"
+labels: ["tipo:rfc", "ccb:propuesto"]
+assignees: ""
+---
+
+## 📄 RFC — Propuesta de Cambio
+
+| Campo | Valor |
+|---|---|
+| **RFC N°** | NNN |
+| **Autor / Responsable** | @usuario |
+| **Fecha de propuesta** | YYYY-MM-DD |
+| **Tarea relacionada** | #N |
+| **Estado del ciclo de vida** | `Propuesto` → `En revisión por CCB` → `Aprobado` → `Implementado` / `Rechazado` |
+
+---
+
+## 🔍 Propuesta
+
+<!-- Descripción clara y concisa del cambio propuesto -->
+
+---
+
+## 💡 Motivación
+
+<!-- ¿Por qué es necesario este cambio? ¿Qué problema resuelve? -->
+
+---
+
+## 📐 Impacto
+
+<!-- Componentes, archivos, tablas o módulos afectados -->
+
+**Archivos/módulos afectados:**
+- [ ] `src/...`
+- [ ] Tabla Supabase: `"..."`
+
+**Nivel de impacto:** Alto / Medio / Bajo
+
+---
+
+## 🔀 Alternativas consideradas
+
+<!-- Otras soluciones evaluadas y por qué se descartaron -->
+
+1. **Alternativa A**: ...
+2. **Alternativa B**: ...
+
+---
+
+## ⚠️ Riesgo
+
+<!-- Posibles efectos negativos, dependencias críticas o puntos de fallo -->
+
+- Riesgo 1: ...
+- Plan de mitigación: ...
+
+---
+
+## 🏛️ Decisión del CCB
+
+<!-- Esta sección la completa el CCB (Juan como presidente + 2 miembros) -->
+
+**Fecha de revisión:** <!-- YYYY-MM-DD -->
+
+**Decisión:** `Aprobado` / `Rechazado` / `En revisión por CCB`
+
+**Justificación:**
+> ...
+
+**Firmado por:**
+- Presidente CCB: @juanjose1234456787654
+- Miembro CCB 2: @...
+- Miembro CCB 3: @...

.github/ISSUE_TEMPLATE/tarea_actividad.md

@@ -0,0 +1,76 @@
+---
+name: "Tarea / Actividad (Segundo Parcial)"
+about: "Plantilla estándar para issues de tarea del segundo parcial – PROYECTO_MANEJO_SP2"
+title: "[NN/18][Responsable] Código – Nombre de la tarea"
+labels: ["tipo:tarea"]
+assignees: ""
+---
+
+## 📋 Encabezado
+
+| Campo | Valor |
+|---|---|
+| **Orden** | NN de 18 |
+| **Responsable** | @usuario |
+| **Fase** | Fase X – Nombre |
+| **Rama sugerida** | `feature/<nombre-rama>` |
+| **Depende de** | #N (Código) — o "Ninguna – puedes empezar ya" |
+| **Bloquea a** | #N (Código) |
+| **Prioridad** | Alta / Media / Baja |
+
+> ⚠️ **Antes de cerrar este issue:** confirma que el issue del que dependes ya tiene su PR aprobado y fusionado en `develop`.
+>
+> 💡 **Trabajo en paralelo:** Puedes empezar usando las interfaces TypeScript y firmas de funciones publicadas por el responsable anterior; integra contra la implementación real cuando se haga merge a `develop`.
+
+---
+
+## 🎯 Objetivo
+
+<!-- 1–2 frases que describan qué se logra al completar esta tarea -->
+
+---
+
+## 🔧 Detalle técnico
+
+<!-- Qué construir, archivos clave y tablas de Supabase involucradas -->
+
+**Archivos a tocar:**
+- `src/...`
+
+**Tablas Supabase (PascalCase):**
+- `"Tabla1"`, `"Tabla2"`
+
+---
+
+## ✅ Criterios de aceptación
+
+- [ ] Criterio verificable 1
+- [ ] Criterio verificable 2
+- [ ] Criterio verificable 3
+
+---
+
+## 🏁 Definición de Terminado
+
+- [ ] Código con tipado estricto TypeScript (sin `any`)
+- [ ] Sin imports de `mockData` ni datos quemados en código
+- [ ] Commits con formato `<tipo>(<alcance>): <descripción>`
+- [ ] PR hacia `develop` con `Closes #N` y **2 aprobaciones**
+- [ ] Capturas o evidencia funcional adjunta
+- [ ] Evidencia disponible para el informe técnico UTA
+
+---
+
+## 🌿 Flujo Gitflow
+
+```bash
+git checkout develop && git pull origin develop
+git checkout -b feature/<nombre-rama>
+
+# … desarrollar …
+
+git add . && git commit -m "feat(<modulo>): <descripción>"
+git push origin feature/<nombre-rama>
+# Abrir PR hacia develop con: Closes #<número de este issue>
+```
+