Overview
The Appointments & Agenda module provides a comprehensive booking system for managing your beauty center’s schedule. It offers a visual calendar interface with day and week views, real-time booking management, staff assignment, and complete status tracking for all appointments.Key Features
Calendar Interface
View Modes- Day View: Focused timeline showing all appointments for a single day
- Week View: Extended view displaying appointments across 7 days
- Easy Navigation: Quick jump to today, or navigate forward/backward by day or week
- Date Display: Clear formatting showing weekday, date, and month in Spanish locale
- Time-based layout with start and end times prominently displayed
- Color-coded appointment cards based on status
- Hover effects for better visual feedback
- Responsive design adapting to all screen sizes
Appointment Management
Core Booking Information- Client assignment (required)
- Staff member assignment (optional)
- Service or Pack selection
- Date and time scheduling
- Duration in minutes
- Optional notes field
- Pending: Initial state when booking is created (yellow/warning styling)
- Confirmed: Appointment verified and confirmed (blue/info styling)
- Completed: Service successfully delivered (green/success styling)
- Cancelled: Appointment cancelled by client or center (red/error styling)
- No Show: Client failed to attend scheduled appointment (gray/muted styling)
Search & Filtering
- Real-time search across all bookings in current view
- Filter by client name or surname
- Filter by assigned staff member name
- Instant results as you type
- Search persists across view changes
Quick Actions
Each appointment card provides dropdown menu access to:- Confirm: Change status to confirmed
- Complete: Mark service as delivered
- Cancel: Set status to cancelled
- Edit: Modify booking details
- Delete: Permanently remove from schedule
User Workflows
Creating a New Appointment
- Navigate to Agenda from the main menu
- Select the desired date using:
- Calendar navigation buttons (previous/next)
- “Hoy” (Today) button to return to current date
- The selected date determines the default booking date
- Click Nueva Cita button in the top toolbar
- Fill in the booking form:
- Client: Search and select from your client database (required)
- Staff: Assign a staff member to the appointment (optional)
- Service/Pack: Choose what service is being booked
- Date: Defaults to selected calendar date (can be changed)
- Start Time: Select appointment start (HH:mm format)
- Duration: Enter service duration in minutes
- Notes: Add any special instructions or client requests
- Click Save to create the booking
- The new appointment appears on the calendar timeline immediately
Viewing Appointment Details
Each appointment card displays:- Time Column (left border):
- Large start time (e.g., “10:00”)
- Small end time (e.g., “11:30”)
- Day of week abbreviation
- Main Card Content:
- Status badge with current state
- Assigned staff member name (if any)
- Client full name in bold
- Service/Pack ID reference
- Duration indicator with clock icon
- Notes preview (if added)
Changing Appointment Status
Method 1: Quick Status Update- Locate the appointment on the calendar
- Click the three-dot menu icon on the appointment card
- In the dropdown, select the desired status action:
- Confirmar: Mark as confirmed
- Finalizar: Mark as completed
- Cancelar: Mark as cancelled
- Status updates immediately with color change
- Open the appointment dropdown menu
- Click Editar
- Modify any booking details including status
- Save changes to update the appointment
Editing an Appointment
- From the calendar view, click the three-dot menu on any appointment
- Select Editar from the dropdown
- The booking form opens with current values pre-filled
- Modify any fields:
- Change client or staff assignment
- Adjust date and time
- Update duration
- Edit notes
- Change status
- Click Save to apply changes
- Calendar updates to reflect the modifications
Rescheduling Appointments
- Open the appointment for editing
- Change the Booking Date to the new desired date
- Update Start Time if needed
- Adjust Duration if the service time has changed
- Add a note explaining the reschedule reason (optional)
- Save the appointment
- The booking moves to the new date on the calendar
Managing No-Shows
- When a client fails to attend their appointment:
- Open the appointment dropdown menu
- Select status update to No Show (from the dropdown or edit form)
- Optionally add a note about attempted contact or circumstances
- The appointment remains on the calendar for record-keeping with muted styling
Deleting Appointments
- Click the three-dot menu on the appointment
- Select Eliminar from the dropdown
- Confirm deletion in the warning dialog
- The appointment is permanently removed from the system
- Note: This action cannot be undone
Searching for Specific Bookings
- Use the search box in the top toolbar
- Type any part of:
- Client first name
- Client surname
- Staff member name
- The calendar filters in real-time to show only matching appointments
- Clear the search box to show all bookings again
Switching Between Views
Day View (recommended for detailed daily management)- Click the DÍA tab in the view selector
- See all appointments for the selected date in a linear timeline
- Navigate between days using arrow buttons
- Click the SEMANA tab in the view selector
- See appointments across 7 consecutive days
- Navigate between weeks using arrow buttons
- Useful for capacity planning and staff scheduling
Business Benefits
Optimized Scheduling
- Visual timeline prevents double-booking
- See staff availability at a glance
- Balance workload across team members
- Identify scheduling gaps for optimal utilization
Improved Client Experience
- Quickly confirm availability during phone calls
- Send appointment confirmations with accurate details
- Track client attendance patterns
- Professional booking management increases trust
Staff Coordination
- Assign specific staff to appointments
- Track staff schedules and workload
- Plan breaks and coverage
- See who is booked when
Operational Efficiency
- Reduce paper appointment books
- Instant search across all bookings
- Quick status updates from any device
- Eliminate scheduling conflicts
Business Insights
- Track appointment volume by day/week
- Monitor no-show rates
- Analyze booking patterns for staffing decisions
- Measure completion rates vs cancellations
Revenue Management
- See daily/weekly booking value
- Identify prime booking times
- Optimize pricing based on demand
- Track service popularity through bookings
Appointments are stored in the
Booking model and linked to both clients and staff through the User model relations. The item_type field indicates whether a service or pack is being booked, with item_id storing the reference.