# tahsinulislamsiam/admission-co-pilot architecture

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

- Interactive diagram: https://gitdiagram.com/tahsinulislamsiam/admission-co-pilot
- Repository: https://github.com/tahsinulislamsiam/admission-co-pilot

## Overview

This is a bilingual student admissions-guidance platform for Bangladesh, with student and administrator experiences. Students can manage accounts, explore and compare universities, get recommendations and assistant guidance, and take timed mock tests followed by results analysis. Administrators review questions and circulars and manage university records. The graph includes the client routing, feature-to-service calls, and server assistant modules supported by the source index or excerpts; several feature details and server API wiring are not sampled, so those links are omitted.

Main entry points: [`src/app/router.jsx`](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/app/router.jsx) (Role-based routing), [`src/lib/axios.js`](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/lib/axios.js) (HTTP client), [`src/features/assistant`](https://github.com/tahsinulislamsiam/admission-co-pilot/tree/main/src/features/assistant) (Guidance assistant), [`src/features/mock-tests/pages/TestEnginePage.jsx`](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/features/mock-tests/pages/TestEnginePage.jsx) (Timed test engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client shell"]
  node_app["App bootstrap<br/>[App.jsx]"]
  node_router["Role-based routing<br/>[router.jsx]"]
end

subgraph group_student["Student guidance"]
  node_auth["Account and profile"]
  node_dashboard["Student dashboard<br/>[DashboardPage.jsx]"]
  node_universities["University discovery"]
  node_recommendations["Admissions recommendations"]
  node_assistant["Guidance assistant"]
end

subgraph group_tests["Testing and analysis"]
  node_test_catalog["Mock test catalog<br/>[TestListPage.jsx]"]
  node_test_engine["Timed test engine<br/>[TestEnginePage.jsx]"]
  node_test_state["Attempt state<br/>[testEngineStore.js]"]
  node_results["Results analysis"]
end

subgraph group_admin["Administration"]
  node_admin_pages["Admin review and records"]
  node_admin_hooks["Admin data workflows<br/>[useAdmin.js]"]
end

subgraph group_services["Data and services"]
  node_auth_service["Authentication service<br/>[authService.js]"]
  node_test_service["Test service<br/>[testService.js]"]
  node_analysis_service["Analysis service<br/>[analysisService.js]"]
  node_university_service["University service"]
  node_recommendation_service["Recommendation service"]
  node_assistant_service["Assistant service"]
  node_admin_service["Admin service<br/>[adminService.js]"]
  node_api_client["HTTP client<br/>[axios.js]"]
  node_auth_state["Persistent session state<br/>[authStore.js]"]
  node_server_api["Server API<br/>[index.js]"]
  node_assistant_backend["Assistant backend<br/>[assistant.js]"]
end

node_student_actor(("Student"))
node_admin_actor(("Administrator"))

node_app -->|"mounts routes"| node_router
node_app -->|"revalidates session"| node_auth_service
node_student_actor -.->|"opens student routes"| node_router
node_admin_actor -.->|"opens admin routes"| node_router
node_router -->|"routes to"| node_auth
node_router -->|"routes to"| node_dashboard
node_router -->|"routes to"| node_universities
node_router -->|"routes to"| node_recommendations
node_router -->|"routes to"| node_assistant
node_router -->|"routes to"| node_test_catalog
node_router -->|"routes to"| node_test_engine
node_router -->|"routes to"| node_results
node_router -->|"routes to"| node_admin_pages
node_admin_pages -->|"uses workflows"| node_admin_hooks
node_admin_hooks -->|"calls"| node_admin_service
node_admin_hooks -->|"loads records"| node_university_service
node_test_engine -->|"reads and updates"| node_test_state
node_test_engine -->|"uses"| node_test_service
node_results -->|"loads test data"| node_test_service
node_results -->|"loads analysis"| node_analysis_service
node_universities -->|"loads university data"| node_university_service
node_recommendations -->|"requests recommendations"| node_recommendation_service
node_assistant -->|"requests assistance"| node_assistant_service
node_assistant -->|"uses assistant state"| node_auth_state
node_auth_service -->|"sends requests"| node_api_client
node_auth_service -->|"updates session"| node_auth_state
node_admin_service -->|"sends requests"| node_api_client
node_test_service -->|"sends requests"| node_api_client
node_university_service -->|"sends requests"| node_api_client
node_assistant_service -->|"sends requests"| node_api_client
node_api_client -->|"reads token"| node_auth_state
node_server_api -->|"uses assistant module"| node_assistant_backend

click node_app "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/app/App.jsx"
click node_router "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/app/router.jsx"
click node_auth "https://github.com/tahsinulislamsiam/admission-co-pilot/tree/main/src/features/auth"
click node_dashboard "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/features/dashboard/pages/DashboardPage.jsx"
click node_universities "https://github.com/tahsinulislamsiam/admission-co-pilot/tree/main/src/features/universities"
click node_recommendations "https://github.com/tahsinulislamsiam/admission-co-pilot/tree/main/src/features/recommendations"
click node_assistant "https://github.com/tahsinulislamsiam/admission-co-pilot/tree/main/src/features/assistant"
click node_test_catalog "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/features/mock-tests/pages/TestListPage.jsx"
click node_test_engine "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/features/mock-tests/pages/TestEnginePage.jsx"
click node_test_state "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/store/testEngineStore.js"
click node_results "https://github.com/tahsinulislamsiam/admission-co-pilot/tree/main/src/features/analysis"
click node_admin_pages "https://github.com/tahsinulislamsiam/admission-co-pilot/tree/main/src/features/admin/pages"
click node_admin_hooks "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/features/admin/hooks/useAdmin.js"
click node_auth_service "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/services/authService.js"
click node_test_service "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/services/testService.js"
click node_analysis_service "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/services/analysisService.js"
click node_university_service "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/services/universityService.js"
click node_recommendation_service "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/services/recommendationService.js"
click node_assistant_service "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/services/assistantService.js"
click node_admin_service "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/services/adminService.js"
click node_api_client "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/lib/axios.js"
click node_auth_state "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/store/authStore.js"
click node_server_api "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/server/index.js"
click node_assistant_backend "https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/server/assistant.js"

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_router toneBlue
class node_auth,node_dashboard,node_universities,node_recommendations,node_assistant toneAmber
class node_test_catalog,node_test_engine,node_test_state,node_results toneMint
class node_admin_pages,node_admin_hooks toneRose
class node_auth_service,node_test_service,node_analysis_service,node_university_service,node_recommendation_service,node_assistant_service,node_admin_service,node_api_client,node_auth_state,node_server_api,node_assistant_backend,node_student_actor,node_admin_actor toneIndigo
```

## Components

### Client shell

- [App bootstrap](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/app/App.jsx): `src/app/App.jsx`
- [Role-based routing](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/app/router.jsx): `src/app/router.jsx`

### Student guidance

- [Account and profile](https://github.com/tahsinulislamsiam/admission-co-pilot/tree/main/src/features/auth): `src/features/auth`
- [Student dashboard](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/features/dashboard/pages/DashboardPage.jsx): `src/features/dashboard/pages/DashboardPage.jsx`
- [University discovery](https://github.com/tahsinulislamsiam/admission-co-pilot/tree/main/src/features/universities): `src/features/universities`
- [Admissions recommendations](https://github.com/tahsinulislamsiam/admission-co-pilot/tree/main/src/features/recommendations): `src/features/recommendations`
- [Guidance assistant](https://github.com/tahsinulislamsiam/admission-co-pilot/tree/main/src/features/assistant): `src/features/assistant`

### Testing and analysis

- [Mock test catalog](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/features/mock-tests/pages/TestListPage.jsx): `src/features/mock-tests/pages/TestListPage.jsx`
- [Timed test engine](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/features/mock-tests/pages/TestEnginePage.jsx): `src/features/mock-tests/pages/TestEnginePage.jsx`
- [Attempt state](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/store/testEngineStore.js): `src/store/testEngineStore.js`
- [Results analysis](https://github.com/tahsinulislamsiam/admission-co-pilot/tree/main/src/features/analysis): `src/features/analysis`

### Administration

- [Admin review and records](https://github.com/tahsinulislamsiam/admission-co-pilot/tree/main/src/features/admin/pages): `src/features/admin/pages`
- [Admin data workflows](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/features/admin/hooks/useAdmin.js): `src/features/admin/hooks/useAdmin.js`

### Data and services

- [Authentication service](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/services/authService.js): `src/services/authService.js`
- [Test service](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/services/testService.js): `src/services/testService.js`
- [Analysis service](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/services/analysisService.js): `src/services/analysisService.js`
- [University service](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/services/universityService.js): `src/services/universityService.js`
- [Recommendation service](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/services/recommendationService.js): `src/services/recommendationService.js`
- [Assistant service](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/services/assistantService.js): `src/services/assistantService.js`
- [Admin service](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/services/adminService.js): `src/services/adminService.js`
- [HTTP client](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/lib/axios.js): `src/lib/axios.js`
- [Persistent session state](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/src/store/authStore.js): `src/store/authStore.js`
- [Server API](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/server/index.js): `server/index.js`
- [Assistant backend](https://github.com/tahsinulislamsiam/admission-co-pilot/blob/main/server/assistant.js): `server/assistant.js`

### Other components

- **Student**
- **Administrator**

## Connections

- App bootstrap → Role-based routing: mounts routes (evidence: `src/app/App.jsx`)
- App bootstrap → Authentication service: revalidates session (evidence: `src/app/App.jsx`)
- Student → Role-based routing: opens student routes
- Administrator → Role-based routing: opens admin routes
- Role-based routing → Account and profile: routes to (evidence: `src/app/router.jsx`)
- Role-based routing → Student dashboard: routes to (evidence: `src/app/router.jsx`)
- Role-based routing → University discovery: routes to (evidence: `src/app/router.jsx`)
- Role-based routing → Admissions recommendations: routes to (evidence: `src/app/router.jsx`)
- Role-based routing → Guidance assistant: routes to (evidence: `src/app/router.jsx`)
- Role-based routing → Mock test catalog: routes to (evidence: `src/app/router.jsx`)
- Role-based routing → Timed test engine: routes to (evidence: `src/app/router.jsx`)
- Role-based routing → Results analysis: routes to (evidence: `src/app/router.jsx`)
- Role-based routing → Admin review and records: routes to (evidence: `src/app/router.jsx`)
- Admin review and records → Admin data workflows: uses workflows (evidence: `src/features/admin/pages/CircularReviewPage.jsx`)
- Admin data workflows → Admin service: calls (evidence: `src/features/admin/hooks/useAdmin.js`)
- Admin data workflows → University service: loads records (evidence: `src/features/admin/hooks/useAdmin.js`)
- Timed test engine → Attempt state: reads and updates (evidence: `src/features/mock-tests/pages/TestEnginePage.jsx`)
- Timed test engine → Test service: uses (evidence: `src/features/mock-tests/pages/TestEnginePage.jsx`)
- Results analysis → Test service: loads test data (evidence: `src/features/analysis/hooks/useResult.js`)
- Results analysis → Analysis service: loads analysis (evidence: `src/features/analysis/hooks/useResult.js`)
- University discovery → University service: loads university data (evidence: `src/features/universities/hooks/useUniversities.js`)
- Admissions recommendations → Recommendation service: requests recommendations (evidence: `src/features/recommendations/hooks/useRecommendations.js`)
- Guidance assistant → Assistant service: requests assistance (evidence: `src/features/assistant/hooks/useAssistant.js`)
- Guidance assistant → Persistent session state: uses assistant state (evidence: `src/features/assistant/hooks/useAssistant.js`)
- Authentication service → HTTP client: sends requests (evidence: `src/services/authService.js`)
- Authentication service → Persistent session state: updates session (evidence: `src/services/authService.js`)
- Admin service → HTTP client: sends requests (evidence: `src/services/adminService.js`)
- Test service → HTTP client: sends requests (evidence: `src/services/testService.js`)
- University service → HTTP client: sends requests (evidence: `src/services/universityService.js`)
- Assistant service → HTTP client: sends requests (evidence: `src/services/assistantService.js`)
- HTTP client → Persistent session state: reads token (evidence: `src/lib/axios.js`)
- Server API → Assistant backend: uses assistant module (evidence: `server/index.js`)
