Designing a Constraint-Driven Booking System for Pet Services
A multi-role admin platform handling real-time booking logic, dynamic pricing, slot management, and customer operations for a US-based pet lodging and daycare business.
The Challenge of System Complexity.
The pet lodging platform needed to coordinate multiple service types — lodging, daycare, and grooming — with distinct booking rules, time-based slot management, per-pet configurations, and real-time service combinations. In parallel, the system needed to ensure accurate billing, transactional consistency, and real-time visibility for staff across all devices and service scenarios. The challenge was not building individual features but designing the interconnected system that is operationally reliable and scalable.
Multiple Service Roles
Admin, staff, and customer roles each needed distinct permissions, views, and workflows within the same system.
Temporal Constraints
Each service type had unique time rules — lodging by night, daycare by day-slot, grooming by appointment window.
Physical Unit Management
Real-time room and slot availability had to reflect check-ins, check-outs, and maintenance states across 90+ units.
Financial Integrity
Pricing varied by service, pet size, duration, and add-ons. Calculations needed to be accurate and auditable.
Operational Visibility
Staff needed real-time updates on arrivals, departures, and occupancy without manual refresh or data lag.
Maintainable Practice
The codebase had to remain clean and extensible as new service types and business rules were added over time.
THE SOLUTIONS
To address these challenges, I designed a constraint-driven system where booking logic, pricing, and resource allocation are separate composable components, maintained through a unified API, and remain auditable across every workflow.
Unified Booking Engine
A single booking service handles the orchestration of form steps, deposits, service selection, pet assignment, unit allocation, and confirmation — keeping the booking flow consistent and auditable across service types.
Time-Based Availability & Conflict Detection
Availability checks run against existing bookings with overlap detection and buffer logic. This eliminates double-booking and ensures accurate slot counts across lodging, daycare, and grooming simultaneously.
Resource Allocation System
Rooms and grooming slots are modeled as allocatable resources with state machines — vacant, reserved, occupied, under maintenance. Real-time unit maps give staff visual clarity across all 90+ units at once.
Composable Pricing Engine
Pricing is computed from a rule graph — base rate × duration × pet size + add-ons − discounts. Each transaction is broken down line by line so clients and staff see exactly what they're paying for and why.
Transaction-Safe Financial System
All billing is processed in atomic operations with invoice and receipt generation. Payments are logged with references, enabling full audit trails, refund tracking, and revenue reporting.
Configurable Admin System
An admin layer allows business owners to configure service types, pricing rules, grooming schedules, and unit configurations without touching code — making the system adaptable as the business grows.
THE IMPLEMENTATION
To manage the full complexity of a live pet lodging operation, the platform was architected as seven interconnected systems — each handling a distinct operational domain.
Booking Engine
A 7-step guided booking wizard handles the full reservation flow — service selection, pet assignment, date picking, room assignment, add-ons, discounts, and confirmation. A separate quick booking form handles walk-ins with deferred room assignment. Real-time availability checks run before every reservation to prevent conflicts.
Unit Map & Occupancy
An interactive floor map visualizes all dog suites and cat condos with live occupancy status — vacant, reserved, occupied, under maintenance. Color-coded sections give staff instant spatial awareness across 90+ units. Quick-book actions are available directly from any vacant unit on the map without leaving the view.
Grooming Scheduler
A weekly slot calendar displays all booked and available grooming appointments per suite and condo row. Staff can filter by service type and pet, switch between month, week, day, and list views, and see real-time slot status across all sections. Bulk slot generation, employee assignment, and capacity tracking are managed from the same interface.
Financial System
A configurable pricing engine applies quantity-based, time-based, and discount-based rules automatically — calculating the best applicable price per booking. The invoice lifecycle covers pending, paid, and complete states with multi-payment support, loan tracking, and custom discount application. Revenue reports and transaction history are filterable by date and status.
Customer & Pet Management
A full customer directory supports search, CSV import/export, credit balance tracking, and co-owner management — with complete booking and invoice history per customer. Pet profiles store species, breed, age, allergy notes, vet associations, and documents. A self-service client portal lets customers view pets, book services, and track their own booking history.
Operations & Admin
Role-based access separates admin, manager, staff, and client views — each with scoped permissions and protected routes. A global search covers customers, pets, bookings, invoices, and vets with type and status filtering. A service configuration panel gives admins full control over pricing rules, tax rates, operating hours, and cancellation policies. A mobile API layer supports a companion app with OTP auth, booking submission, and pet management.
Reporting & Analytics
A reporting dashboard surfaces key business metrics in real time — total revenue, occupancy rate, rooms available, and total bookings. A filterable revenue chart tracks performance across all service types over any date range. A revenue breakdown by service (lodging, daycare, grooming) gives ownership full financial visibility without leaving the platform.
KEY DESIGN DECISIONS
Booking, pricing, availability, and notifications are decoupled services — each independently testable and replaceable.
Every booking step validates before proceeding. Invalid states are impossible by design, not caught after the fact.
Every feature was designed around how staff actually operate — not theoretical use cases. Real data, real edge cases.
Pricing breakdowns, unit states, and booking summaries expose system logic to users — building trust through transparency.
THE IMPACT
The platform is actively used in production by a US-based pet lodging business. It replaced a manual booking process, reduced scheduling errors, and gave staff real-time operational visibility across all service types. The system handles lodging, daycare, and grooming bookings simultaneously with consistent data integrity.