Especificación funcional del sistema

Documento de requerimientos organizado por módulos. Cliente: ECIM BUSINESS SOLUTIONS EIRL.

Índiceaaa

1. Usuarios, roles y permisos
2. Registro del alumno y documentación
3. Planes, pagos, cuotas y vencimientos
4. Aprobación de pagos y habilitación de la alumna
5. Contrato y firma del alumno
6. Membresía
7. Cohortes, capacidad y jornada de las asesoras
8. Asignación de alumnas a asesoras y preferencia horaria
9. Calendario, disponibilidad y reservas
10. Asesoría académica y temario de 12 clases mensuales
11. Sesiones, asistencia y bitácora
12. Control de horas y consolidado mensual
13. Liquidación mensual de asesoras
14. Formación (15 módulos)
15. Seguimiento real de actividad académica
16. Beneficios y recompensas
17. Fase de ventas (Camila → Jasmin)
18. Cobranza y comisiones
19. Servicio Premium
20. Constancia digital y código QR
21. Notificaciones automáticas
22. Paneles por rol
23. Reportes
24. Configuración administrativa
25. Seguridad, privacidad y auditoría
26. Condiciones generales de desarrollo
27. Diagramas de funcionamiento

1. Usuarios, roles y permisos

Objetivo: gestionar los usuarios y controlar el acceso según el rol, garantizando que cada usuario vea y opere solo la información que le corresponde.

Funcionalidades

• Autenticación de usuarios (inicio y cierre de sesión seguro).
• Registro, visualización y modificación de los datos de los usuarios.
• Gestión de roles y permisos (RBAC con permisos finos).
• Separación de datos por rol.

Roles

2. Registro del alumno y documentación

Objetivo: que el alumno registre sus datos personales, su programa y su pago inicial, adjuntando los documentos de sustento.

Funcionalidades

• Formulario de registro con:
  • Nombres y apellidos completos
  • DNI o Carné de Extranjería
  • Nacionalidad
  • Correo electrónico (preferentemente Gmail)
  • WhatsApp
  • País y ciudad
  • Programa y plan
  • Tipo de pago
  • Monto pagado
  • Método de pago (Yape, Plin, transferencia, depósito u otro)
  • Comprobante de pago
  • Documento de identidad (solo lado frontal)
• Al enviar el registro, el alumno queda en estado "Pago pendiente de validación".
• Almacenamiento privado de documentos, visibles únicamente para los roles autorizados.

3. Planes, pagos, cuotas y vencimientos

Objetivo: configurar los planes comerciales y registrar la situación financiera de cada alumno.

Planes de referencia actuales (parámetros configurables, no valores fijos en el código):

Funcionalidades

• Configuración de cada plan: precio total, monto de reserva, número de cuotas, monto de cada cuota, fechas o reglas de vencimiento, duración de membresía, regla Pago → módulos, regla Pago → recompensas, regla Pago → habilitación para programar asesorías y condiciones de servicio.
• Registro de nuevos pagos por el alumno desde "Mis pagos" con el botón REGISTRAR NUEVO PAGO; al adjuntar el comprobante queda como "Pago pendiente de validación".
• Control de total pagado, saldo, cuotas y vencimientos de cada alumno.
• Reglas Pago → módulos configurables por Administración, sin establecer en el código que una cuota equivale a un módulo.

Ejemplo (modificable sin cambiar código)

4. Aprobación de pagos y habilitación de la alumna

Objetivo: gestionar la aprobación de pagos como evento crítico y conectar los pagos con la habilitación de la alumna y la programación de asesorías.

Lógica central: pago aprobado → alumna habilitada → asesoría programable.

Funcionalidades

• Aprobación o rechazo únicamente por la Dueña/Superadmin o Administración autorizada. Ni la asesora comercial ni la educativa pueden aprobar, rechazar o modificar un pago.
• Al aprobar un pago, el sistema ejecuta automáticamente y en este orden:
  1. Registrar el pago aprobado
  2. Actualizar total pagado
  3. Actualizar saldo
  4. Actualizar cuota y vencimiento
  5. Aplicar la regla de módulos desbloqueados
  6. Desbloquear recompensas aplicables
  7. Actualizar membresía
  8. Cambiar el estado de la alumna a HABILITADA y liberar la programación de asesorías según su plan
  9. Calcular la comisión comercial
  10. Actualizar dashboards
  11. Activar el flujo de asignación/asesoría si corresponde
  12. Notificar a la asesora educativa asignada que la alumna está habilitada
  13. Enviar notificaciones al alumno y a la comercial
  14. Registrar la auditoría
