# sanjith-ux/autograder-lab-submission-portal architecture

> Architecture diagram of the GitHub repository sanjith-ux/autograder-lab-submission-portal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sanjith-ux/autograder-lab-submission-portal
- Repository: https://github.com/sanjith-ux/autograder-lab-submission-portal

## Overview

LabTrack is an initial React portal frontend: users select a student or lecturer role, enter email and password, and reach a role-specific placeholder dashboard. The sampled code implements client-side form validation and route selection only; it shows no authentication service, persistence, or implemented lab workflows. The README mentions schedules, submissions, attendance, and feedback as intended portal capabilities, but they are not present in this slice. Edges reflect sampled imports and routing; no backend or external service is evidenced.

Main entry points: [`FrontEnd/src/App.jsx`](https://github.com/sanjith-ux/autograder-lab-submission-portal/blob/main/FrontEnd/src/App.jsx) (Route dispatch), [`FrontEnd/src/pages/LoginPage.jsx`](https://github.com/sanjith-ux/autograder-lab-submission-portal/blob/main/FrontEnd/src/pages/LoginPage.jsx) (Sign-in form), [`FrontEnd/src/main.jsx`](https://github.com/sanjith-ux/autograder-lab-submission-portal/blob/main/FrontEnd/src/main.jsx) (React mount), [`FrontEnd/src/components/RoleSelector.jsx`](https://github.com/sanjith-ux/autograder-lab-submission-portal/blob/main/FrontEnd/src/components/RoleSelector.jsx) (Role selector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Frontend entry"]
  node_mount["React mount<br/>[main.jsx]"]
  node_router["Route dispatch<br/>[App.jsx]"]
end

subgraph group_access["Sign-in flow"]
  node_login["Sign-in form<br/>[LoginPage.jsx]"]
  node_role["Role selector<br/>[RoleSelector.jsx]"]
end

subgraph group_workspace["Role dashboards"]
  node_dashboard["Placeholder dashboard<br/>[DashboardPage.jsx]"]
end

node_user(("Portal user"))

node_user -->|"enters credentials"| node_login
node_mount -->|"renders"| node_router
node_router -->|"routes sign-in"| node_login
node_login -->|"renders selector"| node_role
node_login -->|"navigates by role"| node_router
node_router -->|"routes dashboards"| node_dashboard

click node_mount "https://github.com/sanjith-ux/autograder-lab-submission-portal/blob/main/FrontEnd/src/main.jsx"
click node_router "https://github.com/sanjith-ux/autograder-lab-submission-portal/blob/main/FrontEnd/src/App.jsx"
click node_login "https://github.com/sanjith-ux/autograder-lab-submission-portal/blob/main/FrontEnd/src/pages/LoginPage.jsx"
click node_role "https://github.com/sanjith-ux/autograder-lab-submission-portal/blob/main/FrontEnd/src/components/RoleSelector.jsx"
click node_dashboard "https://github.com/sanjith-ux/autograder-lab-submission-portal/blob/main/FrontEnd/src/pages/DashboardPage.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_mount,node_router,node_user toneBlue
class node_login,node_role toneAmber
class node_dashboard toneMint
```

## Components

### Frontend entry

- [React mount](https://github.com/sanjith-ux/autograder-lab-submission-portal/blob/main/FrontEnd/src/main.jsx): `FrontEnd/src/main.jsx`
- [Route dispatch](https://github.com/sanjith-ux/autograder-lab-submission-portal/blob/main/FrontEnd/src/App.jsx): `FrontEnd/src/App.jsx`

### Sign-in flow

- [Sign-in form](https://github.com/sanjith-ux/autograder-lab-submission-portal/blob/main/FrontEnd/src/pages/LoginPage.jsx): `FrontEnd/src/pages/LoginPage.jsx`
- [Role selector](https://github.com/sanjith-ux/autograder-lab-submission-portal/blob/main/FrontEnd/src/components/RoleSelector.jsx): `FrontEnd/src/components/RoleSelector.jsx`

### Role dashboards

- [Placeholder dashboard](https://github.com/sanjith-ux/autograder-lab-submission-portal/blob/main/FrontEnd/src/pages/DashboardPage.jsx): `FrontEnd/src/pages/DashboardPage.jsx`

### Other components

- **Portal user**

## Connections

- Portal user → Sign-in form: enters credentials (evidence: `FrontEnd/src/pages/LoginPage.jsx`)
- React mount → Route dispatch: renders (evidence: `FrontEnd/src/main.jsx`)
- Route dispatch → Sign-in form: routes sign-in (evidence: `FrontEnd/src/App.jsx`)
- Sign-in form → Role selector: renders selector (evidence: `FrontEnd/src/pages/LoginPage.jsx`)
- Sign-in form → Route dispatch: navigates by role (evidence: `FrontEnd/src/pages/LoginPage.jsx`)
- Route dispatch → Placeholder dashboard: routes dashboards (evidence: `FrontEnd/src/App.jsx`)
