# vadilka/scientific-research-management-platform architecture

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

- Interactive diagram: https://gitdiagram.com/vadilka/scientific-research-management-platform
- Repository: https://github.com/vadilka/scientific-research-management-platform

## Overview

This is a bilingual scientific-article management platform. Authors register, create and submit articles (including files); editors assign reviewers; reviewers provide recommendations; editors decide and publish. The backend also supports role administration, notifications, operational reports and monitoring. The frontend routes users to these capabilities and communicates with the Spring backend. Most backend links beyond the excerpted review and submission services are documented capabilities rather than inspected calls, so those links are shown as unverified where useful.

Main entry points: [`backend/src/main/java/pl/san/articlesubmission/ArticleSubmissionSystemApplication.java`](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/ArticleSubmissionSystemApplication.java) (Spring API), [`frontend/src/App.tsx`](https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/App.tsx) (Application routes), [`frontend/src/api/client.ts`](https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/api/client.ts) (API client), [`backend/src/main/java/pl/san/articlesubmission/submission/service/SubmissionService.java`](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/submission/service/SubmissionService.java) (Submission service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Application routes<br/>[App.tsx]"]
  node_submission_ui["Submission pages"]
  node_review_ui["Review pages<br/>[ReviewsPage.tsx]"]
  node_admin_ui["Admin pages<br/>[AdminPage.tsx]"]
  node_reports_ui["Reports pages<br/>[ReportsPage.tsx]"]
  node_notify_ui["Notifications page"]
  node_api["API client<br/>[client.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication service<br/>[UserService.java]"]
  node_jwt["JWT security<br/>[JwtService.java]"]
  node_users[("User records<br/>[User.java]")]
end

subgraph group_workflow["Article workflow"]
  node_submissions["Submission service"]
  node_submission_records[("Article records")]
  node_files["Submission files"]
  node_assignments["Reviewer assignments"]
  node_reviews["Review service<br/>[ReviewService.java]"]
  node_decisions["Editorial decisions"]
end

subgraph group_operations["Workflow support"]
  node_notifications["Notification service"]
  node_reports["Reporting service"]
  node_monitoring["Metrics endpoint"]
end

subgraph group_platform["Runtime platform"]
  node_backend["Spring API"]
  node_postgres[("PostgreSQL")]
end

node_author(("Platform users"))
node_prometheus["Prometheus"]
node_grafana["Grafana"]

node_author -.->|"uses"| node_app
node_app -->|"routes to"| node_submission_ui
node_app -->|"routes to"| node_review_ui
node_app -->|"routes to"| node_admin_ui
node_app -->|"routes to"| node_reports_ui
node_app -->|"routes to"| node_notify_ui
node_review_ui -->|"calls"| node_api
node_submission_ui -.->|"calls"| node_api
node_admin_ui -.->|"calls"| node_api
node_reports_ui -.->|"calls"| node_api
node_notify_ui -.->|"calls"| node_api
node_api -.->|"HTTP requests"| node_backend
node_backend -.->|"dispatches"| node_auth
node_auth -.->|"reads and writes"| node_users
node_backend -.->|"dispatches"| node_submissions
node_submissions -.->|"persists"| node_submission_records
node_submissions -.->|"coordinates"| node_files
node_backend -->|"dispatches"| node_assignments
node_backend -->|"dispatches"| node_reviews
node_assignments -->|"notifies"| node_notifications
node_reviews -->|"notifies"| node_notifications
node_backend -.->|"dispatches"| node_decisions
node_backend -.->|"dispatches"| node_notifications
node_backend -.->|"dispatches"| node_reports
node_reports -->|"reads"| node_submission_records
node_reports -->|"counts"| node_assignments
node_backend -.->|"stores data"| node_postgres
node_prometheus -.->|"scrapes metrics"| node_monitoring
node_grafana -.->|"visualizes metrics"| node_prometheus

click node_app "https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/App.tsx"
click node_submission_ui "https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/pages/SubmissionsPage.tsx"
click node_review_ui "https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/pages/ReviewsPage.tsx"
click node_admin_ui "https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/pages/AdminPage.tsx"
click node_reports_ui "https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/pages/ReportsPage.tsx"
click node_notify_ui "https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/pages/NotificationsPage.tsx"
click node_api "https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/api/client.ts"
click node_auth "https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/user/service/UserService.java"
click node_jwt "https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/config/JwtService.java"
click node_users "https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/user/User.java"
click node_submissions "https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/submission/service/SubmissionService.java"
click node_submission_records "https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/submission/ArticleSubmission.java"
click node_files "https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/submission/service/SubmissionFileService.java"
click node_assignments "https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/review/service/ReviewAssignmentService.java"
click node_reviews "https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/review/service/ReviewService.java"
click node_decisions "https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/review/service/EditorialDecisionService.java"
click node_notifications "https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/notification/service/NotificationService.java"
click node_reports "https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/reporting/service/ReportingService.java"
click node_monitoring "https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/monitoring/MonitoringConfiguration.java"
click node_backend "https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/ArticleSubmissionSystemApplication.java"

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_app,node_submission_ui,node_review_ui,node_admin_ui,node_reports_ui,node_notify_ui,node_api,node_author toneBlue
class node_auth,node_jwt,node_users toneAmber
class node_submissions,node_submission_records,node_files,node_assignments,node_reviews,node_decisions toneMint
class node_notifications,node_reports,node_monitoring toneRose
class node_backend,node_postgres,node_prometheus,node_grafana toneIndigo
```

## Components

### Web client

- [Application routes](https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Submission pages](https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/pages/SubmissionsPage.tsx): `frontend/src/pages/SubmissionsPage.tsx`
- [Review pages](https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/pages/ReviewsPage.tsx): `frontend/src/pages/ReviewsPage.tsx`
- [Admin pages](https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/pages/AdminPage.tsx): `frontend/src/pages/AdminPage.tsx`
- [Reports pages](https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/pages/ReportsPage.tsx): `frontend/src/pages/ReportsPage.tsx`
- [Notifications page](https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/pages/NotificationsPage.tsx): `frontend/src/pages/NotificationsPage.tsx`
- [API client](https://github.com/vadilka/scientific-research-management-platform/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`

### Identity and access

- [Authentication service](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/user/service/UserService.java): `backend/src/main/java/pl/san/articlesubmission/user/service/UserService.java`
- [JWT security](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/config/JwtService.java): `backend/src/main/java/pl/san/articlesubmission/config/JwtService.java`
- [User records](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/user/User.java): `backend/src/main/java/pl/san/articlesubmission/user/User.java`

### Article workflow

- [Submission service](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/submission/service/SubmissionService.java): `backend/src/main/java/pl/san/articlesubmission/submission/service/SubmissionService.java`
- [Article records](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/submission/ArticleSubmission.java): `backend/src/main/java/pl/san/articlesubmission/submission/ArticleSubmission.java`
- [Submission files](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/submission/service/SubmissionFileService.java): `backend/src/main/java/pl/san/articlesubmission/submission/service/SubmissionFileService.java`
- [Reviewer assignments](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/review/service/ReviewAssignmentService.java): `backend/src/main/java/pl/san/articlesubmission/review/service/ReviewAssignmentService.java`
- [Review service](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/review/service/ReviewService.java): `backend/src/main/java/pl/san/articlesubmission/review/service/ReviewService.java`
- [Editorial decisions](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/review/service/EditorialDecisionService.java): `backend/src/main/java/pl/san/articlesubmission/review/service/EditorialDecisionService.java`

### Workflow support

- [Notification service](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/notification/service/NotificationService.java): `backend/src/main/java/pl/san/articlesubmission/notification/service/NotificationService.java`
- [Reporting service](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/reporting/service/ReportingService.java): `backend/src/main/java/pl/san/articlesubmission/reporting/service/ReportingService.java`
- [Metrics endpoint](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/monitoring/MonitoringConfiguration.java): `backend/src/main/java/pl/san/articlesubmission/monitoring/MonitoringConfiguration.java`

### Runtime platform

- [Spring API](https://github.com/vadilka/scientific-research-management-platform/blob/main/backend/src/main/java/pl/san/articlesubmission/ArticleSubmissionSystemApplication.java): `backend/src/main/java/pl/san/articlesubmission/ArticleSubmissionSystemApplication.java`
- **PostgreSQL**

### Other components

- **Platform users**
- **Prometheus**
- **Grafana**

## Connections

- Platform users → Application routes: uses (evidence: `README.md`)
- Application routes → Submission pages: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Review pages: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Admin pages: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Reports pages: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Notifications page: routes to (evidence: `frontend/src/App.tsx`)
- Review pages → API client: calls (evidence: `frontend/src/pages/ReviewsPage.tsx`)
- Submission pages → API client: calls
- Admin pages → API client: calls
- Reports pages → API client: calls
- Notifications page → API client: calls
- API client → Spring API: HTTP requests
- Spring API → Authentication service: dispatches
- Authentication service → User records: reads and writes (evidence: `README.md`)
- Spring API → Submission service: dispatches
- Submission service → Article records: persists (evidence: `README.md`)
- Submission service → Submission files: coordinates (evidence: `README.md`)
- Spring API → Reviewer assignments: dispatches
- Spring API → Review service: dispatches
- Reviewer assignments → Notification service: notifies (evidence: `backend/src/main/java/pl/san/articlesubmission/review/service/ReviewAssignmentService.java`)
- Review service → Notification service: notifies (evidence: `backend/src/main/java/pl/san/articlesubmission/review/service/ReviewService.java`)
- Spring API → Editorial decisions: dispatches
- Spring API → Notification service: dispatches
- Spring API → Reporting service: dispatches
- Reporting service → Article records: reads (evidence: `backend/src/main/java/pl/san/articlesubmission/reporting/service/ReportingService.java`)
- Reporting service → Reviewer assignments: counts (evidence: `backend/src/main/java/pl/san/articlesubmission/reporting/service/ReportingService.java`)
- Spring API → PostgreSQL: stores data (evidence: `README.md`)
- Prometheus → Metrics endpoint: scrapes metrics (evidence: `README.md`)
- Grafana → Prometheus: visualizes metrics (evidence: `README.md`)