• Rechazo con motivo obligatorio; un pago rechazado no desbloquea beneficios ni habilita la programación.
• Reversión o devolución mediante un ajuste/reversión, sin eliminar el histórico.
• Bloqueo de nuevas reservas mientras la cuota no esté aprobada, con mensaje claro y registro del intento. Solo se puede programar a una alumna no habilitada con autorización expresa de la Dueña, la cual queda auditada.
• Detección automática de cuota vencida: la alumna pasa a no habilitada, se bloquean nuevas reservas según la política, semáforo rojo en el perfil, notificación a la Dueña, la comercial y la asesora, y registro de auditoría.
• Política configurable ante una cuota que vence cuando ya hay clases reservadas (mantener, suspender o cancelar esas reservas, y periodo de gracia). Por defecto se bloquea la creación de nuevas reservas y se conservan las ya creadas con un aviso visible.

Semáforo de estado de cuota

Visible en solo lectura en el perfil de cada alumna asignada a la asesora educativa.

5. Contrato y firma del alumno

Objetivo: generar automáticamente el contrato con los datos del registro y gestionar su aceptación y firma.

Funcionalidades

• Generación automática del contrato con: ECIM BUSINESS SOLUTIONS EIRL, nombre, DNI/CE, nacionalidad, email, WhatsApp, programa, plan, precio total, pago inicial, saldo, cuotas, vencimientos y términos.
• Flujo de firma: revisar contrato → aceptar términos → FIRMAR CONTRATO → guardar fecha/hora, usuario, versión y evidencia.
• El alumno revisa el contrato antes de firmar; una vez firmado no se muestra una sección permanente "Mi contrato".
• Histórico de contratos firmados: búsqueda, visualización y descarga por Superadmin/Administración.

⚠️ Nota legal: la validez jurídica depende del mecanismo de firma seleccionado y de la normativa aplicable. Una firma dibujada no equivale automáticamente a una firma digital certificada.

6. Membresía

Objetivo: controlar la vigencia del servicio contratado por cada alumno.

Funcionalidades

• Registro de fecha de inicio, fecha de expiración, plan y estado (Activa / Expirada).
• Historial de renovaciones.
• Reglas de duración configurables (ejemplo: inicio 17/09/2026 → vencimiento 17/09/2027 para un plan de un año).

7. Cohortes, capacidad y jornada de las asesoras

Objetivo: organizar el crecimiento mediante cohortes y controlar la capacidad mensual de las asesoras educativas.

Metas y cifras de diseño

Rotación de ejemplo:

Funcionalidades

• Cohorte como entidad propia con: fecha de inicio y fin, meta de alumnos, capacidad máxima por asesora, asesoras asignadas, alumnos asignados, horas comprometidas, estado (planificada, abierta, en atención, cierre, finalizada) y reglas de liberación y reutilización.
• Regla de capacidad: máximo inicial de 10 alumnos nuevos por asesora y cohorte. Una asesora en 10/10 no recibe otro alumno de esa cohorte salvo override autorizado por la Dueña/Superadmin, registrando quién, cuándo y por qué.
• Regla de liberación: al terminar los tres meses, el sistema cambia automáticamente a la asesora a "Disponible para nueva cohorte", siempre que no haya otra asignación incompatible, con registro de auditoría.
• Cierre de cohorte: cerrar periodo → impedir nuevas asignaciones → finalizar cohorte → liberar asesora → recalcular capacidad → permitir nueva cohorte → auditar.
• Cálculo automático de cuántas asesoras se requieren cuando cambie la meta mensual de alumnos.

Jornada de cada asesora educativa

• 5 horas diarias, lunes a sábado → 30 h semanales / 120 h mensuales (4 semanas de cálculo).
• Cada alumna recibe 3 horas por semana (12 h al mes), en 12 clases de 1 hora (3 por semana).
• Con 10 alumnas se completan las 120 h mensuales de la asesora.
• El sistema conserva las fechas reales de calendario sin asumir que todos los meses tienen cuatro semanas; el parámetro de cálculo es configurable.

