ITECEL ADM — Wiki Técnica

Appearance

CATÁLOGO FUNCIONAL DE MÓDULOS DE LA APLICACIÓN ​

ITECEL ADM — Fuente de Verdad Funcional
Última actualización: 2026-09-27

ÍNDICE DE MÓDULOS ​

  1. Panel de Administrador (Dashboard)
  2. Directorio de Viviendas y Residentes
  3. Presupuesto Anual y Fondos
  4. Emisión de Expensas y Alícuotas
  5. Cobranzas y Registro de Pagos
  6. Control y Registro de Egresos
  7. Estados de Cuenta y Liquidaciones
  8. Cuentas Bancarias y Caja Chica
  9. Informes Financieros y Auditoría
  10. Cartelera Virtual y Comunicaciones
  11. Repositorio de Documentos y Actas
  12. Configuración del Condominio y Licencia
  13. Herramientas Operativas Rápidas (Invitaciones y Despacho Masivo)
  14. Panel de Control Superadmin (Cockpit Global)
  15. Portal del Residente y Directorio Comunitario

1. Panel de Administrador (adminDashboard) ​

  • Ruta en app: 'adminDashboard'
  • Entrada de código: [src/components/AdminDashboardView.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/AdminDashboardView.tsx)
  • Qué hace (lenguaje para cliente): Tu centro de control operativo diario. Funciona como un tablero con accesos directos e interactivos a cada sección del sistema, complementado con indicadores rápidos de inmuebles registrados, presupuesto, balance bancario y egresos acumulados que te llevan a su detalle con un solo clic.
  • Roles con acceso: Administrador regular, Demo (Superadmin accede directamente a su propio Cockpit; Residente y Comité acceden a Portal).
  • Tabla(s) principal(es): KPIs agregados en memoria y base de datos desde housing_units, budgets, bank_accounts, expenses, generated_debts.
  • Estado: Estable.

2. Directorio de Viviendas y Residentes (directory) ​

  • Ruta en app: 'directory'
  • Entrada de código: [src/components/DirectoryTable.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/DirectoryTable.tsx)
  • Qué hace (lenguaje para cliente): Registra viviendas, departamentos, casas, locales, establece datos de contacto de propietarios y/o inquilinos, determina porcentajes de alícuota y registra correos electrónicos a los que luego podrás enviar invitaciones para que cada residente ingrese a la plataforma, o incluso estados de cuenta. (En cuentas demo dispones de una cuota de prueba de 10 correos).
  • Roles con acceso: Administrador regular, Demo, Miembro del Directorio / Comité (modo lectura).
  • Tabla(s) principal(es): housing_units, sections (claves foráneas: condo_id → condos(id), section_id → sections(id)).
  • Estado: Estable.

3. Presupuesto Anual y Fondos (budget) ​

  • Ruta en app: 'budget'
  • Entrada de código: [src/components/BudgetView.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/BudgetView.tsx)
  • Qué hace (lenguaje para cliente): Establece tu ecosistema contable. Mediante partidas presupuestarias, planifica los ingresos y gastos proyectados para el año, ordinarios o extraordinarios y monitorea la ejecución presupuestaria en tiempo real para evitar desviaciones financieras.
  • Roles con acceso: Administrador regular, Demo, Miembro del Directorio / Comité (modo lectura).
  • Tabla(s) principal(es): budgets (clave primaria compuesta: (condo_id, year)).
  • Estado: Estable.

4. Emisión de Expensas y Alícuotas (generateDebts) ​

  • Ruta en app: 'generateDebts'
  • Entrada de código: [src/components/debts/GenerateDebtsMainView.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/debts/GenerateDebtsMainView.tsx)
  • Qué hace (lenguaje para cliente): Emite las cuotas mensuales de forma detallada y rápida, ya sea según el coeficiente de alícuota o por valores fijos. Utiliza la plantilla para generar adeudos recurrentes masivos. Los adeudos quedan registrados inmediatamente en las cuentas de cada vivienda.
  • Roles con acceso: Administrador regular, Demo.
  • Tabla(s) principal(es): debt_templates, generated_debts (condo_id → condos(id), unit_id → housing_units(id), template_id → debt_templates(id)).
  • Estado: Estable / Núcleo en congelamiento de pruebas.

