# nishantcg13/springboot architecture

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

- Interactive diagram: https://gitdiagram.com/nishantcg13/springboot
- Repository: https://github.com/nishantcg13/springboot

## Overview

This repository is a collection of independent Spring Boot learning projects, not one integrated backend. Its clearest end-to-end workflows are a blog REST API, canteen order management, OTP-based account registration, and book CRUD; smaller student and email examples demonstrate the same controller/service/repository pattern. The graph highlights those products and selected standalone demos. Source excerpts establish only some calls, so other tree-visible subsystems are included without speculative connections; the README describes the architecture generally rather than documenting individual applications.

Main entry points: [`blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/controllers/PostController.java`](https://github.com/nishantcg13/springboot/blob/main/blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/controllers/PostController.java) (Post API), [`Canteen Management System/Canteen-Management-System/src/main/java/com/nishant/cms/service/CmsService.java`](https://github.com/nishantcg13/springboot/blob/main/Canteen%20Management%20System/Canteen-Management-System/src/main/java/com/nishant/cms/service/CmsService.java) (Order Operations), [`email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/service/UserService.java`](https://github.com/nishantcg13/springboot/blob/main/email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/service/UserService.java) (Account Workflow), [`Canteen Management System/Canteen-Management-System/src/main/java/com/nishant/cms/service/UserService.java`](https://github.com/nishantcg13/springboot/blob/main/Canteen%20Management%20System/Canteen-Management-System/src/main/java/com/nishant/cms/service/UserService.java) (User Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_blog["Blog API"]
  node_post_controller["Post API"]
  node_post_service["Post Operations"]
  node_post_data[("Post Repository")]
  node_post_dto["Post Payloads<br/>[PostDto.java]"]
  node_blog_auth["JWT Security"]
end

subgraph group_canteen["Canteen Management"]
  node_cms_controller["Order API<br/>[CmsController.java]"]
  node_cms_service["Order Operations<br/>[CmsService.java]"]
  node_cms_data[("Order Repository<br/>[CmsRepository.java]")]
  node_user_service["User Operations<br/>[UserService.java]"]
  node_user_data[("User Repository")]
  node_order_entity["Order Record<br/>[OrderEntity.java]"]
end

subgraph group_accounts["Accounts And Email"]
  node_otp_controller["Account API"]
  node_otp_service["Account Workflow<br/>[UserService.java]"]
  node_otp_store[("Account Repository")]
  node_otp_email["OTP Email<br/>[EmailUtil.java]"]
  node_otp_generator["OTP Generator<br/>[OtpUtil.java]"]
  node_notification_api["Email Endpoint"]
  node_mail_service["Mail Provider"]
end

subgraph group_demos["Learning Demos"]
  node_book_api["Book API"]
  node_book_service["Book Operations<br/>[BookService.java]"]
  node_book_store[("Book Repository")]
  node_upload_api["File Upload API"]
  node_upload_helper["Upload Helper"]
  node_student_api["Student API"]
  node_student_service["Student Operations"]
  node_student_store[("Student Repository")]
  node_relationship_service["Relationship Service"]
  node_relationship_store[("Relationship Repository")]
  node_basic_student_api["Basic Student API"]
  node_basic_student_store[("Basic Student Repository")]
end

node_client(("API Client"))

node_client -->|"sends requests"| node_post_controller
node_post_controller -->|"delegates to"| node_post_service
node_post_controller -->|"accepts and returns"| node_post_dto
node_post_controller -.->|"requires authorization"| node_blog_auth
node_post_service -.->|"uses repository"| node_post_data
node_client -.->|"sends requests"| node_cms_controller
node_cms_controller -->|"delegates to"| node_cms_service
node_cms_service -->|"reads and writes"| node_cms_data
node_cms_service -->|"checks users"| node_user_data
node_cms_service -->|"updates orders"| node_order_entity
node_user_service -->|"persists users"| node_user_data
node_user_service -->|"finds user orders"| node_cms_data
node_client -.->|"sends requests"| node_otp_controller
node_otp_controller -->|"delegates to"| node_otp_service
node_otp_service -->|"generates codes"| node_otp_generator
node_otp_service -->|"sends verification"| node_otp_email
node_otp_service -->|"reads and writes"| node_otp_store
node_client -.->|"sends requests"| node_notification_api
node_notification_api -->|"sends email"| node_mail_service
node_client -.->|"sends requests"| node_book_api
node_book_api -->|"delegates to"| node_book_service
node_book_service -->|"reads and writes"| node_book_store
node_client -.->|"uploads files"| node_upload_api
node_upload_api -->|"delegates upload"| node_upload_helper
node_client -.->|"sends requests"| node_student_api
node_student_api -->|"delegates to"| node_student_service
node_student_service -->|"reads and writes"| node_student_store
node_relationship_service -->|"reads and writes"| node_relationship_store
node_basic_student_api -->|"uses repository"| node_basic_student_store

click node_post_controller "https://github.com/nishantcg13/springboot/blob/main/blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/controllers/PostController.java"
click node_post_service "https://github.com/nishantcg13/springboot/blob/main/blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/services/impl/PostServiceImpl.java"
click node_post_data "https://github.com/nishantcg13/springboot/blob/main/blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/repositories/PostRepository.java"
click node_post_dto "https://github.com/nishantcg13/springboot/blob/main/blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/payloads/PostDto.java"
click node_blog_auth "https://github.com/nishantcg13/springboot/blob/main/blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/security/JwtAuthenticationFilter.java"
click node_cms_controller "https://github.com/nishantcg13/springboot/blob/main/Canteen%20Management%20System/Canteen-Management-System/src/main/java/com/nishant/cms/controller/CmsController.java"
click node_cms_service "https://github.com/nishantcg13/springboot/blob/main/Canteen%20Management%20System/Canteen-Management-System/src/main/java/com/nishant/cms/service/CmsService.java"
click node_cms_data "https://github.com/nishantcg13/springboot/blob/main/Canteen%20Management%20System/Canteen-Management-System/src/main/java/com/nishant/cms/repository/CmsRepository.java"
click node_user_service "https://github.com/nishantcg13/springboot/blob/main/Canteen%20Management%20System/Canteen-Management-System/src/main/java/com/nishant/cms/service/UserService.java"
click node_user_data "https://github.com/nishantcg13/springboot/blob/main/Canteen%20Management%20System/Canteen-Management-System/src/main/java/com/nishant/cms/repository/UserRepository.java"
click node_order_entity "https://github.com/nishantcg13/springboot/blob/main/Canteen%20Management%20System/Canteen-Management-System/src/main/java/com/nishant/cms/entity/OrderEntity.java"
click node_otp_controller "https://github.com/nishantcg13/springboot/blob/main/email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/controller/UserController.java"
click node_otp_service "https://github.com/nishantcg13/springboot/blob/main/email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/service/UserService.java"
click node_otp_store "https://github.com/nishantcg13/springboot/blob/main/email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/repository/UserRepository.java"
click node_otp_email "https://github.com/nishantcg13/springboot/blob/main/email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/util/EmailUtil.java"
click node_otp_generator "https://github.com/nishantcg13/springboot/blob/main/email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/util/OtpUtil.java"
click node_notification_api "https://github.com/nishantcg13/springboot/blob/main/email-sender/email-sender/src/main/java/com/nishant/email_sender/controller/NotificationController.java"
click node_book_api "https://github.com/nishantcg13/springboot/blob/main/bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/controller/BookController.java"
click node_book_service "https://github.com/nishantcg13/springboot/blob/main/bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/service/BookService.java"
click node_book_store "https://github.com/nishantcg13/springboot/blob/main/bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/repository/BookRepository.java"
click node_upload_api "https://github.com/nishantcg13/springboot/blob/main/bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/controller/FileUploadController.java"
click node_upload_helper "https://github.com/nishantcg13/springboot/blob/main/bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/helper/FileUploadHelper.java"
click node_student_api "https://github.com/nishantcg13/springboot/blob/main/jpapractice/jpapractice/src/main/java/practice/jpapractice/controller/StudentController.java"
click node_student_service "https://github.com/nishantcg13/springboot/blob/main/jpapractice/jpapractice/src/main/java/practice/jpapractice/services/StudentServices.java"
click node_student_store "https://github.com/nishantcg13/springboot/blob/main/jpapractice/jpapractice/src/main/java/practice/jpapractice/repository/StudentRepository.java"
click node_relationship_service "https://github.com/nishantcg13/springboot/blob/main/Relationship/Relationship/src/main/java/com/relationship/Relationship/service/RelationshipService.java"
click node_relationship_store "https://github.com/nishantcg13/springboot/blob/main/Relationship/Relationship/src/main/java/com/relationship/Relationship/repository/RelationshipRepository.java"
click node_basic_student_api "https://github.com/nishantcg13/springboot/blob/main/BasicAttempts/BasicAttempts/src/main/java/com/learning/BasicAttempts/controller/StudentController.java"
click node_basic_student_store "https://github.com/nishantcg13/springboot/blob/main/BasicAttempts/BasicAttempts/src/main/java/com/learning/BasicAttempts/repository/Studentrepository.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_post_controller,node_post_service,node_post_data,node_post_dto,node_blog_auth,node_client toneBlue
class node_cms_controller,node_cms_service,node_cms_data,node_user_service,node_user_data,node_order_entity toneAmber
class node_otp_controller,node_otp_service,node_otp_store,node_otp_email,node_otp_generator,node_notification_api,node_mail_service toneMint
class node_book_api,node_book_service,node_book_store,node_upload_api,node_upload_helper,node_student_api,node_student_service,node_student_store,node_relationship_service,node_relationship_store,node_basic_student_api,node_basic_student_store toneRose
```

## Components

### Blog API

- [Post API](https://github.com/nishantcg13/springboot/blob/main/blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/controllers/PostController.java): `blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/controllers/PostController.java`
- [Post Operations](https://github.com/nishantcg13/springboot/blob/main/blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/services/impl/PostServiceImpl.java): `blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/services/impl/PostServiceImpl.java`
- [Post Repository](https://github.com/nishantcg13/springboot/blob/main/blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/repositories/PostRepository.java): `blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/repositories/PostRepository.java`
- [Post Payloads](https://github.com/nishantcg13/springboot/blob/main/blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/payloads/PostDto.java): `blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/payloads/PostDto.java`
- [JWT Security](https://github.com/nishantcg13/springboot/blob/main/blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/security/JwtAuthenticationFilter.java): `blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/security/JwtAuthenticationFilter.java`

### Canteen Management

- [Order API](https://github.com/nishantcg13/springboot/blob/main/Canteen%20Management%20System/Canteen-Management-System/src/main/java/com/nishant/cms/controller/CmsController.java): `Canteen Management System/Canteen-Management-System/src/main/java/com/nishant/cms/controller/CmsController.java`
- [Order Operations](https://github.com/nishantcg13/springboot/blob/main/Canteen%20Management%20System/Canteen-Management-System/src/main/java/com/nishant/cms/service/CmsService.java): `Canteen Management System/Canteen-Management-System/src/main/java/com/nishant/cms/service/CmsService.java`
- [Order Repository](https://github.com/nishantcg13/springboot/blob/main/Canteen%20Management%20System/Canteen-Management-System/src/main/java/com/nishant/cms/repository/CmsRepository.java): `Canteen Management System/Canteen-Management-System/src/main/java/com/nishant/cms/repository/CmsRepository.java`
- [User Operations](https://github.com/nishantcg13/springboot/blob/main/Canteen%20Management%20System/Canteen-Management-System/src/main/java/com/nishant/cms/service/UserService.java): `Canteen Management System/Canteen-Management-System/src/main/java/com/nishant/cms/service/UserService.java`
- [User Repository](https://github.com/nishantcg13/springboot/blob/main/Canteen%20Management%20System/Canteen-Management-System/src/main/java/com/nishant/cms/repository/UserRepository.java): `Canteen Management System/Canteen-Management-System/src/main/java/com/nishant/cms/repository/UserRepository.java`
- [Order Record](https://github.com/nishantcg13/springboot/blob/main/Canteen%20Management%20System/Canteen-Management-System/src/main/java/com/nishant/cms/entity/OrderEntity.java): `Canteen Management System/Canteen-Management-System/src/main/java/com/nishant/cms/entity/OrderEntity.java`

### Accounts And Email

- [Account API](https://github.com/nishantcg13/springboot/blob/main/email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/controller/UserController.java): `email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/controller/UserController.java`
- [Account Workflow](https://github.com/nishantcg13/springboot/blob/main/email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/service/UserService.java): `email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/service/UserService.java`
- [Account Repository](https://github.com/nishantcg13/springboot/blob/main/email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/repository/UserRepository.java): `email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/repository/UserRepository.java`
- [OTP Email](https://github.com/nishantcg13/springboot/blob/main/email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/util/EmailUtil.java): `email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/util/EmailUtil.java`
- [OTP Generator](https://github.com/nishantcg13/springboot/blob/main/email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/util/OtpUtil.java): `email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/util/OtpUtil.java`
- [Email Endpoint](https://github.com/nishantcg13/springboot/blob/main/email-sender/email-sender/src/main/java/com/nishant/email_sender/controller/NotificationController.java): `email-sender/email-sender/src/main/java/com/nishant/email_sender/controller/NotificationController.java`
- **Mail Provider**

### Learning Demos

- [Book API](https://github.com/nishantcg13/springboot/blob/main/bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/controller/BookController.java): `bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/controller/BookController.java`
- [Book Operations](https://github.com/nishantcg13/springboot/blob/main/bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/service/BookService.java): `bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/service/BookService.java`
- [Book Repository](https://github.com/nishantcg13/springboot/blob/main/bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/repository/BookRepository.java): `bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/repository/BookRepository.java`
- [File Upload API](https://github.com/nishantcg13/springboot/blob/main/bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/controller/FileUploadController.java): `bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/controller/FileUploadController.java`
- [Upload Helper](https://github.com/nishantcg13/springboot/blob/main/bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/helper/FileUploadHelper.java): `bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/helper/FileUploadHelper.java`
- [Student API](https://github.com/nishantcg13/springboot/blob/main/jpapractice/jpapractice/src/main/java/practice/jpapractice/controller/StudentController.java): `jpapractice/jpapractice/src/main/java/practice/jpapractice/controller/StudentController.java`
- [Student Operations](https://github.com/nishantcg13/springboot/blob/main/jpapractice/jpapractice/src/main/java/practice/jpapractice/services/StudentServices.java): `jpapractice/jpapractice/src/main/java/practice/jpapractice/services/StudentServices.java`
- [Student Repository](https://github.com/nishantcg13/springboot/blob/main/jpapractice/jpapractice/src/main/java/practice/jpapractice/repository/StudentRepository.java): `jpapractice/jpapractice/src/main/java/practice/jpapractice/repository/StudentRepository.java`
- [Relationship Service](https://github.com/nishantcg13/springboot/blob/main/Relationship/Relationship/src/main/java/com/relationship/Relationship/service/RelationshipService.java): `Relationship/Relationship/src/main/java/com/relationship/Relationship/service/RelationshipService.java`
- [Relationship Repository](https://github.com/nishantcg13/springboot/blob/main/Relationship/Relationship/src/main/java/com/relationship/Relationship/repository/RelationshipRepository.java): `Relationship/Relationship/src/main/java/com/relationship/Relationship/repository/RelationshipRepository.java`
- [Basic Student API](https://github.com/nishantcg13/springboot/blob/main/BasicAttempts/BasicAttempts/src/main/java/com/learning/BasicAttempts/controller/StudentController.java): `BasicAttempts/BasicAttempts/src/main/java/com/learning/BasicAttempts/controller/StudentController.java`
- [Basic Student Repository](https://github.com/nishantcg13/springboot/blob/main/BasicAttempts/BasicAttempts/src/main/java/com/learning/BasicAttempts/repository/Studentrepository.java): `BasicAttempts/BasicAttempts/src/main/java/com/learning/BasicAttempts/repository/Studentrepository.java`

### Other components

- **API Client**

## Connections

- API Client → Post API: sends requests
- Post API → Post Operations: delegates to (evidence: `blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/controllers/PostController.java`)
- Post API → Post Payloads: accepts and returns (evidence: `blog-app-apis/blog-app-apis/src/main/java/com/nishant/blog_app_apis/controllers/PostController.java`)
- Post API → JWT Security: requires authorization
- Post Operations → Post Repository: uses repository
- API Client → Order API: sends requests
- Order API → Order Operations: delegates to (evidence: `Canteen Management System/Canteen-Management-System/src/main/java/com/nishant/cms/controller/CmsController.java`)
- Order Operations → Order Repository: reads and writes (evidence: `Canteen Management System/Canteen-Management-System/src/main/java/com/nishant/cms/service/CmsService.java`)
- Order Operations → User Repository: checks users (evidence: `Canteen Management System/Canteen-Management-System/src/main/java/com/nishant/cms/service/CmsService.java`)
- Order Operations → Order Record: updates orders (evidence: `Canteen Management System/Canteen-Management-System/src/main/java/com/nishant/cms/service/CmsService.java`)
- User Operations → User Repository: persists users (evidence: `Canteen Management System/Canteen-Management-System/src/main/java/com/nishant/cms/service/UserService.java`)
- User Operations → Order Repository: finds user orders (evidence: `Canteen Management System/Canteen-Management-System/src/main/java/com/nishant/cms/service/UserService.java`)
- API Client → Account API: sends requests
- Account API → Account Workflow: delegates to (evidence: `email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/controller/UserController.java`)
- Account Workflow → OTP Generator: generates codes (evidence: `email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/service/UserService.java`)
- Account Workflow → OTP Email: sends verification (evidence: `email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/service/UserService.java`)
- Account Workflow → Account Repository: reads and writes (evidence: `email-otp-sender/email-otp-sender/src/main/java/com/nishant/emailotp/service/UserService.java`)
- API Client → Email Endpoint: sends requests
- Email Endpoint → Mail Provider: sends email (evidence: `email-sender/email-sender/src/main/java/com/nishant/email_sender/controller/NotificationController.java`)
- API Client → Book API: sends requests
- Book API → Book Operations: delegates to (evidence: `bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/controller/BookController.java`)
- Book Operations → Book Repository: reads and writes (evidence: `bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/service/BookService.java`)
- API Client → File Upload API: uploads files
- File Upload API → Upload Helper: delegates upload (evidence: `bootrestbook/bootrestbook/src/main/java/com/rest/bootrestbook/controller/FileUploadController.java`)
- API Client → Student API: sends requests
- Student API → Student Operations: delegates to (evidence: `jpapractice/jpapractice/src/main/java/practice/jpapractice/controller/StudentController.java`)
- Student Operations → Student Repository: reads and writes (evidence: `jpapractice/jpapractice/src/main/java/practice/jpapractice/services/StudentServices.java`)
- Relationship Service → Relationship Repository: reads and writes (evidence: `Relationship/Relationship/src/main/java/com/relationship/Relationship/service/RelationshipService.java`)
- Basic Student API → Basic Student Repository: uses repository (evidence: `BasicAttempts/BasicAttempts/src/main/java/com/learning/BasicAttempts/controller/StudentController.java`)
