# varunhunakunti2-crypto/padhaanewala_education architecture

> Architecture diagram of the GitHub repository varunhunakunti2-crypto/padhaanewala_education, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/varunhunakunti2-crypto/padhaanewala_education
- Repository: https://github.com/varunhunakunti2-crypto/padhaanewala_education

## Overview

Padhaanewala is an Indian student education and admissions platform. Students explore colleges, courses, exams and scholarships, use planning and prediction tools, take browser-based mock tests, and seek admissions help; staff manage catalogue and engagement content. The tree shows distinct frontend and FastAPI backend areas. The sampled sources confirm backend route registration, review persistence, session-token bookkeeping, mock-test browser-only behavior, and AI/statistics endpoints. README content is empty, and most frontend/backend wiring was not sampled, so uncertain connections are omitted.

Main entry points: [`padhaanewala/frontend/app`](https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/app) (Education pages), [`padhaanewala/frontend/app/api/ai/route.ts`](https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/frontend/app/api/ai/route.ts) (AI assistant), [`padhaanewala/backend/app/services/session_service.py`](https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/backend/app/services/session_service.py) (Session ledger), [`padhaanewala/frontend/frontend/components/college`](https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/college) (College discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_student["Student discovery"]
  node_webpages["Education pages"]
  node_college_catalog["College discovery"]
  node_course_catalog["Courses and exams"]
  node_compare["College comparison"]
  node_scholarships["Scholarships"]
end

subgraph group_tools["Student tools"]
  node_predictor["College predictor"]
  node_planner["Exam planner"]
  node_mock_tests["Mock tests<br/>[MockTestEngine.tsx]"]
  node_app_context["Student state<br/>[AppContext.tsx]"]
  node_ai_chat["AI assistant<br/>[route.ts]"]
end

subgraph group_engagement["Admissions engagement"]
  node_admissions["Admissions help"]
  node_reviews["College reviews<br/>[reviews.py]"]
  node_blogs["Education content"]
end

subgraph group_backend["Backend services"]
  node_backend_app["FastAPI application<br/>[main.py]"]
  node_routers["API routers"]
  node_session_service["Session ledger<br/>[session_service.py]"]
  node_refresh_tokens[("Refresh-token records<br/>[refresh_token.py]")]
  node_database[("Application database<br/>[database.py]")]
  node_backend_stats["Backend statistics<br/>[stats.py]"]
end

subgraph group_operations["Platform operations"]
  node_admin["Content administration"]
  node_stats_route["Catalog statistics<br/>[route.ts]"]
end

node_student(("Student"))
node_openai["OpenAI"]
node_backend_api["Backend API"]

node_student -->|"browses"| node_webpages
node_webpages -->|"opens"| node_college_catalog
node_webpages -->|"opens"| node_course_catalog
node_webpages -->|"opens"| node_compare
node_webpages -->|"opens"| node_scholarships
node_webpages -->|"opens"| node_predictor
node_webpages -->|"opens"| node_planner
node_webpages -->|"opens"| node_mock_tests
node_webpages -->|"asks"| node_ai_chat
node_webpages -->|"seeks help"| node_admissions
node_webpages -->|"reads"| node_blogs
node_mock_tests -->|"reads history"| node_app_context
node_college_catalog -->|"updates saved list"| node_app_context
node_ai_chat -.->|"requests reply"| node_openai
node_ai_chat -->|"uses offline reply"| node_backend_api
node_backend_app -->|"registers routes"| node_routers
node_reviews -->|"reads and writes"| node_database
node_session_service -->|"records tokens"| node_refresh_tokens
node_session_service -->|"updates ledger"| node_database
node_stats_route -->|"requests counts"| node_backend_api
node_backend_api -->|"serves catalog counts"| node_backend_stats
node_admin -->|"loads statistics"| node_stats_route

click node_webpages "https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/app"
click node_college_catalog "https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/college"
click node_course_catalog "https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/app/courses"
click node_compare "https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/compare"
click node_scholarships "https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/scholarships"
click node_predictor "https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/predictor"
click node_planner "https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/planner"
click node_mock_tests "https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/frontend/frontend/components/mocktests/MockTestEngine.tsx"
click node_app_context "https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/frontend/lib/context/AppContext.tsx"
click node_ai_chat "https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/frontend/app/api/ai/route.ts"
click node_admissions "https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/admission"
click node_reviews "https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/backend/app/routers/reviews.py"
click node_blogs "https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/app/blog"
click node_admin "https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/admin"
click node_backend_app "https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/backend/app/main.py"
click node_routers "https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/backend/app/routers"
click node_session_service "https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/backend/app/services/session_service.py"
click node_refresh_tokens "https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/backend/app/models/refresh_token.py"
click node_database "https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/backend/app/database.py"
click node_stats_route "https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/frontend/app/api/stats/route.ts"
click node_backend_stats "https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/backend/app/routers/stats.py"

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_webpages,node_college_catalog,node_course_catalog,node_compare,node_scholarships toneBlue
class node_predictor,node_planner,node_mock_tests,node_app_context,node_ai_chat toneAmber
class node_admissions,node_reviews,node_blogs,node_backend_api toneMint
class node_backend_app,node_routers,node_session_service,node_refresh_tokens,node_database,node_backend_stats toneRose
class node_admin,node_stats_route,node_student,node_openai toneIndigo
```

## Components

### Student discovery

- [Education pages](https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/app): `padhaanewala/frontend/app`
- [College discovery](https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/college): `padhaanewala/frontend/frontend/components/college`
- [Courses and exams](https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/app/courses): `padhaanewala/frontend/app/courses`
- [College comparison](https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/compare): `padhaanewala/frontend/frontend/components/compare`
- [Scholarships](https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/scholarships): `padhaanewala/frontend/frontend/components/scholarships`

### Student tools

- [College predictor](https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/predictor): `padhaanewala/frontend/frontend/components/predictor`
- [Exam planner](https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/planner): `padhaanewala/frontend/frontend/components/planner`
- [Mock tests](https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/frontend/frontend/components/mocktests/MockTestEngine.tsx): `padhaanewala/frontend/frontend/components/mocktests/MockTestEngine.tsx`
- [Student state](https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/frontend/lib/context/AppContext.tsx): `padhaanewala/frontend/lib/context/AppContext.tsx`
- [AI assistant](https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/frontend/app/api/ai/route.ts): `padhaanewala/frontend/app/api/ai/route.ts`

### Admissions engagement

- [Admissions help](https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/admission): `padhaanewala/frontend/frontend/components/admission`
- [College reviews](https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/backend/app/routers/reviews.py): `padhaanewala/backend/app/routers/reviews.py`
- [Education content](https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/app/blog): `padhaanewala/frontend/app/blog`

### Backend services

- [FastAPI application](https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/backend/app/main.py): `padhaanewala/backend/app/main.py`
- [API routers](https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/backend/app/routers): `padhaanewala/backend/app/routers`
- [Session ledger](https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/backend/app/services/session_service.py): `padhaanewala/backend/app/services/session_service.py`
- [Refresh-token records](https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/backend/app/models/refresh_token.py): `padhaanewala/backend/app/models/refresh_token.py`
- [Application database](https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/backend/app/database.py): `padhaanewala/backend/app/database.py`
- [Backend statistics](https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/backend/app/routers/stats.py): `padhaanewala/backend/app/routers/stats.py`

### Platform operations

- [Content administration](https://github.com/varunhunakunti2-crypto/padhaanewala_education/tree/main/padhaanewala/frontend/frontend/components/admin): `padhaanewala/frontend/frontend/components/admin`
- [Catalog statistics](https://github.com/varunhunakunti2-crypto/padhaanewala_education/blob/main/padhaanewala/frontend/app/api/stats/route.ts): `padhaanewala/frontend/app/api/stats/route.ts`

### Other components

- **Student**
- **OpenAI**
- **Backend API**

## Connections

- Student → Education pages: browses
- Education pages → College discovery: opens
- Education pages → Courses and exams: opens
- Education pages → College comparison: opens
- Education pages → Scholarships: opens
- Education pages → College predictor: opens
- Education pages → Exam planner: opens
- Education pages → Mock tests: opens
- Education pages → AI assistant: asks
- Education pages → Admissions help: seeks help
- Education pages → Education content: reads
- Mock tests → Student state: reads history
- College discovery → Student state: updates saved list
- AI assistant → OpenAI: requests reply
- AI assistant → Backend API: uses offline reply
- FastAPI application → API routers: registers routes
- College reviews → Application database: reads and writes
- Session ledger → Refresh-token records: records tokens
- Session ledger → Application database: updates ledger
- Catalog statistics → Backend API: requests counts
- Backend API → Backend statistics: serves catalog counts
- Content administration → Catalog statistics: loads statistics