5. Cobranzas y Registro de Pagos (payments) ​

  • Ruta en app: 'payments'
  • Entrada de código: [src/components/payments/CapturePaymentsMainView.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/payments/CapturePaymentsMainView.tsx)
  • Qué hace (lenguaje para cliente): Registra transferencias, depósitos o pagos recibidos de los residentes. Concilia comprobantes rápidamente y mantén los saldos al día sin descuadres ni retrasos.
  • Roles con acceso: Administrador regular, Demo.
  • Tabla(s) principal(es): payment_records, generated_debts, bank_movements (account_id → bank_accounts(id), debt_id → generated_debts(id)).
  • Estado: Estable / Núcleo en congelamiento de pruebas.

6. Control y Registro de Egresos (expenses) ​

  • Ruta en app: 'expenses'
  • Entrada de código: [src/components/expenses/CaptureExpenseMainView.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/expenses/CaptureExpenseMainView.tsx), [src/components/suppliers/SuppliersDirectoryView.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/suppliers/SuppliersDirectoryView.tsx)
  • Qué hace (lenguaje para cliente): Registra cada desembolso clasificándolo por su partida presupuestaria, asociándolo al proveedor correspondiente y manteniendo un respaldo digital de egresos.
  • Roles con acceso: Administrador regular, Demo.
  • Tabla(s) principal(es): expenses, suppliers, bank_movements (supplier_id → suppliers(id), account_id → bank_accounts(id)).
  • Estado: Estable.

7. Estados de Cuenta y Liquidaciones (accountStatement) ​

  • Ruta en app: 'accountStatement'
  • Entrada de código: [src/components/statements/AccountStatementFullView.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/statements/AccountStatementFullView.tsx), [src/components/UnitAccountStatementModal.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/UnitAccountStatementModal.tsx)
  • Qué hace (lenguaje para cliente): Revisa el historial detallado de cargos y pagos de cualquier vivienda, descarga estados de cuenta en PDF o envíalos por correo electrónico. (En cuentas demo dispones de una cuota de prueba de 10 correos para experimentar el despacho digital).
  • Roles con acceso: Administrador regular, Demo, Residente (únicamente su unidad asignada), Miembro del Comité.
  • Tabla(s) principal(es): Reconciliación cruzada de housing_units, generated_debts, payment_records, statement_dispatches.
  • Estado: Estable.

8. Cuentas Bancarias y Caja Chica (bankAccounts) ​

  • Ruta en app: 'bankAccounts'
  • Entrada de código: [src/components/BankAccountsView.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/BankAccountsView.tsx)
  • Qué hace (lenguaje para cliente): Administra las cuentas bancarias receptoras y fondos del condominio. Cada pago cobrado o gasto cancelado impacta automáticamente en el saldo de la cuenta elegida y puedes revisar sus estados de cuenta.
  • Roles con acceso: Administrador regular, Demo.
  • Tabla(s) principal(es): bank_accounts, bank_movements (condo_id → condos(id), related_account_id → bank_accounts(id)).
  • Estado: Estable.

9. Informes Financieros y Auditoría (financials) ​

  • Ruta en app: 'financials'
  • Entrada de código: [src/components/FinancialsPreview.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/FinancialsPreview.tsx)
  • Qué hace (lenguaje para cliente): Genera reportes de balances, flujo de caja, ejecución presupuestaria y listados de morosidad listos para imprimir o exportar, ideales para asambleas y auditorías con total transparencia.
  • Roles con acceso: Administrador regular, Demo, Residente, Miembro del Comité.
  • Tabla(s) principal(es): Agregación en tiempo real de generated_debts, payment_records, expenses, bank_movements, budgets.
  • Estado: Estable.

