# slyrackgo/blogapp architecture

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

- Interactive diagram: https://gitdiagram.com/slyrackgo/blogapp
- Repository: https://github.com/slyrackgo/blogapp

## Overview

##### Project type and purpose
- This is a full-stack blogging platform (“BlogApp”)
- Frontend: Angular application (SPA + SSR) for users and admin
- Backend: Spring Boot REST API providing authentication, post/comment CRUD, search
- Database: MySQL for persisting users, posts, comments

##### File structure
- Top-level directories
– blogServer: Maven-based Spring Boot service (Controller, Service, Repository, Entity)
– webBlog: Angular project (Pages components, Services, Guards, SSR entry)
- Build & config files
– blogServer/pom.xml, mvnw* → Java build, dependency, run scripts
– webBlog/package.json, angular.json, tsconfig* → Node/Angular build and project config
- Key architectural patterns
– Backend: MVC pattern with Controllers → Services → Repositories
– Frontend: Modular Angular Pages + Services + Route Guards, optional SSR via server.ts

##### README for additional insights
- Features: authentication, create/edit posts, comments, search, admin panel
- Tech stack: Angular (TypeScript/SCSS), Java Spring Boot, MySQL

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Global entities
    Browser["Browser"]:::frontend

    %% Frontend Layer
    subgraph "Angular Application"
        direction TB
        SSR["Angular Universal SSR Server"]:::frontend
        SPA["Angular SPA"]:::frontend

        subgraph "Pages" 
            direction TB
            CreatePost["CreatePostComponent"]:::frontend
            Login["LoginComponent"]:::frontend
            SearchByName["SearchByNameComponent"]:::frontend
            ViewAll["ViewAllComponent"]:::frontend
            ViewPost["ViewPostComponent"]:::frontend
        end

        subgraph "Services & Guards"
            direction TB
            AuthService["AuthService"]:::frontend
            PostService["PostService"]:::frontend
            CommentService["CommentService"]:::frontend
            AuthGuard["AuthGuard"]:::frontend
        end

        AppRoutes["AppRoutes"]:::frontend
        AngularMaterial["AngularMaterialModule"]:::frontend

        subgraph "Entry & Config"
            direction TB
            IndexHTML["index.html"]:::config
            MainTS["main.ts"]:::config
            AngularJSON["angular.json"]:::config
            PackageJSON["package.json"]:::config
        end
    end

    %% Backend Layer
    subgraph "Spring Boot Application"
        direction TB
        Entry["BlogServerApplication"]:::backend

        subgraph "Controllers"
            direction TB
            PostController["PostController"]:::backend
            CommentController["CommentController"]:::backend
        end

        subgraph "Services"
            direction TB
            PostServiceIntf["PostService"]:::backend
            PostServiceImpl["PostServiceImpl"]:::backend
            CommentServiceIntf["CommentService"]:::backend
            CommentServiceImpl["CommentServiceImpl"]:::backend
        end

        subgraph "Repositories"
            direction TB
            PostRepo["PostRepository"]:::backend
            CommentRepo["CommentRepository"]:::backend
        end

        subgraph "Entities"
            direction TB
            PostEntity["Post"]:::backend
            CommentEntity["Comment"]:::backend
        end

        subgraph "Configuration"
            direction TB
            WebConfig["WebConfig"]:::config
            AppProps["application.properties"]:::config
        end

        subgraph "Build & Project Config"
            direction TB
            Pom["pom.xml"]:::config
            Mvnw["mvnw"]:::config
        end
    end

    %% Database
    MySQL["MySQL Database"]:::db

    %% Connections
    Browser --> SSR
    SSR --> SPA

    SPA --> CreatePost
    SPA --> Login
    SPA --> SearchByName
    SPA --> ViewAll
    SPA --> ViewPost
    SPA --> AuthService
    SPA --> PostService
    SPA --> CommentService
    SPA --> AuthGuard
    SPA --> AppRoutes
    SPA --> AngularMaterial
    SPA --> IndexHTML
    SPA --> MainTS
    SPA --> AngularJSON
    SPA --> PackageJSON

    AuthService -->|HTTP| PostController
    AuthService -->|HTTP| CommentController

    PostService -->|HTTP GET/POST| PostController
    CommentService -->|HTTP GET/POST| CommentController

    CommentService -->|HTTP| CommentController

    PostController -->|calls| PostServiceImpl
    CommentController -->|calls| CommentServiceImpl

    PostServiceImpl -->|uses| PostRepo
    CommentServiceImpl -->|uses| CommentRepo

    PostRepo -->|persists| MySQL
    CommentRepo -->|persists| MySQL

    %% Click Events Frontend
    click CreatePost "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/app/Pages/create-post/create-post.component.ts"
    click Login "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/app/Pages/login/login.component.ts"
    click SearchByName "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/app/Pages/search-by-name/search-by-name.component.ts"
    click ViewAll "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/app/Pages/view-all/view-all.component.ts"
    click ViewPost "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/app/Pages/view-post/view-post.component.ts"
    click SSR "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/server.ts"
    click SSR "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/main.server.ts"
    click SSR "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/app/app.config.server.ts"
    click SSR "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/app/app.routes.server.ts"
    click AppRoutes "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/app/app.routes.ts"
    click AngularMaterial "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/app/AngularMaterialModule.ts"
    click AuthService "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/app/Service/auth.service.ts"
    click PostService "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/app/Service/post.service.ts"
    click CommentService "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/app/Service/comment.service.ts"
    click AuthGuard "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/app/guards/auth.guard.ts"
    click AngularJSON "https://github.com/slyrackgo/blogapp/blob/main/webBlog/angular.json"
    click PackageJSON "https://github.com/slyrackgo/blogapp/blob/main/webBlog/package.json"
    click IndexHTML "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/index.html"
    click MainTS "https://github.com/slyrackgo/blogapp/blob/main/webBlog/src/main.ts"

    %% Click Events Backend
    click Entry "https://github.com/slyrackgo/blogapp/blob/main/blogServer/src/main/java/com/socialApp/blogServer/BlogServerApplication.java"
    click PostController "https://github.com/slyrackgo/blogapp/blob/main/blogServer/src/main/java/com/socialApp/blogServer/Controller/PostController.java"
    click CommentController "https://github.com/slyrackgo/blogapp/blob/main/blogServer/src/main/java/com/socialApp/blogServer/Controller/CommentController.java"
    click PostServiceIntf "https://github.com/slyrackgo/blogapp/blob/main/blogServer/src/main/java/com/socialApp/blogServer/Service/PostService.java"
    click PostServiceImpl "https://github.com/slyrackgo/blogapp/blob/main/blogServer/src/main/java/com/socialApp/blogServer/Service/PostServiceImpl.java"
    click CommentServiceIntf "https://github.com/slyrackgo/blogapp/blob/main/blogServer/src/main/java/com/socialApp/blogServer/Service/CommentService.java"
    click CommentServiceImpl "https://github.com/slyrackgo/blogapp/blob/main/blogServer/src/main/java/com/socialApp/blogServer/Service/CommentServiceImpl.java"
    click PostRepo "https://github.com/slyrackgo/blogapp/blob/main/blogServer/src/main/java/com/socialApp/blogServer/Repository/PostRepository.java"
    click CommentRepo "https://github.com/slyrackgo/blogapp/blob/main/blogServer/src/main/java/com/socialApp/blogServer/Repository/CommentRepository.java"
    click PostEntity "https://github.com/slyrackgo/blogapp/blob/main/blogServer/src/main/java/com/socialApp/blogServer/Entity/Post.java"
    click CommentEntity "https://github.com/slyrackgo/blogapp/blob/main/blogServer/src/main/java/com/socialApp/blogServer/Entity/Comment.java"
    click WebConfig "https://github.com/slyrackgo/blogapp/blob/main/blogServer/src/main/java/com/socialApp/blogServer/WebConfig.java"
    click AppProps "https://github.com/slyrackgo/blogapp/blob/main/blogServer/src/main/resources/application.properties"
    click Pom "https://github.com/slyrackgo/blogapp/blob/main/blogServer/pom.xml"
    click Mvnw "https://github.com/slyrackgo/blogapp/tree/main/blogServer/mvnw"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366D6,color:#0366D6
    classDef backend fill:#E0FFE0,stroke:#028A02,color:#028A02
    classDef db fill:#FFE0B3,stroke:#E68A00,color:#E68A00
    classDef config fill:#F0F0F0,stroke:#888888,color:#333333
```
