How kazes5/soccer works
Soccer Carpool Coordinator helps youth soccer teams organize rides by scheduling sessions and pickup points, assigning shift responsibilities, coordinating swaps, and notifying members. The web client is the primary interface; the Fastify API handles authentication and team workflows against PostgreSQL, while Redis-backed workers support reminders and notification delivery. The README also identifies shared Zod contracts and design tokens. Several API route families and background subsystems are documented or indexed but not excerpted, so their individual internal call relationships are not asserted.
Main entry points: app.ts HTTP API · app Web experience · sessions.ts Session scheduling · notifications.ts Notification APIs
Components 31
Team client
- Web experience
apps/web/src/app - Schedule and shifts
apps/web/src/app/schedule/page.tsx - Team home
apps/web/src/app/home/page.tsx - Swap requests
apps/web/src/app/swaps/page.tsx - Notifications
apps/web/src/app/notifications/page.tsx - Team administration
apps/web/src/app/admin - System administration
apps/web/src/app/system/page.tsx - AI chat
apps/web/src/components/chat
API service
- HTTP API
apps/api/src/app.ts - Authentication
apps/api/src/routes/auth.ts - Session validation
apps/api/src/plugins/auth.ts - Session scheduling
apps/api/src/routes/sessions.ts - Shift claims
apps/api/src/routes/shifts.ts - Swap coordination
apps/api/src/routes/swap-requests.ts - Teams and members
apps/api/src/routes/teams.ts - Team invitations
apps/api/src/routes/invites.ts - Team settings
apps/api/src/routes/schedule-templates.ts - Notification APIs
apps/api/src/routes/notifications.ts - Chat actions
apps/api/src/routes/chat.ts - Audit records
apps/api/src/routes/audit-logs.ts - System operations
apps/api/src/routes/system.ts - PostgreSQL
Background delivery
- Redis queues
apps/api/src/lib/queues.ts - Job worker
apps/api/src/worker/index.ts - Scheduled tasks
apps/api/src/worker/processors/scheduled-task.ts - Notification outbox
apps/api/src/worker/processors/outbox.ts - Push delivery
apps/api/src/lib/push-delivery.ts
Shared packages
- Shared contracts
packages/contracts/src - Design tokens
packages/ui-tokens/src - Mobile locale support
apps/mobile/src/lib/locale-storage.ts
Other components
- Team member
Connections 39
- Team member → Web experience: uses
README.md - Web experience → HTTP API: calls
- HTTP API → Session validation: registers
apps/api/src/app.ts - HTTP API → Authentication: registers
apps/api/src/app.ts - HTTP API → Session scheduling: registers
apps/api/src/app.ts - HTTP API → Shift claims: registers
apps/api/src/app.ts - HTTP API → Swap coordination: registers
apps/api/src/app.ts - HTTP API → Teams and members: registers
apps/api/src/app.ts - HTTP API → Team invitations: registers
apps/api/src/app.ts - HTTP API → Notification APIs: registers
apps/api/src/app.ts - HTTP API → Chat actions: registers
apps/api/src/app.ts - HTTP API → System operations: registers
apps/api/src/app.ts - HTTP API → Team settings: registers
apps/api/src/app.ts - Session scheduling → PostgreSQL: reads and writes
apps/api/src/routes/sessions.ts - Session scheduling → Notification APIs: records events
apps/api/src/routes/sessions.ts - Session scheduling → Redis queues: schedules reminders
apps/api/src/routes/sessions.ts - Session validation → PostgreSQL: validates sessions
apps/api/src/plugins/auth.ts - Authentication → PostgreSQL: manages credentials
apps/api/src/routes/auth.ts - Team settings → PostgreSQL: manages settings
- Notification APIs → PostgreSQL: reads notifications
- Chat actions → PostgreSQL: uses team data
- Chat actions → Notification APIs: dispatches actions
- Job worker → Scheduled tasks: runs processors
- Job worker → Notification outbox: runs processors
- Scheduled tasks → Redis queues: consumes jobs
- Notification outbox → Redis queues: consumes jobs
- Notification outbox → Push delivery: delivers pushes
- Push delivery → Team member: sends notifications
- Schedule and shifts → HTTP API: requests schedules
- Team home → HTTP API: loads team overview
- Swap requests → HTTP API: requests swaps
- Notifications → HTTP API: loads notifications
- Team administration → HTTP API: manages team
- System administration → HTTP API: manages system
- AI chat → HTTP API: sends chat
- Web experience → Shared contracts: shares types
- HTTP API → Shared contracts: validates payloads
- Web experience → Design tokens: uses styles
- Mobile locale support → Team member: persists locale