# flyingimmortal/jarpress architecture

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

- Interactive diagram: https://gitdiagram.com/flyingimmortal/jarpress
- Repository: https://github.com/flyingimmortal/jarpress

## Overview

##### Project type and purpose
- This is a backend-focused, full‑stack system (Jarpress) built on Spring Boot + MyBatis.
- Its goal is to expose WordPress content via a unified API, support H5/Uni‑app/Mini‑program/WeChat clients, and integrate with WordPress without plugins or schema changes.

##### File structure
- Top‑level Maven multi‑module:
- seifly‑common: shared utilities, annotations, AOP aspects, filters, Redis caching, cross‑cutting framework code.
- seifly‑javapress: core domain definitions (DDD entities, enums, constants).
- javapress‑dao: persistence layer using MyBatis mappers to WordPress tables.
- javapress‑business: domain services implementing business rules and use‑cases (CommentsService, PostsService, etc.).
- javapress‑app: Spring Boot application layer (controllers, interceptors, REST/OpenAPI config, security, JWT, WxConfig).
- External artifacts: WordPress MySQL database (doc/db scripts), Redis (caching), external WeChat APIs.

##### Key README insights
- Core tech: Java 8, Spring Boot 2.7.x, MyBatis, SpringDoc OpenAPI.
- DDD layering: application layer (controllers) → business/core domain services → persistence.
- Frontends live in separate repo (Uni‑app + Vant Weapp for Mini‑program).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Clients
    subgraph "Clients"
        direction TB
        H5["H5/PC Web App"]:::external
        UniApp["Uni-app Mini-program"]:::external
        WeChatClient["WeChat Public‑App"]:::external
    end

    %% Backend Layers
    subgraph "Backend System"
        direction TB

        subgraph "API Gateway / Jarpress-App"
            direction TB
            Controllers["Controllers\n(seifly‑javapress/javapress-app/src/main/java/cn/seifly/module/wp/web/controller)"]:::code
            Config["HTTP/CORS/Interceptors\n(seifly‑javapress/javapress-app/src/main/java/cn/seifly/module/wp/web/config)"]:::code
            JwtUtil["JwtUtil.java"]:::code
            EntryPoint["JavaPressApplication.java"]:::code
            OpenApi["OpenApiConfig.java"]:::code
            Profiles["application-*.yml"]:::code
        end

        subgraph "Common Framework (seifly-common)"
            direction TB
            Annotations["Annotations & AOP\n(.../cn/seifly/common/annotation & aspectj)"]:::code
            Filters["Filters & Interceptors\n(.../cn/seifly/common/filter & interceptor)"]:::code
            RedisCache["RedisCache.java"]:::code
            RedisCfg["RedisConfig.java"]:::code
            DynamicDS["DynamicDataSource"]:::code
        end

        subgraph "Business Services (javapress-business)"
            direction TB
            BizServices["Service Interfaces & Impl\n(.../cn/seifly/module/wp/service)"]:::code
            BizDTOs["DTOs & Constants\n(.../comm & /dto)"]:::code
        end

        subgraph "Persistence (javapress-dao)"
            direction TB
            DAOImpl["DAO Implementations\n(.../cn/seifly/module/wp/dao)"]:::code
            Mappers["MyBatis Mappers\n(.../dao/mysql & Mapper.java)"]:::code
            DataObjects["DataObjects (DOs)\n(.../dao/dataobject)"]:::code
        end

        subgraph "Domain Module"
            direction TB
            CoreDTOs["Core DataObjects\n(.../api/dataobject/posts,comments, etc.)"]:::code
            EnumsConsts["Enums & Constants\n(.../comm)"]:::code
        end
    end

    %% Data Stores
    subgraph "Data Stores"
        direction TB
        MySQL["WordPress MySQL"]:::datastore
        Redis["Redis Cache"]:::datastore
    end

    %% External Services
    subgraph "External Services"
        direction TB
        WeChatAPI["WeChat API"]:::external
        SpringDocUI["SpringDoc UI"]:::external
    end

    %% Data Flows
    H5 -->|REST/JSON| Controllers
    UniApp -->|REST/JSON| Controllers
    WeChatClient -->|REST/JSON| Controllers

    Controllers -->|invoke| BizServices
    BizServices -->|use| DAOImpl
    DAOImpl -->|MyBatis query| MySQL

    Controllers -->|cache| Redis
    BizServices -->|cache| Redis
    Redis -->|provides| Controllers

    Controllers -->|OpenAPI docs| SpringDocUI
    Config -->|uses| Annotations
    Controllers -->|AOP advice| Annotations
    DAOImpl -->|AOP advice| Annotations
    Controllers -->|filters| Filters
    Controllers -->|interceptors| Filters

    BizServices -->|config| DynamicDS
    DAOImpl -->|dynamic routing| DynamicDS

    BizServices -->|WeChat integration| WeChatAPI
    Config -->|WxConfig| WeChatAPI

    Profiles -->|configures| EntryPoint

    CoreDTOs -->|shared| DAOImpl
    EnumsConsts -->|shared| BizServices

    %% Click Events
    click Controllers "https://github.com/flyingimmortal/jarpress/tree/main/seifly‑javapress/javapress-app/src/main/java/cn/seifly/module/wp/web/controller"
    click Config "https://github.com/flyingimmortal/jarpress/tree/main/seifly‑javapress/javapress-app/src/main/java/cn/seifly/module/wp/web/config"
    click JwtUtil "https://github.com/flyingimmortal/jarpress/blob/main/seifly‑javapress/javapress-app/src/main/java/cn/seifly/module/wp/web/utils/JwtUtil.java"
    click EntryPoint "https://github.com/flyingimmortal/jarpress/blob/main/seifly‑javapress/javapress-app/src/main/java/cn/seifly/module/wp/JavaPressApplication.java"
    click OpenApi "https://github.com/flyingimmortal/jarpress/blob/main/seifly‑javapress/javapress-app/src/main/java/cn/seifly/module/wp/web/config/OpenApiConfig.java"
    click Profiles "https://github.com/flyingimmortal/jarpress/blob/main/seifly‑javapress/javapress-app/src/main/resources/application-*.yml"
    click Annotations "https://github.com/flyingimmortal/jarpress/tree/main/seifly‑common/src/main/java/cn/seifly/common/annotation"
    click Filters "https://github.com/flyingimmortal/jarpress/tree/main/seifly‑common/src/main/java/cn/seifly/common/filter"
    click RedisCache "https://github.com/flyingimmortal/jarpress/blob/main/seifly‑common/src/main/java/cn/seifly/common/core/redis/RedisCache.java"
    click RedisCfg "https://github.com/flyingimmortal/jarpress/blob/main/seifly‑common/src/main/java/cn/seifly/framework/config/RedisConfig.java"
    click DynamicDS "https://github.com/flyingimmortal/jarpress/tree/main/seifly‑common/src/main/java/cn/seifly/framework/datasource"
    click BizServices "https://github.com/flyingimmortal/jarpress/tree/main/seifly‑javapress/javapress-business/src/main/java/cn/seifly/module/wp/service"
    click BizDTOs "https://github.com/flyingimmortal/jarpress/tree/main/seifly‑javapress/javapress-business/src/main/java/cn/seifly/module/wp/comm"
    click DAOImpl "https://github.com/flyingimmortal/jarpress/tree/main/seifly‑javapress/javapress-dao/src/main/java/cn/seifly/module/wp/dao"
    click Mappers "https://github.com/flyingimmortal/jarpress/tree/main/seifly‑javapress/javapress-dao/src/main/java/cn/seifly/module/wp/dao/mysql"
    click DataObjects "https://github.com/flyingimmortal/jarpress/tree/main/seifly‑javapress/javapress-dao/src/main/java/cn/seifly/module/wp/dao/dataobject"
    click CoreDTOs "https://github.com/flyingimmortal/jarpress/tree/main/seifly‑javapress/javapress-business/src/main/java/cn/seifly/module/wp/api/dataobject"
    click EnumsConsts "https://github.com/flyingimmortal/jarpress/tree/main/seifly‑javapress/javapress-business/src/main/java/cn/seifly/module/wp/comm"

    %% Styles
    classDef code fill:#D0E6FF,stroke:#036;
    classDef datastore fill:#DFF5D0,stroke:#396;
    classDef external fill:#FFE0B2,stroke:#E68A00;
```
