HotelMap × Magellan
Catalog

Feature Catalog

Two views into the same platform. The Operator view focuses on outcomes — what teams and stakeholders get out of each service. Switch to the Engineer view for the technical detail behind every capability.

The Five Services

Magellan, fully catalogued

Contract Extractor
Service 1
Turn PDF contracts into structured data — upload a hotel contract (file or link) and get organised fields ready for downstream systems: event dates, room blocks, rates, taxes, deposits, deadlines, cancellation rules, and contact details.
No more manual data entry — the system reads the contract for you and fills a standard form, instead of a person retyping terms from a long PDF.
Side-by-side review — staff open a simple web form from a contract link, see the original PDF next to extracted fields, edit mistakes inline, and the work auto-saves.
Smart quality flagging — uncertain or incomplete extractions are routed to a review queue rather than silently passing bad data downstream.
One queue for everything questionable — a single review surface to dismiss duplicates, mark items reviewed, or supersede an old contract with the latest version.
Always notified — Slack alerts when extractions fail, downloads break, or the service errors, plus a daily summary of volume and success rate.
Conservative by default — missing values stay empty rather than guessed, so the output is safe to compare against the live booking system.
Magellan Agent
Service 2
Always-on inbox monitoring — watches the Magellan mailbox continuously and picks up new contract emails without anyone refreshing Outlook.
Reads contracts, finds the event — opens the PDF, matches it to the right HotelMap event, and asks the sender to confirm before moving on.
Verifies before going live — compares the signed contract to the hotel booking page and explains matches and mismatches in plain language.
Polite automatic follow-ups — schedules chases when clients or hotels stop replying (typically 48 business hours after verification, hotel chases, approval resends).
Human approval before sensitive sends — some scheduled emails wait in an approval queue so your team can approve or cancel before they go out.
Escalation to Hotel Ops — routes stuck, repeated, or frustrated threads to humans with a full handoff instead of the bot spinning.
No live upload without operator say-so — never pushes contracted rates to a map until the operator confirms the target event ID or Mcode.
Full conversation audit trail — every stage change, scheduled action, and message exchange is recorded for compliance and oversight.
Branded outbound emails — every reply looks like HotelMap (“Mags”) with clear action banners and one-click buttons to the contract, booking link, or live map.
Agent Interactions API
Service 3
Contract verification in seconds — checks a contract against what guests can actually book online and returns a clear pass/fail-style score with explanations.
Find the right event automatically — links contracts to the matching HotelMap event so teams don’t manually search calendars and maps.
Rates and inventory go live without re-keying — turns contract terms into bookable Duplo promotions and offline room blocks in one call.
Hotel contact lookup — pulls hotel name, contact person, and email straight from the contract PDF for faster outreach.
Smart contract screening — stops work early on expired, empty, or non-viable contracts (past dates, no rooms, no commission) so AI spend is not wasted.
Q&A on contract data — lets the Magellan agent fetch specific contract fields (dates, rooms, policies, contacts) without re-reading the entire PDF.
Secure automation backbone — token-protected, designed so the agent can run end-to-end with no manual data entry between steps.
Magellan Dashboard
Service 4
One pane of glass over the entire HotelMap supply chain — connections, room blocks, bookings, alerts.
Supervised contract intake — when email automation isn’t enough, operators can drag-drop PDFs into the ghost extractor and review the queue manually.
Approve or cancel agent actions in real time — manage allowlists, monitor live conversations, intervene per scheduled action.
Operational visibility — see how rate sourcing, booking match quality, and Duplo pushes are performing day-to-day.
Re-run any pipeline step from the UI — verify, match, push, search, book — no shell, no Postman.
Self-serve analytics — operators query the warehouse without direct database access; row caps keep it safe.
Role-appropriate access — operators only see what their role allows.
Son of Duplo
Service 5
Live competitor rate intelligence — automated browsers collect hotel rates from external booking platforms to keep pricing visibility current.
Always-on market watching — rate sourcing runs continuously, in parallel with contract email processing, not only when a PDF arrives.
Live rates flow into HotelMap — discovered rates are normalised and fed into the availability engine, so blocks reflect real-world pricing.
Bookings on partner sites at scale — the same fleet completes reservations on hotel and brand sites end-to-end, not just searches.
Human override when automation stalls — operators remote into any browser instance to handle captchas, broken flows, or script tuning without taking the fleet down.
Independent of the contract pipeline — runs alongside Magellan, not in series, so contract intake doesn’t block rate sourcing.
Platform infrastructure

The supporting platform

Behind the five headline services sits a layer of focused infrastructure repos. Each one owns a single responsibility — a reservation gateway, a forecasting service, an async API in front of the browser fleet — and is released and scaled independently.

Booking API
hotelmap-dev-magellan-booking-api
Reservation execution layer. Takes a normalised booking request from Magellan and creates or cancels the actual reservation against whichever PMS the hotel runs.
FastAPI · PostgreSQL · Valkey · Alembic
Room-Block Analytics
hotelmap-dev-magellan-room-block-analytics
Pickup intelligence. Snapshots every room block, forecasts the pickup percentage per event, flags anomalies, and ranks hotel performance over time.
FastAPI · scikit-learn · pandas · APScheduler
SOD Search API
hotelmap-dev-magellan-sodr-search-api
Cached, deduped front door for hotel-availability search. Operators and agents hit one URL; the system reuses recent results and only sends new work to the browser fleet when needed.
FastAPI · Valkey · Kafka · RDS
SOD Search Worker
hotelmap-dev-magellan-sodr-search
The hands-on-keyboard half of search. Browser-automation worker that visits booking sites, executes the search, and returns normalised room and rate data.
Playwright · OpenAI computer-use · Kameleo · SQS
SOD Booking API
hotelmap-dev-magellan-sodr-booking-api
Async front door for completing bookings on partner sites. Submit a booking job, get a job ID, and poll for the confirmation number once the fleet has finished.
FastAPI · Valkey · Kafka · UUID6
SOD Booking Worker
hotelmap-dev-magellan-sodr-booking
Completes hotel reservations on brand websites end-to-end. Runs the booking flow that a human would, captures the confirmation, and reports it back to Magellan.
Playwright · pyautogui · OpenAI vision · Kameleo