# danusigan/softwareproject architecture

> Architecture diagram of the GitHub repository danusigan/softwareproject, 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/danusigan/softwareproject
- Repository: https://github.com/danusigan/softwareproject

## Overview

This is the React frontend for an LO–PO analytics and academic-outcomes application. Users enter through public landing/login screens or role-protected routes, then manage curriculum outcomes and mappings, work with marks and attainment, and review reports or CQI plans. Page components call backend REST endpoints through service modules (some pages also use Axios directly). The source index and excerpts establish routing and selected service calls; most page implementations and backend behavior were not sampled, so unverified connections are omitted.

Main entry points: [`softwareproject_frontend/src/App.jsx`](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/App.jsx) (Application routes), [`softwareproject_frontend/src/services/cqiService.js`](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/services/cqiService.js) (CQI service), [`softwareproject_frontend/src/pages/MarksWorkbenchPage.jsx`](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/MarksWorkbenchPage.jsx) (Marks workbench), [`softwareproject_frontend/src/components/ProtectedRoute.jsx`](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/components/ProtectedRoute.jsx) (Route guard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and shell"]
  node_router["Application routes<br/>[App.jsx]"]
  node_auth["Session service<br/>[authService.js]"]
  node_guard["Route guard<br/>[ProtectedRoute.jsx]"]
  node_landing["Landing page<br/>[landingpage.jsx]"]
  node_header["Navigation header<br/>[header.jsx]"]
  node_footer["Page footer<br/>[footer.jsx]"]
end

subgraph group_curriculum["Curriculum management"]
  node_admin["Admin dashboard<br/>[admindashboard.jsx]"]
  node_lecturer["Lecturer dashboard"]
  node_lecturer_mgmt["Lecturer management"]
  node_multi_select["Assignment selector"]
  node_lo_create["LO creation and mapping"]
  node_lo_po["LO–PO mapping review"]
  node_outcomes["Program outcomes"]
end

subgraph group_assessment["Assessment and CQI"]
  node_marks["Marks workbench"]
  node_marks_service["Marks service<br/>[marksService.js]"]
  node_cqi_service["CQI service<br/>[cqiService.js]"]
  node_cqi_review["CQI plan review<br/>[CqiReviewPage.jsx]"]
  node_cqi_plans["CQI plan display"]
end

subgraph group_insight["Reporting and insights"]
  node_comparison["LO comparison<br/>[ComparisonPage.jsx]"]
  node_student_reports["Student reports"]
  node_batch_reports["Batch reports"]
end

node_user(("User"))
node_backend["Backend REST API"]

node_user -->|"navigates"| node_router
node_router -->|"routes to"| node_landing
node_router -->|"protects routes"| node_guard
node_guard -->|"checks session"| node_auth
node_header -->|"reads session"| node_auth
node_admin -->|"uses selector"| node_multi_select
node_lecturer_mgmt -->|"uses selector"| node_multi_select
node_marks -->|"requests marks"| node_marks_service
node_marks -->|"requests CQI"| node_cqi_service
node_cqi_review -->|"reviews plans"| node_cqi_service
node_marks_service -->|"sends REST requests"| node_backend
node_cqi_service -->|"sends REST requests"| node_backend
node_cqi_plans -->|"loads and updates plans"| node_backend

click node_router "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/App.jsx"
click node_auth "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/services/authService.js"
click node_guard "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/components/ProtectedRoute.jsx"
click node_landing "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/landingpage.jsx"
click node_header "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/components/header.jsx"
click node_footer "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/components/footer.jsx"
click node_admin "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/admindashboard.jsx"
click node_lecturer "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/lecturerdashboard.jsx"
click node_lecturer_mgmt "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/ManageLecturersPage.jsx"
click node_multi_select "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/components/MultiSelectAutocomplete.jsx"
click node_lo_create "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/CreateLOWithMappingPage.jsx"
click node_lo_po "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/LOPOMappingManagementPage.jsx"
click node_outcomes "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/ProgramOutcomesPage.jsx"
click node_comparison "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/ComparisonPage.jsx"
click node_marks "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/MarksWorkbenchPage.jsx"
click node_marks_service "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/services/marksService.js"
click node_cqi_service "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/services/cqiService.js"
click node_cqi_review "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/CqiReviewPage.jsx"
click node_cqi_plans "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/components/CqiPlansDisplay.jsx"
click node_student_reports "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/StudentReportsPage.jsx"
click node_batch_reports "https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/BatchReportsPage.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_auth,node_guard,node_landing,node_header,node_footer,node_user toneBlue
class node_admin,node_lecturer,node_lecturer_mgmt,node_multi_select,node_lo_create,node_lo_po,node_outcomes toneAmber
class node_marks,node_marks_service,node_cqi_service,node_cqi_review,node_cqi_plans,node_backend toneMint
class node_comparison,node_student_reports,node_batch_reports toneRose
```

## Components

### Access and shell

- [Application routes](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/App.jsx): `softwareproject_frontend/src/App.jsx`
- [Session service](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/services/authService.js): `softwareproject_frontend/src/services/authService.js`
- [Route guard](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/components/ProtectedRoute.jsx): `softwareproject_frontend/src/components/ProtectedRoute.jsx`
- [Landing page](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/landingpage.jsx): `softwareproject_frontend/src/pages/landingpage.jsx`
- [Navigation header](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/components/header.jsx): `softwareproject_frontend/src/components/header.jsx`
- [Page footer](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/components/footer.jsx): `softwareproject_frontend/src/components/footer.jsx`

### Curriculum management

- [Admin dashboard](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/admindashboard.jsx): `softwareproject_frontend/src/pages/admindashboard.jsx`
- [Lecturer dashboard](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/lecturerdashboard.jsx): `softwareproject_frontend/src/pages/lecturerdashboard.jsx`
- [Lecturer management](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/ManageLecturersPage.jsx): `softwareproject_frontend/src/pages/ManageLecturersPage.jsx`
- [Assignment selector](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/components/MultiSelectAutocomplete.jsx): `softwareproject_frontend/src/components/MultiSelectAutocomplete.jsx`
- [LO creation and mapping](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/CreateLOWithMappingPage.jsx): `softwareproject_frontend/src/pages/CreateLOWithMappingPage.jsx`
- [LO–PO mapping review](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/LOPOMappingManagementPage.jsx): `softwareproject_frontend/src/pages/LOPOMappingManagementPage.jsx`
- [Program outcomes](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/ProgramOutcomesPage.jsx): `softwareproject_frontend/src/pages/ProgramOutcomesPage.jsx`

### Assessment and CQI

- [Marks workbench](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/MarksWorkbenchPage.jsx): `softwareproject_frontend/src/pages/MarksWorkbenchPage.jsx`
- [Marks service](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/services/marksService.js): `softwareproject_frontend/src/services/marksService.js`
- [CQI service](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/services/cqiService.js): `softwareproject_frontend/src/services/cqiService.js`
- [CQI plan review](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/CqiReviewPage.jsx): `softwareproject_frontend/src/pages/CqiReviewPage.jsx`
- [CQI plan display](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/components/CqiPlansDisplay.jsx): `softwareproject_frontend/src/components/CqiPlansDisplay.jsx`

### Reporting and insights

- [LO comparison](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/ComparisonPage.jsx): `softwareproject_frontend/src/pages/ComparisonPage.jsx`
- [Student reports](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/StudentReportsPage.jsx): `softwareproject_frontend/src/pages/StudentReportsPage.jsx`
- [Batch reports](https://github.com/danusigan/softwareproject/blob/main/softwareproject_frontend/src/pages/BatchReportsPage.jsx): `softwareproject_frontend/src/pages/BatchReportsPage.jsx`

### Other components

- **User**
- **Backend REST API**

## Connections

- User → Application routes: navigates (evidence: `softwareproject_frontend/src/App.jsx`)
- Application routes → Landing page: routes to (evidence: `softwareproject_frontend/src/App.jsx`)
- Application routes → Route guard: protects routes (evidence: `softwareproject_frontend/src/App.jsx`)
- Route guard → Session service: checks session (evidence: `softwareproject_frontend/src/components/ProtectedRoute.jsx`)
- Navigation header → Session service: reads session (evidence: `softwareproject_frontend/src/components/header.jsx`)
- Admin dashboard → Assignment selector: uses selector (evidence: `softwareproject_frontend/src/pages/admindashboard.jsx`)
- Lecturer management → Assignment selector: uses selector (evidence: `softwareproject_frontend/src/pages/ManageLecturersPage.jsx`)
- Marks workbench → Marks service: requests marks (evidence: `softwareproject_frontend/src/pages/MarksWorkbenchPage.jsx`)
- Marks workbench → CQI service: requests CQI (evidence: `softwareproject_frontend/src/pages/MarksWorkbenchPage.jsx`)
- CQI plan review → CQI service: reviews plans (evidence: `softwareproject_frontend/src/pages/CqiReviewPage.jsx`)
- Marks service → Backend REST API: sends REST requests (evidence: `softwareproject_frontend/src/services/marksService.js`)
- CQI service → Backend REST API: sends REST requests (evidence: `softwareproject_frontend/src/services/cqiService.js`)
- CQI plan display → Backend REST API: loads and updates plans (evidence: `softwareproject_frontend/src/components/CqiPlansDisplay.jsx`)
