Data Model
Understanding ABRA’s data model is essential for developers working on the platform.
Core Entities
Guest
The central entity representing a hotel guest.Reservation
A guest’s booked stay.Guest Intelligence Entities
Entity Relationships Diagram
Detailed ERD coming soonKey Tables
| Table | Description |
|---|---|
| guests | Guest profiles |
| reservations | Bookings |
| reservation_guests | Many-to-many pivot |
| preferences | Guest preferences |
| celebrations | Special occasions |
| nuggets | Guest insights |
| hurdles | Issue tracking |
| wow_moments | Exceptional experiences |
| hotels | Property configuration |
| users | Staff accounts |
| departments | Organizational units |
Soft Deletes
Most entities use soft deletes (deleted_at) to preserve history.
External IDs
Guests and reservations maintain external IDs for PMS synchronization:oracle_id- Oracle Hospitality IDmaestro_id- Maestro PMS IDapi_provider_id- Generic external system reference