Turnos iniciales

• Todas de lunes a sábado, con 10 alumnos nuevos por cohorte por defecto.
• Configurables: duración de cada slot, capacidad por slot, días de atención, vacaciones, feriados y bloqueos.
• El turno de cinco horas es una ventana de disponibilidad; no implica cinco reservas obligatorias.

8. Asignación de alumnas a asesoras y preferencia horaria

Objetivo: que la asesora comercial asigne cada alumno nuevo a una asesora educativa con cupo y horario compatible.

Funcionalidades

• Vista de disponibilidad para la comercial: asesora, asignados (X/10), máximo, cupos restantes, turno y estado (Disponible / Sin cupos).
• Contador mensual y por cohorte en tiempo real: al asignar, el contador aumenta; al llegar a 10/10 el estado cambia a "Sin cupos".
• Filtros por cohorte, turno y disponibilidad.
• Preferencia horaria del alumno durante el proceso comercial. No es una reserva; sirve para encontrar una asesora compatible (ej.: si María puede conectarse a las 7:00 p. m., Melissa identifica una asesora de su cohorte cuyo turno cubra ese horario).
• Proceso de asignación: validar cohorte → validar capacidad → validar periodo/horario → asignar alumno ↔ asesora → incrementar contador → recalcular cupos → guardar preferencia → asignar la malla de temas vigente → notificar → auditar.
• El alumno queda pendiente de programación definitiva; la reserva concreta se crea después.
• Separación en base de datos de tres conceptos:

9. Calendario, disponibilidad y reservas de asesorías

Objetivo: gestionar la agenda de las asesoras y la programación de asesorías, con una única reserva compartida entre alumno y asesora (sin registros desconectados que puedan desincronizarse).

Funcionalidades

• Primera asesoría y programación del horario: con la alumna asignada y cuota aprobada, la asesora consulta la disponibilidad de la alumna y sus propios slots, se acuerdan días y horas, la asesora crea la pauta semanal/recurrente y el sistema genera las reservas individuales asignándoles su tema del temario vigente. Las reservas aparecen para ambas y cada cambio queda auditado.
• Reservas recurrentes: serie semanal con fecha inicial y final; en cada fecha se valida turno y disponibilidad, cuota de sesiones, habilitación por pago aprobado y slot libre. Cada sesión es un registro individual; se puede reprogramar una sesión sin alterar la serie; se registran excepciones y cambios; ambos calendarios se actualizan automáticamente.
• Prevención de doble booking: no se permiten dos reservas confirmadas en el mismo slot; cada reserva se crea con una operación transaccional/atómica.
• Proceso de reserva: validar alumno/asesora/etapa → validar habilitación por cuota aprobada → cuota de sesiones → fecha/hora → turno → slot libre → crear booking atómico → asignar tema de la malla → ocupar slot → actualizar agendas → notificar → auditar.
• Calendario de asesoras (diario, semanal y mensual) con: turno de trabajo, slots ocupados/libres, sesiones confirmadas/pendientes/reprogramadas/canceladas, bloqueos y vacaciones, disponibilidad para nuevas asignaciones, filtros por cohorte y etapa, y el tema previsto de cada clase.
• La alumna ve solo los horarios permitidos de su asesora; la asesora ve solo a sus alumnas.

10. Asesoría académica y temario pautado de 12 clases mensuales

Objetivo: organizar la etapa académica: 3 meses, 12 clases de 1 hora por mes (3 por semana), 36 clases en total. Cada clase está pautada por tema para que la asesora no improvise. Cantidad de clases, duración y clases por semana son configurables.

Funcionalidades

