How honglei111/vue-blog works
Project type and purpose
• This is a full-stack, front-end/back-end separated personal blog system (“Ruyu-Blog”) comprising:
• A SpringBoot3 monolithic REST API (“blog-backend”)
• A public Vue3-based blog UI (“blog-frontend/kuailemao-blog”)
• An admin Vue3 dashboard UI (“blog-frontend/kuailemao-admin”)
• Supporting scripts, SQL init files, Docker Compose, Nginx configs, etc.
File structure
• Top-level directories:
• blog-backend: Java source (controllers, services, mappers, entities, config, AOP, security, interceptors, RabbitMQ listeners, Quartz tasks, utils), resources, tests, Dockerfile.
• blog-frontend/kuailemao-admin: Antdv Pro admin SPA with src/api, components, pages, router, store, Dockerfile, Nginx default.conf.
• blog-frontend/kuailemao-blog: Public blog SPA with src/apis, components, views, router, store, Dockerfile, Nginx default.conf.
• sql: schema and data seeding scripts.
• Infrastructure files: .sh/docker-restart.sh, Dockerfiles, Compose scripts, Nginx configs.
README for additional insights
• Technologies: Vue3 + Pinia + TypeScript + Axios + Element Plus/Antdv Pro on frontends; SpringBoot3 + SpringSecurity + MyBatis-Plus + MySQL + Redis + RabbitMQ + Minio + Quartz on backend; Nginx reverse proxy; Docker Compose.
• Features: RBAC, JWT auth, dynamic menus/routes, rate-limiting via interceptor+Redis, AOP logging + RabbitMQ, async email; Quartz scheduled cache refresh; RESTful API; Swagger/Knife4j docs.
• External integrations: GitHub/Gitee OAuth, SMTP email.
Main components & interactions
a. Frontends (Browser clients)
• Public blog UI (Vue3 + Element Plus)
• Admin dashboard UI (Vue3 + Antdv Pro)
b. API Gateway / Reverse Proxy
• Nginx serves static files, proxies /api to backend
c. Backend service (SpringBoot3)
• REST Controllers ←→ Service Layer ←→ MyBatis-Plus Mappers ←→ MySQL
• Redis for caching & rate-limiting
• RabbitMQ for async logging/email
• Quartz Scheduler for periodic tasks
• Minio for file storage
• JWT + SpringSecurity for authentication/authorization
• AOP interceptors for logging, custom annotations (AccessLimit, Blacklist)
d. Persistent layers & external services
• MySQL 8.0 (relational data)
• Redis 7.x (cache, rate limit store)
• RabbitMQ (message broker)
• Minio (object storage for images)
• OAuth providers (GitHub, Gitee)
• SMTP Email Server
Architectural patterns & design principles
• Layered architecture (Controller → Service → DAO)
• Front-end/back-end decoupling via REST
• Asynchronous messaging for non-blocking tasks
• AOP for cross-cutting (logging)
• Interceptor + Redis for rate limiting
• RBAC with dynamic permissions via SpringSecurity
• Scheduled tasks with Quartz
Final checklist
• Related sub-components
• Cross-cutting concerns (AOP, interceptors)
• Versioned API docs endpoint (Swagger/Knife4j)
• Docker Compose orchestration