# The owners' decisions (the "why" behind the rules)

| When | Decision |
|---|---|
| 2026-11-04 | **No on-account risk at all**: every sale on every channel is paid by card before booking; failed payment = no booking. ("We are not taking risk on account bookings for now.") May be relaxed later only by the owners. |
| 2026-11-04 | **Every rate can be % or a fixed rand amount per booking** — margins, fees, shares, corporate fees. |
| 2026-11-04 | Never sell at the bare supplier price; the system must stop set-ups that lose money. |
| 2026-11-04 | Deposits are OFF (full payment); travel insurance is not sold. |
| 2026-11-05 | Make agent logins and package loading easy (still to do). |
| 2026-11-06 | **Deals, not Settings**: agents and corporates are priced and paid only on their own deal; Settings margins only for our own sales. |
| 2026-11-06 | **One source, no mistakes**: one place per setting; every state honoured system-wide; guards, not trust. |
| 2026-11-06 | **Corporates on our server**: no self-hosted installs or keys; clients are folders at /<shortname>/, own domains allowed. |
| 2026-11-06 | **VAT the SA way**: agent on live sectors (VAT on our part), principal on our own packages, agents' packages invoiced on their behalf. |
| 2026-11-07 | **Books are immutable**: history never recomputed; rates apply going forward; recorded payments locked; corrections are new records; nobody with sales is deleted. Records kept at least 5 years. |
| 2026-11-07 | International flights: we pay the VAT inside our fixed fee (e.g. R57 per flight). Insurance stays off. |
| 2026-11-08 | **The owners' four split rules**: live 50/50; packages Getaway/API loaded 70 Getaway / 30 API; agent-loaded packages 50/50; monthly fees = live rule. |
| 2026-11-08 | International-flight fee zero-rated: ON. |
| 2026-11-08 | **Finance is the one home of money screens**, with three tabs (Agents, Corporates, Platform) plus Books; no repeated screens or buttons. |
| 2026-11-08 | "Everything real": the dev books were repaired (R0 bookings recorded from their payments or cancelled as never paid; invoice gaps recorded as void). |
| 2026-11-08 | Gateway naming: "Gateway fees (card)" / "payment gateway" in everything people see. |
| 2026-11-09 | Security pass: two-step sign-in for money actions, hashed sessions, signed document links, throttles, sealed audit log after go-live. |
| 2026-11-15 | Contradiction audit: one rule for own-package money (old platform fee can only be switched off); agent texts promise only deal rates; months end in SA time everywhere; corporate clients without written fees cannot book. |
| 2026-11-15 | **TravelClip**: a local, free assistant for the owner's login only (Qwen3-4B on this computer, memory kept apart from the books). The code guards the money; TravelClip explains. |

## Design decisions (sites and back office)
- Native mouse pointer, readable colours, quick subtle motion, no black/solid backgrounds, things to do are never searched.
- API Travel Solutions' logo top-left on dashboards and sign-in pages — not on the guest sites; corporate bookers are white-label.
- Three back-office layouts per login: Standard, Classic (calm, progressive), Travel OS (beta).
