Trips Portal E2E Lifecycle
This guide documents the end-to-end participant experience in the Trips Portal.
1. Entry And Authentication
Supported entry paths:
- Token link:
/play/trips/{tripId}/access?token=... - Authenticated account access (for trip participants)
Portal access flow:
- Player opens access URL.
- Token is validated (or account session is used).
- Session is established for the trip player context.
- User is redirected to portal home.
2. Portal Navigation Model
Current portal navigation is menu-based (hamburger sheet), not bottom tabs.
Primary sections:
HomeRoundsStandingsExpensesSettings
3. Home To Scoring Flow
From Home, players can:
- Jump to
Enter Scores - Open
Leaderboards - See today’s schedule
- View championship preview
- View Ryder Cup summary when present
Primary E2E path:
- Home
- Open active round
- Enter scores hole by hole
- Save and verify leaderboard impact
4. Round Lifecycle In Portal
Round states players will encounter:
scheduledin_progress/activecompleted
Player actions:
- Start round (when allowed by readiness state)
- Enter group scores
- Navigate holes quickly
- View group and full scorecard context
- Complete round
5. Live Scoring And Leaderboards
Portal supports:
- Live round leaderboard
- Tournament leaderboard
- Multi-round leaderboard
- Ryder Cup display
- Point game state and selections
Expected behavior:
- Score submissions update standings without full page reload.
- Realtime status gracefully falls back to polling when needed.
6. Side Games
Within round context, players can manage:
- Skins
- Nassau
Typical flow:
- Open
Side Gamesfrom round scoring context. - Create or join a game.
- Track game state through scoring.
- Review and settle outcomes.
7. Portal Expenses And Settlements
Portal includes trip expense and settlement visibility:
- View personal net balance.
- Add shared expense.
- Review settlement list and pending status.
- Track payment progress.
8. Settings And Device Experience
Portal settings cover:
- Appearance mode
- Outdoor mode
- Haptics
- Session/account state
- Local data reset
Offline expectations:
- Score entry should remain possible while disconnected.
- Sync resumes automatically after connection recovery.
9. Failure Paths To Test
Run these explicitly in UAT:
- Expired or invalid token on
/access. - Player missing
tripPlayerIdcontext. - Round exists but setup incomplete.
- Offline score entry then reconnect.
- Settlement data refresh after expense changes.
Portal E2E Acceptance Checklist
| Step | Pass Criteria |
|---|---|
| Access | New token opens correct player context |
| Home | Active rounds and quick actions render |
| Scoring | Score save succeeds and persists |
| Leaderboard | Placement or totals update after scoring |
| Side games | Skins/Nassau state loads and updates |
| Expenses | New expense affects balances |
| Offline | Pending data syncs after reconnect |