time_to_leave/CHECKLIST.md

ÖBB Planner — Implementation Checklist

Phase 2 complete. Moving to Phase 3.

---

Checkbox key

• [ ] pending (required) — blocks the next phase until both ✅ and ✔️ are [x]
• [x] done
• [~] optional or deferred — never blocks phase advancement; check [x] if completed, leave [~] to skip

---

Phase 1 — Scaffold Next.js Project (~30 min)

#	Item	✅	✔️
1	Initialize Next.js with App Router, TypeScript, Tailwind CSS	[x]	[x]
2	Set up tsconfig.json with strict mode	[x]	[x]
3	Create .env.example with PORT, HAFAS_URL, NOMINATIM_URL, OSRM_URL	[x]	[x]
4	Configure next.config.ts (rewrites if needed) (optional — only required if URL rewrites are actually needed)	[~]	[~]
5	Configure vitest.config.ts (deferred — must be done before Phase 7 begins, but not required to complete Phase 1)	[x]	[~]
6	Set up postcss.config.mjs	[x]	[x]

---

Phase 2 — Types + Library Layer (~2 hours)

#	Item	✅	✔️
7	Define TypeScript types in src/types/index.ts	[x]	[x]
8	Port lib/hafas-client.ts — HAFAS API client functions with proper types	[x]	[x]
9	Port lib/calendar-utils.ts — extractEvents + cleanLocation	[x]	[x]
10	Port lib/countdown-utils.ts, lib/formatting.ts, lib/constants.ts, lib/demo.ts	[x]	[x]
11	Create lib/geocoding-client.ts — Nominatim client (NEW)	[x]	[x]
12	Create lib/bike-routing-client.ts — OSRM client (NEW)	[x]	[x]

---

Phase 3 — API Routes (~45 min)

#	Item	✅	✔️
13	src/app/api/hafas/route.ts — POST handler, same logic as Express	[x]	[x]
14	src/app/api/calendar/route.ts — GET handler for remote ICS	[x]	[x]
15	src/app/api/calendar/parse/route.ts — POST handler for ICS body	[x]	[x]
16	src/app/api/geocode/route.ts — GET handler for Nominatim (NEW)	[x]	[x]
17	src/app/api/bike-route/route.ts — GET handler for OSRM (NEW)	[x]	[x]
18	src/app/api/health/route.ts — health check	[x]	[x]

---

Phase 4 — Custom Hooks (~2.5 hours)

#	Item	✅	✔️
19	useServerHealth.ts — polls /api/health every 30s	[x]	[x]
20	useClock.ts — interval that updates now every 10s	[x]	[x]
21	useGeolocation.ts — wraps navigator.geolocation	[x]	[x]
22	useOriginStation.ts — finds nearest station from geolocation	[x]	[x]
23	useJourneys.ts — the complex fetchAll logic, per-event journey fetching	[x]	[x]
24	useBikeRoute.ts — fetches bicycle route for an event (NEW)	[x]	[x]
25	useCalendar.ts — URL/file import with merge logic	[x]	[x]
26	useEventsStore.ts — shared events state via Context (NEW)	[x]	[x]

---

Phase 5 — UI Components (~3.5 hours)

#	Item	✅	✔️
27	ui/Chip.tsx — small badge component	[x]	[x]
28	ui/Button.tsx — styled button	[x]	[x]
29	ui/LoadingSpinner.tsx — loading indicator	[x]	[x]
30	event/LeaveByBadge.tsx — countdown badge	[x]	[x]
31	event/JourneyList.tsx — departure rows	[x]	[x]
32	event/TrainSection.tsx — train data in event card	[x]	[x]
33	event/BikeSection.tsx — bicycle data in event card (NEW)	[x]	[x]
34	event/EventCard.tsx — composes train + bike sections	[x]	[x]
35	calendar/UrlTab.tsx	[x]	[x]
36	calendar/FileTab.tsx	[x]	[x]
37	calendar/CalendarPanel.tsx	[x]	[x]
38	add-event/AddEventModal.tsx	[x]	[x]
39	layout/Header.tsx	[x]	[x]
40	layout/Navbar.tsx (NEW)	[x]	[x]

---

Phase 6 — Calendar Page (~1 hour)

#	Item	✅	✔️
41	calendar/CalendarView.tsx — month grid component (NEW)	[x]	[x]
42	calendar/DayEvents.tsx — events for a selected day (NEW)	[x]	[x]
43	app/calendar/page.tsx — calendar route (NEW)	[x]	[x]

---

Phase 7 — Tests (~2 hours)

#	Item	✅	✔️
44	Migrate server/__tests__/*.test.js → src/app/api/__tests__/*.test.ts	[x]	[x]
45	Add unit tests for calendar-utils.ts, countdown-utils.ts in src/lib/__tests__/	[x]	[x]
46	Add API tests for geocode and bike-route in src/app/api/__tests__/ (NEW)	[x]	[x]
47	Add component smoke tests with @testing-library/react (optional — valuable but not on the critical path; skip if setup cost outweighs benefit at the time)	[~]	[~]

---

Phase 8 — Cleanup (~30 min)

#	Item	✅	✔️
48	Delete old server/ directory	[x]	[x]
49	Delete old oebb-planner-app/ directory	[x]	[x]
50	Delete oebb-planner.jsx	[x]	[x]
51	Update README.md with new architecture and instructions	[x]	[x]
52	Final integration test	[x]	[x]

---

✅ Implemented — Code exists and is in the repo.
✔️ Reviewed — Code has been reviewed for correctness against the plan.
[ ] pending required · [x] done · [~] optional/deferred (never blocks phase advancement)