Break Phase 1 into atomic, testable goals. Each goal = one working unit, no cross-dependency drift.

Trip Draft → Trip (DB) → LineItems → Offer → Order → Projection

Goal:

• Ensure every Trip draft has a persistent id

Done when:

• tripData.id always exists before any save

Goal:

• Persist Trip from Document silently

Files:

• trips/actions/commitTripFromDocument.ts

Done when:

• DB row updates on every edit
• No duplicates (upsert works)

Goal:

• Store DB id inside draft (_dbId)

Done when:

• trip._dbId exists after first sync
• Used by downstream actions

Goal:

• Ensure trip.pricing is always serializable + complete

Done when:

• pricing JSON survives reload
• no undefined fields

Goal:

• Convert pricing → LineItems (document scope)

Done when:

• LineItems appear under document
• correct sourceType: "trip"

Goal:

• Prevent duplication on re-generation

Done when:

• overwrite pattern works
• no stacking duplicates

Goal:

• Every LineItem references trip

Done when:

• sourceId = trip.id
• meta.tripId exists

Goal:

• Create Offer container from Trip

Files:

• offers/actions/createOfferFromTrip.ts

Done when:

• Offer exists with:
  • tripId
  • documentId

Goal:

• Clone LineItems from Document → Offer

Done when:

• Offer has its own LineItems
• Document remains unchanged

Goal:

• Combine G8 + G9 into single action

Files:

• createOfferFromTripFlow.ts

Done when:

• One call → full Offer ready

Goal:

• Button inside TripBuilder

Done when:

• Click → Offer created
• No reload needed

Goal:

• Render Offer purely from LineItems

Done when:

• totals derived in render only
• no stored totals required

Goal:

• Prevent duplicate offers per draft (optional rule)

Done when:

• either:
  • always new Offer
  • OR reuse existing

Goal:

• Populate document sections from Trip

Files:

• populateTripDocument.ts

Done when:

• Trip data visible in document fields

Goal:

• Define clear authority

Rule:

• Document = UI
• Trip = structured snapshot

Done when:

• no circular overwrite bugs

Goal:

• Create Order from Offer

Files:

• orders/actions/createOrderFromOffer.ts

Done when:

• Order row created
• linked to Offer

Goal:

• Copy LineItems → OrderLineItems

Done when:

• Order survives Offer edits

Goal:

• Freeze Offer after order

Done when:

• status = "ordered"

Goal:

• Compute totals only when needed

Done when:

• no totals stored as truth

Goal:

• Button to create Order

Done when:

• redirect → /orders/[id]

Goal:

• Render Order snapshot

Done when:

• PDF matches Order exactly

Goal:

• Stable printable root

Done when:

• all exports use same DOM root

Goal:

• One pricing engine used everywhere

Done when:

• Trip + Experience share logic

Goal:

• Same pipeline as Trip

Done when:

• interchangeable in Offer

Goal:

• Allow Trip + Experience in one Offer

Done when:

• LineItems coexist safely

Goal:

• Re-sync Trip into Offer without breaking Experience items

Done when:

• selective overwrite works

Goal:

• Replace all LineItems from Document

Done when:

• Offer fully mirrors Document

Goal:

• Publish Offer / Document as Space

Done when:

• page generated from snapshot

Goal:

• Ensure Offer can be exported

Done when:

• LineItems complete
• metadata ready

Goal:

• Guard all actions

Done when:

• no silent failures
• clear thrown errors

1. Pick ONE goal
2. Implement
3. Test manually
4. Confirm DB state
5. Move next

1. G2 → G3 → G5 → G8 → G9 → G10 → G11
2. G12 → G16 → G17 → G18
3. G21 → G22
4. Then expand (Experience / Space)

• Trip persists without duplication
• LineItems reflect pricing exactly
• Offer clones LineItems correctly
• Order locks snapshot
• PDF matches Order
• No totals stored outside LineItems
• No Prisma outside actions

• unify _dbId naming → tripId
• add version to Offer later
• add status transitions enum
• optional audit log for LineItems mutations