项目结构文档（cc-square 全栈）

记录时间：2026-08-12 用途：后续查询备用

一、整体架构

前端：cc-square（Vue 3 + Vite）
后端：yudao / ruoyi-vue-pro（Spring Boot 3.5.9 + Java 17 + Maven + MyBatis-Plus）
数据库：MySQL localhost:3306，库名 ruoyi-vue-pro，270 张表，接入账户 readonly（只读）

二、前端 cc-square（/home/yangxuan/cc-square）

技术栈：Vue 3.4.21 + Vite 5.0.12 + Vuex 4.1.0 + Vue Router 4.3.0 + Ant Design Vue + Axios 1.6.7 + Less 4.5.1 + ECharts

src/
├── assets/               # 资源（imgs 等）
├── components/
│   ├── Background/
│   └── skin/
├── config/
├── pages/
│   └── home.vue          # 唯一主页面
├── request/
│   ├── index/axios 封装
│   └── api/
│       ├── auth.js       # 认证 API
│       └── nav.js        # 导航 API
├── router/
│   └── router.js
├── store/                # Vuex
├── styles/
└── util/

特点：目前前端为较精简的单页结构（核心页面 home.vue）。

三、后端 ruoyi-vue-pro（/home/yangxuan/ruoyi-vue-pro）

业务模块（本项目核心）

yudao-module-tab（TAB 业务，核心，结构最完整）
- controller：admin（engine / website / websitetype）/ app
- service：engine / websitetype / website / impl
- dal：dataobject + mysql（engine / website / websitetype）
- resources/mapper（engine / website / websitetype）
yudao-module-wellness（健康管理）
yudao-module-family（家庭管理）
yudao-module-home（首页）

框架/支撑模块

yudao-server（主服务）
yudao-dependencies（依赖管理）
yudao-framework（基础框架）
yudao-module-system（系统管理：用户/角色/菜单/字典）
yudao-module-infra（基础设施：文件/日志/配置）

芋道官方附带模块（非本项目核心）

yudao-module-ai / bpm / crm / erp / iot / mall / member / mes / mp / pay / report，以及 yudao-ui（芋道自带 UI，非 cc-square）。

四、tab 模块分层调用链示例

controller(admin/app) → service → dal(mysql) → mapper XML → 数据库表

engine（引擎）
website（网站）
websitetype（网站类型）

包根路径：cn.iocoder.yudao.module.tab 资源路径：src/main/resources/mapper

五、使用提示

查询某 API：从 controller 路由 → service 实现 → mapper 追踪
前后端对应：前端 request/api/*.js 与后端 controller 路由对应
数据库为只读，仅 SELECT

2.6 KiB Raw Permalink Blame History Unescape Escape