ITECEL ADM — Wiki Técnica

Appearance

Wiki Técnica Oficial — ITECEL ADM ​

Iniciativa: Wiki + Guía de Usuario y Chatbot (Fase W-2)
Última actualización: 2026-09-28
Estado: Fuente de Verdad Oficial / Repositorio Git
Principio Rector: El código manda sobre la documentación. Todo commit relevante actualiza su .md en el mismo turno (Regla R14).

📚 Índice Maestro de la Wiki ​

1. Gobernanza, Metodología y Procesos ​

  • [docs/GOBERNANZA.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/GOBERNANZA.md)
    Rol y equipo, Reglas Permanentes del Método (R1 a R13), nueva regla R14 (Mantenimiento de la Wiki), contexto del proyecto y protocolo de turno de 5 pasos.
  • [docs/GOBERNANZA-SQL-Y-RITUALES.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/GOBERNANZA-SQL-Y-RITUALES.md)
    Anexo canónico para manipulación de SQL en producción, principio del esquema real como única verdad y smoke tests obligatorios.
  • [docs/pruebas-adversarias-obligatorias.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/pruebas-adversarias-obligatorias.md)
    Pila de validación adversaria, casos límite y pruebas de estrés para cambios estructurales.

2. Catálogo Funcional y Módulos ​

  • [docs/MODULOS.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/MODULOS.md)
    Catálogo completo de los 15 módulos del sistema: rutas en app, archivos de entrada en código, descripción orientada al cliente (fichas aprobadas), roles con acceso, tablas de base de datos asociadas y estado operativo.
  • [docs/TOUR_DIDACTICO_GUION.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/TOUR_DIDACTICO_GUION.md)
    Guion canónico y especificación visual de las 14 tarjetas del tour didáctico interactivo de bienvenida.
  • [docs/MODULO-FINANZAS.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/MODULO-FINANZAS.md)
    Especificación profunda del flujo de conciliación bancaria, adeudos y cuentas por cobrar.
  • [docs/PRESUPUESTO-VS-REAL.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/PRESUPUESTO-VS-REAL.md)
    Metodología de cálculo del presupuesto anual vs egresos reales ejecutados.

3. Arquitectura y Decisiones de Diseño (ADRs) ​

  • [docs/ARQUITECTURA.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/ARQUITECTURA.md)
    Topología general del stack (React + Vite + Supabase + Vercel + Resend), responsabilidades frontend vs backend, diagramas Mermaid y análisis forense de la cadena de identidad.
  • [docs/DECISIONES.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/DECISIONES.md)
    Registro formal de Decisiones de Arquitectura (ADR-001 al ADR-015): límites en BD, separación identidad vs descriptivo, matriz de precios, perpetua, superadmins intocables, auditoría con JWT, anti-spam demo, anti-deadlock, supresión Resend, wiki repo, doble despliegue, enlaces por email, auditoría Vía B en DELETE, sistema unificado de límites sobre plan_limits y tres estados de licencia con deuda de purga a 30 días.
  • [docs/ARQUITECTURA-RESPALDOS-Y-GOBERNANZA.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/ARQUITECTURA-RESPALDOS-Y-GOBERNANZA.md)
    Especificación de la arquitectura de respaldos centrales en PostgreSQL (central_backups), RLS y retención.

4. Operaciones, Despliegues y Runbooks ​

  • [docs/RUNBOOK.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/RUNBOOK.md)
    Guía operativa paso a paso para el operador: ritual de despliegue dual (Edge Functions en Supabase y SQL Editor), checklist anti-deadlock para DDL, protocolo de diagnóstico de correos en Resend, checklist post-sync en Table Editor y registro de las 3 superficies de despliegue.
  • [docs/RUNBOOK-W2-DESPLEGUE-WIKI.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/RUNBOOK-W2-DESPLEGUE-WIKI.md)
    Guía de despliegue manual del visor VitePress en Cloudflare Pages con protección perimetral Cloudflare Zero Trust (One-Time PIN). Estado: preparado en repositorio, despliegue pendiente de ejecución por el operador.

5. Datos, Esquemas y Deuda Técnica ​

  • [docs/DATOS.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/DATOS.md)
    Diagrama Entidad-Relación (ERD) en Mermaid, catálogo de tablas y políticas RLS vigentes, elementos pendientes de verificación contra producción con scripts SQL de solo lectura, matriz de precios definitiva (Tier × Ciclo) y enums.
  • [docs/module-table-map.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/module-table-map.md)
    Mapeo forense de integración, llaves foráneas críticas y orden topológico obligatorio de inserción/sincronización (11 pasos).
  • [docs/TECHNICAL_DEBT.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/TECHNICAL_DEBT.md) / [docs/DEUDA-TECNICA.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/DEUDA-TECNICA.md)
    Registro canónico de deuda técnica (Secciones 1 a 10 con D-NUEVA-1 a D-NUEVA-5).
  • [docs/ROADMAP.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/ROADMAP.md)
    Evolución histórica y fases de desarrollo del producto.
  • [docs/FASE-4-ESPECIFICACION.md](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/docs/FASE-4-ESPECIFICACION.md)
    Documento histórico de la especificación de la Fase 4.

🔒 Compromisos de Seguridad y Privacidad ​

  1. Cero Secretos: Ningún archivo de esta wiki contiene API keys, passwords, tokens JWT o credenciales.
  2. Cero Datos de Pilotos: No se almacenan nombres reales de residentes, correos privados de clientes ni montos confidenciales de pruebas de campo.
  3. Auditabilidad: Los cambios a esta wiki quedan registrados mediante Git en el historial del repositorio.

Wiki Técnica Oficial — ITECEL ADM

Acceso Restringido · Cloudflare Zero Trust