# sullacarlvinjay/thesisdjango architecture

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

- Interactive diagram: https://gitdiagram.com/sullacarlvinjay/thesisdjango
- Repository: https://github.com/sullacarlvinjay/thesisdjango

## Overview

Thesis is a scholarship and student-record management system, with student, staff, partner, and SDSO office portals. Its core workflow spans account access and verification, scholarship applications or declarations, office review, and maintained scholar records; reporting and ranking form additional office capabilities. The README provides no product detail, so portal capabilities are identified from module names and the sampled code. Several major modules are unsampled; their relationships are omitted where the available evidence does not establish them.

Main entry points: [`backend/api/models.py`](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/models.py) (Domain records), [`backend/api/views_auth.py`](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_auth.py) (Sign-in and registration), [`backend/api/views_vpsea.py`](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_vpsea.py) (SDSO office portal), [`backend/api/views_archives.py`](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_archives.py) (Scholar archives)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and accounts"]
  node_auth["Sign-in and registration<br/>[views_auth.py]"]
  node_email["Email verification<br/>[email_verify.py]"]
  node_mfa["Multi-factor auth<br/>[mfa.py]"]
end

subgraph group_portals["Scholarship portals"]
  node_student["Student portal<br/>[views_student.py]"]
  node_staff["Staff portal<br/>[views_staff.py]"]
  node_partner["Partner portal<br/>[views_partner.py]"]
  node_catalogue["Scholarship catalogue<br/>[catalogue.py]"]
  node_declarations["Scholarship declarations"]
end

subgraph group_office["Office operations"]
  node_office["SDSO office portal<br/>[views_vpsea.py]"]
  node_archives["Scholar archives<br/>[views_archives.py]"]
  node_ranking["Scholarship rankings<br/>[staff_ranking.py]"]
  node_analytics["Analytics and reports<br/>[views_analytics.py]"]
  node_masterlist["Masterlist reports"]
end

subgraph group_shared["Shared services"]
  node_models[("Domain records<br/>[models.py]")]
  node_sharedviews["Portal workflows<br/>[views_shared.py]"]
  node_columns["Scholar columns<br/>[scholar_columns.py]"]
  node_notify["Notifications<br/>[notify.py]"]
  node_ratelimit["Credential throttling<br/>[ratelimit.py]"]
  node_jobs["Background jobs<br/>[jobs.py]"]
  node_terms["Academic terms<br/>[terms.py]"]
end

node_applicant(("Portal users"))

node_applicant -.->|"uses"| node_auth
node_auth -->|"reads accounts"| node_models
node_auth -->|"checks attempts"| node_ratelimit
node_auth -->|"verifies email"| node_email
node_auth -->|"uses terms"| node_terms
node_auth -->|"sends notices"| node_notify
node_auth -->|"uses MFA"| node_mfa
node_office -->|"reads and updates"| node_models
node_office -->|"uses helpers"| node_sharedviews
node_office -->|"delegates reviews"| node_declarations
node_office -->|"uses archive workflows"| node_archives
node_office -->|"uses columns"| node_columns
node_office -->|"sends notices"| node_notify
node_archives -->|"reads and updates"| node_models
node_archives -->|"uses columns"| node_columns
node_archives -->|"uses helpers"| node_sharedviews
node_declarations -->|"creates records"| node_models
node_sharedviews -->|"reads records"| node_models
node_columns -->|"reads records"| node_models
node_columns -->|"supports reports"| node_masterlist
node_notify -->|"writes notifications"| node_models
node_notify -->|"uses jobs"| node_jobs
node_student -.->|"uses records"| node_models
node_staff -->|"uses records"| node_models
node_staff -->|"uses helpers"| node_sharedviews
node_student -.->|"browses programmes"| node_catalogue
node_partner -.->|"manages records"| node_models
node_ranking -.->|"uses records"| node_models
node_analytics -.->|"uses records"| node_models
node_masterlist -.->|"uses records"| node_models

