# ajstyles20/fyp-repository-and-supervision-platform architecture

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

- Interactive diagram: https://gitdiagram.com/ajstyles20/fyp-repository-and-supervision-platform
- Repository: https://github.com/ajstyles20/fyp-repository-and-supervision-platform

## Overview

Baze Project Hub is a Django application for student accounts and final-year project supervision, approvals, and discovery. Students register and await staff review; signed-in users and staff then use role-scoped project workflows, while authorized staff can allocate supervisors and maintain assignment history. Current and archived projects, academic structure, and project documents support the repository experience. The sampled views and models show the main interactions; some README-documented capabilities, including approvals and document handling, are represented at their shared project-view or model layer because their individual handlers were not sampled.

Main entry points: [`projecthub_slice1/apps/projects/views.py`](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/projects/views.py) (Project workflows), [`projecthub_slice1/apps/accounts/views.py`](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/accounts/views.py) (Account workflows), [`projecthub_slice1/apps/accounts/forms.py`](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/accounts/forms.py) (Login & registration forms), [`projecthub_slice1/apps/accounts/permissions.py`](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/accounts/permissions.py) (Role permissions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Accounts &amp; access"]
  node_account_views["Account workflows<br/>[views.py]"]
  node_account_forms["Login &amp; registration forms<br/>[forms.py]"]
  node_account_models["Users &amp; student profiles<br/>[models.py]"]
  node_permissions["Role permissions<br/>[permissions.py]"]
end

subgraph group_academics["Academic structure"]
  node_academic_views["Academic structure view<br/>[views.py]"]
  node_academic_models["Faculty, departments &amp; programmes<br/>[models.py]"]
end

subgraph group_projects["Project management"]
  node_project_views["Project workflows<br/>[views.py]"]
  node_project_forms["Project forms<br/>[forms.py]"]
  node_assignment_service["Supervisor assignment service<br/>[services.py]"]
  node_project_models["Projects &amp; assignments<br/>[models.py]"]
end

subgraph group_repository["Project repository"]
  node_repository["Current &amp; past project repository<br/>[views.py]"]
  node_project_documents["Project documents<br/>[models.py]"]
end

node_user(("Students &amp; staff"))

node_user -->|"registers or signs in"| node_account_views
node_user -->|"uses project workflows"| node_project_views
node_account_views -->|"validates submissions"| node_account_forms
node_account_views -->|"reviews registrations"| node_account_models
node_account_views -->|"checks roles"| node_permissions
node_account_forms -->|"creates accounts"| node_account_models
node_account_forms -->|"loads programmes"| node_academic_models
node_academic_views -->|"reads academic structure"| node_academic_models
node_academic_views -->|"restricts staff access"| node_permissions
node_project_views -->|"validates project actions"| node_project_forms
node_project_views -->|"reads project records"| node_project_models
node_project_views -->|"assigns supervisors"| node_assignment_service
node_assignment_service -->|"updates assignment history"| node_project_models
node_project_views -->|"builds repository results"| node_repository
node_repository -.->|"serves authorized downloads"| node_project_documents
node_project_views -->|"restricts project access"| node_permissions

click node_account_views "https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/accounts/views.py"
click node_account_forms "https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/accounts/forms.py"
click node_account_models "https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/accounts/models.py"
click node_permissions "https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/accounts/permissions.py"
click node_academic_views "https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/academics/views.py"
click node_academic_models "https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/academics/models.py"
click node_project_views "https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/projects/views.py"
click node_project_forms "https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/projects/forms.py"
click node_assignment_service "https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/projects/services.py"
click node_project_models "https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/projects/models.py"
click node_repository "https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/projects/views.py"
click node_project_documents "https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/projects/models.py"

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_account_views,node_account_forms,node_account_models,node_permissions toneBlue
class node_academic_views,node_academic_models toneAmber
class node_project_views,node_project_forms,node_assignment_service,node_project_models toneMint
class node_repository,node_project_documents toneRose
class node_user toneIndigo
```

## Components

### Accounts & access

- [Account workflows](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/accounts/views.py): `projecthub_slice1/apps/accounts/views.py`
- [Login & registration forms](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/accounts/forms.py): `projecthub_slice1/apps/accounts/forms.py`
- [Users & student profiles](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/accounts/models.py): `projecthub_slice1/apps/accounts/models.py`
- [Role permissions](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/accounts/permissions.py): `projecthub_slice1/apps/accounts/permissions.py`

### Academic structure

- [Academic structure view](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/academics/views.py): `projecthub_slice1/apps/academics/views.py`
- [Faculty, departments & programmes](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/academics/models.py): `projecthub_slice1/apps/academics/models.py`

### Project management

- [Project workflows](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/projects/views.py): `projecthub_slice1/apps/projects/views.py`
- [Project forms](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/projects/forms.py): `projecthub_slice1/apps/projects/forms.py`
- [Supervisor assignment service](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/projects/services.py): `projecthub_slice1/apps/projects/services.py`
- [Projects & assignments](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/projects/models.py): `projecthub_slice1/apps/projects/models.py`

### Project repository

- [Current & past project repository](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/projects/views.py): `projecthub_slice1/apps/projects/views.py`
- [Project documents](https://github.com/ajstyles20/fyp-repository-and-supervision-platform/blob/main/projecthub_slice1/apps/projects/models.py): `projecthub_slice1/apps/projects/models.py`

### Other components

- **Students & staff**

## Connections

- Students & staff → Account workflows: registers or signs in (evidence: `README.md`)
- Students & staff → Project workflows: uses project workflows (evidence: `README.md`)
- Account workflows → Login & registration forms: validates submissions (evidence: `projecthub_slice1/apps/accounts/views.py`)
- Account workflows → Users & student profiles: reviews registrations (evidence: `projecthub_slice1/apps/accounts/views.py`)
- Account workflows → Role permissions: checks roles (evidence: `projecthub_slice1/apps/accounts/views.py`)
- Login & registration forms → Users & student profiles: creates accounts (evidence: `projecthub_slice1/apps/accounts/forms.py`)
- Login & registration forms → Faculty, departments & programmes: loads programmes (evidence: `projecthub_slice1/apps/accounts/forms.py`)
- Academic structure view → Faculty, departments & programmes: reads academic structure (evidence: `projecthub_slice1/apps/academics/views.py`)
- Academic structure view → Role permissions: restricts staff access (evidence: `projecthub_slice1/apps/academics/views.py`)
- Project workflows → Project forms: validates project actions (evidence: `projecthub_slice1/apps/projects/views.py`)
- Project workflows → Projects & assignments: reads project records (evidence: `projecthub_slice1/apps/projects/views.py`)
- Project workflows → Supervisor assignment service: assigns supervisors (evidence: `projecthub_slice1/apps/projects/views.py`)
- Supervisor assignment service → Projects & assignments: updates assignment history (evidence: `projecthub_slice1/apps/projects/services.py`)
- Project workflows → Current & past project repository: builds repository results (evidence: `projecthub_slice1/apps/projects/views.py`)
- Current & past project repository → Project documents: serves authorized downloads (evidence: `README.md`)
- Project workflows → Role permissions: restricts project access (evidence: `projecthub_slice1/apps/projects/views.py`)
