How pranshuaryal/git-gud works
GitGud is a repository-based collaboration app for organizing notes into nested sections, forking and starring repositories, and proposing and reviewing merge requests. Users authenticate, browse or create repositories, edit notes, and submit changes from forks; owners review requests and may approve them, updating the note and its version history. The graph combines sampled backend call paths with documented-by-source-index frontend and product subsystems. Frontend-to-backend links are dashed because the relevant HTTP wiring was not sampled.
Main entry points: api.ts API client · prisma.service.ts Prisma service · auth.controller.ts Auth endpoints · merge-request.service.ts Merge request service
Components 21
Web experience
- Web pages
frontend/src/app/(app) - Sign-in page
frontend/src/app/auth/page.tsx - Auth context
frontend/src/app/context/AuthContext.tsx - API client
frontend/src/lib/api.ts - Merge request views
frontend/src/app/(app)/merge-requests - Repository editor
frontend/src/app/(app)/repos/[id]/edit/page.tsx - Repository browser
frontend/src/app/(app)/repos/[id]/page.tsx - Note editor
frontend/src/components/NoteEditor.tsx
Identity
- Auth endpoints
backend/src/auth/auth.controller.ts - Auth service
backend/src/auth/auth.service.ts - JWT guard
backend/src/common/guards/jwt-auth.guard.ts - JWT utilities
backend/src/common/utils/jwt.utils.ts
Repositories and notes
- Repository endpoints
backend/src/repo/repo.controller.ts - Repository service
backend/src/repo/repo.service.ts - Profile endpoints
backend/src/repo/profiles.controller.ts
Merge requests and persistence
- Merge request endpoints
backend/src/merge-request/merge-request.controller.ts - Merge request service
backend/src/merge-request/merge-request.service.ts - Diff computation
backend/src/repo/diff.util.ts - Prisma service
backend/src/prisma/prisma.service.ts - PostgreSQL
Other components
- User
Connections 21
- User → Sign-in page: signs in
- User → Web pages: uses
- Sign-in page → Auth context: uses
- Web pages → API client: requests
- Merge request views → API client: requests
- Repository editor → API client: requests
- Repository browser → API client: requests
- API client → Auth endpoints: HTTP calls
- API client → Repository endpoints: HTTP calls
- API client → Merge request endpoints: HTTP calls
- Auth endpoints → Auth service: calls
backend/src/auth/auth.controller.ts - Auth service → Prisma service: queries
backend/src/auth/auth.service.ts - Auth endpoints → JWT guard: guards routes
backend/src/auth/auth.controller.ts - JWT guard → JWT utilities: verifies token
backend/src/common/guards/jwt-auth.guard.ts - Repository endpoints → Repository service: calls
backend/src/repo/repo.controller.ts - Repository service → Prisma service: queries
backend/src/repo/repo.service.ts - Profile endpoints → Repository service: calls
backend/src/repo/profiles.controller.ts - Merge request endpoints → Merge request service: calls
backend/src/merge-request/merge-request.controller.ts - Merge request service → Prisma service: queries
backend/src/merge-request/merge-request.service.ts - Merge request service → Diff computation: computes diff
backend/src/merge-request/merge-request.service.ts - Prisma service → PostgreSQL: connects
backend/src/prisma/prisma.service.ts