Skip to main content
Welcome to the HRS Equestrian School Management System! This guide will help you get up and running quickly.

Prerequisites

Before you begin, ensure you have the following installed:
  • Node.js (v16 or higher)
  • npm, yarn, or pnpm package manager
  • A modern web browser (Chrome, Firefox, Safari, or Edge)

Installation

1

Clone or Download the Repository

Get the source code for the HRS system:
git clone https://github.com/luckidetrenque/Frontend-Proyecto-HRS.git
cd Frontend-Proyecto-HRS
2

Install Dependencies

Install all required packages using your preferred package manager:
npm install
3

Configure Environment

Create a .env file in the project root (or copy from .env.example):
cp .env.example .env
Edit the .env file to set your API base URL:
VITE_API_BASE_URL=http://localhost:3000
4

Start Development Server

Launch the development server:
npm run dev
The application will be available at http://localhost:5173

First Steps

Once your development server is running, follow these steps to set up your school:
1

Register an Account

Navigate to the registration page and create your admin account.
Your email must be in the whitelist to register. Contact your system administrator if you encounter registration issues.
2

Add Your First Instructor

Go to InstructorsNew InstructorFill in the required information:
  • DNI (National ID number)
  • Name and Surname
  • Date of Birth
  • Phone (without 0 or 15 prefix)
  • Email
  • Assign a color for calendar visualization
3

Register Horses

Go to HorsesNew HorseAdd your school’s horses:
  • Name
  • Type (ESCUELA for school-owned, PRIVADO for private)
  • Availability status
4

Enroll Your First Student

Go to StudentsNew StudentComplete the registration form:
  • Personal information (DNI, name, date of birth, phone, email)
  • Select a class plan (4, 8, 12, or 16 classes per month)
  • Configure horse assignment (no horse, reserved school horse, or private horse)
5

Schedule Your First Class

Go to Calendar → Switch to Day ViewClick on an empty time slot to create a class:
  • Student, instructor, and horse are pre-selected based on availability
  • Choose the specialty (Equitation, Training, Equine Therapy, or Riding)
  • Set duration (30 or 60 minutes)
  • Mark as trial class if applicable

Key Features to Explore

Calendar Views

Explore Month, Week, and Day views with color-coded schedules

Class Scheduling

Learn about class types, states, and validation rules

Reports & Analytics

Generate comprehensive reports on students, classes, and performance

Trial Classes

Set up trial classes for prospective students

Common Tasks

Schedule Multiple Classes

Use the Copy Classes feature to duplicate an entire week’s schedule:
  1. Go to Calendar → Day View
  2. Click Copy Classes in the toolbar
  3. Select source and destination weeks
  4. Choose how many weeks to copy
Learn more about copying classes →

Export Daily Schedule

Export a professionally formatted Excel file:
  1. Navigate to Calendar → Day View
  2. Select the desired day
  3. Click Export to Excel
  4. Open the downloaded file for printing or analysis
Learn more about Excel export →

Cancel a Full Day

Quickly cancel all classes on a specific day:
  1. Go to Calendar → Day View
  2. Click Cancel Day in the toolbar
  3. Select a cancellation reason (weather, holiday, maintenance, etc.)
  4. Confirm the action
Learn more about bulk operations →

Next Steps

Now that you have the basics set up, explore these guides to make the most of the system:

System Overview

Understand the architecture and data flow

User Roles

Learn about authentication and permissions

Data Structure

Explore entities and relationships

Configuration

Customize the system for your school

Need Help?

Check that:
  • Your email is in the system whitelist
  • You’ve registered an account
  • Your session hasn’t expired (15-minute idle timeout)
  • You’re using the correct credentials
Learn more about authentication →
Verify that:
  • The class status is PROGRAMADA (scheduled)
  • You haven’t applied filters that hide the class
  • The date range includes your class
  • The calendar view is set to the correct week/month
Common validation issues:
  • Class would end after 18:30 (time limit)
  • Instructor or horse already has a class at that time (conflict)
  • Student has reached their monthly class limit
  • Trial class validation failed
Learn more about validation rules →

Support

For additional help and documentation:
  • Browse the User Guides for detailed feature explanations
  • Check the Reference section for data models and business rules
  • Review Troubleshooting for common issues and solutions

Build docs developers (and LLMs) love