time_to_leave/MANUAL_TESTING_CHECKLIST.md

# TimeToLeave - Manual Testing Checklist

Use this checklist for browser, mobile, and integration testing before release.

## Prerequisites

- [ ] `npm install` has been run.
- [ ] Required environment variables are configured.
- [ ] Web app is running locally or deployed.
- [ ] Mobile app has a reachable `EXPO_PUBLIC_API_BASE_URL` when tested on a device.
- [ ] Network access is available for HAFAS, Nominatim, OSRM, Wiener Linien, and calendar providers.

## Web Dashboard

- [ ] Open `/`.
- [ ] Verify the departure desk loads without console errors.
- [ ] Add or import at least two future events.
- [ ] Verify the dashboard shows the next upcoming event.
- [ ] Verify edit and remove actions work from the event card.
- [ ] Verify event data persists after browser refresh.

## Web Calendar Import

- [ ] Open `/calendar`.
- [ ] Import a valid allowed ICS URL.
- [ ] Upload a local `.ics` file.
- [ ] Verify imported events with locations merge into the local event store.
- [ ] Verify duplicate imports do not create unusable duplicate records.
- [ ] Use batch destination editing and confirm edited destinations are retained.

## Google Calendar Web Sync

- [ ] Confirm `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, `GOOGLE_REDIRECT_URI`, and `DEPLOYMENT_URL` are configured.
- [ ] Open the Google tab on `/calendar`.
- [ ] Connect Google Calendar through OAuth.
- [ ] Verify sync returns upcoming events with locations.
- [ ] Disconnect Google Calendar.
- [ ] Verify status returns to disconnected.

## Settings and Reminders

- [ ] Enable browser notifications when prompted.
- [ ] Change reminder buffer and arrival buffer.
- [ ] Toggle walking option off and on.
- [ ] Toggle bike option off and on.
- [ ] Refresh the page and verify settings persist.
- [ ] Verify disabling bike hides or disables bike mode.
- [ ] Verify disabling walking removes the final-walk adjustment from train mode.

## Train Mode

- [ ] Use an event with a real destination and origin station.
- [ ] Verify destination geocoding completes.
- [ ] Verify destination station lookup completes.
- [ ] Verify `/api/hafas` is called with `TripSearch`.
- [ ] Verify journey rows show departure, arrival, platform, train labels, delay, changes, and cancellations when present.
- [ ] Verify leave-by time is based on a journey that arrives before the event minus arrival buffer and final walk.
- [ ] Increase arrival buffer and verify leave-by can move earlier.

## Bike and Walking Routes

- [ ] Switch to bike mode.
- [ ] Verify `/api/bike-route` is called with four coordinate parameters.
- [ ] Verify bike duration, distance, and steps are displayed.
- [ ] Switch back to train mode with walking enabled.
- [ ] Verify `/api/walk-route` is called for station-to-destination walking.
- [ ] Verify walking duration and distance appear in the train section.
- [ ] Test route error handling with invalid or very distant coordinates.

## Wiener Linien

- [ ] Use a destination near Vienna public transport.
- [ ] Verify `/api/wienerlinien/stops` returns nearby stops.
- [ ] Verify `/api/wienerlinien/monitor` returns live departures for selected stops.
- [ ] Verify loading, empty, and error states are readable.

## API Guards

- [ ] Verify remote calendar URLs from unsupported hosts are rejected.
- [ ] Verify private or localhost calendar URLs are rejected.
- [ ] Verify overly large HAFAS POST bodies are rejected.
- [ ] Verify invalid coordinates return client errors.
- [ ] Verify CORS allows only configured origins.
- [ ] Verify rate limiting returns `429` after the configured threshold.

## Mobile Event Flow

- [ ] Start the Expo app.
- [ ] Add a manual event.
- [ ] Edit the event.
- [ ] Delete the event.
- [ ] Restart the app and verify stored events persist.
- [ ] Open event detail and verify train, bike, walking, and nearby-stop sections load when data is available.

## Mobile Calendar Import

- [ ] Import an ICS URL.
- [ ] Grant calendar permission.
- [ ] Verify native calendars are listed.
- [ ] Select and deselect individual calendars.
- [ ] Use select all and deselect all.
- [ ] Sync native calendars for the next 30 days.
- [ ] Verify events without locations are excluded.
- [ ] Verify CalDAV/DAVx, Apple, Google, Exchange, subscribed, local, and other source labels render correctly when available on the device.

## Mobile Settings and Notifications

- [ ] Search for an origin station.
- [ ] Use current location to find nearest origin station.
- [ ] Change reminder buffer and arrival buffer.
- [ ] Toggle walking and bike options.
- [ ] Toggle notifications.
- [ ] Verify notification settings persist after app restart.
- [ ] Verify scheduled notifications are recreated when settings change.
- [ ] Toggle dark/light theme and verify it persists.

## Offline and Failure States

- [ ] Disable network and open web event detail data.
- [ ] Verify geocoding, HAFAS, route, and Wiener Linien errors are visible and non-blocking.
- [ ] Re-enable network and verify retry/refresh paths work.
- [ ] Test mobile with the backend URL unavailable and verify errors are understandable.

## Accessibility and Layout

- [ ] Navigate web controls with keyboard only.
- [ ] Verify modal focus and close behavior.
- [ ] Verify buttons and interactive controls have accessible labels or readable text.
- [ ] Test narrow mobile browser width, tablet width, and desktop width.
- [ ] Verify mobile screens do not clip primary controls.

## Sign-Off

- [ ] Web smoke test passed.
- [ ] Mobile smoke test passed.
- [ ] Calendar import tested.
- [ ] Live transit integration tested.
- [ ] Notifications tested.
- [ ] No critical bugs remain.

Tested by:

Date:

Build/version: