# HurghadaTransferCalc.online — Extended LLM Architecture, Schema & Entity Specification

> Comprehensive technical architecture, data schemas, category taxonomy, and complete 36-entity Red Sea transit catalog for `hurghadatransfercalc.online`, maintained by the **Red Sea Transit & Aviation Research Desk**.

---

## 1. Site Architecture & Technical Stack

- **Framework:** Astro Static Site Generation (`output: 'static'`, `trailingSlash: 'always'`, `compressHTML: true`) with Preact interactive islands (`HurghadaTransferWorkbench.tsx`).
- **Calculation Engine:** Pure deterministic TypeScript engine (`src/engines/hurghadaTransferEngine.ts`) verified by 18 automated Vitest test assertions across 5 mathematical test fixtures (`TC-01` through `TC-05`).
- **Design System:** 2026 Studio Aviation & Hallmark v2.0.0 physical materiality (`calm_ledger_light`) with 4-layer OKLCH Warm Sinai Limestone surfaces, self-hosted WOFF2 variable fonts (`Plus Jakarta Sans`, `Inter`, `IBM Plex Mono`), and Solari Split-Flap Obsidian telemetry readouts.
- **Static Reference FX Rates (Editable in UI):** `1 EUR = 52.0 EGP`, `1 EUR = 1.08 USD`, `1 EUR = 0.85 GBP`.

---

## 2. Category Taxonomy & Silo Map

| Route Slug | Silo Role | Primary Search Intent | Indexed Entities |
| :--- | :--- | :--- | :--- |
| `/` | Primary Hub (`zone_transfer_split`) | Calculate door-to-door HRG Airport private transfer vs. shuttle and UberX fares across 13 resort zones with automatic passenger/kiteboard vehicle tier step-up. | 13 Transfer Zones, 3 Vehicle Tiers |
| `/hurghada-airport-departures/` | Scenario Calculator (`terminal_decoder`) | Decode HRG Terminal 1 (International, approx. 92,000 m²) vs. Terminal 2 (Charter/Domestic, approx. 3.2 km perimeter road) across 17 airlines and calculate VIP Fast-Track queue savings. | 17 Airlines (`EZY`, `TOM`, `CFG`, `W6`, `MS`, `SU`, etc.) |
| `/go-bus-hurghada/` | Scenario Calculator (`intercity_bus_breakeven`) | Compare Go Bus, Blue Bus, and White Bus coach classes against private door-to-door vehicles on Hurghada–Cairo (460 km) and Hurghada–Luxor (300 km) corridors. | 6 Intercity Coach Schedules |
| `/taxi-hurghada/` | Reverse Calculator (`taxi_uber_scam_shield`) | Compare UberX (including the 50 EGP HRG airport toll gate surcharge), InDrive, and street taxi bargaining bands with a printable Arabic/English fair-fare driver card. | 13 Transfer Zones + Airport Toll Rules |
| `/about/` | Trust & Methodology | Document data provenance, static planning FX methodology, and Regulation (EU) 2024/1689 Article 50 AI transparency disclosures. | Governance & Methodology |
| `/sitemap/` | Directory & Crawl Hub | Complete HTML sitemap linking all 8 indexable HTML routes, section anchors, 36 catalog entities, and machine syndication feeds. | 8 Pages + 36 Entities |
| `/privacy-policy/` | Legal & Compliance | GDPR Consent Mode v2 and client-side `localStorage` state persistence disclosure. | Privacy Governance |
| `/terms-of-service/` | Legal & Compliance | Nominative fair use and statutory safe harbor disclaimer. | Legal Governance |

---

## 3. Content & Data Schemas

