auto backup 2026-08-12 21:00

workspace-cc/memory/project-structure.md

@@ -0,0 +1,76 @@
+# 项目结构文档（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