# liyupi/yudada architecture

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

- Interactive diagram: https://gitdiagram.com/liyupi/yudada
- Repository: https://github.com/liyupi/yudada

## Overview

##### Project type and purpose
- From the file tree and README, this is a full‑stack “AI 答题应用平台” (AI‑powered quiz application platform) comprising:
- A Taro+React “MBTI 性格测试小程序” mini‑app (mbti-test-mini)
- A Vue 3 web frontend (yudada-frontend)
- A Java Spring Boot backend (yudada-backend)
- Purpose: let users create, publish, share and answer quiz apps, optionally backed by AI generation/scoring; admin can manage apps, users, and view analytics.

##### File structure
- Top‑level modules:
- mbti-test-mini: Taro cross‑platform微信小程序, with src/components, pages, utils, data, configs
- yudada-frontend: Vue 3 SPA, with src/api, components, views, router, store (Pinia), OpenAPI codegen
- yudada-backend: Spring Boot monolith with layered package structure (controller, service, manager, mapper, entity, dto, config, utils), plus SQL scripts, Dockerfile, tests
- Config/build files:
- Frontend: vue.config.js, babel.config.js, Dockerfile, nginx.conf
- Backend: pom.xml, application.yml (dev/prod), Dockerfile, Maven wrapper
- Patterns:
- Backend: MVC (controllers → services → mappers → DB), AOP interceptors, annotation‑driven auth, RxJava reactive flows, SSE streams, caching layers, sharding
- Frontend: MVVM (Vue components + Pinia store), OpenAPI‑driven API client, role-based access control