• Control por alumna de sesiones asignadas, utilizadas, restantes, realizadas, reprogramadas, no realizadas y asistencia. Cada alumna pertenece a una cohorte, tiene asesora asignada y debe estar habilitada por pago aprobado. Cada sesión tiene estado, duración y tema, y alimenta el historial y el control de horas.
• Malla de temas por etapa (académica, ventas y futuras), definida por Administración. Cada tema contiene: número de orden, nombre, objetivo, contenidos, material de apoyo, entregable/tarea esperada y duración prevista (por defecto 1 hora). La etapa académica contempla 36 temas (configurable).
• Malla versionada: si se modifica, las alumnas en curso conservan la versión con la que iniciaron, salvo que la Dueña decida migrarlas.
• Vista de solo lectura de la malla para la asesora educativa.
• Asignación automática del tema: al crear la pauta semanal se generan las 12 reservas del mes y cada una recibe el siguiente tema pendiente, en orden. Antes de la clase, la asesora ve tema, objetivo, contenidos y material.
• Avance del temario:
  • Clase realizada → tema marcado como trabajado y avanza el puntero.
  • Clase reprogramada o inasistencia → el tema no se consume y se re-secuencian las clases siguientes.
• Cambio de orden de temas propuesto por la asesora, con justificación y auditoría.
• Política ante inasistencia (configurable): reponer el tema al final del mes, desplazar toda la secuencia o perder el tema. Por defecto: desplazamiento de la secuencia sin pérdida del tema.
• Seguimiento por tema:
  • Ficha de la alumna con los 36 temas y su estado (trabajado, pendiente, en curso o con dificultad).
  • Indicador del tema actual y del retraso respecto de la malla.
  • Comparación entre clases previstas y realizadas en el mes.
  • Reporte transversal de los temas que generan más dificultad.
  • Filtros por asesora, cohorte, etapa, mes y tema.

📌 Dependencia de negocio: la carga de la malla de la etapa académica (36 temas con objetivo, contenidos y material) la proporciona el cliente. Sin ese insumo, el sistema se entrega con la estructura configurable vacía y la malla se carga después desde administración.

11. Sesiones, asistencia y bitácora

Objetivo: que la asesora registre el resultado de cada clase y el seguimiento de la alumna.

Estados de la sesión y sus efectos

Campos de registro de cada clase

• Estado de la clase
• Tema trabajado (el previsto por la malla; editable con justificación)
• Observaciones (texto libre)
• Avances (qué logró la alumna)
• Dificultades (qué no logró o le costó; opción de marcar el tema como "con dificultad")
• Tarea (encargo para la siguiente clase y su cumplimiento)
• Siguiente tema (propuesto y precargado por el sistema)
• Duración efectiva
• Asistencia, métricas y progreso
• Fecha/hora
• Trazabilidad del usuario que registró o modificó

Flujos

Al marcar una sesión como realizada: registrar asistencia/duración → actualizar horas → actualizar cuota de sesiones → marcar tema como trabajado y avanzar puntero → bitácora (avances, dificultades, tarea, siguiente tema) → actividad → reportes → liquidación.

Al reprogramar o registrar inasistencia: registrar estado y motivo → no consumir el tema → re-secuenciar clases siguientes → actualizar horas reprogramadas/no realizadas → notificar a alumna y asesora → reflejar en consolidado y liquidación → auditar.

12. Control de horas de las asesoras y consolidado mensual

Objetivo: que la Dueña sepa cuántas alumnas tiene cada asesora, cuántas horas tiene programadas, cuántas realizó y cuáles fueron reprogramadas o no realizadas, con el consolidado necesario para pagar correctamente.

Funcionalidades

• Indicadores por asesora y por mes: alumnas asignadas, capacidad mensual, horas comprometidas, programadas, realizadas, reprogramadas, no realizadas, reconocidas para pago, tarifa por hora y total a pagar.
• Cálculo con la duración efectiva/reconocida de las sesiones (con la malla vigente cada clase dura 1 hora, configurable) y la tarifa vigente de cada asesora.
• Consolidado mensual por asesora listo para el pago.
• Separación clara de horas: comprometidas, programadas, realizadas, reprogramadas, no realizadas y reconocidas.

Ejemplo ilustrativo

13. Liquidación mensual de asesoras

Objetivo: seleccionar periodo, asesora y cohorte y generar un detalle auditable del pago mensual.

Detalle de la liquidación