10. Cartelera Virtual y Comunicaciones (communications) ​

  • Ruta en app: 'communications' (acceso directo desde el botón #navbar-quick-communications-btn en el navbar)
  • Entrada de código: [src/components/community/CommunicationsMainView.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/community/CommunicationsMainView.tsx)
  • Qué hace (lenguaje para cliente): Desde aquí puedes acceder al panel de Comunicaciones. Mantén a toda la comunidad informada. Publica avisos y comunicados oficiales en formato de posts dinámicos al alcance de todos los residentes.
  • Roles con acceso: Administrador regular (publicar y gestionar), Demo (límite de documentos en post según D-NUEVA-4), Residente y Comité (lectura e interacción).
  • Tabla(s) principal(es): community_posts (almacenamiento en bucket Supabase condo-community).
  • Estado: Estable (con evoluciones pendientes en deuda técnica: despacho por email y descarga JPG/PDF).

11. Repositorio de Documentos y Actas (documents) ​

  • Ruta en app: 'documents'
  • Entrada de código: [src/components/community/CommunicationsMainView.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/community/CommunicationsMainView.tsx)
  • Qué hace (lenguaje para cliente): Sube reglamentos internos, actas de asamblea o circulares oficiales en formato PDF para que estén archivados en la nube y disponibles para consulta y descarga de todos los copropietarios e inquilinos.
  • Roles con acceso: Administrador regular, Demo, Residente, Miembro del Comité.
  • Tabla(s) principal(es): community_documents (bucket privado en Supabase Storage).
  • Estado: Estable.

12. Configuración del Condominio y Licencia (settings) ​

  • Ruta en app: 'settings'
  • Entrada de código: [src/components/SettingsView.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/SettingsView.tsx)
  • Qué hace (lenguaje para cliente): Personaliza los datos legales de tu condominio, logotipo, instrucciones de pago y revisa el estado de tu licencia. Además, desde aquí podrás repetir este tour interactivo cuando lo necesites.
  • Roles con acceso: Administrador regular, Demo.
  • Tabla(s) principal(es): condos (perfil institucional), licenses (lectura de estado), app_users.
  • Estado: Estable.

13. Herramientas Operativas Rápidas (Invitaciones y Despacho Masivo) ​

  • Ruta en app: Sección dentro de Configuración (#section-administrative-tools)
  • Entrada de código: [src/components/ResidentInvitationsModal.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/ResidentInvitationsModal.tsx), [src/components/statements/StatementDispatchModal.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/statements/StatementDispatchModal.tsx)
  • Qué hace (lenguaje para cliente): Accede a herramientas operativas clave para tu gestión: el envío masivo de invitaciones para que los residentes activen su cuenta en el portal, y la cobranza masiva para despachar todos los estados de cuenta por correo electrónico en un par de clics. (En cuentas demo dispones de una cuota de prueba de 10 correos unificados).
  • Roles con acceso: Administrador regular, Demo (con semáforo de cupo 10/10).
  • Tabla(s) principal(es): housing_units, statement_dispatches, demo_email_dispatches, Edge Functions send-invitation y send-statement.
  • Estado: Estable.

14. Panel de Control Superadmin (Cockpit Global) ​

  • Ruta en app: 'cockpit', 'licenses', 'centralBackups'
  • Entrada de código: [src/components/superadmin/SuperadminCockpitScreen.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/superadmin/SuperadminCockpitScreen.tsx), [src/components/licenses/LicensesPanelModal.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/licenses/LicensesPanelModal.tsx), [src/components/backups/CentralBackupsModal.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/backups/CentralBackupsModal.tsx)
  • Qué hace (lenguaje para cliente): Consola maestra exclusiva de los propietarios del sistema para aprobar solicitudes de licencia, emitir licencias perpetuas o anuales, inspeccionar el padrón de condominios activos y restaurar o descargar snapshots centralizados de la base de datos.
  • Roles con acceso: Exclusivo Superadmin global (vida permanente, sin licencias).
  • Tabla(s) principal(es): licenses, license_requests, central_backups, app_users, condos.
  • Estado: Estable.

15. Portal del Residente y Directorio Comunitario ​

  • Ruta en app: Subconjunto restringido (communications, documents, accountStatement, financials)
  • Entrada de código: [src/App.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/App.tsx), [src/components/statements/AccountStatementFullView.tsx](file:///c:/Users/Admin/ITECEL-adm/ITECEL-ADM/src/components/statements/AccountStatementFullView.tsx)
  • Qué hace (lenguaje para cliente): Entorno seguro y personal para el copropietario e inquilino. Permite consultar el desglose exacto de alícuotas pendientes, saldos a favor, descargar comprobantes en PDF, y revisar publicaciones y reglamentos del condominio.
  • Roles con acceso: Residente, Miembro del Comité.
  • Tabla(s) principal(es): housing_units (filtrada por RLS a su usuario), generated_debts, payment_records, community_posts.
  • Estado: Estable.
  • Análisis Forense Botón por Botón: Queda registrado como deuda técnica pendiente un recorrido forense exhaustivo que documente detalladamente cada botón, modal secundario y acción disponible dentro de cada una de las pantallas de la aplicación.

Wiki Técnica Oficial — ITECEL ADM

Acceso Restringido · Cloudflare Zero Trust