How bewbam/thesis-submission-system works
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: submissions.service.ts Submission processing · admin.controller.ts Admin API · App.jsx Portal UI · auth.service.ts Authentication service
Components 29
Portal interface
- Portal UI
frontend/src/App.jsx - Library archive UI
frontend/src/LibraryArchivePanel.jsx - Localization
frontend/src/i18n/I18nProvider.jsx
Identity and access
- Authentication API
backend/src/auth/auth.controller.ts - Authentication service
backend/src/auth/auth.service.ts - JWT validation
backend/src/auth/jwt.strategy.ts - Permission checks
backend/src/auth/permissions.guard.ts - User accounts
backend/src/users/users.service.ts
Thesis workflow
- Submission API
backend/src/submissions/submissions.controller.ts - Submission processing
backend/src/submissions/submissions.service.ts - Submission forms
backend/src/submissions/submission-form-fields.service.ts - Review API
backend/src/reviews/reviews.controller.ts - Review workflow
backend/src/reviews/reviews.service.ts - Workflow notifications
backend/src/mail/workflow-mail.service.ts
Archive services
- Archive configuration
backend/src/archive/archive-config.controller.ts - Submission periods
backend/src/archive/submission-periods.service.ts - DSpace provisioning
backend/src/archive/dspace-provisioner.service.ts
Administration
- Admin API
backend/src/admin/admin.controller.ts - User administration
backend/src/admin/admin-users.service.ts - Role administration
backend/src/admin/admin-roles.service.ts - System settings
backend/src/admin/admin-settings.service.ts
Other components
- Student
- Reviewer
- Library staff
- Library director
- Administrator
- PostgreSQL
- DSpace
- SMTP mail
Connections 29
- Student → Portal UI: uses
README.md - Reviewer → Portal UI: uses
README.md - Library staff → Library archive UI: uses
README.md - Library director → Library archive UI: uses
README.md - Administrator → Portal UI: uses
README.md - Portal UI → Localization: renders with
frontend/src/App.jsx - Library archive UI → Localization: renders with
frontend/src/LibraryArchivePanel.jsx - Authentication API → Authentication service: delegates to
backend/src/auth/auth.controller.ts - Authentication service → User accounts: looks up users
backend/src/auth/auth.service.ts - Authentication API → JWT validation: guards routes
backend/src/auth/auth.controller.ts - Review API → Review workflow: delegates to
backend/src/reviews/reviews.controller.ts - Submission API → Submission processing: delegates to
backend/src/submissions/submissions.controller.ts - Submission API → Submission forms: loads form fields
backend/src/submissions/submissions.controller.ts - Submission processing → Submission periods: checks periods
backend/src/submissions/submissions.service.ts - Submission processing → DSpace provisioning: uses provisioning
backend/src/submissions/submissions.service.ts - Submission processing → Workflow notifications: sends notices
backend/src/submissions/submissions.service.ts - Review workflow → Workflow notifications: sends notices
backend/src/reviews/reviews.service.ts - Archive configuration → DSpace provisioning: configures publishing
backend/src/archive/archive-config.controller.ts - Archive configuration → Submission periods: manages periods
- DSpace provisioning → DSpace: provisions archive
README.md - Admin API → User administration: manages users
backend/src/admin/admin.controller.ts - Admin API → Role administration: manages roles
backend/src/admin/admin.controller.ts - Admin API → System settings: updates settings
backend/src/admin/admin.controller.ts - Admin API → Submission forms: configures forms
backend/src/admin/admin.controller.ts - Authentication service → System settings: reads login settings
backend/src/auth/auth.service.ts - Permission checks → JWT validation: checks request user
backend/src/auth/permissions.guard.ts - Submission processing → PostgreSQL: queries records
- Review workflow → PostgreSQL: queries records
- Workflow notifications → SMTP mail: sends email
README.md