# praveenrampk/secret-santa architecture

> Architecture diagram of the GitHub repository praveenrampk/secret-santa, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/praveenrampk/secret-santa
- Repository: https://github.com/praveenrampk/secret-santa

## Overview

This is a Secret Santa group-management web application: members sign in, manage profiles and wishlists, create groups, and administer membership. The sampled backend shows group and wishlist operations backed by Mongo repositories; the frontend includes group and profile pages. Match allocation and live updates are advertised, but their implementations are not present in the supplied tree. Authentication is documented, though the sampled material does not establish its implementation or wiring.

Main entry points: [`server/src/group/group.service.ts`](https://github.com/praveenrampk/secret-santa/blob/main/server/src/group/group.service.ts) (Group service), [`server/src/wish-list/wish-list.service.ts`](https://github.com/praveenrampk/secret-santa/blob/main/server/src/wish-list/wish-list.service.ts) (Wishlist service), [`server/src/member/member.controller.ts`](https://github.com/praveenrampk/secret-santa/blob/main/server/src/member/member.controller.ts) (Member API), [`server/src/member/repositories/member.repository.ts`](https://github.com/praveenrampk/secret-santa/blob/main/server/src/member/repositories/member.repository.ts) (Member repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web experience"]
  node_dashboard["Group dashboard<br/>[page.tsx]"]
  node_group_list["Group listing<br/>[page.tsx]"]
  node_group_members_ui["Member roster"]
  node_group_header["Group controls<br/>[group-header.tsx]"]
  node_wishlist_ui["Wishlist pages<br/>[page.tsx]"]
end

subgraph group_identity["Member accounts"]
  node_signin["Sign in<br/>[page.tsx]"]
  node_signup["Sign up<br/>[page.tsx]"]
  node_profile["Member profile<br/>[page.tsx]"]
  node_member_api["Member API"]
  node_member_service["Member service<br/>[member.service.ts]"]
  node_member_repo["Member repository"]
  node_member_store[("Member records<br/>[member.schema.ts]")]
end

subgraph group_groups["Group management"]
  node_group_api["Group API"]
  node_group_service["Group service<br/>[group.service.ts]"]
  node_group_repo["Group repository"]
  node_group_store[("Group records<br/>[group.schema.ts]")]
  node_membership_repo["Membership repository"]
  node_membership_store[("Membership records")]
end

subgraph group_gifts["Gift exchange"]
  node_wishlist_api["Wishlist API"]
  node_wishlist_service["Wishlist service"]
  node_wishlist_repo["Wishlist repository"]
  node_wishlist_store[("Wishlist records")]
  node_match_allocation["Match allocation"]
  node_live_updates["Exchange updates"]
end

node_member(("Member"))

node_member -->|"signs in"| node_signin
node_member -->|"registers"| node_signup
node_member -.->|"views groups"| node_dashboard
node_member -->|"manages profile"| node_profile
node_signin -.->|"authenticates"| node_member_api
node_signup -.->|"registers"| node_member_api
node_profile -.->|"updates account"| node_member_api
node_member_api -->|"delegates"| node_member_service
node_member_service -->|"queries"| node_member_repo
node_member_repo -->|"persists"| node_member_store
node_dashboard -.->|"opens groups"| node_group_list
node_group_list -.->|"loads groups"| node_group_api
node_group_members_ui -->|"fetches roster"| node_group_api
node_group_api -->|"delegates"| node_group_service
node_group_service -->|"queries groups"| node_group_repo
node_group_service -->|"looks up members"| node_member_repo
node_group_service -->|"manages membership"| node_membership_repo
node_group_repo -->|"persists"| node_group_store
node_membership_repo -->|"persists"| node_membership_store
node_group_header -->|"renders"| node_group_members_ui
node_wishlist_ui -.->|"manages lists"| node_wishlist_api
node_wishlist_api -->|"delegates"| node_wishlist_service
node_wishlist_service -->|"queries lists"| node_wishlist_repo
node_wishlist_service -->|"checks group"| node_group_repo
node_wishlist_service -->|"checks member"| node_membership_repo
node_wishlist_repo -->|"persists"| node_wishlist_store
node_member -.->|"joins exchange"| node_match_allocation
node_match_allocation -.->|"publishes status"| node_live_updates

click node_signin "https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/signin/page.tsx"
click node_signup "https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/signup/page.tsx"
click node_profile "https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/member/profile/basic-details/page.tsx"
click node_member_api "https://github.com/praveenrampk/secret-santa/blob/main/server/src/member/member.controller.ts"
click node_member_service "https://github.com/praveenrampk/secret-santa/blob/main/server/src/member/member.service.ts"
click node_member_repo "https://github.com/praveenrampk/secret-santa/blob/main/server/src/member/repositories/member.repository.ts"
click node_member_store "https://github.com/praveenrampk/secret-santa/blob/main/server/src/member/schemas/member.schema.ts"
click node_dashboard "https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/dashboard/page.tsx"
click node_group_list "https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/group/page.tsx"
click node_group_members_ui "https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/group/%5BgroupID%5D/members/group-members-client.tsx"
click node_group_header "https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/group/%5BgroupID%5D/group-header.tsx"
click node_group_api "https://github.com/praveenrampk/secret-santa/blob/main/server/src/group/group.controller.ts"
click node_group_service "https://github.com/praveenrampk/secret-santa/blob/main/server/src/group/group.service.ts"
click node_group_repo "https://github.com/praveenrampk/secret-santa/blob/main/server/src/group/repositories/group.repository.ts"
click node_group_store "https://github.com/praveenrampk/secret-santa/blob/main/server/src/group/schemas/group.schema.ts"
click node_membership_repo "https://github.com/praveenrampk/secret-santa/blob/main/server/src/group/repositories/group-member.repository.ts"
click node_membership_store "https://github.com/praveenrampk/secret-santa/blob/main/server/src/group/schemas/group-member.schema.ts"
click node_wishlist_ui "https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/member/profile/wishlists/page.tsx"
click node_wishlist_api "https://github.com/praveenrampk/secret-santa/blob/main/server/src/wish-list/wish-list.controller.ts"
click node_wishlist_service "https://github.com/praveenrampk/secret-santa/blob/main/server/src/wish-list/wish-list.service.ts"
click node_wishlist_repo "https://github.com/praveenrampk/secret-santa/blob/main/server/src/wish-list/repositories/wish-list.repository.ts"
click node_wishlist_store "https://github.com/praveenrampk/secret-santa/blob/main/server/src/wish-list/schemas/wish-list.schema.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_group_list,node_group_members_ui,node_group_header,node_wishlist_ui toneBlue
class node_signin,node_signup,node_profile,node_member_api,node_member_service,node_member_repo,node_member_store toneAmber
class node_group_api,node_group_service,node_group_repo,node_group_store,node_membership_repo,node_membership_store toneMint
class node_wishlist_api,node_wishlist_service,node_wishlist_repo,node_wishlist_store,node_match_allocation,node_live_updates toneRose
class node_member toneIndigo
```

## Components

### Web experience

- [Group dashboard](https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/dashboard/page.tsx): `client/src/app/dashboard/page.tsx`
- [Group listing](https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/group/page.tsx): `client/src/app/group/page.tsx`
- [Member roster](https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/group/%5BgroupID%5D/members/group-members-client.tsx): `client/src/app/group/[groupID]/members/group-members-client.tsx`
- [Group controls](https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/group/%5BgroupID%5D/group-header.tsx): `client/src/app/group/[groupID]/group-header.tsx`
- [Wishlist pages](https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/member/profile/wishlists/page.tsx): `client/src/app/member/profile/wishlists/page.tsx`

### Member accounts

- [Sign in](https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/signin/page.tsx): `client/src/app/signin/page.tsx`
- [Sign up](https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/signup/page.tsx): `client/src/app/signup/page.tsx`
- [Member profile](https://github.com/praveenrampk/secret-santa/blob/main/client/src/app/member/profile/basic-details/page.tsx): `client/src/app/member/profile/basic-details/page.tsx`
- [Member API](https://github.com/praveenrampk/secret-santa/blob/main/server/src/member/member.controller.ts): `server/src/member/member.controller.ts`
- [Member service](https://github.com/praveenrampk/secret-santa/blob/main/server/src/member/member.service.ts): `server/src/member/member.service.ts`
- [Member repository](https://github.com/praveenrampk/secret-santa/blob/main/server/src/member/repositories/member.repository.ts): `server/src/member/repositories/member.repository.ts`
- [Member records](https://github.com/praveenrampk/secret-santa/blob/main/server/src/member/schemas/member.schema.ts): `server/src/member/schemas/member.schema.ts`

### Group management

- [Group API](https://github.com/praveenrampk/secret-santa/blob/main/server/src/group/group.controller.ts): `server/src/group/group.controller.ts`
- [Group service](https://github.com/praveenrampk/secret-santa/blob/main/server/src/group/group.service.ts): `server/src/group/group.service.ts`
- [Group repository](https://github.com/praveenrampk/secret-santa/blob/main/server/src/group/repositories/group.repository.ts): `server/src/group/repositories/group.repository.ts`
- [Group records](https://github.com/praveenrampk/secret-santa/blob/main/server/src/group/schemas/group.schema.ts): `server/src/group/schemas/group.schema.ts`
- [Membership repository](https://github.com/praveenrampk/secret-santa/blob/main/server/src/group/repositories/group-member.repository.ts): `server/src/group/repositories/group-member.repository.ts`
- [Membership records](https://github.com/praveenrampk/secret-santa/blob/main/server/src/group/schemas/group-member.schema.ts): `server/src/group/schemas/group-member.schema.ts`

### Gift exchange

- [Wishlist API](https://github.com/praveenrampk/secret-santa/blob/main/server/src/wish-list/wish-list.controller.ts): `server/src/wish-list/wish-list.controller.ts`
- [Wishlist service](https://github.com/praveenrampk/secret-santa/blob/main/server/src/wish-list/wish-list.service.ts): `server/src/wish-list/wish-list.service.ts`
- [Wishlist repository](https://github.com/praveenrampk/secret-santa/blob/main/server/src/wish-list/repositories/wish-list.repository.ts): `server/src/wish-list/repositories/wish-list.repository.ts`
- [Wishlist records](https://github.com/praveenrampk/secret-santa/blob/main/server/src/wish-list/schemas/wish-list.schema.ts): `server/src/wish-list/schemas/wish-list.schema.ts`
- **Match allocation**
- **Exchange updates**

### Other components

- **Member**

## Connections

- Member → Sign in: signs in
- Member → Sign up: registers
- Member → Group dashboard: views groups
- Member → Member profile: manages profile
- Sign in → Member API: authenticates
- Sign up → Member API: registers
- Member profile → Member API: updates account
- Member API → Member service: delegates (evidence: `server/src/member/member.controller.ts`)
- Member service → Member repository: queries (evidence: `server/src/member/member.service.ts`)
- Member repository → Member records: persists (evidence: `server/src/member/repositories/member.repository.ts`)
- Group dashboard → Group listing: opens groups
- Group listing → Group API: loads groups
- Member roster → Group API: fetches roster (evidence: `client/src/app/group/[groupID]/members/group-members-client.tsx`)
- Group API → Group service: delegates (evidence: `server/src/group/group.controller.ts`)
- Group service → Group repository: queries groups (evidence: `server/src/group/group.service.ts`)
- Group service → Member repository: looks up members (evidence: `server/src/group/group.service.ts`)
- Group service → Membership repository: manages membership (evidence: `server/src/group/group.service.ts`)
- Group repository → Group records: persists (evidence: `server/src/group/repositories/group.repository.ts`)
- Membership repository → Membership records: persists (evidence: `server/src/group/repositories/group-member.repository.ts`)
- Group controls → Member roster: renders (evidence: `client/src/app/group/[groupID]/group-header.tsx`)
- Wishlist pages → Wishlist API: manages lists
- Wishlist API → Wishlist service: delegates (evidence: `server/src/wish-list/wish-list.controller.ts`)
- Wishlist service → Wishlist repository: queries lists (evidence: `server/src/wish-list/wish-list.service.ts`)
- Wishlist service → Group repository: checks group (evidence: `server/src/wish-list/wish-list.service.ts`)
- Wishlist service → Membership repository: checks member (evidence: `server/src/wish-list/wish-list.service.ts`)
- Wishlist repository → Wishlist records: persists (evidence: `server/src/wish-list/repositories/wish-list.repository.ts`)
- Member → Match allocation: joins exchange
- Match allocation → Exchange updates: publishes status