### A. `TransferZone` Schema (`TRANSFER_ZONES` — 13 Entities)
- `id`: String identifier (`mamsha`, `sheraton`, `dahar`, `senzo`, `ahyaa`, `sahl_hasheesh`, `makadi_bay`, `el_gouna`, `soma_bay`, `safaga`, `marsa_alam`, `luxor`, `cairo`)
- `zone`: Human-readable English & Arabic corridor name
- `distanceKm`: Highway distance from HRG Airport in kilometers (`7` to `460` km)
- `driveMinutes`: Typical highway transit duration in minutes (`12` to `300` mins)
- `sedanEur`: Fixed pre-booked private sedan benchmark (`1–3` pax, up to 3 suitcases) in EUR
- `minivanEur`: Fixed pre-booked Toyota HiAce minivan benchmark (`4–8` pax, or `2–4` kiteboard bags) in EUR
- `coasterEur`: Fixed pre-booked Toyota Coaster minibus benchmark (`9–16` pax) in EUR
- `shuttlePaxEur`: Shared package tour shuttle per-passenger benchmark in EUR
- `uberEgp`: UberX planning benchmark in EGP (including the 50 EGP HRG airport perimeter toll)
- `streetTaxiEgpMin` / `streetTaxiEgpMax`: Typical curbside street taxi bargaining range in EGP

### B. `HrgAirline` Schema (`HRG_AIRLINES` — 17 Entities)
- `id`: Carrier slug
- `airline`: Full carrier name
- `iata`: 2-letter or 3-letter carrier code (`EZY`, `TOM`, `CFG`, `W6`, `EW`, `WK`, `XR`, `PC`, `TK`, `LS`, `QS`, `MS`, `ENT`, `SU`, `NP`, `SM`)
- `terminal`: Assigned HRG terminal (`Terminal 1 (International)` or `Terminal 2 (Charter & Domestic)`)
- `gates`: Assigned departure wing and gate range
- `recommendedArrivalHrs`: Recommended pre-flight arrival buffer in hours (`2.0` to `3.5` hrs)
- `standardQueueMins` / `fastTrackQueueMins`: Typical peak security/passport queue vs. VIP Fast-Track (`€28/pax`) queue duration

### C. `IntercityBusSchedule` Schema (`INTERCITY_BUS_SCHEDULES` — 6 Entities)
- `id`: Schedule tier slug
- `operator`: Coach operator (`Go Bus`, `Blue Bus`, `White Bus`)
- `tier`: Cabin class (`Deluxe Plus`, `Elite Plus DD`, `Aero First Class`, `Business Class`, `VIP Coach`)
- `route`: Corridor (`Hurghada ↔ Cairo (460 km)` or `Hurghada ↔ Luxor (300 km)`)
- `fareEgp`: One-way ticket benchmark in EGP (`350` to `950` EGP)
- `durationMins` / `durationLabel`: Scheduled highway duration
- `stationHurghada` / `stationDest`: Departure and arrival terminal locations

---

## 4. Complete Catalog Entity Inventory (36 Entities)

