Skip to main content

Onboarding Checklist

Onboarding objective​

New engineers should be able to run the stack, understand core domain flow, and ship a safe small change within day 1-3.

Day 0 — access​

  • Repo + branch policy access
  • Dev/staging environment access
  • Toolchain installed (PHP, Composer, Node.js, DB client)
  • .env copied and required variables filled

Day 1 — local bootstrap​

  • Install dependencies
  • Generate app key, run migrate + minimal seed
  • Start backend/frontend runtime
  • Verify admin route + API health endpoint

Day 2 — domain understanding​

  • Read overview.md, architecture.md, domain-model.md
  • Read business-flows.md and state-machine.md
  • Review key endpoints in api-reference.md
  • Run one end-to-end scenario

Day 3 — first contribution​

  • Pick a small scoped task
  • Run relevant test/lint
  • Update canonical docs if behavior changes
  • Open PR with verification evidence

Definition of ready​

  • Can run app locally without real-time guidance
  • Can explain auth/reservation/coupon flow
  • Can map a small change to canonical docs