# open-sourcery-umd/website architecture

> Architecture diagram of the GitHub repository open-sourcery-umd/website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/open-sourcery-umd/website
- Repository: https://github.com/open-sourcery-umd/website

## Overview

Open Sourcery’s Next.js site is a club community hub for discovering projects, forming teams, tracking engagement, and following events. Members create and manage project proposals, join teams, and see GitHub-backed project information; account and profile features support that workflow, while gems and events provide engagement tracking. The graph includes documented capabilities whose implementation was not sampled, but omits speculative links between them. Edges are limited to relationships visible in excerpts, the source index, or the README.

Main entry points: [`src/app/api/projects/route.ts`](https://github.com/open-sourcery-umd/website/blob/main/src/app/api/projects/route.ts) (Project API), [`src/app`](https://github.com/open-sourcery-umd/website/tree/main/src/app) (Website pages), [`src/lib/projectService.ts`](https://github.com/open-sourcery-umd/website/blob/main/src/lib/projectService.ts) (Project service), [`src/lib/apiClient.ts`](https://github.com/open-sourcery-umd/website/blob/main/src/lib/apiClient.ts) (Authorized API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Site experience"]
  node_site["Website pages"]
  node_guides["Developer guides"]
end

subgraph group_projects["Projects and teams"]
  node_project_views["Project views"]
  node_project_ui["Project dashboard"]
  node_project_service["Project service<br/>[projectService.ts]"]
  node_member_actions["Member actions<br/>[memberActions.ts]"]
  node_projects_store[("Project records<br/>[firebaseAdmin.ts]")]
  node_github_service["GitHub service<br/>[githubService.ts]"]
  node_github_api["GitHub operations<br/>[githubApi.ts]"]
end

subgraph group_accounts["Accounts and APIs"]
  node_project_api["Project API<br/>[route.ts]"]
  node_github_api_route["GitHub API route<br/>[route.ts]"]
  node_auth["Authentication context<br/>[AuthContext.tsx]"]
  node_api_client["Authorized API client<br/>[apiClient.ts]"]
  node_request_auth["Request authentication<br/>[requestAuth.ts]"]
  node_profiles_api["Profiles API<br/>[route.ts]"]
  node_profiles["Profile operations<br/>[profiles.ts]"]
  node_users["User service<br/>[userService.ts]"]
  node_event_api["Events API<br/>[route.ts]"]
  node_gem_api["Gems API<br/>[route.ts]"]
  node_discord_api_route["Discord API route<br/>[route.ts]"]
end

subgraph group_engagement["Community engagement"]
  node_events["Event experience<br/>[EventsCalendar.tsx]"]
  node_event_context["Event context<br/>[EventContext.tsx]"]
  node_event_service["Event service<br/>[eventService.ts]"]
  node_gems["Gem tracking<br/>[gems.ts]"]
  node_gem_ui["Gem leaderboard<br/>[GemLeaderboard.tsx]"]
  node_discord_sync["Discord sync<br/>[discordSync.ts]"]
end

node_visitor(("Visitor or member"))
node_github{{"GitHub"}}
node_firebase[("Firebase")]
node_discord{{"Discord"}}

node_visitor -->|"visits"| node_site
node_site -->|"discovers projects"| node_project_views
node_project_views -.->|"shows teams"| node_project_ui
node_project_ui -->|"uses"| node_project_service
node_project_service -->|"requests actions"| node_project_api
node_project_api -->|"authenticates"| node_request_auth
node_project_api -->|"dispatches actions"| node_member_actions
node_member_actions -->|"reads and updates"| node_projects_store
node_project_ui -->|"loads GitHub data"| node_github_service
node_project_service -->|"loads membership"| node_github_service
node_github_service -->|"requests data"| node_github_api_route
node_github_api_route -->|"calls"| node_github_api
node_member_actions -->|"manages access"| node_github_api
node_github_api -->|"reads and changes"| node_github
node_project_service -->|"sends authorized requests"| node_api_client
node_api_client -->|"gets current user token"| node_auth
node_api_client -->|"sends requests"| node_project_api
node_project_api -->|"verifies caller"| node_request_auth
node_request_auth -->|"verifies tokens"| node_firebase
node_profiles_api -->|"authenticates"| node_request_auth
node_profiles_api -->|"dispatches profile actions"| node_profiles
node_users -->|"sends requests"| node_api_client
node_site -.->|"follows club events"| node_events
node_events -.->|"uses"| node_event_context
node_event_context -->|"loads events"| node_event_service
node_event_service -->|"requests events"| node_event_api
node_gem_api -->|"dispatches gem actions"| node_gems
node_gem_ui -.->|"shows engagement"| node_gems
node_site -.->|"offers guidance"| node_guides
node_discord_api_route -->|"invites member"| node_discord_sync
node_discord_sync -->|"syncs membership"| node_discord

click node_site "https://github.com/open-sourcery-umd/website/tree/main/src/app"
click node_project_views "https://github.com/open-sourcery-umd/website/tree/main/src/app/our-projects"
click node_project_ui "https://github.com/open-sourcery-umd/website/blob/main/src/components/project/ProjectDashboard.tsx"
click node_project_service "https://github.com/open-sourcery-umd/website/blob/main/src/lib/projectService.ts"
click node_project_api "https://github.com/open-sourcery-umd/website/blob/main/src/app/api/projects/route.ts"
click node_member_actions "https://github.com/open-sourcery-umd/website/blob/main/src/lib/server/memberActions.ts"
click node_projects_store "https://github.com/open-sourcery-umd/website/blob/main/src/lib/server/firebaseAdmin.ts"
click node_github_service "https://github.com/open-sourcery-umd/website/blob/main/src/lib/githubService.ts"
click node_github_api_route "https://github.com/open-sourcery-umd/website/blob/main/src/app/api/github/route.ts"
click node_github_api "https://github.com/open-sourcery-umd/website/blob/main/src/lib/githubApi.ts"
click node_auth "https://github.com/open-sourcery-umd/website/blob/main/src/context/AuthContext.tsx"
click node_api_client "https://github.com/open-sourcery-umd/website/blob/main/src/lib/apiClient.ts"
click node_request_auth "https://github.com/open-sourcery-umd/website/blob/main/src/lib/server/requestAuth.ts"
click node_profiles_api "https://github.com/open-sourcery-umd/website/blob/main/src/app/api/profiles/route.ts"
click node_profiles "https://github.com/open-sourcery-umd/website/blob/main/src/lib/server/profiles.ts"
click node_users "https://github.com/open-sourcery-umd/website/blob/main/src/lib/userService.ts"
click node_events "https://github.com/open-sourcery-umd/website/blob/main/src/components/EventsCalendar.tsx"
click node_event_context "https://github.com/open-sourcery-umd/website/blob/main/src/context/EventContext.tsx"
click node_event_service "https://github.com/open-sourcery-umd/website/blob/main/src/lib/eventService.ts"
click node_event_api "https://github.com/open-sourcery-umd/website/blob/main/src/app/api/events/route.ts"
click node_gems "https://github.com/open-sourcery-umd/website/blob/main/src/lib/server/gems.ts"
click node_gem_api "https://github.com/open-sourcery-umd/website/blob/main/src/app/api/gems/route.ts"
click node_gem_ui "https://github.com/open-sourcery-umd/website/blob/main/src/components/GemLeaderboard.tsx"
click node_guides "https://github.com/open-sourcery-umd/website/tree/main/src/app/guides"
click node_discord_api_route "https://github.com/open-sourcery-umd/website/blob/main/src/app/api/discord/route.ts"
click node_discord_sync "https://github.com/open-sourcery-umd/website/blob/main/src/lib/server/discordSync.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_site,node_guides toneBlue
class node_project_views,node_project_ui,node_project_service,node_member_actions,node_projects_store,node_github_service,node_github_api,node_firebase toneAmber
class node_project_api,node_github_api_route,node_auth,node_api_client,node_request_auth,node_profiles_api,node_profiles,node_users,node_event_api,node_gem_api,node_discord_api_route toneMint
class node_events,node_event_context,node_event_service,node_gems,node_gem_ui,node_discord_sync toneRose
class node_visitor,node_github,node_discord toneIndigo
```

## Components

### Site experience

- [Website pages](https://github.com/open-sourcery-umd/website/tree/main/src/app): `src/app`
- [Developer guides](https://github.com/open-sourcery-umd/website/tree/main/src/app/guides): `src/app/guides`

### Projects and teams

- [Project views](https://github.com/open-sourcery-umd/website/tree/main/src/app/our-projects): `src/app/our-projects`
- [Project dashboard](https://github.com/open-sourcery-umd/website/blob/main/src/components/project/ProjectDashboard.tsx): `src/components/project/ProjectDashboard.tsx`
- [Project service](https://github.com/open-sourcery-umd/website/blob/main/src/lib/projectService.ts): `src/lib/projectService.ts`
- [Member actions](https://github.com/open-sourcery-umd/website/blob/main/src/lib/server/memberActions.ts): `src/lib/server/memberActions.ts`
- [Project records](https://github.com/open-sourcery-umd/website/blob/main/src/lib/server/firebaseAdmin.ts): `src/lib/server/firebaseAdmin.ts`
- [GitHub service](https://github.com/open-sourcery-umd/website/blob/main/src/lib/githubService.ts): `src/lib/githubService.ts`
- [GitHub operations](https://github.com/open-sourcery-umd/website/blob/main/src/lib/githubApi.ts): `src/lib/githubApi.ts`

### Accounts and APIs

- [Project API](https://github.com/open-sourcery-umd/website/blob/main/src/app/api/projects/route.ts): `src/app/api/projects/route.ts`
- [GitHub API route](https://github.com/open-sourcery-umd/website/blob/main/src/app/api/github/route.ts): `src/app/api/github/route.ts`
- [Authentication context](https://github.com/open-sourcery-umd/website/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Authorized API client](https://github.com/open-sourcery-umd/website/blob/main/src/lib/apiClient.ts): `src/lib/apiClient.ts`
- [Request authentication](https://github.com/open-sourcery-umd/website/blob/main/src/lib/server/requestAuth.ts): `src/lib/server/requestAuth.ts`
- [Profiles API](https://github.com/open-sourcery-umd/website/blob/main/src/app/api/profiles/route.ts): `src/app/api/profiles/route.ts`
- [Profile operations](https://github.com/open-sourcery-umd/website/blob/main/src/lib/server/profiles.ts): `src/lib/server/profiles.ts`
- [User service](https://github.com/open-sourcery-umd/website/blob/main/src/lib/userService.ts): `src/lib/userService.ts`
- [Events API](https://github.com/open-sourcery-umd/website/blob/main/src/app/api/events/route.ts): `src/app/api/events/route.ts`
- [Gems API](https://github.com/open-sourcery-umd/website/blob/main/src/app/api/gems/route.ts): `src/app/api/gems/route.ts`
- [Discord API route](https://github.com/open-sourcery-umd/website/blob/main/src/app/api/discord/route.ts): `src/app/api/discord/route.ts`

### Community engagement

- [Event experience](https://github.com/open-sourcery-umd/website/blob/main/src/components/EventsCalendar.tsx): `src/components/EventsCalendar.tsx`
- [Event context](https://github.com/open-sourcery-umd/website/blob/main/src/context/EventContext.tsx): `src/context/EventContext.tsx`
- [Event service](https://github.com/open-sourcery-umd/website/blob/main/src/lib/eventService.ts): `src/lib/eventService.ts`
- [Gem tracking](https://github.com/open-sourcery-umd/website/blob/main/src/lib/server/gems.ts): `src/lib/server/gems.ts`
- [Gem leaderboard](https://github.com/open-sourcery-umd/website/blob/main/src/components/GemLeaderboard.tsx): `src/components/GemLeaderboard.tsx`
- [Discord sync](https://github.com/open-sourcery-umd/website/blob/main/src/lib/server/discordSync.ts): `src/lib/server/discordSync.ts`

### Other components

- **Visitor or member**
- **GitHub**
- **Firebase**
- **Discord**

## Connections

- Visitor or member → Website pages: visits
- Website pages → Project views: discovers projects
- Project views → Project dashboard: shows teams
- Project dashboard → Project service: uses (evidence: `src/components/project/ProjectDashboard.tsx`)
- Project service → Project API: requests actions (evidence: `src/lib/projectService.ts`)
- Project API → Request authentication: authenticates (evidence: `src/app/api/projects/route.ts`)
- Project API → Member actions: dispatches actions (evidence: `src/app/api/projects/route.ts`)
- Member actions → Project records: reads and updates (evidence: `src/lib/server/memberActions.ts`)
- Project dashboard → GitHub service: loads GitHub data (evidence: `src/components/project/ProjectDashboard.tsx`)
- Project service → GitHub service: loads membership (evidence: `src/lib/projectService.ts`)
- GitHub service → GitHub API route: requests data (evidence: `src/lib/githubService.ts`)
- GitHub API route → GitHub operations: calls (evidence: `src/app/api/github/route.ts`)
- Member actions → GitHub operations: manages access (evidence: `src/lib/server/memberActions.ts`)
- GitHub operations → GitHub: reads and changes (evidence: `src/lib/githubApi.ts`)
- Project service → Authorized API client: sends authorized requests (evidence: `src/lib/projectService.ts`)
- Authorized API client → Authentication context: gets current user token (evidence: `src/lib/apiClient.ts`)
- Authorized API client → Project API: sends requests
- Project API → Request authentication: verifies caller (evidence: `src/app/api/projects/route.ts`)
- Request authentication → Firebase: verifies tokens (evidence: `src/lib/server/requestAuth.ts`)
- Profiles API → Request authentication: authenticates (evidence: `src/app/api/profiles/route.ts`)
- Profiles API → Profile operations: dispatches profile actions (evidence: `src/app/api/profiles/route.ts`)
- User service → Authorized API client: sends requests (evidence: `src/lib/userService.ts`)
- Website pages → Event experience: follows club events
- Event experience → Event context: uses
- Event context → Event service: loads events (evidence: `src/context/EventContext.tsx`)
- Event service → Events API: requests events (evidence: `src/lib/eventService.ts`)
- Gems API → Gem tracking: dispatches gem actions (evidence: `src/app/api/gems/route.ts`)
- Gem leaderboard → Gem tracking: shows engagement
- Website pages → Developer guides: offers guidance
- Discord API route → Discord sync: invites member (evidence: `src/app/api/discord/route.ts`)
- Discord sync → Discord: syncs membership (evidence: `src/lib/server/discordSync.ts`)
