# purshottambirle22-dot/codestride architecture

> Architecture diagram of the GitHub repository purshottambirle22-dot/codestride, 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/purshottambirle22-dot/codestride
- Repository: https://github.com/purshottambirle22-dot/codestride

## Overview

CodeStride is a coding-practice tracker: users explore topics, patterns, and questions, record solving progress, and review personal and competitive statistics. The frontend’s app shell selects the major product pages; backend service excerpts show catalog enrichment, progress updates, points, and leaderboard calculations. The tree documents additional profile and admin capabilities. Backend controller wiring and several frontend page/API connections were not sampled, so those relationships are omitted rather than inferred.

Main entry points: [`codestride-frontend/src/App.tsx`](https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/App.tsx) (App shell), [`src/main/java/com/codestride/leaderboard/service/LeaderboardService.java`](https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/leaderboard/service/LeaderboardService.java) (Leaderboard service), [`src/main/java/com/codestride/scoring/service/PointsService.java`](https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/scoring/service/PointsService.java) (Points service), [`codestride-frontend/src/api/client.ts`](https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/api/client.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Frontend experience"]
  node_app["App shell<br/>[App.tsx]"]
  node_authui["Auth context<br/>[AuthContext.tsx]"]
  node_api["API client<br/>[client.ts]"]
  node_topicspage["Topics pages<br/>[TopicsPage.tsx]"]
  node_patternpage["Pattern pages"]
  node_questionspage["Questions page<br/>[QuestionsPage.tsx]"]
  node_dashboardpage["Dashboard page<br/>[DashboardPage.tsx]"]
  node_adminpage["Admin page<br/>[AdminPage.tsx]"]
  node_leaderboardpage["Leaderboard page"]
  node_profilepage["Profile page<br/>[ProfilePage.tsx]"]
end

subgraph group_learning["Learning catalog"]
  node_catalog["Catalog services"]
  node_catalogdata[("Catalog data<br/>[Pattern.java]")]
end

subgraph group_identity["Identity and profile"]
  node_authservice["Authentication<br/>[AuthService.java]"]
  node_users[("User records<br/>[User.java]")]
end

subgraph group_engagement["Progress and scoring"]
  node_progress["Question progress"]
  node_progressdata[("Progress records")]
  node_points["Points service<br/>[PointsService.java]"]
  node_ledger[("Points ledger<br/>[PointsLedger.java]")]
end

subgraph group_insights["Insights and administration"]
  node_dashboard["Dashboard service"]
  node_leaderboard["Leaderboard service"]
  node_admin["Admin service<br/>[AdminService.java]"]
end

node_learner(("Learner"))

node_learner -->|"uses"| node_app
node_app -->|"wraps"| node_authui
node_app -->|"renders"| node_topicspage
node_app -->|"renders"| node_patternpage
node_app -->|"renders"| node_questionspage
node_app -->|"renders"| node_dashboardpage
node_app -->|"renders"| node_leaderboardpage
node_app -->|"renders"| node_profilepage
node_app -->|"renders"| node_adminpage
node_app -->|"requests dashboard"| node_api
node_authui -->|"uses"| node_api
node_authservice -->|"reads and writes"| node_users
node_authservice -.->|"serves authentication requests"| node_api
node_catalog -->|"uses catalog records"| node_catalogdata
node_progress -->|"reads and writes"| node_progressdata
node_progress -->|"awards points"| node_points
node_points -->|"reads ledger"| node_ledger
node_dashboard -->|"uses totals"| node_points
node_dashboard -->|"uses rank"| node_leaderboard
node_leaderboard -->|"aggregates points"| node_ledger
node_leaderboard -->|"reads users"| node_users
node_admin -->|"reads user records"| node_users

click node_app "https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/App.tsx"
click node_authui "https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/context/AuthContext.tsx"
click node_api "https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/api/client.ts"
click node_topicspage "https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/pages/TopicsPage.tsx"
click node_patternpage "https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/pages/PatternDetailPage.tsx"
click node_questionspage "https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/pages/QuestionsPage.tsx"
click node_dashboardpage "https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/pages/DashboardPage.tsx"
click node_catalog "https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/catalog/service/PatternService.java"
click node_catalogdata "https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/catalog/entity/Pattern.java"
click node_authservice "https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/auth/service/AuthService.java"
click node_users "https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/user/entity/User.java"
click node_progress "https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/progress/service/QuestionProgressService.java"
click node_progressdata "https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/progress/entity/QuestionProgress.java"
click node_points "https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/scoring/service/PointsService.java"
click node_ledger "https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/scoring/entity/PointsLedger.java"
click node_dashboard "https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/dashboard/service/DashboardService.java"
click node_leaderboard "https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/leaderboard/service/LeaderboardService.java"
click node_admin "https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/admin/service/AdminService.java"
click node_adminpage "https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/pages/AdminPage.tsx"
click node_leaderboardpage "https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/pages/LeaderboardPage.tsx"
click node_profilepage "https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/pages/ProfilePage.tsx"

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_app,node_authui,node_api,node_topicspage,node_patternpage,node_questionspage,node_dashboardpage,node_adminpage,node_leaderboardpage,node_profilepage toneBlue
class node_catalog,node_catalogdata toneAmber
class node_authservice,node_users toneMint
class node_progress,node_progressdata,node_points,node_ledger toneRose
class node_dashboard,node_leaderboard,node_admin,node_learner toneIndigo
```

## Components

### Frontend experience

- [App shell](https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/App.tsx): `codestride-frontend/src/App.tsx`
- [Auth context](https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/context/AuthContext.tsx): `codestride-frontend/src/context/AuthContext.tsx`
- [API client](https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/api/client.ts): `codestride-frontend/src/api/client.ts`
- [Topics pages](https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/pages/TopicsPage.tsx): `codestride-frontend/src/pages/TopicsPage.tsx`
- [Pattern pages](https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/pages/PatternDetailPage.tsx): `codestride-frontend/src/pages/PatternDetailPage.tsx`
- [Questions page](https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/pages/QuestionsPage.tsx): `codestride-frontend/src/pages/QuestionsPage.tsx`
- [Dashboard page](https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/pages/DashboardPage.tsx): `codestride-frontend/src/pages/DashboardPage.tsx`
- [Admin page](https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/pages/AdminPage.tsx): `codestride-frontend/src/pages/AdminPage.tsx`
- [Leaderboard page](https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/pages/LeaderboardPage.tsx): `codestride-frontend/src/pages/LeaderboardPage.tsx`
- [Profile page](https://github.com/purshottambirle22-dot/codestride/blob/main/codestride-frontend/src/pages/ProfilePage.tsx): `codestride-frontend/src/pages/ProfilePage.tsx`

### Learning catalog

- [Catalog services](https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/catalog/service/PatternService.java): `src/main/java/com/codestride/catalog/service/PatternService.java`
- [Catalog data](https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/catalog/entity/Pattern.java): `src/main/java/com/codestride/catalog/entity/Pattern.java`

### Identity and profile

- [Authentication](https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/auth/service/AuthService.java): `src/main/java/com/codestride/auth/service/AuthService.java`
- [User records](https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/user/entity/User.java): `src/main/java/com/codestride/user/entity/User.java`

### Progress and scoring

- [Question progress](https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/progress/service/QuestionProgressService.java): `src/main/java/com/codestride/progress/service/QuestionProgressService.java`
- [Progress records](https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/progress/entity/QuestionProgress.java): `src/main/java/com/codestride/progress/entity/QuestionProgress.java`
- [Points service](https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/scoring/service/PointsService.java): `src/main/java/com/codestride/scoring/service/PointsService.java`
- [Points ledger](https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/scoring/entity/PointsLedger.java): `src/main/java/com/codestride/scoring/entity/PointsLedger.java`

### Insights and administration

- [Dashboard service](https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/dashboard/service/DashboardService.java): `src/main/java/com/codestride/dashboard/service/DashboardService.java`
- [Leaderboard service](https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/leaderboard/service/LeaderboardService.java): `src/main/java/com/codestride/leaderboard/service/LeaderboardService.java`
- [Admin service](https://github.com/purshottambirle22-dot/codestride/blob/main/src/main/java/com/codestride/admin/service/AdminService.java): `src/main/java/com/codestride/admin/service/AdminService.java`

### Other components

- **Learner**

## Connections

- Learner → App shell: uses (evidence: `codestride-frontend/src/App.tsx`)
- App shell → Auth context: wraps (evidence: `codestride-frontend/src/App.tsx`)
- App shell → Topics pages: renders (evidence: `codestride-frontend/src/App.tsx`)
- App shell → Pattern pages: renders (evidence: `codestride-frontend/src/App.tsx`)
- App shell → Questions page: renders (evidence: `codestride-frontend/src/App.tsx`)
- App shell → Dashboard page: renders (evidence: `codestride-frontend/src/App.tsx`)
- App shell → Leaderboard page: renders (evidence: `codestride-frontend/src/App.tsx`)
- App shell → Profile page: renders (evidence: `codestride-frontend/src/App.tsx`)
- App shell → Admin page: renders (evidence: `codestride-frontend/src/App.tsx`)
- App shell → API client: requests dashboard (evidence: `codestride-frontend/src/App.tsx`)
- Auth context → API client: uses (evidence: `codestride-frontend/src/context/AuthContext.tsx`)
- Authentication → User records: reads and writes (evidence: `src/main/java/com/codestride/auth/service/AuthService.java`)
- Authentication → API client: serves authentication requests
- Catalog services → Catalog data: uses catalog records (evidence: `src/main/java/com/codestride/catalog/service/PatternService.java`)
- Question progress → Progress records: reads and writes (evidence: `src/main/java/com/codestride/progress/service/QuestionProgressService.java`)
- Question progress → Points service: awards points (evidence: `src/main/java/com/codestride/progress/service/QuestionProgressService.java`)
- Points service → Points ledger: reads ledger (evidence: `src/main/java/com/codestride/scoring/service/PointsService.java`)
- Dashboard service → Points service: uses totals (evidence: `src/main/java/com/codestride/dashboard/service/DashboardService.java`)
- Dashboard service → Leaderboard service: uses rank (evidence: `src/main/java/com/codestride/dashboard/service/DashboardService.java`)
- Leaderboard service → Points ledger: aggregates points (evidence: `src/main/java/com/codestride/leaderboard/service/LeaderboardService.java`)
- Leaderboard service → User records: reads users (evidence: `src/main/java/com/codestride/leaderboard/service/LeaderboardService.java`)
- Admin service → User records: reads user records (evidence: `src/main/java/com/codestride/admin/service/AdminService.java`)
