# 项目结构文档（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