# harshith-10/build-it architecture

> Architecture diagram of the GitHub repository harshith-10/build-it, 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/harshith-10/build-it
- Repository: https://github.com/harshith-10/build-it

## Overview

This repository is a role-based academic coding platform: administrators and faculty manage exams, question collections, groups, and programming labs; students take exams, submit lab work, and review performance. The main workflow runs from exam participation through code submission, grading, and persistence. Labs have a parallel management and submission flow, while authentication and permission checks protect role-specific operations. Evidence is limited to the README, SOURCE INDEX references, and sampled excerpts; unsampled connections are omitted or marked unverified.

Main entry points: [`src/db/index.ts`](https://github.com/harshith-10/build-it/blob/main/src/db/index.ts) (Database connection), [`src/actions/student/exams/submit-actions.ts`](https://github.com/harshith-10/build-it/blob/main/src/actions/student/exams/submit-actions.ts) (Exam submissions), [`src/actions/admin/exams.ts`](https://github.com/harshith-10/build-it/blob/main/src/actions/admin/exams.ts) (Exam management), [`src/actions/admin/labs.ts`](https://github.com/harshith-10/build-it/blob/main/src/actions/admin/labs.ts) (Lab management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and roles"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_permissions["Access checks<br/>[auth-access.ts]"]
  node_userdata[("Users and sessions<br/>[auth.ts]")]
end

subgraph group_exams["Exams and coding"]
  node_examadmin["Exam management<br/>[exams.ts]"]
  node_examclient["Exam session UI<br/>[ide-shell.tsx]"]
  node_submission["Exam submissions<br/>[submit-actions.ts]"]
  node_grading["Grading rules<br/>[grading.ts]"]
  node_jet["Code execution<br/>[jet.ts]"]
  node_examdata[("Exam records<br/>[exams.ts]")]
end

subgraph group_labs["Programming labs"]
  node_labadmin["Lab management<br/>[labs.ts]"]
  node_labmanager["Lab manager UI<br/>[labs-manager.tsx]"]
  node_labtemplate["Lab report editor"]
  node_labactions["Lab submissions<br/>[submissions.ts]"]
  node_labdata[("Lab records<br/>[labs.ts]")]
end

subgraph group_operations["Academic operations"]
  node_groups[("Student groups<br/>[groups.ts]")]
  node_collections[("Question collections")]
  node_analytics["Student analytics<br/>[page.tsx]"]
  node_database[("Database connection<br/>[index.ts]")]
end

node_student(("Student"))
node_faculty(("Faculty"))
node_admin(("Administrator"))

node_auth -->|"configures adapter"| node_database
node_permissions -->|"checks session"| node_auth
node_permissions -->|"queries access"| node_database
node_admin -.->|"manages exams"| node_examadmin
node_examadmin -->|"uses exam records"| node_examdata
node_examadmin -->|"checks access"| node_permissions
node_student -.->|"takes exam"| node_examclient
node_examclient -.->|"submits answers"| node_submission
node_submission -->|"uses grading"| node_grading
node_submission -->|"runs code"| node_jet
node_submission -->|"persists results"| node_database
node_faculty -.->|"manages labs"| node_labmanager
node_labmanager -->|"calls lab actions"| node_labadmin
node_labadmin -->|"uses lab records"| node_database
node_labtemplate -->|"requests report data"| node_labactions
node_labactions -->|"stores submissions"| node_database
node_labadmin -->|"uses lab schema"| node_labdata
node_labactions -->|"uses lab schema"| node_labdata
node_student -.->|"reviews performance"| node_analytics
node_analytics -->|"reads exam data"| node_database
node_examdata -.->|"registered schema"| node_database
node_groups -.->|"registered schema"| node_database
node_collections -.->|"registered schema"| node_database

click node_auth "https://github.com/harshith-10/build-it/blob/main/src/lib/auth.ts"
click node_permissions "https://github.com/harshith-10/build-it/blob/main/src/lib/auth-access.ts"
click node_userdata "https://github.com/harshith-10/build-it/blob/main/src/db/schema/auth.ts"
click node_examadmin "https://github.com/harshith-10/build-it/blob/main/src/actions/admin/exams.ts"
click node_examclient "https://github.com/harshith-10/build-it/blob/main/src/components/exam/ide-shell.tsx"
click node_submission "https://github.com/harshith-10/build-it/blob/main/src/actions/student/exams/submit-actions.ts"
click node_grading "https://github.com/harshith-10/build-it/blob/main/src/lib/grading.ts"
click node_jet "https://github.com/harshith-10/build-it/blob/main/src/lib/jet.ts"
click node_examdata "https://github.com/harshith-10/build-it/blob/main/src/db/schema/exams.ts"
click node_labadmin "https://github.com/harshith-10/build-it/blob/main/src/actions/admin/labs.ts"
click node_labmanager "https://github.com/harshith-10/build-it/blob/main/src/components/admin/labs/labs-manager.tsx"
click node_labtemplate "https://github.com/harshith-10/build-it/blob/main/src/components/labs/lab-record-template.tsx"
click node_labactions "https://github.com/harshith-10/build-it/blob/main/src/actions/student/labs/submissions.ts"
click node_labdata "https://github.com/harshith-10/build-it/blob/main/src/db/schema/labs.ts"
click node_groups "https://github.com/harshith-10/build-it/blob/main/src/db/schema/groups.ts"
click node_collections "https://github.com/harshith-10/build-it/blob/main/src/db/schema/question-collections.ts"
click node_analytics "https://github.com/harshith-10/build-it/blob/main/src/app/(student)/analytics/page.tsx"
click node_database "https://github.com/harshith-10/build-it/blob/main/src/db/index.ts"

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_auth,node_permissions,node_userdata toneBlue
class node_examadmin,node_examclient,node_submission,node_grading,node_jet,node_examdata toneAmber
class node_labadmin,node_labmanager,node_labtemplate,node_labactions,node_labdata toneMint
class node_groups,node_collections,node_analytics,node_database toneRose
class node_student,node_faculty,node_admin toneIndigo
```

## Components

### Access and roles

- [Authentication](https://github.com/harshith-10/build-it/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Access checks](https://github.com/harshith-10/build-it/blob/main/src/lib/auth-access.ts): `src/lib/auth-access.ts`
- [Users and sessions](https://github.com/harshith-10/build-it/blob/main/src/db/schema/auth.ts): `src/db/schema/auth.ts`

### Exams and coding

- [Exam management](https://github.com/harshith-10/build-it/blob/main/src/actions/admin/exams.ts): `src/actions/admin/exams.ts`
- [Exam session UI](https://github.com/harshith-10/build-it/blob/main/src/components/exam/ide-shell.tsx): `src/components/exam/ide-shell.tsx`
- [Exam submissions](https://github.com/harshith-10/build-it/blob/main/src/actions/student/exams/submit-actions.ts): `src/actions/student/exams/submit-actions.ts`
- [Grading rules](https://github.com/harshith-10/build-it/blob/main/src/lib/grading.ts): `src/lib/grading.ts`
- [Code execution](https://github.com/harshith-10/build-it/blob/main/src/lib/jet.ts): `src/lib/jet.ts`
- [Exam records](https://github.com/harshith-10/build-it/blob/main/src/db/schema/exams.ts): `src/db/schema/exams.ts`

### Programming labs

- [Lab management](https://github.com/harshith-10/build-it/blob/main/src/actions/admin/labs.ts): `src/actions/admin/labs.ts`
- [Lab manager UI](https://github.com/harshith-10/build-it/blob/main/src/components/admin/labs/labs-manager.tsx): `src/components/admin/labs/labs-manager.tsx`
- [Lab report editor](https://github.com/harshith-10/build-it/blob/main/src/components/labs/lab-record-template.tsx): `src/components/labs/lab-record-template.tsx`
- [Lab submissions](https://github.com/harshith-10/build-it/blob/main/src/actions/student/labs/submissions.ts): `src/actions/student/labs/submissions.ts`
- [Lab records](https://github.com/harshith-10/build-it/blob/main/src/db/schema/labs.ts): `src/db/schema/labs.ts`

### Academic operations

- [Student groups](https://github.com/harshith-10/build-it/blob/main/src/db/schema/groups.ts): `src/db/schema/groups.ts`
- [Question collections](https://github.com/harshith-10/build-it/blob/main/src/db/schema/question-collections.ts): `src/db/schema/question-collections.ts`
- [Student analytics](https://github.com/harshith-10/build-it/blob/main/src/app/(student)/analytics/page.tsx): `src/app/(student)/analytics/page.tsx`
- [Database connection](https://github.com/harshith-10/build-it/blob/main/src/db/index.ts): `src/db/index.ts`

### Other components

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

## Connections

- Authentication → Database connection: configures adapter (evidence: `src/lib/auth.ts`)
- Access checks → Authentication: checks session (evidence: `src/lib/auth-access.ts`)
- Access checks → Database connection: queries access (evidence: `src/lib/auth-access.ts`)
- Administrator → Exam management: manages exams
- Exam management → Exam records: uses exam records (evidence: `src/actions/admin/exams.ts`)
- Exam management → Access checks: checks access (evidence: `src/actions/admin/exams.ts`)
- Student → Exam session UI: takes exam
- Exam session UI → Exam submissions: submits answers
- Exam submissions → Grading rules: uses grading (evidence: `src/actions/student/exams/submit-actions.ts`)
- Exam submissions → Code execution: runs code (evidence: `src/actions/student/exams/submit-actions.ts`)
- Exam submissions → Database connection: persists results (evidence: `src/actions/student/exams/submit-actions.ts`)
- Faculty → Lab manager UI: manages labs
- Lab manager UI → Lab management: calls lab actions (evidence: `src/components/admin/labs/labs-manager.tsx`)
- Lab management → Database connection: uses lab records (evidence: `src/actions/admin/labs.ts`)
- Lab report editor → Lab submissions: requests report data (evidence: `src/components/labs/lab-record-template.tsx`)
- Lab submissions → Database connection: stores submissions (evidence: `src/actions/student/labs/submissions.ts`)
- Lab management → Lab records: uses lab schema (evidence: `src/actions/admin/labs.ts`)
- Lab submissions → Lab records: uses lab schema (evidence: `src/actions/student/labs/submissions.ts`)
- Student → Student analytics: reviews performance
- Student analytics → Database connection: reads exam data (evidence: `src/app/(student)/analytics/page.tsx`)
- Exam records → Database connection: registered schema
- Student groups → Database connection: registered schema
- Question collections → Database connection: registered schema
