# buiduynguyenn/pet_care_management architecture

> Architecture diagram of the GitHub repository buiduynguyenn/pet_care_management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/buiduynguyenn/pet_care_management
- Repository: https://github.com/buiduynguyenn/pet_care_management

## Overview

##### Project type and purpose
- This is a standalone Spring Boot backend for a Pet Care Management system.
- It exposes REST endpoints (Appointment, Blog, Cart, Order, Pet, Product, Service, ServiceReview, User, Contact, Chat) and a WebSocket endpoint for real-time chat.
- It handles authentication/authorization via JWT, file uploads (albums, pet images, product images), and data persistence via Spring Data JPA.

##### File structure
- Top-level files: pom.xml (Maven build), application.properties (configuration), uploads/ (local file storage).
- src/main/java/com/pet_care_management/pet:
- config: SecurityConfig (JWT filter), WebSocketConfig
- controller: HTTP controllers for each domain
- dto: request/response objects for API layer
- entity: JPA entities representing tables
- repository: Spring Data JPA interfaces
- service + service.impl: business logic layer
- security: JwtUtil, JwtAuthenticationFilter
- PetApplication.java: main Spring Boot entry point
- resources/static/chat-test.html: simple WebSocket client
- src/test: unit tests for the application

##### Key insights from README
- Minimal README, but project name (“Pet Care Management Backend”) confirms backend role

##### Detail
- Domain controller and its corresponding service/repository if space allows
- Call out configuration classes (SecurityConfig, WebSocketConfig) as part of the control plane
- JWTUtil and JwtAuthenticationFilter as part of the security flow
- Uploads/ directory as an external resource the backend writes to and reads from

## Diagram (Mermaid)

