# colrge/my_upm_fyp architecture

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

- Interactive diagram: https://gitdiagram.com/colrge/my_upm_fyp
- Repository: https://github.com/colrge/my_upm_fyp

## Overview

##### Project type and purpose
- This is a full-stack, multi-module Java/Vue application built as a final-year project on top of the RuoYi framework.
- The README confirms a Vue3/Element-UI front end, Spring Boot/MyBatis/Spring Security/JWT back end, MySQL + Redis, deployed on a Google Cloud VM.

##### File structure
- Top-level is a Maven multi-module project:
- rouyi-ui-Vue3: Vue3 front-end source, assets, build scripts (Vite, npm, .env files).
- ruoyi-admin: Core Spring Boot monolith exposing REST APIs, controllers, services, mappers.
- ruoyi-appointment: Dedicated Spring Boot microservice for appointment, activity, expiry, file-submit.
- ruoyi-system, ruoyi-quartz, ruoyi-generator: Domain-specific modules for system management, scheduled tasks (Quartz), code generation.
- ruoyi-common & ruoyi-framework: Shared library modules providing annotations, utilities, AOP, security, config.
- bin, sql, doc, img: Scripts for build/run, database schema, documentation, screenshots.

##### README for additional insights
- Tech stack details reinforce separation: frontend calls backend via Axios; backend uses JWT for auth and Redis for cache/session; persistence via MyBatis mapping to MySQL; scheduling via Quartz; code generation via ruoyi-generator.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Google Cloud VM" 
        direction TB
        subgraph "Frontend Layer"
            direction TB
            SPA["Vue3 SPA"]:::frontend
        end
        subgraph "Backend Layer"
            direction TB
            subgraph "Services"
                direction TB
                Admin["Spring Boot: ruoyi-admin"]:::backend
                Appointment["Spring Boot: ruoyi-appointment"]:::backend
                System["ruoyi-system"]:::backend
                QuartzService["ruoyi-quartz (Quartz Scheduler)"]:::backend
                Generator["ruoyi-generator"]:::backend
                Visa["Visa Application Module"]:::backend
            end
            subgraph "Common Services/Libs"
                direction TB
                Common["ruoyi-common"]:::common
                Framework["ruoyi-framework"]:::framework
                Filter["JwtAuthenticationTokenFilter"]:::framework
                RedisConf["RedisConfig"]:::framework
            end
        end
        subgraph "Data Stores"
            direction TB
            MySQL[(MySQL)]:::db
            Redis[(Redis Cache)]:::db
        end
    end

    SPA -->|"HTTP (Axios)"| Admin
    SPA -->|"HTTP (Axios)"| Appointment

    Admin -.->|depends| Common
    Admin -.->|depends| Framework
    Appointment -.->|depends| Common
    Appointment -.->|depends| Framework

    Admin -->|loads module| Visa

    QuartzService -->|triggers| Admin
    QuartzService -->|triggers| Appointment
    Generator -->|invoked by Admin UI| Admin

    Admin -->|"MyBatis"| MySQL
    Appointment -->|"MyBatis"| MySQL

    Admin <-->|"Cache/RW"| Redis
    Appointment <-->|"Cache/RW"| Redis

    Admin --> Filter
    Framework --> RedisConf

    click SPA "https://github.com/colrge/my_upm_fyp/tree/master/rouyi-ui-Vue3/src"
    click Admin "https://github.com/colrge/my_upm_fyp/tree/master/ruoyi-admin/src/main/java/com/ruoyi/web/controller"
    click Visa "https://github.com/colrge/my_upm_fyp/tree/master/ruoyi-admin/src/main/java/com/ruoyi/visa"
    click Filter "https://github.com/colrge/my_upm_fyp/blob/master/ruoyi-framework/src/main/java/com/ruoyi/framework/security/filter/JwtAuthenticationTokenFilter.java"
    click Common "https://github.com/colrge/my_upm_fyp/tree/master/ruoyi-common/src/main/java/com/ruoyi/common"
    click Framework "https://github.com/colrge/my_upm_fyp/tree/master/ruoyi-framework/src/main/java/com/ruoyi/framework"
    click RedisConf "https://github.com/colrge/my_upm_fyp/blob/master/ruoyi-framework/src/main/java/com/ruoyi/framework/config/RedisConfig.java"
    click Appointment "https://github.com/colrge/my_upm_fyp/tree/master/ruoyi-appointment/src/main/java/com/ruoyi/appointment"
    click Mappers "https://github.com/colrge/my_upm_fyp/tree/master/ruoyi-appointment/src/main/resources/mapper"
    click QuartzService "https://github.com/colrge/my_upm_fyp/tree/master/ruoyi-quartz/src/main/java/com/ruoyi/quartz"
    click Config "https://github.com/colrge/my_upm_fyp/blob/master/ruoyi-quartz/src/main/java/com/ruoyi/quartz/config/ScheduleConfig.java"
    click Generator "https://github.com/colrge/my_upm_fyp/tree/master/ruoyi-generator/src/main/java/com/ruoyi/generator"
    click Templates "https://github.com/colrge/my_upm_fyp/tree/master/ruoyi-generator/src/main/resources/vm"
    click System "https://github.com/colrge/my_upm_fyp/tree/master/ruoyi-system/src/main/java/com/ruoyi/system"

    classDef frontend fill:#f9f,stroke:#333,stroke-width:1px;
    classDef backend fill:#bbf,stroke:#333,stroke-width:1px;
    classDef common fill:#bfb,stroke:#333,stroke-width:1px;
    classDef framework fill:#fbf,stroke:#333,stroke-width:1px;
    classDef db fill:#ffc,stroke:#333,stroke-width:1px;
```