• Asesora (nombre/ID), periodo y cohorte atendida
• Alumnas atendidas
• Clases programadas (cantidad y horas)
• Sesiones realizadas
• Sesiones reprogramadas (cantidad y horas; pendientes hasta realizarse)
• Sesiones no realizadas (inasistencias y cancelaciones, con su tratamiento según regla)
• Horas dictadas y horas reconocidas
• Tarifa vigente
• Monto = horas reconocidas × tarifa
• Estado: generada / pendiente / pagada / ajustada
• Datos del pago (fecha, responsable y observación)
• Auditoría (usuario y fecha de generación/modificación)

Reglas

• Solo las sesiones con estado reconocible alimentan el pago; una reserva futura no se paga como realizada y una reprogramada queda pendiente hasta realizarse.
• Se registra el mes programado y el mes dictado para sesiones reprogramadas al mes siguiente, según la regla definida.
• Las liquidaciones históricas no se eliminan; se ajustan.
• Tarifa por hora configurable con fecha de vigencia.

14. Formación (15 módulos)

Objetivo: contenidos formativos del programa, con 15 módulos. Confirmado: Módulo 1: Creación de tienda. Los nombres y contenidos de los demás son editables desde administración.

Funcionalidades

• Gestión por módulo de: videos/clases, PDFs y materiales, descargables, actividades, evaluaciones, tareas y recursos adicionales.
• Estados de módulo: Bloqueado, En progreso, Completado, con desbloqueo según las reglas Pago → módulos.

15. Seguimiento real de actividad académica

Objetivo: que la Dueña sepa si los alumnos realmente consumen la formación, más allá del porcentaje de módulos completados.

Registro por niveles

• El reproductor envía eventos medibles; abrir la página de una clase no cuenta automáticamente como "vista".
• La precisión depende del proveedor de video/reproductor elegido.

16. Beneficios y recompensas

Objetivo: gestionar la sección "Mis beneficios" del alumno.

Funcionalidades

• Desbloqueo de recompensas por pago, avance de fase, módulo, hitos o pago total.
• Tipos de recompensa: portadas para tiendas, banners, plantillas, guías, checklists, e-books, masterclasses, clases bonus, recursos exclusivos y nuevos recursos futuros.
• Reglas configurables (ejemplo): reserva → bienvenida; cuota 1 → portadas; cuota 2 → plantillas; cuota 3 → guía; pago total → bonus final.

17. Fase de ventas (Camila → Jasmin)

Objetivo: gestionar la fase de ventas: 3 meses, 4 sesiones mensuales, 1 sesión por semana, con su propia malla de temas.

Funcionalidades

• Etapa de inicio a cargo de Camila (implementación y acompañamiento), activa desde el inicio de la fase.
• Etapa de revisión/escala a cargo de Jasmin Meléndez (campañas, métricas, optimización, estrategia y escalamiento), que se habilita tras la transferencia.
• Opción "TRASLADAR A ALUMNA", usada por la Dueña cuando corresponda. No hay elección aleatoria entre Camila y Jasmin; Camila aparece primero.
• La transferencia conserva las sesiones restantes del periodo (ej.: si ya se usaron 3 de 4, Jasmin dispone de la restante); el sistema no añade otras 4 automáticamente.

18. Cobranza y comisiones

Objetivo: seguimiento de la cobranza a cargo de la asesora comercial y cálculo de sus comisiones.

Cobranza

• Indicadores: alumnos asignados, total contratado, total cobrado, saldo pendiente y vencido.
• Filtros: todos, pagados, pendientes, vencidos, vence hoy, vence en los próximos 7 días, parciales, totalmente pagados, y por alumno, plan, fecha y estado.
• Historial de cobranza: alumno, cuota, monto, fecha, canal (WhatsApp, llamada, email u otro), resultado y notas.

Comisiones

• Porcentaje de referencia: 12% para la asesora comercial, configurable y con fecha de vigencia.
• Base de cálculo: pagos aprobados (ej.: pago aprobado de S/ 500 → comisión de S/ 60).
• Estados: generada / pendiente / pagada / ajustada.
• Liquidación con periodo, pagos, porcentaje, monto, fecha y responsable.
• Ante devolución o anulación, se crea un ajuste/reversión conservando el histórico.

19. Servicio Premium

Objetivo: servicio separado para clientes que ya venden y tienen operación, y requieren acompañamiento en estrategia, campañas, métricas, rentabilidad, conversión, optimización y escalamiento, a cargo de la coach Jasmin Meléndez.

