Sistema
Arquitectura del Admin OS
Mapa de módulos, esquema sugerido, RBAC, workflows, MVP y roadmap.
Mapa de módulos
- DashboardKPIs globales, alertas IA, actividad.
- OrganizationsMulti-tenant: HQ, branches, franquicias, colegios.
- Users & RBACRoles dinámicos, permisos por módulo, audit log.
- ProgramsStages → niveles → ejercicios, reglas adaptativas.
- StudentsPerfil 360°, progreso, pagos, notas, IA.
- BookingsCalendario, recurrencia, Zoom/Meet, asistencia.
- ContractsGeneración, firma, OCR, validación de pago.
- FinancePlanes, facturas, cobranza, conciliación, Stripe.
- CRMPipeline, Meta Ads, WhatsApp, email, conversión.
- AI EngineRecetas: churn, refuerzo, generación, resúmenes.
- ReportsCatálogo de reportes operativos y académicos.
Esquema sugerido (Postgres)
| Tabla | Columnas clave |
|---|---|
| organizations | id, name, type, parent_id, plan_id, status |
| users | id, email, name, status, last_seen |
| user_roles | user_id, role, organization_id |
| roles | id, name, scope |
| permissions | role_id, module, action (read|write|admin) |
| programs | id, name, ages, status |
| stages | id, program_id, order, name |
| levels | id, stage_id, order, name, rules_json |
| exercises | id, level_id, type, payload_json, ai_generated |
| students | id, user_id, organization_id, program_id, profile_json |
| enrollments | id, student_id, contract_id, status, started_at |
| progress_events | id, student_id, exercise_id, score, duration, created_at |
| bookings | id, student_id, monitor_id, starts_at, status, link |
| attendance | booking_id, status, notes, ai_summary |
| contracts | id, student_id, organization_id, status, pdf_url, signed_at |
| documents | id, contract_id, type, ocr_json |
| plans | id, name, price, interval |
| subscriptions | id, organization_id, plan_id, status, renews_at |
| invoices | id, subscription_id, amount, due, status, method |
| payments | id, invoice_id, amount, provider, provider_ref |
| leads | id, name, source, stage, value, owner_id |
| commissions | id, user_id, period, base, rate, amount, status |
| ai_runs | id, recipe, input_ref, output_json, latency_ms, cost |
| audit_log | id, actor_id, action, target, diff_json, at |
Multi-tenant por organization_id. RLS por auth.uid() y por organization_id.
RBAC
- Super AdminTodo
- OperacionesOperaciones, Estudiantes, Reservas, Contratos
- Dir. AcadémicaProgramas, IA, Estudiantes (lectura)
- MonitorReservas propias, notas, asistencia
- CobranzaFacturas, recordatorios, conciliación
- FinanzasFinanzas completo, exportes contables
- VentasCRM, leads, conversión, comisiones propias
- RRHHUsuarios, comisiones, nómina
- Org ManagerSu organización y sus estudiantes
- Padre / EstudianteSu propio perfil y progreso
Workflows clave
- InscripciónLead → Cita → Inscripción → Contrato → Pago → Activo
- ContratoPendiente → En revisión → Aprobado / Devuelto / Cancelado
- CobranzaEmisión → Recordatorio T-3 → Vencimiento → Escalamiento → Pago / Castigo
- SesiónReserva → Recordatorio → Live → Notas → Evaluación → AI summary
- IA refuerzoEvento bajo desempeño → Detección → Sugerencia → Asignación → Validación monitor
API & arquitectura
- • API-first: server functions (TanStack) + REST en
/api/public/*para webhooks. - • Multi-tenant: aislamiento por
organization_id+ RLS. - • Realtime: Postgres changes para dashboards y notificaciones.
- • Auth: email/password + Google (broker Lovable), MFA opcional.
- • Pagos: Stripe (managed) + conciliación bancaria.
- • IA: AI Gateway (OpenAI / Gemini) con recetas tipadas.
- • Integraciones: Zoom, Google Meet, WhatsApp Cloud, Meta Ads.
MVP & Roadmap
MVP (8 semanas)
Auth + RBAC, Organizaciones, Estudiantes, Programas (read), Reservas, Contratos básicos, Facturas Stripe, Dashboard.
Fase 2
CRM completo, Cobranza inteligente, OCR de contratos, Comisiones.
Fase 3
AI Engine (recetas), Reportes avanzados, Multi-idioma, White-label.
Fase 4
Marketplace, franquicias, integraciones LMS externas, mobile app monitor.