##### README for additional insights
- Architecture section shows:
- Tech stack summary: MySQL, Redis, COS, ChatGLM AI, SSE, RxJava, ShardingSphere, Snowflake IDs, Redisson, Caffeine
- Frontend: Vue 3, Arco Design, Axios, QRCode.js, Pinia, OpenAPI; Taro+React for mini‑app

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Clients
    subgraph "Clients" 
        MBTI["MBTI Mini-App<br/>(Taro/React)"]:::client
        subgraph "mbti-test-mini/" 
            DoQuestion["DoQuestionPage"]:::client
            Result["ResultPage"]:::client
            Home["HomePage"]:::client
            Footer["GlobalFooter"]:::client
            BizUtils["bizUtils"]:::client
        end
        WEB["Web Frontend<br/>(Vue 3 SPA)"]:::client
        subgraph "yudada-frontend/" 
            APIClient["OpenAPI Client"]:::client
            UserStore["userStore"]:::client
            Router["Router"]:::client
            Layout["BasicLayout"]:::client
            UserView["UserLoginPage"]:::client
            AdminView["AdminUserPage"]:::client
            AnswerView["DoAnswerPage"]:::client
            StatView["AppStatisticPage"]:::client
        end
    end

    %% API Gateway
    API["API Gateway / Nginx"]:::gateway

    %% Backend Service
    subgraph "Backend Service<br/>(Spring Boot)" 
        subgraph "Controllers" 
            AppCtrl["AppController"]:::controller
            QCtrl["QuestionController"]:::controller
            SCtrl["ScoringResultController"]:::controller
        end
        subgraph "Service Layer" 
            QSvc["QuestionService"]:::service
            QSvcImpl["QuestionServiceImpl"]:::service
        end
        subgraph "Scoring Strategies" 
            Context["ScoringStrategyContext"]:::strategy
            AiStrategy["AiTestScoringStrategy"]:::strategy
        end
        subgraph "Managers" 
            AiMgr["AiManager"]:::manager
            CosMgr["CosManager"]:::manager
        end
        subgraph "Persistence" 
            QMapper["QuestionMapper"]:::persistence
            QEntity["Question Entity"]:::persistence
            QMapperXML["QuestionMapper.xml"]:::persistence
        end
        subgraph "Configuration" 
            RedissonConf["RedissonConfig"]:::config
            MyBatisConf["MyBatisPlusConfig"]:::config
            MainApp["MainApplication"]:::config
        end
    end

    %% External Services and Infrastructure
    MySQL["MySQL (Sharded)"]:::db
    Redis["Redis"]:::cache
    Caffeine["Caffeine Cache"]:::cache
    COS["Tencent COS"]:::storage
    ChatGLM["ChatGLM AI Service"]:::external

    %% Connections
    MBTI -->|HTTP/HTTPS| API
    WEB -->|HTTP/HTTPS| API
    API -->|REST/SSE| AppCtrl
    API -->|REST/SSE| QCtrl
    API -->|REST/SSE| SCtrl

    AppCtrl -->|calls| QSvc
    QCtrl -->|calls| QSvc
    SCtrl -->|streams SSE| MBTI
    SCtrl -->|streams SSE| WEB

    QSvc -->|uses| QSvcImpl
    QSvcImpl -->|strategy| Context
    Context -->|executes| AiStrategy
    QSvcImpl -->|db read/write| QMapper
    QMapper -->|maps| QEntity
    QMapper -->|SQL| MySQL
    QSvcImpl -->|cache get/set| Redis
    QSvcImpl -->|cache get/set| Caffeine
    QSvcImpl -->|upload/download| CosMgr
    CosMgr -->|talks to| COS
    QSvcImpl -->|requests AI| AiMgr
    AiMgr -->|talks to| ChatGLM

    %% Click Events
    click MBTI "https://github.com/liyupi/yudada/tree/master/mbti-test-mini/"
    click DoQuestion "https://github.com/liyupi/yudada/blob/master/mbti-test-mini/src/pages/doQuestion/index.tsx"
    click Result "https://github.com/liyupi/yudada/blob/master/mbti-test-mini/src/pages/result/index.tsx"
    click Home "https://github.com/liyupi/yudada/blob/master/mbti-test-mini/src/pages/index/index.tsx"
    click Footer "https://github.com/liyupi/yudada/blob/master/mbti-test-mini/src/components/GlobalFooter/index.tsx"
    click BizUtils "https://github.com/liyupi/yudada/blob/master/mbti-test-mini/src/utils/bizUtils.ts"

    click WEB "https://github.com/liyupi/yudada/tree/master/yudada-frontend/"
    click APIClient "https://github.com/liyupi/yudada/tree/master/yudada-frontend/src/api/"
    click UserStore "https://github.com/liyupi/yudada/blob/master/yudada-frontend/src/store/userStore.ts"
    click Router "https://github.com/liyupi/yudada/blob/master/yudada-frontend/src/router/index.ts"
    click Layout "https://github.com/liyupi/yudada/blob/master/yudada-frontend/src/layouts/BasicLayout.vue"
    click UserView "https://github.com/liyupi/yudada/blob/master/yudada-frontend/src/views/user/UserLoginPage.vue"
    click AdminView "https://github.com/liyupi/yudada/blob/master/yudada-frontend/src/views/admin/AdminUserPage.vue"
    click AnswerView "https://github.com/liyupi/yudada/blob/master/yudada-frontend/src/views/answer/DoAnswerPage.vue"
    click StatView "https://github.com/liyupi/yudada/blob/master/yudada-frontend/src/views/statistic/AppStatisticPage.vue"

    click API "https://github.com/liyupi/yudada/blob/master/yudada-frontend/docker/nginx.conf"

    click AppCtrl "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/java/com/yupi/yudada/controller/AppController.java"
    click QCtrl "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/java/com/yupi/yudada/controller/QuestionController.java"
    click SCtrl "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/java/com/yupi/yudada/controller/ScoringResultController.java"

    click QSvc "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/java/com/yupi/yudada/service/QuestionService.java"
    click QSvcImpl "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/java/com/yupi/yudada/service/impl/QuestionServiceImpl.java"

    click Context "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/java/com/yupi/yudada/scoring/ScoringStrategyContext.java"
    click AiStrategy "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/java/com/yupi/yudada/scoring/AiTestScoringStrategy.java"

    click AiMgr "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/java/com/yupi/yudada/manager/AiManager.java"
    click CosMgr "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/java/com/yupi/yudada/manager/CosManager.java"

    click QMapper "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/java/com/yupi/yudada/mapper/QuestionMapper.java"
    click QEntity "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/java/com/yupi/yudada/model/entity/Question.java"
    click QMapperXML "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/resources/mapper/QuestionMapper.xml"

    click RedissonConf "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/java/com/yupi/yudada/config/RedissonConfig.java"
    click MyBatisConf "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/java/com/yupi/yudada/config/MyBatisPlusConfig.java"
    click MainApp "https://github.com/liyupi/yudada/blob/master/yudada-backend/src/main/java/com/yupi/yudada/MainApplication.java"
    click DockerBE "https://github.com/liyupi/yudada/tree/master/yudada-backend/Dockerfile"
    click DockerFE "https://github.com/liyupi/yudada/tree/master/yudada-frontend/Dockerfile"

    %% Styles
    classDef client fill:#E0F7FA,stroke:#006064,color:#004D40
    classDef gateway fill:#E8F5E9,stroke:#2E7D32,color:#1B5E20
    classDef controller fill:#FFF3E0,stroke:#FB8C00,color:#E65100
    classDef service fill:#FFF8E1,stroke:#FBC02D,color:#F57F17
    classDef strategy fill:#F3E5F5,stroke:#8E24AA,color:#6A1B9A
    classDef manager fill:#EDE7F6,stroke:#5E35B1,color:#311B92
    classDef persistence fill:#ECEFF1,stroke:#607D8B,color:#263238
    classDef config fill:#F1F8E9,stroke:#558B2F,color:#33691E
    classDef db fill:#E1F5FE,stroke:#039BE5,color:#01579B
    classDef cache fill:#FFFDE7,stroke:#FFD600,color:#F57F17
    classDef storage fill:#ECEFF1,stroke:#90A4AE,color:#546E7A
    classDef external fill:#E0E0E0,stroke:#9E9E9E,color:#424242
```