Parámetros del servicio

Cuando se completa la capacidad se muestra "CUPOS COMPLETOS" y la opción "INGRESAR A LISTA DE ESPERA".

Panel Premium de Jasmin

• Inicio: clientes, sesiones y capacidad
• Clientes Premium: fichas y seguimiento
• Mi calendario: Premium + fase de ventas + bloqueos
• Mis sesiones: historial y pendientes
• Mi disponibilidad: slots y bloqueos
• Seguimiento: objetivos y métricas
• Notificaciones: agenda y cambios
• Mi perfil

Ficha Premium

• Inicio, vencimiento, estado
• Sesiones: Mes 1 x/8, Mes 2 x/8, Mes 3 x/8, total x/24
• Situación inicial, objetivo, ventas actuales, meta
• Campañas, métricas, problemas, acciones, tareas y resultados

Calendario general unificado de Jasmin

Incluye clientes Premium, alumnos en fase de ventas, bloqueos personales/operativos, futuros servicios, disponibilidad y conflictos de horario, con filtros por tipo de servicio.

20. Constancia digital y código QR

Objetivo: emitir la constancia digital cuando se cumplen las condiciones configuradas. Por defecto: 100% pagado + 15 módulos completados.

Funcionalidades

• Constancia con: ECIM BUSINESS SOLUTIONS EIRL, nombre completo, DNI/CE, programa, fecha de emisión, código único (ej.: ECIM-2026-000001), firma autorizada y código QR.
• Página de verificación que muestra: CONSTANCIA VÁLIDA, nombre, programa, código, fecha y estado, sin mostrar datos personales innecesarios.

21. Notificaciones automáticas

Objetivo: enviar avisos automáticos a cada tipo de usuario según los eventos ocurridos.

22. Paneles por rol

Objetivo: reunir las vistas principales de cada tipo de usuario.

Panel del alumno

• Inicio: resumen, progreso, próxima asesoría, estado de pago y membresía
• Mi formación: 15 módulos, clases, materiales y actividades
• Mi progreso: avance general, módulos y actividad
• Mis beneficios: recompensas desbloqueadas y pendientes
• Mis asesorías: próximas sesiones, historial, reprogramaciones y tema de cada clase
• Mis pagos: plan, cuotas, pagado, saldo, vencimientos y comprobantes
• Mi constancia: acceso cuando se cumplan los requisitos
• Mi perfil, notificaciones y cerrar sesión

Panel de la asesora educativa

• Inicio: alumnas, sesiones del día, pendientes y capacidad
• Mi calendario: agenda, reservas y tema previsto de cada clase
• Mis alumnas: asignadas, progreso, próxima sesión y estado de cuota (solo lectura)
• Temario de la alumna: los 36 temas, trabajados, tema actual y temas con dificultad
• Mis sesiones: historial, asistencia y bitácora
• Mi disponibilidad: turno, slots, bloqueos y excepciones
• Notificaciones: nuevas asignaciones, cambios y alumnas habilitadas por pago aprobado
• Mi perfil y Mis horas: programadas, realizadas, reprogramadas, no realizadas y reconocidas
• Indicadores: alumnos nuevos de la cohorte X/10, cupos restantes, sesiones de hoy, sesiones realizadas, horas del periodo, horas pendientes y alumnas con cuota pendiente o vencida

Panel de la asesora comercial

Disponibilidad y cupos de asesoras por cohorte y turno, asignación de alumnos, pagos aprobados, cuotas, vencimientos, cobranza y comisión.

Panel de la Dueña / Superadmin

• Indicadores principales: total de alumnos, alumnos activos, cobrado, pendiente, vencido, comisiones generadas, clientes Premium, cupos Premium, sesiones del día, constancias emitidas y pagos pendientes de validación.
• Actividad académica: activos hoy; sin login de 3 a 7 días; sin progreso por más de 7 días; sin login por más de 30 días; distribución de avance en rangos 0–20%, 21–40%, 41–60%, 61–80% y 81–100%.
• Operación de asesoras: cohortes activas, alumnas por asesora (X/10), cupos restantes, horas (comprometidas, programadas, realizadas, reprogramadas, no realizadas y reconocidas), consolidado mensual listo para pago y liquidaciones pendientes/pagadas.
• Avance académico por temario: temas trabajados por alumna y tema actual, alumnas atrasadas respecto de la malla y temas con mayor dificultad reportada.

