# nipunsam-4/thesis-portal architecture

> Architecture diagram of the GitHub repository nipunsam-4/thesis-portal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nipunsam-4/thesis-portal
- Repository: https://github.com/nipunsam-4/thesis-portal

## Overview

The tree indicates a Laravel thesis-progress and approval application: students and institutional staff work through synopsis circulation and numbered PTS submissions, extensions, reviews, and decisions. Role-specific dashboards and administration support that workflow; thesis, student, and form models hold its domain state. The README is the stock Laravel README and does not describe product behavior. Relationships below are limited to those supported by the supplied excerpts or SOURCE INDEX references; unsampled routes and workflow stages are represented without asserting unverified calls.

Main entry points: [`app/Models/Thesis.php`](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Thesis.php) (Thesis state), [`app/Models/Student.php`](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Student.php) (Student records), [`app/Http/Controllers/Admin/SystemAdminController.php`](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Http/Controllers/Admin/SystemAdminController.php) (System administration), [`app/Http/Controllers/Pts3Controller.php`](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Http/Controllers/Pts3Controller.php) (PTS-3 review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Thesis workflow"]
  node_synopsis[("Synopsis circulation")]
  node_pts1[("PTS-1 submission<br/>[Pts1Form.php]")]
  node_pts2[("PTS-2 submission<br/>[Pts2Form.php]")]
  node_pts2ext[("PTS-2 extension<br/>[Pts2Extension.php]")]
  node_pts3["PTS-3 review<br/>[Pts3Controller.php]"]
  node_pts4[("PTS-4 submission<br/>[Pts4Form.php]")]
  node_pts4ext[("PTS-4 extension<br/>[Pts4Extension.php]")]
  node_laterpts[("PTS-5 and PTS-6<br/>[Pts5Form.php]")]
end

subgraph group_records["Thesis records"]
  node_studentrecord[("Student records<br/>[Student.php]")]
  node_thesis[("Thesis state<br/>[Thesis.php]")]
  node_pts3record[("PTS-3 records<br/>[Pts3Form.php]")]
end

subgraph group_people["Roles and administration"]
  node_dashboards["Role dashboards"]
  node_admin["System administration"]
  node_user[("User and roles<br/>[User.php]")]
  node_department[("Departments<br/>[Department.php]")]
end

subgraph group_support["Workflow services"]
  node_documents["PTS documents"]
  node_communications["Examiner communications"]
  node_mail["Workflow email<br/>[PtsMailService.php]"]
end

node_student(("Student"))
node_staff(("University staff"))

node_student -.->|"uses"| node_dashboards
node_staff -.->|"uses"| node_dashboards
node_staff -.->|"administers"| node_admin
node_dashboards -->|"loads"| node_studentrecord
node_admin -->|"manages"| node_department
node_admin -->|"manages"| node_user
node_admin -->|"queries"| node_thesis
node_studentrecord -->|"belongs to"| node_user
node_studentrecord -->|"belongs to"| node_department
node_studentrecord -->|"has theses"| node_thesis
node_thesis -->|"tracks"| node_synopsis
node_thesis -->|"tracks"| node_pts1
node_thesis -->|"tracks"| node_pts2
node_thesis -->|"tracks"| node_pts2ext
node_thesis -->|"tracks"| node_pts3record
node_thesis -->|"tracks"| node_pts4
node_thesis -->|"tracks"| node_pts4ext
node_thesis -->|"tracks"| node_laterpts
node_pts3 -->|"uses"| node_pts3record
node_pts3 -->|"uses"| node_documents
node_pts3 -->|"uses"| node_communications

click node_dashboards "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Http/Controllers/Student/StudentDashboardController.php"
click node_admin "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Http/Controllers/Admin/SystemAdminController.php"
click node_user "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/User.php"
click node_department "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Department.php"
click node_studentrecord "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Student.php"
click node_thesis "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Thesis.php"
click node_synopsis "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/DraftSynopsisCirculation.php"
click node_pts1 "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Pts1Form.php"
click node_pts2 "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Pts2Form.php"
click node_pts2ext "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Pts2Extension.php"
click node_pts3 "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Http/Controllers/Pts3Controller.php"
click node_pts3record "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Pts3Form.php"
click node_pts4 "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Pts4Form.php"
click node_pts4ext "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Pts4Extension.php"
click node_laterpts "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Pts5Form.php"
click node_documents "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Services/PtsDocumentService.php"
click node_communications "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Services/ExaminerCommunicationService.php"
click node_mail "https://github.com/nipunsam-4/thesis-portal/blob/main/app/Services/PtsMailService.php"

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_synopsis,node_pts1,node_pts2,node_pts2ext,node_pts3,node_pts4,node_pts4ext,node_laterpts toneBlue
class node_studentrecord,node_thesis,node_pts3record toneAmber
class node_dashboards,node_admin,node_user,node_department toneMint
class node_documents,node_communications,node_mail toneRose
class node_student,node_staff toneIndigo
```

## Components

### Thesis workflow

- [Synopsis circulation](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/DraftSynopsisCirculation.php): `app/Models/DraftSynopsisCirculation.php`
- [PTS-1 submission](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Pts1Form.php): `app/Models/Pts1Form.php`
- [PTS-2 submission](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Pts2Form.php): `app/Models/Pts2Form.php`
- [PTS-2 extension](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Pts2Extension.php): `app/Models/Pts2Extension.php`
- [PTS-3 review](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Http/Controllers/Pts3Controller.php): `app/Http/Controllers/Pts3Controller.php`
- [PTS-4 submission](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Pts4Form.php): `app/Models/Pts4Form.php`
- [PTS-4 extension](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Pts4Extension.php): `app/Models/Pts4Extension.php`
- [PTS-5 and PTS-6](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Pts5Form.php): `app/Models/Pts5Form.php`

### Thesis records

- [Student records](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Student.php): `app/Models/Student.php`
- [Thesis state](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Thesis.php): `app/Models/Thesis.php`
- [PTS-3 records](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Pts3Form.php): `app/Models/Pts3Form.php`

### Roles and administration

- [Role dashboards](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Http/Controllers/Student/StudentDashboardController.php): `app/Http/Controllers/Student/StudentDashboardController.php`
- [System administration](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Http/Controllers/Admin/SystemAdminController.php): `app/Http/Controllers/Admin/SystemAdminController.php`
- [User and roles](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/User.php): `app/Models/User.php`
- [Departments](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Models/Department.php): `app/Models/Department.php`

### Workflow services

- [PTS documents](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Services/PtsDocumentService.php): `app/Services/PtsDocumentService.php`
- [Examiner communications](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Services/ExaminerCommunicationService.php): `app/Services/ExaminerCommunicationService.php`
- [Workflow email](https://github.com/nipunsam-4/thesis-portal/blob/main/app/Services/PtsMailService.php): `app/Services/PtsMailService.php`

### Other components

- **Student**
- **University staff**

## Connections

- Student → Role dashboards: uses
- University staff → Role dashboards: uses
- University staff → System administration: administers
- Role dashboards → Student records: loads (evidence: `app/Http/Controllers/Student/StudentDashboardController.php`)
- System administration → Departments: manages (evidence: `app/Http/Controllers/Admin/SystemAdminController.php`)
- System administration → User and roles: manages (evidence: `app/Http/Controllers/Admin/SystemAdminController.php`)
- System administration → Thesis state: queries (evidence: `app/Http/Controllers/Admin/SystemAdminController.php`)
- Student records → User and roles: belongs to (evidence: `app/Models/Student.php`)
- Student records → Departments: belongs to (evidence: `app/Models/Student.php`)
- Student records → Thesis state: has theses (evidence: `app/Models/Student.php`)
- Thesis state → Synopsis circulation: tracks (evidence: `app/Models/Thesis.php`)
- Thesis state → PTS-1 submission: tracks (evidence: `app/Models/Thesis.php`)
- Thesis state → PTS-2 submission: tracks (evidence: `app/Models/Thesis.php`)
- Thesis state → PTS-2 extension: tracks (evidence: `app/Models/Thesis.php`)
- Thesis state → PTS-3 records: tracks (evidence: `app/Models/Thesis.php`)
- Thesis state → PTS-4 submission: tracks (evidence: `app/Models/Thesis.php`)
- Thesis state → PTS-4 extension: tracks (evidence: `app/Models/Thesis.php`)
- Thesis state → PTS-5 and PTS-6: tracks (evidence: `app/Models/Thesis.php`)
- PTS-3 review → PTS-3 records: uses (evidence: `app/Http/Controllers/Pts3Controller.php`)
- PTS-3 review → PTS documents: uses (evidence: `app/Http/Controllers/Pts3Controller.php`)
- PTS-3 review → Examiner communications: uses (evidence: `app/Http/Controllers/Pts3Controller.php`)
