77 lines
2.6 KiB
Markdown
77 lines
2.6 KiB
Markdown
# 项目结构文档（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
|