How kiran-pillai/arka-goals-revamp-mono works
Arka Goals is a weekly squad goal-tracking app with passwordless sign-in and admin-managed invitations. Members authenticate through a magic link, then create or update goals and submit weekly check-ins; admins invite members and manage invite status. The graph includes the documented UI capabilities and sampled backend service calls. Several frontend data hooks and domain screens were not excerpted, so their detailed request wiring is omitted; README-backed links are cited as such.
Main entry points: HomeRoute.tsx Home screen · router.tsx App routes · api.ts HTTP API client · prisma.service.ts Prisma data access
Components 26
Member experience
- App routes
front-end/src/router.tsx - Login screen
front-end/src/routes/LoginRoute.tsx - Auth callback
front-end/src/routes/AuthCallbackRoute.tsx - Home screen
front-end/src/routes/HomeRoute.tsx - Weekly check-in form
front-end/src/WeeklyCheckIn.tsx - Check-in history
front-end/src/CheckInsTable.tsx - Goal setup
front-end/src/GoalSetup.tsx - Goal list
front-end/src/GoalsTable.tsx - Invite management screen
front-end/src/routes/AdminInvitesRoute.tsx - Session context
front-end/src/auth/AuthContext.tsx - HTTP API client
front-end/src/lib/api.ts
Identity and access
- Auth endpoints
back-end/src/auth/auth.controller.ts - Magic-link service
back-end/src/auth/auth.service.ts
Goals and check-ins
- Goal endpoints
back-end/src/goals/goals.controller.ts - Goal operations
back-end/src/goals/goals.service.ts - Check-in endpoints
back-end/src/checkins/checkins.controller.ts - Check-in operations
back-end/src/checkins/checkins.service.ts
Invite management
- Invite endpoints
back-end/src/invites/invites.controller.ts - Invite operations
back-end/src/invites/invites.service.ts - User lookup
back-end/src/users/users.service.ts
Persistence and mail
- Prisma data access
back-end/src/prisma/prisma.service.ts - PostgreSQL
- Email delivery
back-end/src/mail/mail.service.ts - SMTP / MailHog
Other components
- Squad member
- Squad admin
Connections 38
- Squad member → App routes: uses
README.md - Squad admin → App routes: uses
README.md - App routes → Login screen: routes to
front-end/src/router.tsx - App routes → Auth callback: routes to
front-end/src/router.tsx - App routes → Home screen: routes to
front-end/src/router.tsx - App routes → Invite management screen: routes to
front-end/src/router.tsx - Home screen → Weekly check-in form: renders
front-end/src/routes/HomeRoute.tsx - Home screen → Check-in history: renders
front-end/src/routes/HomeRoute.tsx - Home screen → Goal setup: renders
front-end/src/routes/HomeRoute.tsx - Home screen → Goal list: renders
front-end/src/routes/HomeRoute.tsx - Home screen → Session context: reads session
front-end/src/routes/HomeRoute.tsx - Invite management screen → HTTP API client: calls
front-end/src/routes/AdminInvitesRoute.tsx - Auth callback → HTTP API client: calls
front-end/src/routes/AuthCallbackRoute.tsx - Auth callback → Session context: refreshes
front-end/src/routes/AuthCallbackRoute.tsx - Session context → HTTP API client: calls
front-end/src/auth/AuthContext.tsx - Login screen → HTTP API client: calls
front-end/src/routes/LoginRoute.tsx - HTTP API client → Auth endpoints: HTTP requests
README.md - Auth endpoints → Magic-link service: delegates
back-end/src/auth/auth.controller.ts - Magic-link service → Prisma data access: reads/writes
back-end/src/auth/auth.service.ts - Magic-link service → Email delivery: sends links
back-end/src/auth/auth.service.ts - Goal endpoints → Goal operations: delegates
back-end/src/goals/goals.controller.ts - Goal operations → Prisma data access: reads/writes
back-end/src/goals/goals.service.ts - Check-in endpoints → Check-in operations: delegates
back-end/src/checkins/checkins.controller.ts - Check-in operations → Prisma data access: reads/writes
back-end/src/checkins/checkins.service.ts - Invite endpoints → Invite operations: delegates
back-end/src/invites/invites.controller.ts - Invite operations → Prisma data access: reads/writes
back-end/src/invites/invites.service.ts - Invite operations → User lookup: looks up users
back-end/src/invites/invites.service.ts - Invite operations → Magic-link service: sends invite link
back-end/src/invites/invites.service.ts - Prisma data access → PostgreSQL: persists data
README.md - Email delivery → SMTP / MailHog: sends email
README.md - Squad member → Weekly check-in form: submits
README.md - Squad member → Goal setup: sets goals
README.md - Squad admin → Invite management screen: manages invites
README.md - Weekly check-in form → Check-in endpoints: submits check-in
- Goal setup → Goal endpoints: manages goals
- Check-in history → Check-in endpoints: loads history
- Goal list → Goal endpoints: loads goals
- Invite management screen → Invite endpoints: manages invites