# khasan013/dbms_backend architecture

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

- Interactive diagram: https://gitdiagram.com/khasan013/dbms_backend
- Repository: https://github.com/khasan013/dbms_backend

## Overview

CampusCrate is a campus-services backend exposing account and admin APIs alongside lost-and-found, marketplace, food ordering, and to-let listings. The user-facing flow is an HTTP request handled by a controller, processed by a service, and—where supported by the sampled source—persisted through repositories; authentication uses JWT-backed identity checks. The tree also shows supporting image, notification, location, category, and claim capabilities. The README is empty, and most controllers and services were not excerpted, so links for those subsystems are omitted rather than inferred.

Main entry points: [`src/main/java/com/campuscrate/service/UserService.java`](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/UserService.java) (User accounts), [`src/main/java/com/campuscrate/service/AdminService.java`](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/AdminService.java) (Admin operations), [`src/main/java/com/campuscrate/service/FoodService.java`](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/FoodService.java) (Food ordering), [`src/main/java/com/campuscrate/controller/UserController.java`](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/UserController.java) (User API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Accounts and Access"]
  node_user_api["User API"]
  node_user_service["User accounts<br/>[UserService.java]"]
  node_user_store[("User records")]
  node_admin_api["Admin API"]
  node_admin_service["Admin operations<br/>[AdminService.java]"]
  node_jwt["JWT tokens<br/>[JwtService.java]"]
end

subgraph group_community["Campus Services"]
  node_items_api["Lost-found API"]
  node_items_service["Lost-found items<br/>[ItemService.java]"]
  node_items_store[("Item records")]
  node_claims_api["Claims API"]
  node_claims_service["Claims<br/>[ClaimService.java]"]
  node_tolet_api["To-let API"]
  node_tolet_service["To-let listings"]
  node_tolet_store[("Listing records")]
end

subgraph group_commerce["Commerce"]
  node_market_api["Marketplace API"]
  node_market_service["Marketplace listings"]
  node_market_store[("Marketplace records")]
  node_food_api["Food API"]
  node_food_service["Food ordering<br/>[FoodService.java]"]
  node_food_store[("Food records")]
  node_payments["Payment validation"]
end

subgraph group_platform["Platform Support"]
  node_images["Image uploads"]
  node_notifications[("Notifications")]
  node_taxonomy["Categories and locations"]
end

node_client(("API client"))
node_cloudinary["Cloudinary"]

node_client -.->|"sends requests"| node_user_api
node_client -.->|"sends requests"| node_admin_api
node_client -.->|"sends requests"| node_items_api
node_client -.->|"sends requests"| node_claims_api
node_client -.->|"sends requests"| node_market_api
node_client -.->|"sends requests"| node_food_api
node_client -.->|"sends requests"| node_tolet_api
node_user_api -->|"delegates to"| node_user_service
node_user_service -->|"reads and writes"| node_user_store
node_user_service -->|"creates tokens"| node_jwt
node_admin_api -->|"delegates to"| node_admin_service
node_admin_service -->|"creates tokens"| node_jwt
node_admin_service -->|"manages users"| node_user_store
node_items_api -.->|"delegates to"| node_items_service
node_items_service -->|"reads and writes"| node_items_store
node_claims_api -.->|"delegates to"| node_claims_service
node_market_api -->|"delegates to"| node_market_service
node_market_service -->|"reads and writes"| node_market_store
node_food_api -->|"delegates to"| node_food_service
node_food_service -->|"reads and writes"| node_food_store
node_food_service -->|"validates payment"| node_payments
node_tolet_api -.->|"delegates to"| node_tolet_service
node_tolet_service -->|"reads and writes"| node_tolet_store
node_images -.->|"uploads images"| node_cloudinary

click node_user_api "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/UserController.java"
click node_user_service "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/UserService.java"
click node_user_store "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/repository/UserRepository.java"
click node_admin_api "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/AdminController.java"
click node_admin_service "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/AdminService.java"
click node_jwt "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/security/JwtService.java"
click node_items_api "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/ItemController.java"
click node_items_service "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/ItemService.java"
click node_items_store "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/repository/ItemRepository.java"
click node_claims_api "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/ClaimController.java"
click node_claims_service "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/ClaimService.java"
click node_market_api "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/MarketplacePostController.java"
click node_market_service "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/MarketplacePostService.java"
click node_market_store "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/repository/MarketplacePostRepository.java"
click node_food_api "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/FoodController.java"
click node_food_service "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/FoodService.java"
click node_food_store "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/repository/FoodRepository.java"
click node_payments "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/SslCommerzService.java"
click node_tolet_api "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/ToLetListingController.java"
click node_tolet_service "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/ToLetListingService.java"
click node_tolet_store "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/repository/ToLetListingRepository.java"
click node_images "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/ImageUploadService.java"
click node_notifications "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/repository/NotificationRepository.java"
click node_taxonomy "https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/CategoryController.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_user_api,node_user_service,node_user_store,node_admin_api,node_admin_service,node_jwt,node_client toneBlue
class node_items_api,node_items_service,node_items_store,node_claims_api,node_claims_service,node_tolet_api,node_tolet_service,node_tolet_store toneAmber
class node_market_api,node_market_service,node_market_store,node_food_api,node_food_service,node_food_store,node_payments toneMint
class node_images,node_notifications,node_taxonomy toneRose
class node_cloudinary toneIndigo
```

## Components

### Accounts and Access

- [User API](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/UserController.java): `src/main/java/com/campuscrate/controller/UserController.java`
- [User accounts](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/UserService.java): `src/main/java/com/campuscrate/service/UserService.java`
- [User records](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/repository/UserRepository.java): `src/main/java/com/campuscrate/repository/UserRepository.java`
- [Admin API](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/AdminController.java): `src/main/java/com/campuscrate/controller/AdminController.java`
- [Admin operations](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/AdminService.java): `src/main/java/com/campuscrate/service/AdminService.java`
- [JWT tokens](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/security/JwtService.java): `src/main/java/com/campuscrate/security/JwtService.java`

### Campus Services

- [Lost-found API](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/ItemController.java): `src/main/java/com/campuscrate/controller/ItemController.java`
- [Lost-found items](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/ItemService.java): `src/main/java/com/campuscrate/service/ItemService.java`
- [Item records](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/repository/ItemRepository.java): `src/main/java/com/campuscrate/repository/ItemRepository.java`
- [Claims API](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/ClaimController.java): `src/main/java/com/campuscrate/controller/ClaimController.java`
- [Claims](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/ClaimService.java): `src/main/java/com/campuscrate/service/ClaimService.java`
- [To-let API](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/ToLetListingController.java): `src/main/java/com/campuscrate/controller/ToLetListingController.java`
- [To-let listings](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/ToLetListingService.java): `src/main/java/com/campuscrate/service/ToLetListingService.java`
- [Listing records](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/repository/ToLetListingRepository.java): `src/main/java/com/campuscrate/repository/ToLetListingRepository.java`

### Commerce

- [Marketplace API](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/MarketplacePostController.java): `src/main/java/com/campuscrate/controller/MarketplacePostController.java`
- [Marketplace listings](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/MarketplacePostService.java): `src/main/java/com/campuscrate/service/MarketplacePostService.java`
- [Marketplace records](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/repository/MarketplacePostRepository.java): `src/main/java/com/campuscrate/repository/MarketplacePostRepository.java`
- [Food API](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/FoodController.java): `src/main/java/com/campuscrate/controller/FoodController.java`
- [Food ordering](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/FoodService.java): `src/main/java/com/campuscrate/service/FoodService.java`
- [Food records](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/repository/FoodRepository.java): `src/main/java/com/campuscrate/repository/FoodRepository.java`
- [Payment validation](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/SslCommerzService.java): `src/main/java/com/campuscrate/service/SslCommerzService.java`

### Platform Support

- [Image uploads](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/service/ImageUploadService.java): `src/main/java/com/campuscrate/service/ImageUploadService.java`
- [Notifications](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/repository/NotificationRepository.java): `src/main/java/com/campuscrate/repository/NotificationRepository.java`
- [Categories and locations](https://github.com/khasan013/dbms_backend/blob/main/src/main/java/com/campuscrate/controller/CategoryController.java): `src/main/java/com/campuscrate/controller/CategoryController.java`

### Other components

- **API client**
- **Cloudinary**

## Connections

- API client → User API: sends requests
- API client → Admin API: sends requests
- API client → Lost-found API: sends requests
- API client → Claims API: sends requests
- API client → Marketplace API: sends requests
- API client → Food API: sends requests
- API client → To-let API: sends requests
- User API → User accounts: delegates to (evidence: `src/main/java/com/campuscrate/controller/UserController.java`)
- User accounts → User records: reads and writes (evidence: `src/main/java/com/campuscrate/service/UserService.java`)
- User accounts → JWT tokens: creates tokens (evidence: `src/main/java/com/campuscrate/service/UserService.java`)
- Admin API → Admin operations: delegates to (evidence: `src/main/java/com/campuscrate/controller/AdminController.java`)
- Admin operations → JWT tokens: creates tokens (evidence: `src/main/java/com/campuscrate/service/AdminService.java`)
- Admin operations → User records: manages users (evidence: `src/main/java/com/campuscrate/service/AdminService.java`)
- Lost-found API → Lost-found items: delegates to (evidence: `src/main/java/com/campuscrate/controller/ItemController.java`)
- Lost-found items → Item records: reads and writes (evidence: `src/main/java/com/campuscrate/service/ItemService.java`)
- Claims API → Claims: delegates to (evidence: `src/main/java/com/campuscrate/controller/ClaimController.java`)
- Marketplace API → Marketplace listings: delegates to (evidence: `src/main/java/com/campuscrate/controller/MarketplacePostController.java`)
- Marketplace listings → Marketplace records: reads and writes (evidence: `src/main/java/com/campuscrate/service/MarketplacePostService.java`)
- Food API → Food ordering: delegates to (evidence: `src/main/java/com/campuscrate/controller/FoodController.java`)
- Food ordering → Food records: reads and writes (evidence: `src/main/java/com/campuscrate/service/FoodService.java`)
- Food ordering → Payment validation: validates payment (evidence: `src/main/java/com/campuscrate/service/FoodService.java`)
- To-let API → To-let listings: delegates to (evidence: `src/main/java/com/campuscrate/controller/ToLetListingController.java`)
- To-let listings → Listing records: reads and writes (evidence: `src/main/java/com/campuscrate/service/ToLetListingService.java`)
- Image uploads → Cloudinary: uploads images