23. Reportes

Objetivo: reportes gerenciales con exportación a CSV / XLSX / PDF y permisos según rol.

24. Configuración administrativa

Objetivo: modificar las reglas de negocio desde administración, sin reescribir el núcleo del software.

Parámetros configurables

• Programas, planes, precios y reservas; número y montos de cuotas; vencimientos
• Reglas Pago → módulos y Pago → habilitación de asesorías
• Módulos y contenidos; recompensas y reglas
• Tipos de asesoría y etapas; malla de temas por etapa (temas, orden, objetivos, materiales y duración); cantidad de clases mensuales y duración de cada clase
• Política ante inasistencia y reprogramación; política de bloqueo por cuota vencida y periodo de gracia
• Asesoras, capacidad por cohorte, turnos, días, duración de slots y capacidad por slot
• Duración de cohortes, horas por alumno y cuotas de sesiones
• Tarifas por hora y comisiones
• Premium, constancias y notificaciones
• Umbral de inactividad, roles y permisos

Fórmulas operativas parametrizadas

Se recalculan automáticamente cuando cambie la meta de alumnos, la capacidad, las horas semanales, la duración de la clase o la duración de la cohorte.

25. Seguridad, privacidad y auditoría

Objetivo: módulo transversal que protege la información y deja trazabilidad de las acciones críticas.

Seguridad y privacidad

• HTTPS obligatorio, hash seguro de contraseñas y gestión segura de sesiones y tokens.
• RBAC y permisos finos; la asesora educativa accede al estado de cuota en solo lectura y el permiso de aprobación no existe para ese rol.
• Archivos privados con autorización/URLs temporales, validación de tipo y tamaño, y protección contra acceso o descarga no autorizada.
• Backups y recuperación.
• Protección contra doble booking y separación de datos por rol.
• Evaluación de autenticación de doble factor (2FA).
• Revisión de la normativa peruana de protección de datos personales y firma electrónica antes de producción.

Registro de auditoría (datos mínimos por acción)

26. Condiciones generales de desarrollo

Todos los módulos deben observar lo siguiente:

• Una sola fuente de verdad para alumnos, pagos, cohortes, asignaciones y reservas.
• Transacciones atómicas y trazables para las operaciones críticas.
• Restricciones e índices que impidan la doble reserva.
• Históricos inmutables para contratos, pagos y auditoría.
• Separación entre la capacidad de nuevos alumnos y la disponibilidad de calendario.
• Separación entre la malla de temas (plantilla) y el avance de cada alumna (instancia).
• No fijar en el código: precios, cuotas, módulos, recompensas, capacidades, turnos, sesiones, temas, comisiones ni duración de cohortes.
• No permitir asignaciones por encima de la capacidad sin autorización.
• Servicios desacoplados por dominio y colas/eventos para notificaciones no críticas.
• Preparación para integraciones futuras sin acoplar el núcleo.
• Diseño responsive para móvil y PC, con interfaz visible en español.

27. Diagramas de funcionamiento

27.1 Visión general: del registro al certificado

Recorrido completo de un alumno dentro del sistema y quién interviene en cada paso.