### 4.1. Red Sea & Intercity Transfer Zones (13)
1. **Village Road / Al Mamsha** (`7 km`, `~12m`): Sedan `€10`, Minivan `€14`, Coaster `€24`, Shuttle `€5/pax`, UberX `170 EGP`
2. **Sheraton Road / Hurghada Marina** (`8.5 km`, `~15m`): Sedan `€12`, Minivan `€16`, Coaster `€26`, Shuttle `€5/pax`, UberX `195 EGP`
3. **El Dahar (Downtown / Old Town)** (`12 km`, `~18m`): Sedan `€13`, Minivan `€18`, Coaster `€28`, Shuttle `€6/pax`, UberX `220 EGP`
4. **Senzo Mall / South Magawish** (`14 km`, `~18m`): Sedan `€15`, Minivan `€20`, Coaster `€32`, Shuttle `€6/pax`, UberX `260 EGP`
5. **Al Ahyaa Coast** (`18 km`, `~22m`): Sedan `€16`, Minivan `€22`, Coaster `€34`, Shuttle `€7/pax`, UberX `310 EGP`
6. **Sahl Hasheesh (Gated Resort Bay)** (`24 km`, `~25m`): Sedan `€20`, Minivan `€26`, Coaster `€40`, Shuttle `€8/pax`, UberX `380 EGP`
7. **Makadi Bay** (`32 km`, `~30m`): Sedan `€22`, Minivan `€28`, Coaster `€44`, Shuttle `€9/pax`, UberX `440 EGP`
8. **El Gouna** (`36 km`, `~35m`): Sedan `€24`, Minivan `€30`, Coaster `€48`, Shuttle `€10/pax`, UberX `490 EGP`
9. **Soma Bay** (`52 km`, `~45m`): Sedan `€28`, Minivan `€36`, Coaster `€55`, Shuttle `€12/pax`, UberX `680 EGP`
10. **Safaga Port & Resorts** (`60 km`, `~50m`): Sedan `€30`, Minivan `€38`, Coaster `€60`, Shuttle `€14/pax`, UberX `780 EGP`
11. **Marsa Alam Corridors** (`220 km`, `~165m`): Sedan `€75`, Minivan `€95`, Coaster `€145`, Shuttle `€30/pax`, UberX `2,950 EGP`
12. **Luxor (Nile Valley Convoy Highway)** (`300 km`, `~240m`): Sedan `€95`, Minivan `€120`, Coaster `€185`, Shuttle `€40/pax`, UberX `3,850 EGP`
13. **Cairo (Zafarana / Galala Highway)** (`460 km`, `~300m`): Sedan `€110`, Minivan `€135`, Coaster `€210`, Shuttle `€45/pax`, UberX `4,600 EGP`

### 4.2. HRG Airport Airlines (17)
- **Terminal 1 (International Wing):** EasyJet (`EZY`), TUI Airways (`TOM`), Condor (`CFG`), Wizz Air (`W6`), Eurowings (`EW`), Edelweiss Air (`WK`), Corendon Airlines (`XR`), Pegasus Airlines (`PC`), Turkish Airlines (`TK`), Jet2.com (`LS`), Smartwings (`QS`), EgyptAir International (`MS`), Air Cairo International (`SM`).
- **Terminal 2 (Charter & Domestic Wing):** Enter Air (`ENT`), Aeroflot / Rossiya (`SU`), EgyptAir Domestic (`MS`), Nile Air (`NP`).

### 4.3. Intercity Coach Schedules (6)
1. **Go Bus Deluxe Plus (Hurghada ↔ Cairo):** `390 EGP` (`6h 30m`, El Dahar El Nasr St → Tahrir Square / Almaza)
2. **Go Bus Elite Plus DD (Hurghada ↔ Cairo):** `750 EGP` (`5h 30m`, Double Decker VIP with meal & Wi-Fi)
3. **Go Bus Aero First Class (Hurghada ↔ Cairo):** `950 EGP` (`5h 15m`, 2+1 solo business pods)
4. **Blue Bus Business Class (Hurghada ↔ Cairo):** `850 EGP` (`5h 30m`, Senzo / El Dahar → Nasr City / Tahrir)
5. **White Bus VIP Coach (Hurghada ↔ Cairo):** `520 EGP` (`6h 00m`, El Dahar → Ramses / Sixth of October)
6. **Go Bus Deluxe Plus (Hurghada ↔ Luxor):** `350 EGP` (`4h 15m`, El Dahar / Safaga → Luxor Railway Station)

---

## 5. Editorial & Statutory Safe Harbor Policy
- **Institutional Attribution:** Compiled by the **Red Sea Transit & Aviation Research Desk** (`human_reviewed: false`, AI-Assisted Editorial Synthesis under Regulation (EU) 2024/1689 Article 50 & Article 50(4)).
- **Statutory Safe Harbor Notice:** Notice: This calculation engine models published statutory formulas and regulatory codes for informational and planning purposes only. It does not provide certified legal, medical, veterinary, tax, or engineering advice. For definitive rulings, consult an actively licensed professional in your jurisdiction.