​

Key Features Overview

​

Student Management (Alumnos)

​

Complete Registration System

export interface Alumno {
  id: number;
  dni: string;
  nombre: string;
  apellido: string;
  fechaNacimiento: string;
  codigoArea: string;
  telefono: string;
  email: string;
  fechaInscripcion: string;
  cantidadClases: number;
  propietario: boolean;
  activo: boolean;
  caballoPropio?: number | Caballo;
  tipoPension: TipoPension;
  cuotaPension?: CuotaPension | null;
}

​

Real-Time DNI Validation

• Validates DNI as you type (9+ digits)
• Shows immediate error if DNI exists
• Prevents form submission for duplicates
• Works for both students and instructors

​

Flexible Lesson Plans

• 4 classes/month: Casual riders
• 8 classes/month: Regular students (twice weekly)
• 12 classes/month: Committed riders
• 16 classes/month: Intensive training

​

Three Boarding Options

export type TipoPension = "SIN_CABALLO" | "RESERVA_ESCUELA" | "CABALLO_PROPIO";
export type CuotaPension = "ENTERA" | "MEDIA" | "TERCIO";

• School assigns available horse per class
• Maximum flexibility
• No boarding costs
• Ideal for beginners

• Student reserves specific school horse
• Consistent horse-rider pairing
• Boarding quota configuration
• Priority access to reserved horse

• Student brings own horse
• Full boarding services
• Quota-based pricing
• Private horse management

​

Horse Management (Caballos)

​

Horse Entity Structure

export interface Caballo {
  id: number;
  nombre: string;
  tipo: TipoCaballo; // "ESCUELA" | "PRIVADO"
  disponible: boolean;
  propietarios?: Alumno[];
}

​

Horse Features

• Availability Status: Track which horses can be scheduled
• Owner Associations: Link horses to student owners
• Type Differentiation: Visual distinction in calendar and reports
• Usage Statistics: Monitor how often each horse is used
• Conflict Prevention: Cannot schedule same horse for overlapping classes

​

Instructor Management (Instructores)

​

Instructor Profile

export interface Instructor {
  id: number;
  dni: string;
  nombre: string;
  apellido: string;
  fechaNacimiento: string;
  codigoArea: string;
  telefono: string;
  email: string;
  activo: boolean;
  color: string;
}

​

Color-Coded Scheduling

• 7 predefined color options
• Visual identification in calendar
• Quick schedule overview
• Distinguishes classes at a glance

​

Instructor Analytics

• Workload Tracking: Classes per instructor
• Specialty Distribution: Which specialties they teach
• Efficiency Metrics: Completion vs cancellation rates
• Performance Reports: Detailed instructor statistics

​

Class Management (Clases)

​

Class Entity

export interface Clase {
  id: number;
  especialidad: EspecialidadClase;
  dia: string;
  hora: string;
  duracion: number;
  estado: EstadoClase;
  observaciones?: string;
  alumnoId: number | null;
  personaPruebaId?: number | null;
  instructorId: number;
  caballoId: number;
  diaHoraCompleto?: string;
  esPrueba?: boolean;
}

​

Four Specialties

export type EspecialidadClase =
  | "ADIESTRAMIENTO"  // Dressage
  | "EQUINOTERAPIA"   // Equine Therapy
  | "EQUITACION"      // Equitation
  | "MONTA";          // Riding

​

Six Class States

export type EstadoClase =
  | "PROGRAMADA"   // 🟠 Scheduled
  | "INICIADA"     // 🔵 Started
  | "COMPLETADA"   // 🟢 Completed
  | "CANCELADA"    // 🔴 Cancelled
  | "ACA"          // 🟣 Absence with Advance Notice
  | "ASA";         // 🌸 Absence without Advance Notice

1. PROGRAMADA: Initial state when class is created
2. INICIADA: Class has begun
3. COMPLETADA: Successfully finished
4. CANCELADA: Cancelled by school or student
5. ACA: Student notified in advance they won’t attend
6. ASA: Student didn’t show up without notice

​

Class Duration Options

• 30 minutes: Standard short lesson
  • Occupies one 30-minute time slot
  • Default duration
• 60 minutes: Extended lesson
  • Occupies two consecutive 30-minute slots
  • Visual continuity indicator in calendar
  • Both cells are clickable

​

Operating Hours & Validation

• Schedule: 09:00 to 18:30
• Time Slots: 30-minute intervals
• Critical Validation: No class can end after 18:30

• ❌ 60-min class at 18:00 → ends 19:00 (rejected)
• ✅ 60-min class at 17:30 → ends 18:30 (allowed)
• ✅ 30-min class at 18:00 → ends 18:30 (allowed)

“La clase no puede terminar después de las 18:30. Con duración de 60 minutos a las 18:00 terminaría a las 19:00.”

​

Trial Classes System

​

Two Types of Trial Classes

export interface PersonaPrueba {
  id: number;
  nombre: string;
  apellido: string;
  fechaRegistro: string;
}

• For prospective students not yet registered
• Just requires first and last name
• No full student account needed
• Creates “trial person” record
• Identified with 🎓 emoji in calendar

• For registered students trying new specialty
• Student must be INACTIVE
• Student must have no classes in that specialty
• Cannot repeat trial for same specialty

​

Trial Class Rules

1. Student cannot have trial if already has classes in that specialty
2. Cannot repeat trial class for same specialty
3. Trial classes DON’T count toward monthly quota

• 🎓 Emoji in calendar cells
• Orange border highlighting
• “Prueba” badge in details
• Informational alerts when editing

