Horse Types

​

Overview

​

Type Definition

export type TipoCaballo = 
  | "ESCUELA" 
  | "PRIVADO";

​

Values

​

ESCUELA

• Owned by the school
• Available to all students
• Can be used for students with tipoPension: "SIN_CABALLO"
• Can be reserved by students with tipoPension: "RESERVA_ESCUELA"
• Suitable for beginners and regular lessons
• Managed by school staff

• ✅ Can be assigned to any student
• ✅ Can be used for trial classes
• ✅ Can be reserved for exclusive student use
• ✅ Can be assigned per-class basis to students without reservation

• Calendar header color: 🔵 Blue
• Clearly marked in horse selection dropdowns
• Shown in reports as school assets

• Beginner student lessons
• Students without their own horse
• Trial classes for new people
• General riding instruction
• Students who want to try different horses

​

PRIVADO

• Owned by a specific student
• Can only be used by the owner
• Requires tipoPension: "CABALLO_PROPIO" for owner
• Boarded at school facilities
• Owner pays board quota
• Owner has exclusive rights

• ✅ Can only be assigned to classes with the owner
• ❌ Cannot be used by other students
• ❌ Cannot be used for trial classes (unless owner is the trial student)
• ⚠️ System validates ownership when assigning to classes

• Calendar header color: 🟡 Gold
• Marked with owner’s name in horse listings
• Distinguished in reports and exports

// Valid: Owner using their private horse
{
  alumnoId: 123,
  caballoId: 45,  // Horse with tipo: "PRIVADO" owned by student 123
}

// Invalid: Different student trying to use private horse
{
  alumnoId: 999,  // Different student
  caballoId: 45,  // Returns validation error
}

• Advanced students with their own horses
• Competition horses
• Students in specialized training
• Long-term committed students
• Students who own horses

​

Comparison Table

​

Business Rules

​

Horse Assignment Validation

1. School Horse (ESCUELA):
   • ✅ Any active student can use it
   • ✅ Can check for schedule conflicts only
   • ✅ No ownership validation needed
2. Private Horse (PRIVADO):
   • ⚠️ Must validate student is the owner
   • ⚠️ Check student has tipoPension: "CABALLO_PROPIO"
   • ⚠️ Check student’s caballoPropio matches horse ID
   • ❌ Reject if student is not the owner

​

Student-Horse Relationships

​

Horse Registration

1. School Horse:
   {
     "nombre": "Luna",
     "tipo": "ESCUELA",
     "disponible": true
   }
   
2. Private Horse:
   {
     "nombre": "Thunder",
     "tipo": "PRIVADO",
     "disponible": true
   }
   
   Then associate with student:
   {
     "alumnoId": 123,
     "tipoPension": "CABALLO_PROPIO",
     "caballoPropio": 45,  // Thunder's ID
     "propietario": true
   }
   

​

Calendar Visualization

​

Day View (Excel-Style)

• Each horse has its own column
• Horse columns are color-coded by type:
  • 🔵 Blue header: School horses (ESCUELA)
  • 🟡 Gold header: Private horses (PRIVADO)
• Column headers show:
  • Horse name
  • Horse type indicator
  • Owner name (for private horses)

​

Excel Export

• School horses: Blue header background
• Private horses: Gold header background
• Legend included: Explains the color coding
• Owner info: Listed for private horses

​

API Examples

​

Create School Horse

POST /caballos
{
  "nombre": "Luna",
  "tipo": "ESCUELA",
  "disponible": true
}

​

Create Private Horse

POST /caballos
{
  "nombre": "Thunder",
  "tipo": "PRIVADO",
  "disponible": true
}

​

Query School Horses Only

GET /caballos/buscar?tipo=ESCUELA

​

Query Private Horses Only

GET /caballos/buscar?tipo=PRIVADO

​

Validation Error Messages

​

Attempting to Use Private Horse with Wrong Student

{
  "error": "Validation Error",
  "mensaje": "Este caballo privado solo puede ser usado por su propietario",
  "status": 400
}

​

Attempting to Assign School Horse to CABALLO_PROPIO Student

{
  "error": "Validation Error",
  "mensaje": "Un alumno con caballo propio debe tener un caballo de tipo PRIVADO",
  "status": 400
}

​

Related

• Horse Model
• Student Model
• Board Types
• Validation Rules
• Scheduling Rules