# bewbam/thesis-submission-system architecture

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

- Interactive diagram: https://gitdiagram.com/bewbam/thesis-submission-system
- Repository: https://github.com/bewbam/thesis-submission-system

## Overview

Thesis Portal supports thesis submission, multi-stage academic and library review, and archival to DSpace, with separate administration and account controls. The graph follows documented workflow stages and source-visible controller/service ownership. Some UI-to-API and mail transport details are not shown in the excerpts, so those connections are limited to explicit README evidence or omitted.

Main entry points: [`backend/src/submissions/submissions.service.ts`](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/submissions/submissions.service.ts) (Submission processing), [`backend/src/admin/admin.controller.ts`](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/admin/admin.controller.ts) (Admin API), [`frontend/src/App.jsx`](https://github.com/bewbam/thesis-submission-system/blob/main/frontend/src/App.jsx) (Portal UI), [`backend/src/auth/auth.service.ts`](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/auth/auth.service.ts) (Authentication service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Portal interface"]
  node_portal["Portal UI<br/>[App.jsx]"]
  node_library_ui["Library archive UI"]
  node_i18n["Localization<br/>[I18nProvider.jsx]"]
end

subgraph group_identity["Identity and access"]
  node_auth_api["Authentication API<br/>[auth.controller.ts]"]
  node_auth_service["Authentication service<br/>[auth.service.ts]"]
  node_jwt["JWT validation<br/>[jwt.strategy.ts]"]
  node_permissions["Permission checks"]
  node_users["User accounts<br/>[users.service.ts]"]
end

subgraph group_workflow["Thesis workflow"]
  node_submissions_api["Submission API"]
  node_submissions["Submission processing"]
  node_form_fields["Submission forms"]
  node_reviews_api["Review API"]
  node_reviews["Review workflow<br/>[reviews.service.ts]"]
  node_workflow_mail["Workflow notifications"]
end

subgraph group_archive["Archive services"]
  node_archive_config["Archive configuration"]
  node_periods["Submission periods"]
  node_dspace["DSpace provisioning"]
end

subgraph group_admin["Administration"]
  node_admin_api["Admin API"]
  node_admin_users["User administration"]
  node_admin_roles["Role administration"]
  node_admin_settings["System settings"]
end

node_student(("Student"))
node_reviewer(("Reviewer"))
node_library_staff(("Library staff"))
node_director(("Library director"))
node_administrator(("Administrator"))
node_postgres[("PostgreSQL")]
node_dspace_service["DSpace"]
node_smtp["SMTP mail"]

node_student -->|"uses"| node_portal
node_reviewer -->|"uses"| node_portal
node_library_staff -->|"uses"| node_library_ui
node_director -->|"uses"| node_library_ui
node_administrator -->|"uses"| node_portal
node_portal -->|"renders with"| node_i18n
node_library_ui -->|"renders with"| node_i18n
node_auth_api -->|"delegates to"| node_auth_service
node_auth_service -->|"looks up users"| node_users
node_auth_api -->|"guards routes"| node_jwt
node_reviews_api -->|"delegates to"| node_reviews
node_submissions_api -->|"delegates to"| node_submissions
node_submissions_api -->|"loads form fields"| node_form_fields
node_submissions -->|"checks periods"| node_periods
node_submissions -->|"uses provisioning"| node_dspace
node_submissions -->|"sends notices"| node_workflow_mail
node_reviews -->|"sends notices"| node_workflow_mail
node_archive_config -->|"configures publishing"| node_dspace
node_archive_config -->|"manages periods"| node_periods
node_dspace -.->|"provisions archive"| node_dspace_service
node_admin_api -->|"manages users"| node_admin_users
node_admin_api -->|"manages roles"| node_admin_roles
node_admin_api -->|"updates settings"| node_admin_settings
node_admin_api -->|"configures forms"| node_form_fields
node_auth_service -->|"reads login settings"| node_admin_settings
node_permissions -->|"checks request user"| node_jwt
node_submissions -.->|"queries records"| node_postgres
node_reviews -.->|"queries records"| node_postgres
node_workflow_mail -.->|"sends email"| node_smtp

click node_portal "https://github.com/bewbam/thesis-submission-system/blob/main/frontend/src/App.jsx"
click node_library_ui "https://github.com/bewbam/thesis-submission-system/blob/main/frontend/src/LibraryArchivePanel.jsx"
click node_i18n "https://github.com/bewbam/thesis-submission-system/blob/main/frontend/src/i18n/I18nProvider.jsx"
click node_auth_api "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/auth/auth.controller.ts"
click node_auth_service "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/auth/auth.service.ts"
click node_jwt "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/auth/jwt.strategy.ts"
click node_permissions "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/auth/permissions.guard.ts"
click node_users "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/users/users.service.ts"
click node_submissions_api "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/submissions/submissions.controller.ts"
click node_submissions "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/submissions/submissions.service.ts"
click node_form_fields "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/submissions/submission-form-fields.service.ts"
click node_reviews_api "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/reviews/reviews.controller.ts"
click node_reviews "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/reviews/reviews.service.ts"
click node_workflow_mail "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/mail/workflow-mail.service.ts"
click node_archive_config "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/archive/archive-config.controller.ts"
click node_periods "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/archive/submission-periods.service.ts"
click node_dspace "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/archive/dspace-provisioner.service.ts"
click node_admin_api "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/admin/admin.controller.ts"
click node_admin_users "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/admin/admin-users.service.ts"
click node_admin_roles "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/admin/admin-roles.service.ts"
click node_admin_settings "https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/admin/admin-settings.service.ts"

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_portal,node_library_ui,node_i18n,node_reviewer toneBlue
class node_auth_api,node_auth_service,node_jwt,node_permissions,node_users,node_postgres toneAmber
class node_submissions_api,node_submissions,node_form_fields,node_reviews_api,node_reviews,node_workflow_mail toneMint
class node_archive_config,node_periods,node_dspace toneRose
class node_admin_api,node_admin_users,node_admin_roles,node_admin_settings,node_student,node_library_staff,node_director,node_administrator,node_dspace_service,node_smtp toneIndigo
```

## Components

### Portal interface

- [Portal UI](https://github.com/bewbam/thesis-submission-system/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Library archive UI](https://github.com/bewbam/thesis-submission-system/blob/main/frontend/src/LibraryArchivePanel.jsx): `frontend/src/LibraryArchivePanel.jsx`
- [Localization](https://github.com/bewbam/thesis-submission-system/blob/main/frontend/src/i18n/I18nProvider.jsx): `frontend/src/i18n/I18nProvider.jsx`

### Identity and access

- [Authentication API](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/auth/auth.controller.ts): `backend/src/auth/auth.controller.ts`
- [Authentication service](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/auth/auth.service.ts): `backend/src/auth/auth.service.ts`
- [JWT validation](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/auth/jwt.strategy.ts): `backend/src/auth/jwt.strategy.ts`
- [Permission checks](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/auth/permissions.guard.ts): `backend/src/auth/permissions.guard.ts`
- [User accounts](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/users/users.service.ts): `backend/src/users/users.service.ts`

### Thesis workflow

- [Submission API](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/submissions/submissions.controller.ts): `backend/src/submissions/submissions.controller.ts`
- [Submission processing](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/submissions/submissions.service.ts): `backend/src/submissions/submissions.service.ts`
- [Submission forms](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/submissions/submission-form-fields.service.ts): `backend/src/submissions/submission-form-fields.service.ts`
- [Review API](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/reviews/reviews.controller.ts): `backend/src/reviews/reviews.controller.ts`
- [Review workflow](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/reviews/reviews.service.ts): `backend/src/reviews/reviews.service.ts`
- [Workflow notifications](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/mail/workflow-mail.service.ts): `backend/src/mail/workflow-mail.service.ts`

### Archive services

- [Archive configuration](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/archive/archive-config.controller.ts): `backend/src/archive/archive-config.controller.ts`
- [Submission periods](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/archive/submission-periods.service.ts): `backend/src/archive/submission-periods.service.ts`
- [DSpace provisioning](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/archive/dspace-provisioner.service.ts): `backend/src/archive/dspace-provisioner.service.ts`

### Administration

- [Admin API](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/admin/admin.controller.ts): `backend/src/admin/admin.controller.ts`
- [User administration](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/admin/admin-users.service.ts): `backend/src/admin/admin-users.service.ts`
- [Role administration](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/admin/admin-roles.service.ts): `backend/src/admin/admin-roles.service.ts`
- [System settings](https://github.com/bewbam/thesis-submission-system/blob/main/backend/src/admin/admin-settings.service.ts): `backend/src/admin/admin-settings.service.ts`

### Other components

- **Student**
- **Reviewer**
- **Library staff**
- **Library director**
- **Administrator**
- **PostgreSQL**
- **DSpace**
- **SMTP mail**

## Connections

- Student → Portal UI: uses (evidence: `README.md`)
- Reviewer → Portal UI: uses (evidence: `README.md`)
- Library staff → Library archive UI: uses (evidence: `README.md`)
- Library director → Library archive UI: uses (evidence: `README.md`)
- Administrator → Portal UI: uses (evidence: `README.md`)
- Portal UI → Localization: renders with (evidence: `frontend/src/App.jsx`)
- Library archive UI → Localization: renders with (evidence: `frontend/src/LibraryArchivePanel.jsx`)
- Authentication API → Authentication service: delegates to (evidence: `backend/src/auth/auth.controller.ts`)
- Authentication service → User accounts: looks up users (evidence: `backend/src/auth/auth.service.ts`)
- Authentication API → JWT validation: guards routes (evidence: `backend/src/auth/auth.controller.ts`)
- Review API → Review workflow: delegates to (evidence: `backend/src/reviews/reviews.controller.ts`)
- Submission API → Submission processing: delegates to (evidence: `backend/src/submissions/submissions.controller.ts`)
- Submission API → Submission forms: loads form fields (evidence: `backend/src/submissions/submissions.controller.ts`)
- Submission processing → Submission periods: checks periods (evidence: `backend/src/submissions/submissions.service.ts`)
- Submission processing → DSpace provisioning: uses provisioning (evidence: `backend/src/submissions/submissions.service.ts`)
- Submission processing → Workflow notifications: sends notices (evidence: `backend/src/submissions/submissions.service.ts`)
- Review workflow → Workflow notifications: sends notices (evidence: `backend/src/reviews/reviews.service.ts`)
- Archive configuration → DSpace provisioning: configures publishing (evidence: `backend/src/archive/archive-config.controller.ts`)
- Archive configuration → Submission periods: manages periods
- DSpace provisioning → DSpace: provisions archive (evidence: `README.md`)
- Admin API → User administration: manages users (evidence: `backend/src/admin/admin.controller.ts`)
- Admin API → Role administration: manages roles (evidence: `backend/src/admin/admin.controller.ts`)
- Admin API → System settings: updates settings (evidence: `backend/src/admin/admin.controller.ts`)
- Admin API → Submission forms: configures forms (evidence: `backend/src/admin/admin.controller.ts`)
- Authentication service → System settings: reads login settings (evidence: `backend/src/auth/auth.service.ts`)
- Permission checks → JWT validation: checks request user (evidence: `backend/src/auth/permissions.guard.ts`)
- Submission processing → PostgreSQL: queries records
- Review workflow → PostgreSQL: queries records
- Workflow notifications → SMTP mail: sends email (evidence: `README.md`)
