Add Contract — simple flow
How a user creates one full hotel supplier contract (aggregated save).
Start / entry
Decision
Step
Done
Open Add Contract
From Business → Contracts · or Accommodation / Supplier / Customer settings
Choose type
supplier OR customer
type = supplier
Show Supplier
Hide customer · pick hotel from supplier
type = customer
Show Customer + Supplier
Customer required · hotel from supplier
Fill header
Dates · currency · FX rate · base room view · base meal · release · markup · is_active
Add rate periods
period_from / to · materialization % · optional name
Add prices per period
room_type = SGL/DBL/TRP · price · capacity · active
Add meal plan supplements
meal_plan (not base / amount 0) · amount · is_per_person
Add room view supplements
room_view ≠ base_room_view · amount / night
Add children policies
scope · child_order · age range · charge_type / value · same_meal toggle
Validate & Save
Client checks + POST /contracts/create (one payload)
Contract created
Show details / back to list · is_active 1 or 0
Entry prefill UI only
- Contracts list → Add — empty form, user picks type
- Accommodation settings → Add — accommodation preselected
- Supplier settings → Add — type locked supplier · supplier preselected
- Customer settings → Add — type locked customer · customer preselected
Save payload (concept)
- Header →
ac_contracts
- Periods →
ac_contract_rates
- Prices →
ac_contract_rate_prices (room_type_id)
- Meals →
ac_contract_meal_plan
- Views →
ac_contract_room_view
- Children →
ac_contract_children_policies
- One transaction · no booking / invoice in this flow