# gregtech87/pams-backend architecture

> Architecture diagram of the GitHub repository gregtech87/pams-backend, 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/gregtech87/pams-backend
- Repository: https://github.com/gregtech87/pams-backend

## Overview

The repository appears to be a Spring-based backend for PAMS, with user, item, note, and personal-file domains, plus security, email, and PDF-related code. The README only identifies the project as a work in progress and provides no workflow or architectural documentation. Because no source excerpts are available, the graph groups components by their paths and names but omits unverified calls, data flows, and integrations.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API"]
  node_file_api["File API"]
  node_item_api["Item API"]
  node_note_api["Note API"]
  node_user_api["User API"]
end

subgraph group_domain["Domain Services"]
  node_file_service["File Service"]
  node_item_service["Item Service"]
  node_note_service["Note Service"]
  node_user_service["User Service"]
  node_system_service["System Entity Service"]
  node_email_service["Email Service<br/>[EmailService.java]"]
  node_pdf_generator["PDF Generator<br/>[PdfGenerator.java]"]
end

subgraph group_persistence["Persistence"]
  node_repositories["Repositories"]
  node_entities["Domain Entities"]
end

subgraph group_support["Security and Utilities"]
  node_security["Security Config"]
  node_user_details["User Details"]
  node_file_transfer["File Transfer"]
  node_serialization["Binary Serialization"]
end

node_client(("API Client"))

click node_file_api "https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/controller/FileController.java"
click node_item_api "https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/controller/ItemController.java"
click node_note_api "https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/controller/NoteController.java"
click node_user_api "https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/controller/UserController.java"
click node_file_service "https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/service/PersonalFileServiceImpl.java"
click node_item_service "https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/service/ItemServiceImpl.java"
click node_note_service "https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/service/NoteServiceImpl.java"
click node_user_service "https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/service/UserServiceImpl.java"
click node_system_service "https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/service/SystemEntityServiceImpl.java"
click node_email_service "https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/service/EmailService.java"
click node_pdf_generator "https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/PdfUserInfo/PdfGenerator.java"
click node_repositories "https://github.com/gregtech87/pams-backend/tree/master/src/main/java/com/example/pamsbackend/repositorys"
click node_entities "https://github.com/gregtech87/pams-backend/tree/master/src/main/java/com/example/pamsbackend/entity"
click node_security "https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/securtiy/SecurityConfig.java"
click node_user_details "https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/securtiy/config/CustomUserDetailsService.java"
click node_file_transfer "https://github.com/gregtech87/pams-backend/tree/master/src/main/java/com/example/pamsbackend/fileUpAndDownload"
click node_serialization "https://github.com/gregtech87/pams-backend/tree/master/src/main/java/com/example/pamsbackend/dao"

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_file_api,node_item_api,node_note_api,node_user_api,node_client toneBlue
class node_file_service,node_item_service,node_note_service,node_user_service,node_system_service,node_email_service,node_pdf_generator toneAmber
class node_repositories,node_entities toneMint
class node_security,node_user_details,node_file_transfer,node_serialization toneRose
```

## Components

### API

- [File API](https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/controller/FileController.java): `src/main/java/com/example/pamsbackend/controller/FileController.java`
- [Item API](https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/controller/ItemController.java): `src/main/java/com/example/pamsbackend/controller/ItemController.java`
- [Note API](https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/controller/NoteController.java): `src/main/java/com/example/pamsbackend/controller/NoteController.java`
- [User API](https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/controller/UserController.java): `src/main/java/com/example/pamsbackend/controller/UserController.java`

### Domain Services

- [File Service](https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/service/PersonalFileServiceImpl.java): `src/main/java/com/example/pamsbackend/service/PersonalFileServiceImpl.java`
- [Item Service](https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/service/ItemServiceImpl.java): `src/main/java/com/example/pamsbackend/service/ItemServiceImpl.java`
- [Note Service](https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/service/NoteServiceImpl.java): `src/main/java/com/example/pamsbackend/service/NoteServiceImpl.java`
- [User Service](https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/service/UserServiceImpl.java): `src/main/java/com/example/pamsbackend/service/UserServiceImpl.java`
- [System Entity Service](https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/service/SystemEntityServiceImpl.java): `src/main/java/com/example/pamsbackend/service/SystemEntityServiceImpl.java`
- [Email Service](https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/service/EmailService.java): `src/main/java/com/example/pamsbackend/service/EmailService.java`
- [PDF Generator](https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/PdfUserInfo/PdfGenerator.java): `src/main/java/com/example/pamsbackend/PdfUserInfo/PdfGenerator.java`

### Persistence

- [Repositories](https://github.com/gregtech87/pams-backend/tree/master/src/main/java/com/example/pamsbackend/repositorys): `src/main/java/com/example/pamsbackend/repositorys`
- [Domain Entities](https://github.com/gregtech87/pams-backend/tree/master/src/main/java/com/example/pamsbackend/entity): `src/main/java/com/example/pamsbackend/entity`

### Security and Utilities

- [Security Config](https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/securtiy/SecurityConfig.java): `src/main/java/com/example/pamsbackend/securtiy/SecurityConfig.java`
- [User Details](https://github.com/gregtech87/pams-backend/blob/master/src/main/java/com/example/pamsbackend/securtiy/config/CustomUserDetailsService.java): `src/main/java/com/example/pamsbackend/securtiy/config/CustomUserDetailsService.java`
- [File Transfer](https://github.com/gregtech87/pams-backend/tree/master/src/main/java/com/example/pamsbackend/fileUpAndDownload): `src/main/java/com/example/pamsbackend/fileUpAndDownload`
- [Binary Serialization](https://github.com/gregtech87/pams-backend/tree/master/src/main/java/com/example/pamsbackend/dao): `src/main/java/com/example/pamsbackend/dao`

### Other components

- **API Client**