flowchart TD
    A["1. Alumno se registra<br/>datos, plan, comprobante y DNI"] --> B["Estado: Pago pendiente de validación"]
    B --> C{"2. Dueña / Administración<br/>revisa el pago"}
    C -- Rechaza con motivo --> R["Pago rechazado<br/>no se habilita nada"]
    R --> A2["Alumno puede registrar un nuevo pago"]
    A2 --> B
    C -- Aprueba --> D["3. Alumna HABILITADA<br/>se desbloquean módulos, recompensas y membresía"]

    D --> E["4. Contrato generado<br/>alumno revisa, acepta y firma"]
    D --> F["5. Asesora comercial asigna<br/>una asesora educativa con cupo<br/>y horario compatible"]
    D --> G["Se calcula la comisión comercial"]

    F --> H["6. Asesora crea la pauta semanal<br/>3 clases por semana"]
    H --> I["Sistema genera reservas<br/>y asigna un tema a cada clase"]
    I --> J["7. Clase dictada<br/>asesora registra asistencia y bitácora"]

    J --> K{"Resultado de la clase"}
    K -- Realizada --> L["Tema trabajado<br/>avanza el temario<br/>suman horas reconocidas"]
    K -- Reprogramada o no asistió --> M["Tema NO se consume<br/>se re-secuencian las clases"]
    M --> I
    L --> N{"¿Faltan clases?"}
    N -- Sí --> J
    N -- No --> O["8. Fin de la etapa académica<br/>3 meses, 36 clases"]

    L --> P["9. Fin de mes:<br/>consolidado y liquidación<br/>de la asesora"]

    D --> Q["Alumno estudia los 15 módulos<br/>de formación"]
    Q --> S["Se mide actividad real<br/>videos, avance y login"]

    O --> T["Fase de ventas<br/>Camila y luego Jasmin"]
    Q --> U{"¿100% pagado y<br/>15 módulos completos?"}
    T --> U
    U -- Sí --> V["10. Constancia digital con QR<br/>verificable en línea"]

27.2 Qué pasa cuando se aprueba un pago

Es el evento más importante del sistema: una sola acción dispara toda esta cadena automática, en este orden.

flowchart LR
    A(["Pago aprobado<br/>por Dueña o Administración"]) --> B["Registrar pago"]
    B --> C["Actualizar total pagado y saldo"]
    C --> D["Actualizar cuota y vencimiento"]
    D --> E["Desbloquear módulos<br/>y recompensas"]
    E --> F["Actualizar membresía"]
    F --> G["Alumna HABILITADA<br/>y se libera la programación"]
    G --> H["Calcular comisión comercial"]
    H --> I["Actualizar dashboards"]
    I --> J["Notificar a asesora,<br/>alumno y comercial"]
    J --> K(["Registrar auditoría"])

27.3 Semáforo de cuota y bloqueo de reservas

flowchart TD
    A["Alumna intenta reservar<br/>una asesoría"] --> B{"Estado de la cuota"}
    B -- "🟢 Pagada y aprobada" --> C["Reserva permitida"]
    B -- "🟡 Pendiente de validación" --> D["Bloqueada<br/>aviso: falta aprobación"]
    B -- "🔴 Pendiente o vencida" --> E["Bloqueada<br/>queda registro del intento"]
    D --> F{"¿La Dueña autoriza<br/>de forma expresa?"}
    E --> F
    F -- Sí --> G["Reserva permitida<br/>y queda auditada"]
    F -- No --> H["No se programa"]

27.4 Cómo se reparten las asesoras por cohorte

Cada cohorte dura 3 meses y necesita 3 asesoras (10 alumnos cada una). Así se llega a 9 asesoras en régimen estable.

gantt
    title Rotación de asesoras (ejemplo)
    dateFormat  YYYY-MM-DD
    axisFormat  %b
    section Cohorte Octubre
    Asesoras A, B, C   :a1, 2026-10-01, 90d
    section Cohorte Noviembre
    Asesoras D, E, F   :a2, 2026-11-01, 90d
    section Cohorte Diciembre
    Asesoras G, H, I   :a3, 2026-12-01, 90d
    section Cohorte Enero
    Asesoras A, B, C otra vez   :a4, 2027-01-01, 90d

27.5 Quién puede hacer qué (resumen de roles)

flowchart LR
    DU["Dueña / Superadmin<br/>acceso total"] --> PAG["Aprobar o rechazar pagos"]
    AD["Administración"] --> PAG
    AD --> GES["Gestionar alumnos, contratos y reportes"]
    CO["Asesora comercial"] --> ASG["Asignar alumnos a asesoras"]
    CO --> COB["Cobranza y comisión"]
    ED["Asesora educativa"] --> SES["Clases, asistencia y bitácora"]
    ED --> CUO["Ver estado de cuota - solo lectura"]
    AL["Alumno"] --> FOR["Formación, pagos y asesorías propias"]
    PR["Cliente Premium"] --> PRE["Sesiones y seguimiento Premium"]

    CO -. "NO puede aprobar pagos" .-> PAG
    ED -. "NO puede aprobar pagos" .-> PAG