# wittyxuan/forestblog architecture

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

- Interactive diagram: https://gitdiagram.com/wittyxuan/forestblog
- Repository: https://github.com/wittyxuan/forestblog

## Overview

ForestBlog is an SSM-based personal blogging system with public browsing and commenting, plus registered-user and administrator functions. Visitors browse published posts and submit comments; administrators manage articles, categories, tags, comments, users, and other site content. Controllers delegate to service layers, and the article implementation uses MyBatis mapper interfaces. The README documents local image uploads and MySQL. Some controller-to-service links are supported by the SOURCE INDEX; mapper links are directly evidenced for articles. Other subsystem internals were not sampled, so uncertain connections are omitted.

Main entry points: [`ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/home`](https://github.com/wittyxuan/forestblog/tree/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/home) (Public controllers), [`ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/admin`](https://github.com/wittyxuan/forestblog/tree/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/admin) (Admin controllers), [`ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/impl/ArticleServiceImpl.java`](https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/impl/ArticleServiceImpl.java) (Article implementation), [`ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/mapper`](https://github.com/wittyxuan/forestblog/tree/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/mapper) (MyBatis mappers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry points"]
  node_public["Public controllers"]
  node_adminui["Admin controllers"]
  node_upload["Image upload"]
end

subgraph group_content["Blog content"]
  node_article["Article service"]
  node_category["Category service"]
  node_tag["Tag service<br/>[TagService.java]"]
  node_page["Page service<br/>[PageService.java]"]
  node_othercontent["Site services"]
  node_models["Domain models"]
end

subgraph group_accounts["Users and moderation"]
  node_comment["Comment service"]
  node_user["User service<br/>[UserService.java]"]
end

subgraph group_persistence["Persistence and media"]
  node_articleimpl["Article implementation"]
  node_mappers["MyBatis mappers"]
  node_database[("MySQL database")]
  node_uploads[("Upload directory")]
end

node_visitor(("Visitor"))
node_admin(("Administrator"))

node_visitor -->|"browses"| node_public
node_admin -->|"manages"| node_adminui
node_public -->|"requests posts"| node_article
node_public -->|"handles comments"| node_comment
node_public -->|"uses accounts"| node_user
node_public -->|"lists categories"| node_category
node_public -->|"lists tags"| node_tag
node_public -->|"loads pages"| node_page
node_public -->|"loads site data"| node_othercontent
node_adminui -->|"manages articles"| node_article
node_adminui -->|"manages categories"| node_category
node_adminui -->|"manages tags"| node_tag
node_adminui -->|"moderates comments"| node_comment
node_adminui -->|"manages users"| node_user
node_articleimpl -->|"queries and updates"| node_mappers
node_articleimpl -->|"uses entities"| node_models
node_upload -->|"writes files"| node_uploads
node_mappers -.->|"persists data"| node_database

click node_public "https://github.com/wittyxuan/forestblog/tree/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/home"
click node_adminui "https://github.com/wittyxuan/forestblog/tree/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/admin"
click node_article "https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/ArticleService.java"
click node_category "https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/CategoryService.java"
click node_tag "https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/TagService.java"
click node_page "https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/PageService.java"
click node_comment "https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/CommentService.java"
click node_user "https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/UserService.java"
click node_othercontent "https://github.com/wittyxuan/forestblog/tree/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service"
click node_articleimpl "https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/impl/ArticleServiceImpl.java"
click node_mappers "https://github.com/wittyxuan/forestblog/tree/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/mapper"
click node_models "https://github.com/wittyxuan/forestblog/tree/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/entity"
click node_upload "https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/admin/UploadFileController.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_public,node_adminui,node_upload toneBlue
class node_article,node_category,node_tag,node_page,node_othercontent,node_models toneAmber
class node_comment,node_user toneMint
class node_articleimpl,node_mappers,node_database,node_uploads toneRose
class node_visitor,node_admin toneIndigo
```

## Components

### Web entry points

- [Public controllers](https://github.com/wittyxuan/forestblog/tree/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/home): `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/home`
- [Admin controllers](https://github.com/wittyxuan/forestblog/tree/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/admin): `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/admin`
- [Image upload](https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/admin/UploadFileController.java): `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/admin/UploadFileController.java`

### Blog content

- [Article service](https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/ArticleService.java): `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/ArticleService.java`
- [Category service](https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/CategoryService.java): `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/CategoryService.java`
- [Tag service](https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/TagService.java): `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/TagService.java`
- [Page service](https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/PageService.java): `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/PageService.java`
- [Site services](https://github.com/wittyxuan/forestblog/tree/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service): `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service`
- [Domain models](https://github.com/wittyxuan/forestblog/tree/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/entity): `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/entity`

### Users and moderation

- [Comment service](https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/CommentService.java): `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/CommentService.java`
- [User service](https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/UserService.java): `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/UserService.java`

### Persistence and media

- [Article implementation](https://github.com/wittyxuan/forestblog/blob/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/impl/ArticleServiceImpl.java): `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/impl/ArticleServiceImpl.java`
- [MyBatis mappers](https://github.com/wittyxuan/forestblog/tree/master/ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/mapper): `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/mapper`
- **MySQL database**
- **Upload directory**

### Other components

- **Visitor**
- **Administrator**

## Connections

- Visitor → Public controllers: browses (evidence: `README.md`)
- Administrator → Admin controllers: manages (evidence: `README.md`)
- Public controllers → Article service: requests posts (evidence: `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/home/ArticleController.java`)
- Public controllers → Comment service: handles comments (evidence: `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/home/ArticleController.java`)
- Public controllers → User service: uses accounts (evidence: `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/home/ArticleController.java`)
- Public controllers → Category service: lists categories (evidence: `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/home/PageController.java`)
- Public controllers → Tag service: lists tags (evidence: `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/home/IndexController.java`)
- Public controllers → Page service: loads pages (evidence: `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/home/PageController.java`)
- Public controllers → Site services: loads site data (evidence: `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/home/IndexController.java`)
- Admin controllers → Article service: manages articles (evidence: `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/admin/BackArticleController.java`)
- Admin controllers → Category service: manages categories (evidence: `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/admin/BackArticleController.java`)
- Admin controllers → Tag service: manages tags (evidence: `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/admin/BackArticleController.java`)
- Admin controllers → Comment service: moderates comments (evidence: `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/admin/BackCommentController.java`)
- Admin controllers → User service: manages users (evidence: `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/controller/admin/BackUserController.java`)
- Article implementation → MyBatis mappers: queries and updates (evidence: `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/impl/ArticleServiceImpl.java`)
- Article implementation → Domain models: uses entities (evidence: `ForestBlog/src/main/java/com/liuyanzhao/ssm/blog/service/impl/ArticleServiceImpl.java`)
- Image upload → Upload directory: writes files (evidence: `README.md`)
- MyBatis mappers → MySQL database: persists data
