Saltar al contenido principal

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:

CampoDescripciónEfecto
ActivoAcademia activa o no.Una academia inactiva puede ocultarse en listados o bloquear login (según implementación).
Días antes de moraNú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.
PlanPlan asignado (opcional).Límite de estudiantes y precio mensual del plan (para facturación o control).
Precios por disciplinaValor 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

  1. Pre-registro: el interesado envía datos (academy_slug, user, student con disciplina, jornada, valor_mensualidad). Se crea usuario con rol estudiante y estudiante en estado en_revision.
  2. Revisión: admin o coordinador ve la solicitud en Estudiantes y puede Aprobar o Rechazar.
  3. Aprobación: el estado pasa a aprobado y 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.
  4. 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 pagado y 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

ConceptoValor por defecto
Días antes de mora2
Porcentaje de mora5 %
Estado inicial del estudianteen_revision
Primer pago al aprobarCreado 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.