# thakshak289/cet-compass architecture

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

- Interactive diagram: https://gitdiagram.com/thakshak289/cet-compass
- Repository: https://github.com/thakshak289/cet-compass

## Overview

CET Compass is an MHT-CET admissions guidance web app. Students can enter percentile, category, and branch to request college recommendations, then review cutoff and chance details; the app also exposes separate chatbot, college exploration, comparison, and admission-guide routes. The main interface is a TanStack Router application with a shared layout. A separate frontend contains a simpler admission form that currently logs its inputs rather than returning results. The README is empty, and some route implementations were not excerpted, so their internal behavior is not inferred.

Main entry points: [`cet-guidance-hub/src/routeTree.gen.ts`](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routeTree.gen.ts) (Route map), [`cet-guidance-hub/src/components/predictor/CollegePredictor.tsx`](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/components/predictor/CollegePredictor.tsx) (Recommendation form), [`cet-guidance-hub/src/server.ts`](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/server.ts) (SSR server), [`cet-guidance-hub/src/router.tsx`](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/router.tsx) (Router setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_router["Router setup<br/>[router.tsx]"]
  node_route_tree["Route map<br/>[routeTree.gen.ts]"]
  node_root_layout["Shared layout<br/>[__root.tsx]"]
  node_dashboard["Dashboard<br/>[index.tsx]"]
  node_predictor_route["Predictor route<br/>[predictor.tsx]"]
end

subgraph group_admissions["Admissions guidance"]
  node_chatbot["Admission helper<br/>[chatbot.tsx]"]
  node_explore["College explorer<br/>[explore.tsx]"]
  node_compare["College comparison<br/>[compare.tsx]"]
  node_guide["Admission guide<br/>[guide.tsx]"]
  node_predictor["Recommendation form"]
  node_recommendation_api{{"Recommendations API"}}
  node_result_card["College result card"]
  node_admission_data["Admission data<br/>[admission-data.ts]"]
end

subgraph group_operations["Error handling"]
  node_server["SSR server<br/>[server.ts]"]
  node_error_capture["Error capture<br/>[error-capture.ts]"]
  node_error_page["Error page<br/>[error-page.ts]"]
  node_error_reporting["Client reporting"]
end

subgraph group_prototype["Standalone prototype"]
  node_prototype_entry["Prototype entry<br/>[main.jsx]"]
  node_prototype_form["Admission form<br/>[App.jsx]"]
end

node_student(("Student"))

node_router -->|"configures routes"| node_route_tree
node_route_tree -->|"registers root"| node_root_layout
node_route_tree -->|"registers route"| node_dashboard
node_route_tree -->|"registers route"| node_chatbot
node_route_tree -->|"registers route"| node_compare
node_route_tree -->|"registers route"| node_explore
node_route_tree -->|"registers route"| node_guide
node_route_tree -->|"registers route"| node_predictor_route
node_dashboard -->|"renders form"| node_predictor
node_predictor -->|"posts inputs"| node_recommendation_api
node_predictor -->|"renders results"| node_result_card
node_result_card -->|"reads chance metadata"| node_admission_data
node_root_layout -->|"reports errors"| node_error_reporting
node_server -->|"captures errors"| node_error_capture
node_server -->|"renders fallback"| node_error_page
node_prototype_entry -->|"renders app"| node_prototype_form
node_student -.->|"opens app"| node_router

click node_router "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/router.tsx"
click node_route_tree "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routeTree.gen.ts"
click node_root_layout "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routes/__root.tsx"
click node_dashboard "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routes/index.tsx"
click node_predictor_route "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routes/predictor.tsx"
click node_chatbot "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routes/chatbot.tsx"
click node_explore "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routes/explore.tsx"
click node_compare "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routes/compare.tsx"
click node_guide "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routes/guide.tsx"
click node_predictor "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/components/predictor/CollegePredictor.tsx"
click node_result_card "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/components/predictor/CollegeResultCard.tsx"
click node_admission_data "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/lib/admission-data.ts"
click node_server "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/server.ts"
click node_error_capture "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/lib/error-capture.ts"
click node_error_page "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/lib/error-page.ts"
click node_error_reporting "https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/lib/lovable-error-reporting.ts"
click node_prototype_entry "https://github.com/thakshak289/cet-compass/blob/main/frontend/src/main.jsx"
click node_prototype_form "https://github.com/thakshak289/cet-compass/blob/main/frontend/src/App.jsx"

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_router,node_route_tree,node_root_layout,node_dashboard,node_predictor_route toneBlue
class node_chatbot,node_explore,node_compare,node_guide,node_predictor,node_recommendation_api,node_result_card,node_admission_data toneAmber
class node_server,node_error_capture,node_error_page,node_error_reporting toneMint
class node_prototype_entry,node_prototype_form toneRose
class node_student toneIndigo
```

## Components

### App navigation

- [Router setup](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/router.tsx): `cet-guidance-hub/src/router.tsx`
- [Route map](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routeTree.gen.ts): `cet-guidance-hub/src/routeTree.gen.ts`
- [Shared layout](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routes/__root.tsx): `cet-guidance-hub/src/routes/__root.tsx`
- [Dashboard](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routes/index.tsx): `cet-guidance-hub/src/routes/index.tsx`
- [Predictor route](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routes/predictor.tsx): `cet-guidance-hub/src/routes/predictor.tsx`

### Admissions guidance

- [Admission helper](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routes/chatbot.tsx): `cet-guidance-hub/src/routes/chatbot.tsx`
- [College explorer](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routes/explore.tsx): `cet-guidance-hub/src/routes/explore.tsx`
- [College comparison](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routes/compare.tsx): `cet-guidance-hub/src/routes/compare.tsx`
- [Admission guide](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/routes/guide.tsx): `cet-guidance-hub/src/routes/guide.tsx`
- [Recommendation form](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/components/predictor/CollegePredictor.tsx): `cet-guidance-hub/src/components/predictor/CollegePredictor.tsx`
- **Recommendations API**
- [College result card](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/components/predictor/CollegeResultCard.tsx): `cet-guidance-hub/src/components/predictor/CollegeResultCard.tsx`
- [Admission data](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/lib/admission-data.ts): `cet-guidance-hub/src/lib/admission-data.ts`

### Error handling

- [SSR server](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/server.ts): `cet-guidance-hub/src/server.ts`
- [Error capture](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/lib/error-capture.ts): `cet-guidance-hub/src/lib/error-capture.ts`
- [Error page](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/lib/error-page.ts): `cet-guidance-hub/src/lib/error-page.ts`
- [Client reporting](https://github.com/thakshak289/cet-compass/blob/main/cet-guidance-hub/src/lib/lovable-error-reporting.ts): `cet-guidance-hub/src/lib/lovable-error-reporting.ts`

### Standalone prototype

- [Prototype entry](https://github.com/thakshak289/cet-compass/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Admission form](https://github.com/thakshak289/cet-compass/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`

### Other components

- **Student**

## Connections

- Router setup → Route map: configures routes (evidence: `cet-guidance-hub/src/router.tsx`)
- Route map → Shared layout: registers root (evidence: `cet-guidance-hub/src/routeTree.gen.ts`)
- Route map → Dashboard: registers route (evidence: `cet-guidance-hub/src/routeTree.gen.ts`)
- Route map → Admission helper: registers route (evidence: `cet-guidance-hub/src/routeTree.gen.ts`)
- Route map → College comparison: registers route (evidence: `cet-guidance-hub/src/routeTree.gen.ts`)
- Route map → College explorer: registers route (evidence: `cet-guidance-hub/src/routeTree.gen.ts`)
- Route map → Admission guide: registers route (evidence: `cet-guidance-hub/src/routeTree.gen.ts`)
- Route map → Predictor route: registers route (evidence: `cet-guidance-hub/src/routeTree.gen.ts`)
- Dashboard → Recommendation form: renders form (evidence: `cet-guidance-hub/src/routes/index.tsx`)
- Recommendation form → Recommendations API: posts inputs (evidence: `cet-guidance-hub/src/components/predictor/CollegePredictor.tsx`)
- Recommendation form → College result card: renders results (evidence: `cet-guidance-hub/src/components/predictor/CollegePredictor.tsx`)
- College result card → Admission data: reads chance metadata (evidence: `cet-guidance-hub/src/components/predictor/CollegeResultCard.tsx`)
- Shared layout → Client reporting: reports errors (evidence: `cet-guidance-hub/src/routes/__root.tsx`)
- SSR server → Error capture: captures errors (evidence: `cet-guidance-hub/src/server.ts`)
- SSR server → Error page: renders fallback (evidence: `cet-guidance-hub/src/server.ts`)
- Prototype entry → Admission form: renders app (evidence: `frontend/src/main.jsx`)
- Student → Router setup: opens app