```mermaid
graph TB
    %% External Clients
    subgraph "External Clients"
        UI["Web/Mobile Client"]:::external
        ThirdParty["Third-Party API Consumer"]:::external
    end

    %% Security Layer
    subgraph "Security Layer"
        JWTFilter["JwtAuthenticationFilter"]:::security
        SecurityCfg["SecurityConfig"]:::config
        JwtUtil["JwtUtil"]:::security
    end

    %% API Layer - Controllers
    subgraph "API Layer (Controllers)"
        AlbumCtrl["AlbumController"]:::controller
        AppointmentCtrl["AppointmentController"]:::controller
        AuthCtrl["AuthController"]:::controller
        BlogCtrl["BlogController"]:::controller
        CartCtrl["CartController"]:::controller
        ChatCtrl["ChatController"]:::controller
        ContactCtrl["ContactController"]:::controller
        OrderCtrl["OrderController"]:::controller
        PetCtrl["PetController"]:::controller
        ProductCtrl["ProductController"]:::controller
        ServiceCtrl["ServiceController"]:::controller
        ServiceReviewCtrl["ServiceReviewController"]:::controller
        StatisticCtrl["StatisticController"]:::controller
        UserCtrl["UserController"]:::controller
    end

    %% Service Layer
    subgraph "Service Layer"
        Services["*Service Interfaces"]:::service
        ServiceImpl["*ServiceImpl"]:::service
    end

    %% Repository Layer
    subgraph "Repository Layer"
        Repos["*Repository"]:::repository
    end

    %% Infrastructure
    subgraph "Infrastructure"
        DB[(Relational Database)]:::infra
        FileStorage[/"Local File Storage (uploads/)"/]:::infra
        WebSocketBroker[("WebSocket Broker")]:::infra
    end

    %% Main Entry
    PetApp["PetApplication"]:::entry

    %% Flows
    UI -->|HTTP/WS| JWTFilter
    ThirdParty -->|HTTP| JWTFilter
    JWTFilter -->|"auth check"| SecurityCfg
    SecurityCfg -->|configures| AuthCtrl
    SecurityCfg -->|configures| JWTFilter
    JwtUtil -->|used by| JWTFilter

    JWTFilter -->|passes request| AlbumCtrl
    JWTFilter -->|passes request| AppointmentCtrl
    JWTFilter -->|passes request| AuthCtrl
    JWTFilter -->|passes request| BlogCtrl
    JWTFilter -->|passes request| CartCtrl
    JWTFilter -->|passes request| ChatCtrl
    JWTFilter -->|passes request| ContactCtrl
    JWTFilter -->|passes request| OrderCtrl
    JWTFilter -->|passes request| PetCtrl
    JWTFilter -->|passes request| ProductCtrl
    JWTFilter -->|passes request| ServiceCtrl
    JWTFilter -->|passes request| ServiceReviewCtrl
    JWTFilter -->|passes request| StatisticCtrl
    JWTFilter -->|passes request| UserCtrl

    %% Controller to Service
    AlbumCtrl -->|calls| Services
    AppointmentCtrl -->|calls| Services
    AuthCtrl -->|calls| Services
    BlogCtrl -->|calls| Services
    CartCtrl -->|calls| Services
    ChatCtrl -->|calls WS| WebSocketBroker
    ContactCtrl -->|calls| Services
    OrderCtrl -->|calls| Services
    PetCtrl -->|calls| Services
    ProductCtrl -->|calls| Services
    ServiceCtrl -->|calls| Services
    ServiceReviewCtrl -->|calls| Services
    StatisticCtrl -->|calls| Services
    UserCtrl -->|calls| Services

    %% Service to Repository to DB/File
    Services -->|uses| ServiceImpl
    ServiceImpl -->|uses| Repos
    Repos -->|CRUD| DB
    ServiceImpl -->|read/write| FileStorage

    %% Main entry
    PetApp -->|bootstraps| SecurityCfg
    PetApp -->|bootstraps| WebSocketBroker
    PetApp -->|bootstraps| Application

    %% Click events
    click PetApp "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/PetApplication.java"
    click SecurityCfg "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/config/SecurityConfig.java"
    click JwtUtil "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/security/JwtUtil.java"
    click JWTFilter "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/security/JwtAuthenticationFilter.java"
    click AlbumCtrl "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/controller/AlbumController.java"
    click AppointmentCtrl "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/controller/AppointmentController.java"
    click AuthCtrl "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/controller/AuthController.java"
    click BlogCtrl "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/controller/BlogController.java"
    click CartCtrl "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/controller/CartController.java"
    click ChatCtrl "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/controller/ChatController.java"
    click ContactCtrl "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/controller/ContactController.java"
    click OrderCtrl "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/controller/OrderController.java"
    click PetCtrl "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/controller/PetController.java"
    click ProductCtrl "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/controller/ProductController.java"
    click ServiceCtrl "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/controller/ServiceController.java"
    click ServiceReviewCtrl "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/controller/ServiceReviewController.java"
    click StatisticCtrl "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/controller/StatisticController.java"
    click UserCtrl "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/controller/UserController.java"
    click Services "https://github.com/buiduynguyenn/pet_care_management/tree/main/src/main/java/com/pet_care_management/pet/service"
    click ServiceImpl "https://github.com/buiduynguyenn/pet_care_management/tree/main/src/main/java/com/pet_care_management/pet/service/impl"
    click Repos "https://github.com/buiduynguyenn/pet_care_management/tree/main/src/main/java/com/pet_care_management/pet/repository"
    click FileStorage "https://github.com/buiduynguyenn/pet_care_management/tree/main/uploads/"
    click SecurityCfg "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/config/SecurityConfig.java"
    click WebSocketBroker "https://github.com/buiduynguyenn/pet_care_management/blob/main/src/main/java/com/pet_care_management/pet/config/WebSocketConfig.java"

    %% Styles
    classDef external fill:#d3d3d3,stroke:#333,stroke-width:1px
    classDef controller fill:#AED6F1,stroke:#333,stroke-width:1px
    classDef service fill:#A9DFBF,stroke:#333,stroke-width:1px
    classDef repository fill:#F5B041,stroke:#333,stroke-width:1px
    classDef config fill:#D2B4DE,stroke:#333,stroke-width:1px
    classDef security fill:#FAD7A0,stroke:#333,stroke-width:1px
    classDef infra fill:#D5D8DC,stroke:#333,stroke-width:1px
    classDef entry fill:#F1948A,stroke:#333,stroke-width:1px
```
