# devon-du-toit/postgradevue architecture

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

- Interactive diagram: https://gitdiagram.com/devon-du-toit/postgradevue
- Repository: https://github.com/devon-du-toit/postgradevue

## Overview

PostGradeVue is a Vue frontend for managing courses, assessments, student submissions, verification, and grades through a configured backend API. The main workflow is an authenticated instructor navigating courses, maintaining rosters and assessments, uploading and verifying submissions, and recording marks that appear in gradebooks. The graph includes authentication and shared API/pagination layers. The README describes a starter template rather than product features, so domain capabilities are inferred from the named views and sampled calls; unsampled view-to-service links are limited to SOURCE INDEX references.

Main entry points: [`src/router/index.ts`](https://github.com/devon-du-toit/postgradevue/blob/master/src/router/index.ts) (Route access), [`src/services/api.ts`](https://github.com/devon-du-toit/postgradevue/blob/master/src/services/api.ts) (API client), [`src/services/courses.ts`](https://github.com/devon-du-toit/postgradevue/blob/master/src/services/courses.ts) (Course service), [`src/services/pagination.ts`](https://github.com/devon-du-toit/postgradevue/blob/master/src/services/pagination.ts) (Pagination helper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App and navigation"]
  node_app["Application shell<br/>[App.vue]"]
  node_router["Route access<br/>[index.ts]"]
  node_dashboard["Dashboard<br/>[DashboardView.vue]"]
  node_dashboard_service["Dashboard service<br/>[dashboard.ts]"]
end

subgraph group_identity["Authentication"]
  node_login["Login<br/>[LoginView.vue]"]
  node_auth["Auth state<br/>[auth.ts]"]
end

subgraph group_coursework["Courses and assessments"]
  node_courses["Course list<br/>[CoursesView.vue]"]
  node_course_detail["Course and roster"]
  node_assessments["Assessment detail"]
  node_course_service["Course service<br/>[courses.ts]"]
  node_assessment_service["Assessment service<br/>[assessments.ts]"]
  node_student_service["Student service<br/>[students.ts]"]
end

subgraph group_grading["Submissions and grades"]
  node_verification_queue["Verification queue"]
  node_gradebook_view["Gradebook view<br/>[GradebookView.vue]"]
  node_submission_service["Submission service<br/>[submissions.ts]"]
  node_results_service["Results service<br/>[results.ts]"]
  node_gradebook_service["Gradebook service<br/>[gradebook.ts]"]
end

subgraph group_transport["API and data types"]
  node_pagination["Pagination helper<br/>[pagination.ts]"]
  node_api_client["API client<br/>[api.ts]"]
  node_domain_types["Domain data types"]
end

node_instructor(("Instructor"))
node_backend["Backend API"]

node_instructor -->|"navigates"| node_router
node_router -->|"routes to"| node_login
node_router -->|"routes to"| node_dashboard
node_router -->|"routes to"| node_courses
node_router -->|"routes to"| node_course_detail
node_router -->|"routes to"| node_assessments
node_router -->|"routes to"| node_gradebook_view
node_router -->|"routes to"| node_verification_queue
node_login -->|"uses"| node_auth
node_router -->|"checks token"| node_auth
node_auth -->|"requests identity"| node_api_client
node_api_client -->|"reads auth state"| node_auth
node_app -->|"uses"| node_auth
node_app -->|"mounts routes"| node_router
node_courses -->|"loads courses"| node_course_service
node_dashboard -->|"loads dashboard"| node_dashboard_service
node_course_detail -->|"loads course"| node_course_service
node_course_detail -->|"manages roster"| node_student_service
node_course_detail -->|"manages assessments"| node_assessment_service
node_assessments -->|"loads assessment"| node_assessment_service
node_assessments -->|"loads marks"| node_gradebook_service
node_assessments -->|"records results"| node_results_service
node_assessments -->|"uploads and verifies"| node_submission_service
node_verification_queue -->|"loads assessments"| node_assessment_service
node_verification_queue -->|"loads marks"| node_gradebook_service
node_verification_queue -->|"handles queue"| node_submission_service
node_gradebook_view -->|"loads course"| node_course_service
node_gradebook_view -->|"loads grades"| node_gradebook_service
node_course_service -->|"fetches lists"| node_pagination
node_assessment_service -->|"fetches lists"| node_pagination
node_student_service -->|"fetches lists"| node_pagination
node_submission_service -->|"fetches lists"| node_pagination
node_results_service -->|"fetches lists"| node_pagination
node_pagination -->|"requests pages"| node_api_client
node_course_service -->|"requests data"| node_api_client
node_gradebook_service -->|"requests grades"| node_api_client
node_dashboard_service -->|"requests dashboard"| node_api_client
node_submission_service -->|"uploads and posts"| node_api_client
node_api_client -->|"sends HTTP"| node_backend
node_course_service -->|"uses course types"| node_domain_types
node_gradebook_service -->|"uses grade types"| node_domain_types
node_submission_service -->|"uses submission types"| node_domain_types

click node_app "https://github.com/devon-du-toit/postgradevue/blob/master/src/App.vue"
click node_router "https://github.com/devon-du-toit/postgradevue/blob/master/src/router/index.ts"
click node_login "https://github.com/devon-du-toit/postgradevue/blob/master/src/views/LoginView.vue"
click node_auth "https://github.com/devon-du-toit/postgradevue/blob/master/src/stores/auth.ts"
click node_dashboard "https://github.com/devon-du-toit/postgradevue/blob/master/src/views/DashboardView.vue"
click node_courses "https://github.com/devon-du-toit/postgradevue/blob/master/src/views/CoursesView.vue"
click node_course_detail "https://github.com/devon-du-toit/postgradevue/blob/master/src/views/CourseDetailView.vue"
click node_assessments "https://github.com/devon-du-toit/postgradevue/blob/master/src/views/AssessmentDetailView.vue"
click node_verification_queue "https://github.com/devon-du-toit/postgradevue/blob/master/src/views/VerificationQueueView.vue"
click node_gradebook_view "https://github.com/devon-du-toit/postgradevue/blob/master/src/views/GradebookView.vue"
click node_course_service "https://github.com/devon-du-toit/postgradevue/blob/master/src/services/courses.ts"
click node_assessment_service "https://github.com/devon-du-toit/postgradevue/blob/master/src/services/assessments.ts"
click node_student_service "https://github.com/devon-du-toit/postgradevue/blob/master/src/services/students.ts"
click node_submission_service "https://github.com/devon-du-toit/postgradevue/blob/master/src/services/submissions.ts"
click node_results_service "https://github.com/devon-du-toit/postgradevue/blob/master/src/services/results.ts"
click node_gradebook_service "https://github.com/devon-du-toit/postgradevue/blob/master/src/services/gradebook.ts"
click node_dashboard_service "https://github.com/devon-du-toit/postgradevue/blob/master/src/services/dashboard.ts"
click node_pagination "https://github.com/devon-du-toit/postgradevue/blob/master/src/services/pagination.ts"
click node_api_client "https://github.com/devon-du-toit/postgradevue/blob/master/src/services/api.ts"
click node_domain_types "https://github.com/devon-du-toit/postgradevue/tree/master/src/types"

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,node_dashboard,node_dashboard_service toneBlue
class node_login,node_auth toneAmber
class node_courses,node_course_detail,node_assessments,node_course_service,node_assessment_service,node_student_service,node_backend toneMint
class node_verification_queue,node_gradebook_view,node_submission_service,node_results_service,node_gradebook_service toneRose
class node_pagination,node_api_client,node_domain_types,node_instructor toneIndigo
```

## Components

### App and navigation

- [Application shell](https://github.com/devon-du-toit/postgradevue/blob/master/src/App.vue): `src/App.vue`
- [Route access](https://github.com/devon-du-toit/postgradevue/blob/master/src/router/index.ts): `src/router/index.ts`
- [Dashboard](https://github.com/devon-du-toit/postgradevue/blob/master/src/views/DashboardView.vue): `src/views/DashboardView.vue`
- [Dashboard service](https://github.com/devon-du-toit/postgradevue/blob/master/src/services/dashboard.ts): `src/services/dashboard.ts`

### Authentication

- [Login](https://github.com/devon-du-toit/postgradevue/blob/master/src/views/LoginView.vue): `src/views/LoginView.vue`
- [Auth state](https://github.com/devon-du-toit/postgradevue/blob/master/src/stores/auth.ts): `src/stores/auth.ts`

### Courses and assessments

- [Course list](https://github.com/devon-du-toit/postgradevue/blob/master/src/views/CoursesView.vue): `src/views/CoursesView.vue`
- [Course and roster](https://github.com/devon-du-toit/postgradevue/blob/master/src/views/CourseDetailView.vue): `src/views/CourseDetailView.vue`
- [Assessment detail](https://github.com/devon-du-toit/postgradevue/blob/master/src/views/AssessmentDetailView.vue): `src/views/AssessmentDetailView.vue`
- [Course service](https://github.com/devon-du-toit/postgradevue/blob/master/src/services/courses.ts): `src/services/courses.ts`
- [Assessment service](https://github.com/devon-du-toit/postgradevue/blob/master/src/services/assessments.ts): `src/services/assessments.ts`
- [Student service](https://github.com/devon-du-toit/postgradevue/blob/master/src/services/students.ts): `src/services/students.ts`

### Submissions and grades

- [Verification queue](https://github.com/devon-du-toit/postgradevue/blob/master/src/views/VerificationQueueView.vue): `src/views/VerificationQueueView.vue`
- [Gradebook view](https://github.com/devon-du-toit/postgradevue/blob/master/src/views/GradebookView.vue): `src/views/GradebookView.vue`
- [Submission service](https://github.com/devon-du-toit/postgradevue/blob/master/src/services/submissions.ts): `src/services/submissions.ts`
- [Results service](https://github.com/devon-du-toit/postgradevue/blob/master/src/services/results.ts): `src/services/results.ts`
- [Gradebook service](https://github.com/devon-du-toit/postgradevue/blob/master/src/services/gradebook.ts): `src/services/gradebook.ts`

### API and data types

- [Pagination helper](https://github.com/devon-du-toit/postgradevue/blob/master/src/services/pagination.ts): `src/services/pagination.ts`
- [API client](https://github.com/devon-du-toit/postgradevue/blob/master/src/services/api.ts): `src/services/api.ts`
- [Domain data types](https://github.com/devon-du-toit/postgradevue/tree/master/src/types): `src/types`

### Other components

- **Instructor**
- **Backend API**

## Connections

- Instructor → Route access: navigates (evidence: `src/router/index.ts`)
- Route access → Login: routes to (evidence: `src/router/index.ts`)
- Route access → Dashboard: routes to (evidence: `src/router/index.ts`)
- Route access → Course list: routes to (evidence: `src/router/index.ts`)
- Route access → Course and roster: routes to (evidence: `src/router/index.ts`)
- Route access → Assessment detail: routes to (evidence: `src/router/index.ts`)
- Route access → Gradebook view: routes to (evidence: `src/router/index.ts`)
- Route access → Verification queue: routes to (evidence: `src/router/index.ts`)
- Login → Auth state: uses (evidence: `src/views/LoginView.vue`)
- Route access → Auth state: checks token (evidence: `src/router/index.ts`)
- Auth state → API client: requests identity (evidence: `src/stores/auth.ts`)
- API client → Auth state: reads auth state (evidence: `src/services/api.ts`)
- Application shell → Auth state: uses (evidence: `src/App.vue`)
- Application shell → Route access: mounts routes (evidence: `src/main.ts`)
- Course list → Course service: loads courses (evidence: `src/views/CoursesView.vue`)
- Dashboard → Dashboard service: loads dashboard (evidence: `src/views/DashboardView.vue`)
- Course and roster → Course service: loads course (evidence: `src/views/CourseDetailView.vue`)
- Course and roster → Student service: manages roster (evidence: `src/views/CourseDetailView.vue`)
- Course and roster → Assessment service: manages assessments (evidence: `src/views/CourseDetailView.vue`)
- Assessment detail → Assessment service: loads assessment (evidence: `src/views/AssessmentDetailView.vue`)
- Assessment detail → Gradebook service: loads marks (evidence: `src/views/AssessmentDetailView.vue`)
- Assessment detail → Results service: records results (evidence: `src/views/AssessmentDetailView.vue`)
- Assessment detail → Submission service: uploads and verifies (evidence: `src/views/AssessmentDetailView.vue`)
- Verification queue → Assessment service: loads assessments (evidence: `src/views/VerificationQueueView.vue`)
- Verification queue → Gradebook service: loads marks (evidence: `src/views/VerificationQueueView.vue`)
- Verification queue → Submission service: handles queue (evidence: `src/views/VerificationQueueView.vue`)
- Gradebook view → Course service: loads course (evidence: `src/views/GradebookView.vue`)
- Gradebook view → Gradebook service: loads grades (evidence: `src/views/GradebookView.vue`)
- Course service → Pagination helper: fetches lists (evidence: `src/services/courses.ts`)
- Assessment service → Pagination helper: fetches lists (evidence: `src/services/assessments.ts`)
- Student service → Pagination helper: fetches lists (evidence: `src/services/students.ts`)
- Submission service → Pagination helper: fetches lists (evidence: `src/services/submissions.ts`)
- Results service → Pagination helper: fetches lists (evidence: `src/services/results.ts`)
- Pagination helper → API client: requests pages (evidence: `src/services/pagination.ts`)
- Course service → API client: requests data (evidence: `src/services/courses.ts`)
- Gradebook service → API client: requests grades (evidence: `src/services/gradebook.ts`)
- Dashboard service → API client: requests dashboard (evidence: `src/services/dashboard.ts`)
- Submission service → API client: uploads and posts (evidence: `src/services/submissions.ts`)
- API client → Backend API: sends HTTP (evidence: `src/services/api.ts`)
- Course service → Domain data types: uses course types (evidence: `src/services/courses.ts`)
- Gradebook service → Domain data types: uses grade types (evidence: `src/services/gradebook.ts`)
- Submission service → Domain data types: uses submission types (evidence: `src/services/submissions.ts`)