click node_auth "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_auth.py"
click node_email "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/email_verify.py"
click node_mfa "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/mfa.py"
click node_student "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_student.py"
click node_staff "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_staff.py"
click node_partner "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_partner.py"
click node_catalogue "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/catalogue.py"
click node_declarations "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_declarations.py"
click node_office "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_vpsea.py"
click node_archives "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_archives.py"
click node_ranking "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/staff_ranking.py"
click node_analytics "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_analytics.py"
click node_masterlist "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/masterlist_report.py"
click node_models "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/models.py"
click node_sharedviews "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_shared.py"
click node_columns "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/scholar_columns.py"
click node_notify "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/notify.py"
click node_ratelimit "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/ratelimit.py"
click node_jobs "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/jobs.py"
click node_terms "https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/terms.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_auth,node_email,node_mfa,node_applicant toneBlue
class node_student,node_staff,node_partner,node_catalogue,node_declarations toneAmber
class node_office,node_archives,node_ranking,node_analytics,node_masterlist toneMint
class node_models,node_sharedviews,node_columns,node_notify,node_ratelimit,node_jobs,node_terms toneRose
```

## Components

### Access and accounts

- [Sign-in and registration](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_auth.py): `backend/api/views_auth.py`
- [Email verification](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/email_verify.py): `backend/api/email_verify.py`
- [Multi-factor auth](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/mfa.py): `backend/api/mfa.py`

### Scholarship portals

- [Student portal](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_student.py): `backend/api/views_student.py`
- [Staff portal](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_staff.py): `backend/api/views_staff.py`
- [Partner portal](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_partner.py): `backend/api/views_partner.py`
- [Scholarship catalogue](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/catalogue.py): `backend/api/catalogue.py`
- [Scholarship declarations](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_declarations.py): `backend/api/views_declarations.py`

### Office operations

- [SDSO office portal](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_vpsea.py): `backend/api/views_vpsea.py`
- [Scholar archives](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_archives.py): `backend/api/views_archives.py`
- [Scholarship rankings](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/staff_ranking.py): `backend/api/staff_ranking.py`
- [Analytics and reports](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_analytics.py): `backend/api/views_analytics.py`
- [Masterlist reports](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/masterlist_report.py): `backend/api/masterlist_report.py`

### Shared services

- [Domain records](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/models.py): `backend/api/models.py`
- [Portal workflows](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/views_shared.py): `backend/api/views_shared.py`
- [Scholar columns](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/scholar_columns.py): `backend/api/scholar_columns.py`
- [Notifications](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/notify.py): `backend/api/notify.py`
- [Credential throttling](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/ratelimit.py): `backend/api/ratelimit.py`
- [Background jobs](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/jobs.py): `backend/api/jobs.py`
- [Academic terms](https://github.com/sullacarlvinjay/thesisdjango/blob/main/backend/api/terms.py): `backend/api/terms.py`

### Other components

- **Portal users**

## Connections

- Portal users → Sign-in and registration: uses
- Sign-in and registration → Domain records: reads accounts (evidence: `backend/api/views_auth.py`)
- Sign-in and registration → Credential throttling: checks attempts (evidence: `backend/api/views_auth.py`)
- Sign-in and registration → Email verification: verifies email (evidence: `backend/api/views_auth.py`)
- Sign-in and registration → Academic terms: uses terms (evidence: `backend/api/views_auth.py`)
- Sign-in and registration → Notifications: sends notices (evidence: `backend/api/views_auth.py`)
- Sign-in and registration → Multi-factor auth: uses MFA
- SDSO office portal → Domain records: reads and updates (evidence: `backend/api/views_vpsea.py`)
- SDSO office portal → Portal workflows: uses helpers (evidence: `backend/api/views_vpsea.py`)
- SDSO office portal → Scholarship declarations: delegates reviews (evidence: `backend/api/views_vpsea.py`)
- SDSO office portal → Scholar archives: uses archive workflows (evidence: `backend/api/views_vpsea.py`)
- SDSO office portal → Scholar columns: uses columns (evidence: `backend/api/views_vpsea.py`)
- SDSO office portal → Notifications: sends notices (evidence: `backend/api/views_vpsea.py`)
- Scholar archives → Domain records: reads and updates (evidence: `backend/api/views_archives.py`)
- Scholar archives → Scholar columns: uses columns (evidence: `backend/api/views_archives.py`)
- Scholar archives → Portal workflows: uses helpers (evidence: `backend/api/views_archives.py`)
- Scholarship declarations → Domain records: creates records (evidence: `backend/api/views_declarations.py`)
- Portal workflows → Domain records: reads records (evidence: `backend/api/views_shared.py`)
- Scholar columns → Domain records: reads records (evidence: `backend/api/scholar_columns.py`)
- Scholar columns → Masterlist reports: supports reports (evidence: `backend/api/scholar_columns.py`)
- Notifications → Domain records: writes notifications (evidence: `backend/api/notify.py`)
- Notifications → Background jobs: uses jobs (evidence: `backend/api/notify.py`)
- Student portal → Domain records: uses records
- Staff portal → Domain records: uses records (evidence: `backend/api/views_staff.py`)
- Staff portal → Portal workflows: uses helpers (evidence: `backend/api/views_staff.py`)
- Student portal → Scholarship catalogue: browses programmes
- Partner portal → Domain records: manages records
- Scholarship rankings → Domain records: uses records
- Analytics and reports → Domain records: uses records
- Masterlist reports → Domain records: uses records
