Reglas de negocio
Resumen de las reglas que aplican en la plataforma, configurables por academia desde el admin o fijas en el sistema.
Configuración por academia (admin)
Cada academia tiene en el admin:
| Campo | Descripción | Efecto |
|---|---|---|
| Activo | Academia activa o no. | Una academia inactiva puede ocultarse en listados o bloquear login (según implementación). |
| Días antes de mora | Número de días de atraso a partir del cual se considera mora. | Por defecto 2. El reporte de mora y el cálculo de recargos usan este valor. |
| Porcentaje de mora | % de recargo aplicado cuando hay mora. | Por defecto 5. Se aplica sobre el valor base del pago. |
| Plan | Plan asignado (opcional). | Límite de estudiantes y precio mensual del plan (para facturación o control). |
| Precios por disciplina | Valor mensual por disciplina (ej. Taekwondo, Fútbol). | Valores por defecto al inscribir o al crear el primer pago; el pre-registro puede sugerirlos. |
Flujo de estudiantes
- Pre-registro: el interesado envía datos (academy_slug, user, student con disciplina, jornada, valor_mensualidad). Se crea usuario con rol
estudiantey estudiante en estadoen_revision. - Revisión: admin o coordinador ve la solicitud en Estudiantes y puede Aprobar o Rechazar.
- Aprobación: el estado pasa a
aprobadoy se crea el primer pago (vencimiento según lógica del backend, ej. un mes después de la inscripción). El estudiante puede ver sus pagos en Pagos. - Rechazo: el estado pasa a
rechazado. No se crean pagos.
Pagos y mora
- Cada pago tiene: mes correspondiente, fecha de vencimiento, valor base, valor mora, total pagado, estado (pendiente, pagado, fallido).
- Completar pago: admin, coordinador o el propio estudiante registra fecha de pago, total pagado y referencia. El estado pasa a
pagadoy el sistema puede crear el siguiente pago (próximo mes). - Mora: se considera cuando la fecha actual supera la fecha de vencimiento más los días antes de mora configurados. El reporte de mora lista pagos pendientes con atraso; el porcentaje de mora se usa para calcular el recargo (valor_mora).
Becas
- Un estudiante puede tener beca (porcentaje de descuento). Se asigna desde Becas (solo admin de academia).
- Códigos promocionales: por academia; tipo porcentaje o valor fijo; usos máximos y fecha de expiración. Se pueden usar en flujos de pago o inscripción según la implementación.
Contenido público
- Posts y patrocinadores son por academia. La web pública y la sección Público los obtienen con el parámetro
academy(slug). Solo se muestran los de la academia correspondiente.
Resumen de valores por defecto
| Concepto | Valor por defecto |
|---|---|
| Días antes de mora | 2 |
| Porcentaje de mora | 5 % |
| Estado inicial del estudiante | en_revision |
| Primer pago al aprobar | Creado con vencimiento un mes después (según backend). |
Las reglas exactas de cálculo (fechas de vencimiento, aplicación de mora al total, uso de precios por disciplina en el primer pago) están implementadas en el backend (academy-manager-api); esta documentación describe el comportamiento esperado desde el punto de vista de negocio.