How mczagany/arka-goals-revamp-mono works
Arka Goals is a squad weekly-goal tracking application. Members sign in through passwordless email links, then create and review goals and submit weekly check-ins; admins additionally invite and manage members. The frontend routes users to these workflows and calls the NestJS backend, whose domain services use Prisma and PostgreSQL. Mail delivery supports sign-in and invite links. The graph preserves documented product areas, but some frontend-to-domain API calls and unsampled modules are represented only where the available evidence supports them.
Main entry points: router.tsx Route guards · HomeRoute.tsx Squad home · auth.service.ts Magic-link service · api.ts HTTP client
Components 24
Web application
- App bootstrap
front-end/src/main.tsx - Route guards
front-end/src/router.tsx - Session context
front-end/src/auth/AuthContext.tsx - Magic-link login
front-end/src/routes/LoginRoute.tsx - Link callback
front-end/src/routes/AuthCallbackRoute.tsx - Squad home
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 - Goals table
front-end/src/GoalsTable.tsx - Invite management
front-end/src/routes/AdminInvitesRoute.tsx - HTTP client
front-end/src/lib/api.ts
Identity and membership
- Auth endpoints
back-end/src/auth/auth.controller.ts - Magic-link service
back-end/src/auth/auth.service.ts - Invite management
back-end/src/invites/invites.service.ts - User lookup
back-end/src/users/users.service.ts - Email delivery
back-end/src/mail/mail.service.ts
Goal tracking
- Check-in service
back-end/src/checkins/checkins.service.ts - Goals service
back-end/src/goals/goals.service.ts
Backend platform
- Nest application
back-end/src/app.module.ts - Prisma client
back-end/src/prisma/prisma.service.ts - PostgreSQL
Other components
- Squad member
- Squad admin
Connections 31
- Squad member → Magic-link login: requests access
README.md - Squad admin → Invite management: manages roster
README.md - App bootstrap → Route guards: mounts routes
front-end/src/main.tsx - App bootstrap → Session context: provides session
front-end/src/main.tsx - Route guards → Magic-link login: routes to
front-end/src/router.tsx - Route guards → Link callback: routes to
front-end/src/router.tsx - Route guards → Squad home: guards route
front-end/src/router.tsx - Route guards → Invite management: guards route
front-end/src/router.tsx - Session context → HTTP client: requests session
front-end/src/auth/AuthContext.tsx - Magic-link login → HTTP client: submits login
front-end/src/routes/LoginRoute.tsx - Link callback → HTTP client: verifies link
front-end/src/routes/AuthCallbackRoute.tsx - Squad home → Weekly check-in form: renders
front-end/src/routes/HomeRoute.tsx - Squad home → Check-in history: renders
front-end/src/routes/HomeRoute.tsx - Squad home → Goal setup: renders
front-end/src/routes/HomeRoute.tsx - Squad home → Goals table: renders
front-end/src/routes/HomeRoute.tsx - Invite management → HTTP client: manages invites
front-end/src/routes/AdminInvitesRoute.tsx - HTTP client → Nest application: sends requests
front-end/src/lib/api.ts - Nest application → Auth endpoints: registers feature
back-end/src/app.module.ts - Auth endpoints → Magic-link service: delegates auth
back-end/src/auth/auth.controller.ts - Magic-link service → Prisma client: reads and writes
back-end/src/auth/auth.service.ts - Magic-link service → Email delivery: sends links
back-end/src/auth/auth.service.ts - Email delivery → PostgreSQL
- Magic-link service → Invite management
back-end/src/invites/invites.service.ts - Invite management → Magic-link service: sends invite link
back-end/src/invites/invites.service.ts - Invite management → User lookup: looks up users
back-end/src/invites/invites.service.ts - Invite management → Prisma client: reads and writes
back-end/src/invites/invites.service.ts - Nest application → Check-in service: registers feature
back-end/src/app.module.ts - Nest application → Goals service: registers feature
back-end/src/app.module.ts - Check-in service → Prisma client: reads and writes
back-end/src/checkins/checkins.service.ts - Goals service → Prisma client: reads and writes
back-end/src/goals/goals.service.ts - Prisma client → PostgreSQL: connects to
back-end/src/prisma/prisma.service.ts