​

Advanced Calendar System

​

Three Powerful Views

​

Color Coding System

• 🟠 Orange: PROGRAMADA (Scheduled)
• 🔵 Blue: INICIADA (Started)
• 🟢 Green: COMPLETADA (Completed)
• 🔴 Red: CANCELADA (Cancelled)
• 🟣 Purple: ACA (Absence with Notice)
• 🌸 Pink: ASA (Absence without Notice)

​

Calendar Features

​

Calendar Tools & Operations

​

1. Copy Classes (Bulk Scheduling)

copiarClases: async (
  payload?: unknown,
): Promise<unknown & { __successMessage?: string }> => {
  const response = await apiFetch(`/calendario/copiar-clases`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: payload ? JSON.stringify(payload) : undefined,
  });
  return handleResponse<unknown>(response);
}

• Select source day (any day in source week)
• Select destination day (any day in destination week)
• Specify number of weeks to copy
• System copies all classes from entire week

​

2. Delete Classes in Range

• Select start and end dates
• Delete all classes within date range
• Confirmation required before deletion
• Bulk cleanup capability

​

3. Cancel Entire Day

• Rain
• Holiday
• Maintenance
• Special Event
• Emergency
• Other (with custom notes)

• Only cancels PROGRAMADA classes
• Respects already completed classes
• Preserves already cancelled classes
• Batch state update

​

4. Export to Excel

"exceljs": "^4.4.0",
"file-saver": "^2.0.5"

• Title with full date
• Color-coded headers:
  • 🔵 Blue for school horses (ESCUELA)
  • 🟡 Gold for private horses (PRIVADO)
• Cell backgrounds with instructor colors
• Orange borders for trial classes
• Cell comments with complete class details
• Legend for instructors and horse types
• Optimized for A4 printing
• Auto-column width adjustment

​

Reporting & Analytics

​

Available Reports

{
  title: "Reportes",
  description: "Estadísticas y análisis de la escuela",
  icon: BarChart,
  href: "/reportes",
}

​

Period Filtering

• Start date selection
• End date selection
• Default: Current month
• Custom date ranges

​

Excel Export Format

• Titles and subtitles
• Color-coded headers
• Alternating row colors for readability
• Optimized column widths
• Calculated totals and percentages
• Filename: Reporte_[Type]_[Date].xlsx

​

Financial Management (Finanzas)

{
  title: "Finanzas",
  description: "Gestión de ingresos y egresos de la escuela",
  icon: CircleDollarSign,
  href: "/finanzas",
}

• Income tracking
• Expense monitoring
• Financial reports
• Period-based analysis

​

Search & Filtering

​

Intelligent Global Search

• Alumnos (Students)
• Instructores (Instructors)
• Caballos (Horses)
• Clases (Classes)

• Real-time search as you type
• Multi-field simultaneous filtering
• Instant results
• Maintains traditional filters

export interface AlumnoSearchFilters {
  dni?: string;
  nombre?: string;
  apellido?: string;
  activo?: boolean;
  propietario?: boolean;
  fechaInscripcion?: string;
  fechaNacimiento?: string;
}

​

View Options

​

Table vs Cards Views

• Traditional row/column format
• Compact information display
• Sortable columns
• Quick scanning

• Visual card-based layout
• Highlighted key information
• Better for touch interfaces
• More engaging presentation

​

Pagination System

• Previous/Next navigation (← →)
• Page size selector: 10, 20, 50, 100 items
• Current page / total pages indicator
• Total records counter
• Maintains search and filter state

​

Quick Actions

​

In List Views

• Click row: View complete details
• Context menu (⋮):
  • Edit record
  • Delete record
  • Contact (students & instructors)
    • WhatsApp with pre-loaded message
    • Email

​

In Calendar

• Click empty cell: Create class with pre-filled data
• Click class: View details in popover
• Quick state change: Update status from popover
• Navigate to profiles: Direct links to participants

​

Detailed Profile Pages

​

Student Profile

• Complete personal information
• Assigned horse details
• Class statistics and charts
• Complete class history
• Attendance percentage
• Visual performance graphs

​

Instructor Profile

• Personal information
• Specialty distribution charts
• Performance statistics
• Efficiency metrics
• Complete class history

​

Horse Profile

• Horse information
• Associated owners
• Type and availability
• Usage statistics
• Class history

​

Class Details

• Full class information
• All participants (Student, Instructor, Horse)
• Quick state change controls
• Trial class indicator
• Quick access to all participant profiles

​

Notifications & Validations

​

Toast Notification System

"sonner": "^1.7.4"

• 🟢 Success: Confirmations of successful actions
• 🔴 Error: Validation errors and failures
• 🟡 Warning: Important notices
• 🔵 Info: Informational messages

​

Contextual Messages

• Tooltips: Explanatory hints on complex fields
• Real-time Validation: Instant feedback as you type
• Confirmations: Required before destructive actions
• Field Help: Inline guidance for complex inputs

​

Data Validation Rules

​

Critical Validations

​

Default Values

• Class Duration: 30 minutes
• New Class State: PROGRAMADA
• New Student State: Active
• New Instructor State: Active
• New Horse Availability: Available
• Phone Prefix: +549 (automatic for Argentina)

​

Session Management

• Auto-logout after 15 minutes of inactivity
• Basic Auth with secure credential storage
• Session-based authentication
• Protected routes requiring login
• Automatic credential refresh
• Email whitelist for registration
• Strong password validation