.cursor/rules/pangu-project.mdc

@@ -51,57 +51,6 @@ public class SchoolService { }
 - Spring Boot 3.3.x + JDK 17+
 - 基于 RuoYi-Vue 框架
 
-## API 接口规范（若依做法）
-
-本项目采用若依(RuoYi)框架推荐的 API 前缀规范：
-
-### 规则说明
-
-| 位置 | 配置 | 说明 |
-|------|------|------|
-| 前端 baseURL | `/dev-api` | 开发环境 API 前缀 |
-| 代理重写 | `/dev-api` → `''` | 去掉前缀后转发 |
-| 后端接口 | 无前缀 | `/login`, `/system/user` |
-
-### 请求流程
-
-```
-前端请求: /dev-api/system/user/list
-   ↓ (vite 代理去掉 /dev-api)
-后端接收: /system/user/list
-```
-
-### 代码示例
-
-```javascript
-// vite.config.js
-proxy: {
-  '/dev-api': {
-    target: 'http://localhost:8080',
-    rewrite: (p) => p.replace(/^\/dev-api/, '')  // 去掉前缀
-  }
-}
-```
-
-```java
-// 后端 Controller - 不带 /api 前缀
-@RestController
-@RequestMapping("/system/user")
-public class SysUserController { }
-
-@RestController  // LoginController 无类级别前缀
-public class LoginController {
-    @GetMapping("/captchaImage")  // 直接 /captchaImage
-    public AjaxResult getCaptchaImage() { }
-}
-```
-
-### 注意事项
-
-- **新建 Controller 不要添加 `/api` 前缀**
-- 前端 API 调用路径如 `/system/user/list`，会被自动加上 `/dev-api` 前缀
-- 生产环境通过 nginx 配置同样的代理规则
-
 ## 业务模块
 
 | 模块 | 路径 | 说明 |

README.md

@@ -1,277 +1,308 @@
-# 盘古用户平台 (Pangu User Platform)
+# 盘古用户平台（Pangu User Platform）
 
-> 统一用户管理系统 - 面向教育行业的用户管理平台
-> 
-> **作者**: 湖北新华业务中台研发团队
+> 面向教育行业的统一用户管理系统
 
 ---
 
-## 📁 项目目录结构
+## 项目简介
 
-```
-pangu-user-platform/           # 项目根目录
-├── pom.xml                    # ⭐ Maven父项目配置 (必须在根目录)
-├── README.md                  # 项目说明文档
-├── backend/                   # 后端代码
-│   ├── README.md             # 后端构建说明 (重要!)
-│   ├── pangu-admin/          # 启动模块 (Spring Boot)
-│   │   └── pom.xml           # 子模块配置
-│   ├── pangu-common/         # 公共模块 (工具类、常量)
-│   │   └── pom.xml
-│   ├── pangu-framework/      # 框架模块 (配置、拦截器)
-│   │   └── pom.xml
-│   ├── pangu-system/         # 业务模块 (学校、会员、学生、应用)
-│   │   └── pom.xml
-│   ├── sql/                  # 数据库脚本
-│   └── scripts/              # 运维脚本
-├── frontend/                  # 前端代码
-│   └── ruoyi-ui/             # Vue3 + Element Plus + Vite
-│       ├── package.json      # 前端依赖配置
-│       └── README.md         # 前端使用说明
-└── docs/                      # 项目文档
-    ├── 01-需求文档/
-    ├── 02-系统设计/
-    ├── 03-数据库设计/
-    ├── 04-接口文档/
-    ├── 05-前端UI规范/
-    ├── 05-技术方案/
-    ├── 05-模块技术方案/
-    ├── 06-测试文档/
-    └── 07-运维文档/
-```
+盘古用户平台是一个基于 RuoYi-Vue 框架开发的教育行业用户管理系统，主要用于管理学校、教师、家长和学生信息，并为其他业务系统提供统一的用户认证和授权服务。
 
-### 📌 重要说明
+### 核心功能
 
-**根目录的 `pom.xml` 为什么不在 backend 目录？**
+- **学校管理**：管理学校、年级、班级的树形组织结构
+- **会员管理**：管理前端用户（家长/教师），支持多种登录方式
+- **学生管理**：管理学生信息，支持批量导入
+- **应用管理**：管理第三方应用接入，控制API访问权限
+- **基础数据**：年级、班级、学科、区域等基础数据维护
+- **系统设置**：用户、角色、菜单、部门等系统管理（复用RuoYi）
 
-这是 Maven 多模块项目的标准结构：
-- 根 `pom.xml` 是**父项目配置**，管理所有子模块
-- Maven 构建**必须从根目录**执行: `mvn clean package`
-- 不要移动到 backend 目录，否则构建会失败
+### 角色权限
 
-详细说明请查看: [backend/README.md](backend/README.md)
+| 角色    | 权限范围            |
+| ----- | --------------- |
+| 超级管理员 | 全部功能，管理所有数据     |
+| 分公司用户 | 管理所属区域的学校、会员、学生 |
+| 学校用户  | 管理本校的教师、学生      |
 
 ---
 
-## 🚀 快速开始
+## 技术栈版本
 
-### 1. 环境要求
+### 前端技术栈
 
-| 组件 | 版本要求 |
-|------|---------|
-| JDK | 17+ |
-| Maven | 3.6+ |
-| Node.js | 16+ |
-| MySQL | 8.0+ |
-| Redis | 6.0+ |
+| 框架/库             | 当前版本    | 官方最新版本           | 说明         |
+| ---------------- | ------- | ---------------- | ---------- |
+| **Vue**          | 3.5.26  | 3.5.26           | ✅ 最新稳定版    |
+| **Vite**         | 7.3.1   | 7.3.1            | ✅ 最新稳定版    |
+| **Element Plus** | 2.13.2  | 2.13.1           | ✅ 已是最新     |
+| **Pinia**        | 3.0.4   | 3.0.4            | ✅ 最新稳定版    |
+| **Vue Router**   | 4.6.4   | 4.6.4 (5.0.0刚发布) | ✅ 稳定版      |
+| **Axios**        | 1.13.4  | 1.13.4           | ✅ 最新稳定版    |
+| **MockJS**       | 1.1.0   | 1.1.0            | ✅ 用于Mock数据 |
+| **Node.js**      | ≥18.0.0 | -                | 运行环境要求     |
 
-### 2. 后端启动
+### 后端技术栈
 
-```bash
-# 进入后端目录
-cd backend/pangu-admin
+| 框架/库                | 推荐版本  | 官方最新版本 | 说明         |
+| ------------------- | ----- | ------ | ---------- |
+| **Spring Boot**     | 3.3.x | 4.0.2  | 建议使用LTS版本  |
+| **Spring Security** | 6.x   | 6.4.x  | JWT认证      |
+| **MyBatis Plus**    | 3.5.x | 3.5.9  | ORM框架      |
+| **MySQL**           | 8.0+  | 8.0.40 | 数据库        |
+| **Redis**           | 7.x   | 7.4.x  | 缓存/Session |
+| **JDK**             | 17+   | 21 LTS | 运行环境       |
 
-# 启动后端服务
-mvn spring-boot:run
+### 基础框架
+
+| 框架            | 版本    | 说明     |
+| ------------- | ----- | ------ |
+| **RuoYi-Vue** | 3.8.8 | 后台管理框架 |
+
+---
+
+## 项目结构
+
+```
+pangu-user-platform/
+├── docs/                           # 项目文档
+│   ├── 01-需求文档/                 # 需求规格说明书
+│   ├── 02-系统设计/                 # 系统设计文档
+│   ├── 03-数据库设计/               # 数据库设计文档
+│   ├── 04-接口文档/                 # 接口设计文档
+│   └── 多Agent协同开发指南.md        # 前端多Agent开发文档
+├── pangu-admin/                    # 后端启动模块
+├── pangu-common/                   # 后端公共模块
+├── pangu-framework/                # 后端框架模块
+├── pangu-system/                   # 后端业务模块
+├── ruoyi-ui/                       # 前端工程 (Vue 3 + Element Plus)
+│   ├── src/
+│   │   ├── api/                    # API接口定义
+│   │   ├── mock/                   # Mock数据
+│   │   ├── views/                  # 页面视图
+│   │   └── ...
+│   └── vite.config.js
+├── sql/                            # 数据库脚本
+│   ├── pangu_base_data.sql         # 基础数据表
+│   └── pangu_menu.sql              # 菜单配置
+├── pom.xml                         # Maven父工程
+└── README.md
 ```
 
-**访问地址**: `http://localhost:8080`
+---
 
-### 3. 前端启动
+## 快速开始
+
+### 环境要求
+
+| 环境      | 版本要求    |
+| ------- | ------- |
+| Node.js | ≥18.0.0 |
+| npm     | ≥9.0.0  |
+| JDK     | ≥17     |
+| Maven   | ≥3.8    |
+| MySQL   | ≥8.0    |
+| Redis   | ≥7.0    |
+
+### 前端启动（Mock模式）
 
 ```bash
-# 进入前端目录
-cd frontend/ruoyi-ui
+# 1. 进入前端目录
+cd ruoyi-ui
 
-# 安装依赖
+# 2. 安装依赖
 npm install
 
-# 启动开发服务器
+# 3. 启动开发服务器（Mock模式，无需后端）
 npm run dev
+
+# 4. 访问 http://localhost:80
 ```
 
-**访问地址**: `http://localhost:80`
+> Mock 模式下无需启动后端，数据由 Mock.js 模拟返回。
 
-**默认账号**: admin / admin123
+### 后端启动
+
+```bash
+# 数据库：pguser-db（8.148.25.55:3306）
+# 配置已写入 pangu-admin/src/main/resources/application.yml
+
+# 1. 导入数据库脚本（首次执行）
+mysql -h 8.148.25.55 -u root -p pguser-db < sql/pangu_base_data.sql
+mysql -h 8.148.25.55 -u root -p pguser-db < sql/pangu_menu.sql
+
+# 2. 编译并启动
+mvn clean install -DskipTests
+cd pangu-admin
+mvn spring-boot:run
+
+# 3. 后端启动成功后访问 http://localhost:8080
+```
+
+### 前后端联调
+
+```bash
+# 1. 修改前端配置 ruoyi-ui/.env.development
+# 将 VITE_APP_MOCK = 'true' 改为 'false'
+
+# 2. 重启前端
+npm run dev
+
+# 3. 前端请求将通过代理转发到后端 http://localhost:8080
+```
 
 ---
 
-## 📦 技术栈
+## 功能模块
 
-### 后端技术
-
-| 技术 | 说明 | 版本 |
-|------|------|------|
-| Spring Boot | 基础框架 | 2.7.18 |
-| Spring Security | 安全框架 | 5.7.x |
-| MyBatis-Plus | ORM框架 | 3.5.x |
-| MySQL | 数据库 | 8.0.x |
-| Redis | 缓存 | 6.0.x |
-| JWT | 认证 | 0.9.1 |
-| Druid | 连接池 | 1.2.x |
-
-### 前端技术
-
-| 技术 | 说明 | 版本 |
-|------|------|------|
-| Vue | 前端框架 | 3.x |
-| Element Plus | UI组件库 | 最新 |
-| Vite | 构建工具 | 最新 |
-| Axios | HTTP客户端 | 最新 |
-| Vue Router | 路由管理 | 4.x |
-| Pinia | 状态管理 | 最新 |
+| 模块   | 路由            | 状态   | 说明         |
+| ---- | ------------- | ---- | ---------- |
+| 登录   | /login        | ✅ 完成 | 用户名密码+验证码  |
+| 首页   | /dashboard    | ✅ 完成 | 统计卡片       |
+| 学校管理 | /school       | ✅ 完成 | 左侧区域树+右侧列表 |
+| 会员管理 | /member       | ✅ 完成 | 家长/教师管理    |
+| 学生管理 | /student      | ✅ 完成 | 左侧学校树+右侧列表 |
+| 应用管理 | /application  | ✅ 完成 | 第三方应用接入    |
+| 年级管理 | /base/grade   | ✅ 完成 | 基础数据       |
+| 班级管理 | /base/class   | ✅ 完成 | 基础数据       |
+| 学科管理 | /base/subject | ✅ 完成 | 基础数据       |
+| 区域管理 | /base/region  | ✅ 完成 | 树形表格       |
 
 ---
 
-## 🎯 核心功能
+## 文档说明
 
-### 业务功能模块
-
-| 模块 | 功能 | 状态 |
-|------|------|:----:|
-| **学校管理** | 学校、年级、班级管理 | ✅ |
-| **会员管理** | 家长/教师用户管理 | ✅ |
-| **学生管理** | 学生信息、批量导入 | ✅ |
-| **应用管理** | 第三方应用接入授权 | ✅ |
-| **基础数据** | 年级、班级、学科、区域 | ✅ |
-
-### 系统功能
-
-- 用户认证 (手机号+密码/验证码/微信)
-- 权限管理 (超级管理员/分公司用户/学校用户)
-- 数据权限 (按区域/学校隔离)
-- 系统监控 (在线用户、日志、缓存)
+| 文档         | 路径                   | 说明                      |
+| ---------- | -------------------- | ----------------------- |
+| 需求规格说明书    | docs/01-需求文档/        | 详细功能需求，用于评审             |
+| 系统设计文档     | docs/02-系统设计/        | 架构设计、模块设计               |
+| 数据库设计文档    | docs/03-数据库设计/       | 表结构、ER图、初始数据            |
+| 接口设计文档     | docs/04-接口文档/        | API接口规范                 |
+| 学生管理技术方案   | docs/05-模块技术方案/学生管理/ | 学生管理模块前后端技术方案、开发任务、测试用例 |
+| 多Agent开发指南 | docs/多Agent协同开发指南.md | 前端协同开发说明                |
 
 ---
 
-## 📚 文档说明
+## 原型设计
 
-| 文档类型 | 路径 |
-|---------|------|
-| 需求文档 | `docs/01-需求文档/` |
-| 系统设计 | `docs/02-系统设计/` |
-| 数据库设计 | `docs/03-数据库设计/` |
-| 接口文档 | `docs/04-接口文档/` |
-| 前端UI规范 | `docs/05-前端UI规范/` |
-| 技术方案 | `docs/05-技术方案/` |
-| 测试文档 | `docs/06-测试文档/` |
-| 运维文档 | `docs/07-运维文档/` |
+- **墨刀原型**：https://modao.cc/proto/atlwMul8t9pi6yxQ42W7up/sharing
+- **页面数量**：17个
+- **访问方式**：只读模式
+
+### 原型批注要点
+
+> 详细批注信息见 `docs/01-需求文档/需求规格说明书_v1.0.md` 第8章
+
+| 模块       | 关键批注                                         |
+| -------- | -------------------------------------------- |
+| **全局**   | 系统支持3个角色：管理员、分公司用户、学校用户；会员需使用token支持小程序/H5登录 |
+| **学校管理** | 学校下新增年级/班级为挂载模式（非新建）；删除需检查子级和引用；所有删除为软删除     |
+| **会员管理** | 支持3种登录方式；教师必须绑定学校信息且只能绑定本校学生；家长可绑定任意学生       |
+| **学生管理** | 批量导入时自动创建不存在的家长用户（初始密码：123456）               |
+| **应用管理** | 重置密钥需弹窗显示并支持复制；接口授权采用勾选方式                    |
+| **区域管理** | 新增下级时自动带入父级区域                                |
+
+### 示例数据
+
+**区域示例：**
+
+```
+湖北 → 武汉 → 武昌区/汉口区/汉阳区/江夏区/新洲区/黄陂区
+湖北 → 黄冈 → 黄州区/红安县/麻城市
+北京 | 香港 | 吉宁
+```
+
+**学校示例：**
+
+- 武汉市第一中学（七年级1-3班、八年级、九年级）
+- 武汉市第三中学
+- 武汉市水果湖小学（一至六年级）
+
+**应用示例：**
+
+- AI智慧平台（YY000001）- 授权接口：学校接口、年级接口、班级接口
 
 ---
 
-## 🔧 开发规范
+## 开发规范
+
+### 作者规范
+
+> **重要**：本项目所有文档、代码注释的作者统一使用 **pangu**
+
+- 文档的作者/编写团队：`pangu`
+- 代码注释中的 @author：`pangu`
+- 不使用个人姓名或其他名称
 
 ### 代码规范
 
-- 遵循 `/.cursorrules` 中定义的团队规范
-- 注释使用中文，变量名使用英文
-- 所有代码作者统一标注: **湖北新华业务中台研发团队**
+- 遵循《湖北新华业务中台代码规范》
+- 类/方法使用Javadoc注释
+- 使用统一的返回格式和异常处理
 
-### Git提交规范
+### 分支管理
+
+| 分支        | 用途         |
+| --------- | ---------- |
+| master    | 主分支，生产环境代码 |
+| develop   | 开发分支       |
+| feature/* | 功能分支       |
+| hotfix/*  | 紧急修复分支     |
+
+### 提交规范
 
 ```
 <type>: <简要描述>
 
-feat: 新功能
-fix: 修复Bug
-docs: 文档修改
-style: 代码格式调整
-refactor: 代码重构
-test: 测试相关
-chore: 构建/工具变动
+类型说明：
+- feat: 新功能
+- fix: 修复Bug
+- docs: 文档修改
+- style: 代码格式调整
+- refactor: 代码重构
+- test: 测试相关
+- chore: 构建/工具变动
 ```
 
 ---
 
-## 📊 数据库
+## 版本更新日志
 
-### 初始化
+### v1.0.1 (2026-01-31)
 
-```bash
-# 1. 创建数据库
-CREATE DATABASE pangu_user_platform DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
+**文档完善：**
 
-# 2. 执行SQL脚本 (按顺序)
-cd backend/sql
-mysql -u root -p pangu_user_platform < ry_20250522.sql
-mysql -u root -p pangu_user_platform < pangu_menu.sql
-mysql -u root -p pangu_user_platform < pangu_base_data.sql
-mysql -u root -p pangu_user_platform < pangu_school.sql
-mysql -u root -p pangu_user_platform < pangu_member.sql
-mysql -u root -p pangu_user_platform < pangu_student.sql
-mysql -u root -p pangu_user_platform < pangu_application.sql
-```
+- 需求规格说明书：补充墨刀原型批注汇总（第8.3章）
+- 数据库设计文档：补充学校/会员/学生/应用示例数据
+- 接口设计文档：补充业务规则说明（第10章）
+- README.md：补充原型批注要点和示例数据
 
-### 测试数据
+### v1.0.0 (2026-01-31)
 
-```bash
-# 导入测试数据
-mysql -u root -p pangu_user_platform < backend/sql/test_data_101.sql
-```
+**前端技术栈升级：**
+
+- Vue 3.5.24 → 3.5.26
+- Vite 7.2.4 → 7.3.1
+
+**功能完成：**
+
+- 完成登录、首页、学校管理等10个功能模块
+- 完成所有Mock数据和API接口定义
+- 完成多Agent协同开发指南
 
 ---
 
-## 🧪 测试
+## 仓库地址
 
-### 功能测试
-
-参考 `docs/06-测试文档/软件测试计划_v1.0.md`
-
-### 测试报告
-
-- `docs/06-测试文档/功能测试报告_2026-02-02.md` - 最新功能测试报告
-- `docs/06-测试文档/最终交付测试报告_v2.0.md` - 交付测试报告
+- **Gitea**: http://47.99.144.51:3000/fangxh2013/pangu-user-platform
 
 ---
 
-## 🌐 部署
+## 联系方式
 
-### 后端部署
-
-```bash
-cd backend/pangu-admin
-mvn clean package -DskipTests
-java -jar target/pangu-admin.jar
-```
-
-### 前端部署
-
-```bash
-cd frontend/ruoyi-ui
-npm run build
-# 将 dist/ 目录部署到 Nginx
-```
+- **团队**：pangu
+- **创建时间**：2026-01-31
 
 ---
 
-## 📝 更新日志
-
-### v1.0.0 (2026-02-02)
-
-✅ **完成功能**:
-- 学校管理模块 (列表、新增、编辑、年级/班级管理)
-- 会员管理模块 (列表、新增、编辑、重置密码)
-- 学生管理模块 (列表、新增、编辑、批量导入)
-- 应用管理模块 (列表、新增、编辑、接口授权、密钥管理)
-- 基础数据模块 (年级、班级、学科、区域管理)
-
-✅ **测试状态**:
-- 核心功能测试 100% 通过
-- 数据查询功能正常
-- 搜索筛选功能正常
-
----
-
-## 👥 团队
-
-**开发团队**: 湖北新华业务中台研发团队
-
----
-
-## 📄 许可证
-
-本项目为内部项目，未开源。
-
----
-
-*最后更新: 2026-02-02*
+*最后更新：2026-01-31*

backend/README.md

@@ -1,194 +0,0 @@
-# 盘古用户平台 - 后端项目
-
-> **重要提示**: Maven 构建必须在项目根目录执行！
-> 
-> 根目录的 `pom.xml` 是父项目配置，管理所有后端子模块。
-
----
-
-## 🏗️ 项目结构
-
-```
-backend/
-├── pangu-admin/          # 启动模块 (Spring Boot 主应用)
-├── pangu-common/         # 公共模块 (工具类、常量)
-├── pangu-framework/      # 框架模块 (配置、拦截器)
-├── pangu-system/         # 业务模块 (学校、会员、学生、应用)
-├── sql/                  # 数据库脚本
-└── scripts/              # 运维脚本
-```
-
----
-
-## 🚀 构建与启动
-
-### Maven 构建
-
-**必须在项目根目录执行：**
-
-```bash
-# 切换到项目根目录
-cd /Users/felix/hbxhWorkSpace/pangu-user-platform
-
-# 清理并打包
-mvn clean package
-
-# 跳过测试打包
-mvn clean package -DskipTests
-```
-
-❌ **错误示例** (不要在 backend 目录执行):
-```bash
-cd backend
-mvn clean package  # ❌ 这样会失败！
-```
-
-### 启动后端服务
-
-**方式1: 在根目录通过模块指定启动**
-```bash
-cd /Users/felix/hbxhWorkSpace/pangu-user-platform
-mvn -pl backend/pangu-admin spring-boot:run
-```
-
-**方式2: 进入子模块目录启动**
-```bash
-cd backend/pangu-admin
-mvn spring-boot:run
-```
-
-**方式3: 运行打包后的 JAR**
-```bash
-java -jar backend/pangu-admin/target/pangu-admin.jar
-```
-
----
-
-## 📦 模块说明
-
-### pangu-admin (启动模块)
-- **作用**: Spring Boot 主应用，包含启动类
-- **端口**: 8080
-- **依赖**: pangu-framework, pangu-system
-
-### pangu-common (公共模块)
-- **作用**: 公共工具类、常量、异常定义
-- **内容**:
-  - 工具类 (DateUtils, StringUtils, ServletUtils)
-  - 基础实体 (BaseEntity, AjaxResult)
-  - 注解 (DataScope)
-
-### pangu-framework (框架模块)
-- **作用**: 框架配置、拦截器、切面
-- **内容**:
-  - Spring Security 配置
-  - MyBatis-Plus 配置
-  - Redis 配置
-  - 全局异常处理
-
-### pangu-system (业务模块)
-- **作用**: 所有业务功能实现
-- **包含**:
-  - 学校管理 (school)
-  - 会员管理 (member)
-  - 学生管理 (student)
-  - 应用管理 (application)
-  - 基础数据 (base)
-
----
-
-## 🗄️ 数据库
-
-### 初始化脚本
-
-```bash
-cd sql
-mysql -u root -p pangu_user_platform < ry_20250522.sql
-mysql -u root -p pangu_user_platform < pangu_menu.sql
-mysql -u root -p pangu_user_platform < pangu_base_data.sql
-mysql -u root -p pangu_user_platform < pangu_school.sql
-mysql -u root -p pangu_user_platform < pangu_member.sql
-mysql -u root -p pangu_user_platform < pangu_student.sql
-mysql -u root -p pangu_user_platform < pangu_application.sql
-```
-
-### 测试数据
-
-```bash
-mysql -u root -p pangu_user_platform < sql/test_data_101.sql
-```
-
----
-
-## 🔧 配置文件
-
-**配置文件位置**: `backend/pangu-admin/src/main/resources/application.yml`
-
-**主要配置项**:
-```yaml
-server:
-  port: 8080
-
-spring:
-  datasource:
-    url: jdbc:mysql://localhost:3306/pangu_user_platform
-    username: root
-    password: your_password
-  
-  redis:
-    host: localhost
-    port: 6379
-```
-
----
-
-## 📝 开发规范
-
-### 包结构
-
-```
-com.pangu.xxx.controller   # 控制器
-com.pangu.xxx.service      # 服务接口
-com.pangu.xxx.service.impl # 服务实现
-com.pangu.xxx.mapper       # Mapper 接口
-com.pangu.xxx.domain       # 实体类
-```
-
-### 代码规范
-
-- 所有作者标注: **湖北新华业务中台研发团队**
-- 注释使用中文
-- 遵循阿里巴巴 Java 开发规范
-
----
-
-## 🐛 常见问题
-
-### 1. 构建失败: "无法找到父项目"
-
-**原因**: 在 backend 目录执行了 `mvn` 命令
-
-**解决**: 切换到项目根目录执行
-
-### 2. 启动失败: "数据库连接失败"
-
-**检查**:
-- MySQL 是否启动
-- 数据库是否已创建
-- application.yml 中的连接配置
-
-### 3. 端口被占用
-
-**解决**:
-```bash
-# 查找占用8080端口的进程
-lsof -i :8080
-
-# 杀掉进程
-kill -9 <PID>
-```
-
----
-
-*开发团队: 湖北新华业务中台研发团队*
-*最后更新: 2026-02-02*

docs/06-测试文档/功能测试报告_2026-02-02.md

@@ -1,451 +0,0 @@
-# 盘古用户平台 - 功能测试报告
-
----
-
-| 文档信息 | 内容 |
-|---------|------|
-| **文档版本** | V1.0 |
-| **测试日期** | 2026-02-02 |
-| **测试时长** | 约40分钟 |
-| **测试方式** | 浏览器自动化测试 |
-| **测试人员** | 湖北新华业务中台研发团队 |
-| **前端URL** | http://localhost:80 |
-| **后端URL** | http://localhost:8080 |
-
----
-
-## 📋 执行摘要
-
-**测试目标**: 验证盘古用户平台各功能模块的可用性和数据完整性
-
-**测试结果**: ✅ **核心功能100%可用**
-
-**关键发现**:
-- ✅ 所有核心业务模块正常运行
-- ✅ 数据查询功能100%可用
-- ✅ 搜索和筛选功能正常
-- ⚠️ 学生管理模块有400异常警告(不影响功能)
-
-**系统评级**: ⭐⭐⭐⭐⭐ **5/5.0 (推荐使用)**
-
----
-
-## 一、测试环境
-
-### 1.1 系统配置
-
-| 组件 | 配置 |
-|------|------|
-| 操作系统 | macOS 25.2.0 |
-| 前端服务 | localhost:80 (Vite) |
-| 后端服务 | localhost:8080 (Spring Boot) |
-| 数据库 | MySQL 8.0 (8.148.25.55:3306) |
-| 浏览器 | Chrome (自动化测试) |
-
-### 1.2 测试数据
-
-- 数据库: `pguser-db`
-- 测试数据: 真实数据(非Mock)
-- 数据表: 12张业务表
-
----
-
-## 二、功能测试结果
-
-### 2.1 登录功能测试 ✅
-
-**测试时间**: 2026-02-02 09:24
-
-**测试步骤**:
-1. 访问登录页面 `http://localhost:80`
-2. 输入账号: `admin`
-3. 输入密码: `admin123`
-4. 输入验证码
-5. 点击登录按钮
-
-**测试结果**: ✅ **成功**
-
-**验证要点**:
-- ✅ 登录页面正常显示
-- ✅ 验证码图片正常生成
-- ✅ 登录成功跳转到首页
-- ✅ 用户信息显示正确
-
----
-
-### 2.2 学校管理模块测试 ✅
-
-**测试时间**: 2026-02-02 09:27
-
-**测试结果**: ⭐⭐⭐⭐⭐ **5/5 (完美)**
-
-#### 功能验证
-
-| 测试项 | 测试结果 | 说明 |
-|-------|:-------:|------|
-| 列表查询 | ✅ | 显示104条学校数据 |
-| 分页功能 | ✅ | 10条/页,共11页 |
-| 区域筛选 | ✅ | 左侧区域树正常 |
-| 搜索功能 | ✅ | 按学校名称搜索正常 |
-| 重置功能 | ✅ | 重置后恢复所有数据 |
-| 状态标签 | ✅ | 正常(绿)/停用(红) |
-| 操作按钮 | ✅ | 编辑、新增年级、新增班级、删除 |
-
-#### 数据示例
-
-```
-武昌区白鹭街小学 (01) - 正常
-黄冈市外国语学校 (03) - 停用
-武昌区积玉桥学校 (01) - 停用
-武昌实验小学 (01) - 正常
-武昌区水果湖第一小学 (01) - 正常
-武汉小学 (01) - 正常
-武昌区中华路小学 (01) - 正常
-...共104条
-```
-
-#### 搜索功能测试
-
-**测试用例**: 搜索"武昌实验"
-
-**测试结果**: ✅ **成功**
-- 搜索前: 显示104条数据
-- 搜索后: 显示2条匹配数据
-  - 武昌实验小学
-  - 武昌实验中学
-- 重置后: 恢复显示104条数据
-
-**评价**: 学校管理模块功能完整,数据准确,性能优秀
-
----
-
-### 2.3 会员管理模块测试 ✅
-
-**测试时间**: 2026-02-02 09:28
-
-**测试结果**: ⭐⭐⭐⭐⭐ **5/5 (完美)**
-
-#### 功能验证
-
-| 测试项 | 测试结果 | 说明 |
-|-------|:-------:|------|
-| 列表查询 | ✅ | 显示103条会员数据 |
-| 分页功能 | ✅ | 10条/页,共11页 |
-| 手机号脱敏 | ✅ | 显示为 139****XXXX |
-| 身份类型 | ✅ | 教师(3)、家长(1) |
-| 状态显示 | ✅ | 正常(绿色) |
-| 搜索表单 | ✅ | 手机号、昵称、身份类型、状态、注册时间 |
-| 操作按钮 | ✅ | 编辑、重置密码、删除 |
-
-#### 数据示例
-
-```
-139****2026 唐老师 (教师) - 正常
-139****1010 吴秀英 (家长) - 正常
-139****1001 张伟 (家长) - 正常
-139****1002 王芳 (家长) - 正常
-139****1003 李娜 (家长) - 正常
-139****1004 刘强 (家长) - 正常
-...共103条
-```
-
-**评价**: 会员管理模块数据完整,UI美观,功能齐全
-
----
-
-### 2.4 学生管理模块测试 ⚠️
-
-**测试时间**: 2026-02-02 09:28
-
-**测试结果**: ⭐⭐⭐⭐☆ **4/5 (良好)**
-
-#### 功能验证
-
-| 测试项 | 测试结果 | 说明 |
-|-------|:-------:|------|
-| 列表查询 | ✅ | 显示106条学生数据 |
-| 分页功能 | ✅ | 10条/页,共11页 |
-| 学校筛选 | ⚠️ | 左侧树显示"暂无数据" |
-| 搜索表单 | ✅ | 学生姓名、学号、性别 |
-| 性别标签 | ✅ | 男(蓝色)、女(红色) |
-| 数据完整性 | ✅ | 学号、姓名、性别、出生年月、学校、年级、班级 |
-| 操作按钮 | ✅ | 编辑、删除 |
-| 功能按钮 | ✅ | 新增、导入 |
-
-#### 数据示例
-
-```
-STU202601009 男 2013-01 武昌区南湖第一小学 九年级
-STU202605007 男 2006-04
-STU202601010 女 2013-04 武昌区南湖第一小学 九年级
-STU202601008 女 2014-11 武昌区南湖第一小学 八年级
-STU202601007 男 2014-08 武昌区南湖第一小学 八年级
-STU202601001 男 2015-03 武昌区南湖第一小学 七年级 1班
-...共106条
-```
-
-#### 发现的问题
-
-⚠️ **系统接口400异常警告**
-- 页面右上角显示红色警告: "系统接口400异常"
-- **但数据仍正常显示,功能可用**
-- 影响: 用户体验受影响,但不影响核心功能
-- 优先级: **P2(次要)** - 建议排查但不阻碍使用
-
-**评价**: 学生管理模块基本可用,数据完整,但有警告提示需要优化
-
----
-
-### 2.5 应用管理模块测试 ✅
-
-**测试时间**: 2026-02-02 09:29
-
-**测试结果**: ⭐⭐⭐⭐⭐ **5/5 (完美)**
-
-#### 功能验证
-
-| 测试项 | 测试结果 | 说明 |
-|-------|:-------:|------|
-| 列表查询 | ✅ | 显示6条应用数据 |
-| 分页功能 | ✅ | 10条/页,共1页 |
-| 搜索表单 | ✅ | 应用名称、应用编码、状态 |
-| 状态显示 | ✅ | 正常(绿色) |
-| 操作按钮 | ✅ | 编辑、重置密钥、删除 |
-| 功能按钮 | ✅ | 新增、搜索、重置 |
-
-#### 数据示例
-
-```
-AI智慧平台 (YY000001) - 正常
-测试应用 (YY000002) - 正常
-...共6条
-```
-
-**评价**: 应用管理模块功能正常,数据准确
-
----
-
-## 三、数据统计
-
-### 3.1 数据量统计
-
-| 模块 | 数据量 | 显示状态 | 数据质量 |
-|------|:-----:|:-------:|:--------:|
-| 学校管理 | 104条 | ✅ 完整显示 | ⭐⭐⭐⭐⭐ |
-| 会员管理 | 103条 | ✅ 完整显示 | ⭐⭐⭐⭐⭐ |
-| 学生管理 | 106条 | ✅ 完整显示 | ⭐⭐⭐⭐⭐ |
-| 应用管理 | 6条 | ✅ 完整显示 | ⭐⭐⭐⭐⭐ |
-
-**总数据量**: 319条业务数据
-
-**数据一致性**: ✅ **100%** (数据库 ↔ API ↔ 前端完全一致)
-
-### 3.2 功能可用性统计
-
-| 模块 | 可用性 | 评分 | 状态 |
-|------|:-----:|:----:|:----:|
-| 登录功能 | 100% | 5/5 | ✅ |
-| 学校管理 | 100% | 5/5 | ✅ |
-| 会员管理 | 100% | 5/5 | ✅ |
-| 学生管理 | 95% | 4/5 | ⚠️ |
-| 应用管理 | 100% | 5/5 | ✅ |
-
-**平均可用性**: ✅ **99%**
-
----
-
-## 四、性能评估
-
-### 4.1 页面加载性能
-
-| 页面 | 加载时间 | 数据量 | 评价 |
-|------|:-------:|:-----:|:----:|
-| 登录页面 | <2秒 | - | ✅ 快速 |
-| 首页 | <2秒 | - | ✅ 快速 |
-| 学校管理 | <3秒 | 104条 | ✅ 快速 |
-| 会员管理 | <3秒 | 103条 | ✅ 快速 |
-| 学生管理 | <3秒 | 106条 | ✅ 快速 |
-| 应用管理 | <3秒 | 6条 | ✅ 快速 |
-
-**平均加载时间**: <3秒
-
-**性能评价**: ⭐⭐⭐⭐⭐ **5/5 (优秀)**
-
----
-
-## 五、用户体验评估
-
-### 5.1 UI/UX评估
-
-| 维度 | 评分 | 说明 |
-|------|:----:|------|
-| 界面美观度 | 5.0/5 | Element Plus组件美观大方 ✅ |
-| 操作流畅度 | 4.8/5 | 响应快速,交互流畅 ✅ |
-| 数据加载速度 | 4.9/5 | 页面加载<3秒 ✅ |
-| 错误提示 | 4.0/5 | 有提示,但学生管理有误报 ⚠️ |
-| 功能完整性 | 5.0/5 | 核心功能齐全 ✅ |
-
-**综合评分**: ⭐⭐⭐⭐⭐ **4.7/5.0 (优秀)**
-
----
-
-## 六、测试覆盖率
-
-### 6.1 功能测试覆盖
-
-| 测试类型 | 测试项数 | 完成数 | 覆盖率 |
-|---------|:-------:|:------:|:-----:|
-| 登录功能 | 1 | 1 | 100% |
-| 学校管理 | 5 | 5 | 100% |
-| 会员管理 | 3 | 3 | 100% |
-| 学生管理 | 4 | 4 | 100% |
-| 应用管理 | 3 | 3 | 100% |
-
-**总体覆盖率**: ✅ **100%**
-
----
-
-## 七、问题汇总
-
-### 7.1 已发现问题列表
-
-| 序号 | 问题描述 | 优先级 | 影响 | 状态 |
-|:---:|---------|:-----:|------|:----:|
-| 1 | 学生管理页面显示"系统接口400异常"警告 | P2 | 不影响功能,但影响用户体验 | ⚠️ 待修复 |
-| 2 | 学生管理左侧学校筛选树显示"暂无数据" | P2 | 筛选功能不可用 | ⚠️ 待修复 |
-
-**问题总数**: 2个
-- P0(阻塞): 0个
-- P1(严重): 0个
-- P2(次要): 2个
-- P3(轻微): 0个
-
----
-
-## 八、测试结论
-
-### 8.1 总体评估
-
-**系统状态**: ✅ **生产就绪**
-
-**系统评级**: ⭐⭐⭐⭐⭐ **4.7/5.0 (优秀)**
-
-**核心指标**:
-- ✅ 功能可用性: 99%
-- ✅ 数据准确性: 100%
-- ✅ 性能表现: 优秀
-- ✅ 用户体验: 优秀
-- ⚠️ 问题数量: 2个(均为P2次要问题)
-
-### 8.2 优势总结
-
-1. ✅ **数据完整性优秀**: 所有模块数据准确,数据库与前端完全一致
-2. ✅ **核心功能100%可用**: 学校、会员、学生、应用管理核心功能全部正常
-3. ✅ **性能表现优秀**: 页面加载快速,用户体验流畅
-4. ✅ **UI设计美观**: Element Plus组件库使用得当,界面现代化
-5. ✅ **数据量充足**: 共319条真实测试数据,覆盖各种场景
-
-### 8.3 待改进项
-
-1. ⚠️ **学生管理400异常**: 需要排查后端API,消除警告提示
-2. ⚠️ **学校筛选树优化**: 学生管理页面的学校筛选树需要修复
-
----
-
-## 九、建议与后续计划
-
-### 9.1 部署建议
-
-**✅ 推荐部署环境**:
-1. ✅ 开发测试环境 - **立即部署**
-2. ✅ 内部演示环境 - **立即部署**
-3. ✅ 用户验收环境 - **立即部署**
-
-**推荐理由**:
-- 核心功能100%可用
-- 数据质量优秀
-- 性能表现优秀
-- P2问题不影响核心业务
-
-**⚠️ 谨慎部署环境**:
-1. ⚠️ 生产环境 - 建议修复P2问题后部署
-
-### 9.2 后续优化建议
-
-**短期优化** (本周):
-1. 修复学生管理400异常警告
-2. 修复学校筛选树显示问题
-3. 补充自动化测试脚本
-
-**中期优化** (本月):
-1. 完善错误提示机制
-2. 增加操作日志记录
-3. 性能监控和优化
-4. 补充更多测试用例
-
-**长期规划**:
-1. 用户权限管理完善
-2. 数据导入导出功能增强
-3. 移动端适配
-4. 性能压力测试
-
----
-
-## 十、附录
-
-### 10.1 测试截图清单
-
-本次测试共生成8张截图:
-1. ✅ 登录页面
-2. ✅ 登录成功-首页
-3. ✅ 学校管理-列表页面
-4. ✅ 学校管理-搜索结果
-5. ✅ 会员管理-列表页面
-6. ✅ 学生管理-列表页面(含400异常)
-7. ✅ 应用管理-列表页面
-
-### 10.2 测试数据说明
-
-**数据来源**: 真实数据库数据
-**数据库**: pguser-db (MySQL 8.0)
-**数据表**: 12张业务表
-**数据质量**: ⭐⭐⭐⭐⭐ 优秀
-
-### 10.3 测试工具
-
-- **浏览器**: Chrome (自动化测试)
-- **自动化工具**: MCP Browser Extension
-- **测试框架**: Playwright
-- **截图工具**: 浏览器截图API
-
----
-
-## 🎉 最终结论
-
-**系统状态**: ✅ **核心功能100%可用,推荐部署**
-
-**系统评级**: ⭐⭐⭐⭐⭐ **4.7/5.0 (优秀)**
-
-**部署建议**: ✅ **推荐立即部署到开发、演示、验收环境**
-
-**核心成就**:
-- ✅ 所有核心模块功能正常
-- ✅ 数据完整性100%
-- ✅ 性能表现优秀
-- ✅ 用户体验优秀
-- ⚠️ 仅有2个P2次要问题
-
-**后续关注**:
-- ⏳ 修复学生管理400异常(P2)
-- ⏳ 修复学校筛选树问题(P2)
-
----
-
-**测试负责人**: 湖北新华业务中台研发团队
-**报告完成时间**: 2026-02-02 09:30
-**报告状态**: ✅ **最终版本**
-**系统状态**: ✅ **推荐部署** 🚀
-
----
-
-*本报告记录了盘古用户平台的完整功能测试结果。经过测试验证,核心业务模块已达到生产就绪标准,系统整体可用性达到99%,强烈推荐部署到开发和验收环境使用。*

docs/若依介绍清理记录.md

@@ -1,176 +0,0 @@
-# 若依介绍页面清理记录
-
-> 清理时间: 2026-02-02
-> 操作人: 湖北新华业务中台研发团队
-
----
-
-## 📋 清理内容
-
-### 1. 首页若依介绍
-
-**文件**: `frontend/ruoyi-ui/src/views/index.vue`
-
-**清理内容**:
-- ❌ 删除: 若依后台管理框架介绍
-- ❌ 删除: 技术选型说明
-- ❌ 删除: 更新日志
-- ❌ 删除: 联系信息 (官网、QQ群、微信、支付宝)
-- ❌ 删除: 捐赠支持
-- ✅ 替换为: 盘古用户平台统计数据展示页面
-
-**新页面内容**:
-- 欢迎标题: "欢迎使用盘古用户平台"
-- 4个统计卡片: 学校数、会员数、学生数、应用数
-
----
-
-### 2. 导航栏若依链接
-
-**文件**: `frontend/ruoyi-ui/src/layout/components/Navbar.vue`
-
-**清理内容**:
-- ❌ 删除组件引用: `RuoYiGit` (源码地址)
-- ❌ 删除组件引用: `RuoYiDoc` (文档地址)
-- ❌ 删除 Tooltip: "源码地址"
-- ❌ 删除 Tooltip: "文档地址"
-
-**修改位置**:
-- 第15-21行: 删除两个 `<el-tooltip>` 标签
-- 第70-71行: 删除组件 import 语句
-
----
-
-### 3. 若依介绍组件
-
-**删除目录**: `frontend/ruoyi-ui/src/components/RuoYi/`
-
-**删除文件**:
-- ❌ `RuoYi/Git/index.vue` - 源码地址组件 (指向 https://gitee.com/y_project/RuoYi-Vue)
-- ❌ `RuoYi/Doc/index.vue` - 文档地址组件 (指向 http://doc.ruoyi.vip)
-
----
-
-### 4. 版权信息
-
-**文件**: `frontend/ruoyi-ui/src/settings.js`
-
-**修改内容**:
-```javascript
-// 修改前
-footerContent: 'Copyright © 2018-2026 RuoYi. All Rights Reserved.'
-
-// 修改后
-footerContent: 'Copyright © 2026 湖北新华业务中台研发团队. All Rights Reserved.'
-```
-
----
-
-### 5. README 文档
-
-**文件**: `frontend/ruoyi-ui/README.md`
-
-**清理内容**:
-- ❌ 删除: 若依项目介绍
-- ❌ 删除: 若依版本对比表
-- ❌ 删除: 若依演示地址
-- ❌ 删除: 若依文档链接
-- ❌ 删除: 若依 Logo 和徽章
-- ✅ 替换为: 盘古用户平台前端项目说明
-
-**新文档包含**:
-- 项目简介
-- 技术栈说明
-- 快速开始指南
-- 项目结构说明
-- 配置说明
-- 核心功能模块
-- 开发规范
-- 常见问题
-
----
-
-## ✅ 验证结果
-
-### 页面验证
-
-1. **首页** (http://localhost/index)
-   - ✅ 显示盘古用户平台统计数据
-   - ✅ 无若依介绍内容
-   - ✅ 4个统计卡片正常显示
-
-2. **导航栏**
-   - ✅ 删除了"源码地址"图标
-   - ✅ 删除了"文档地址"图标
-   - ✅ 保留了: 搜索、全屏、主题、布局大小、用户头像
-
-3. **版权信息**
-   - ✅ 底部版权已更新为湖北新华团队
-
----
-
-## 📝 保留的若依内容
-
-以下若依相关内容因**技术性原因保留**:
-
-### 1. 核心工具文件
-- `src/utils/ruoyi.js` - 若依工具函数库
-- `src/assets/styles/ruoyi.scss` - 若依样式文件
-
-**保留原因**: 这些是核心功能函数，已被大量业务代码引用。
-
-### 2. 代码注释中的若依字样
-- 部分组件注释中提及 "RuoYi" 或 "若依"
-- 工具函数中的作者标注
-
-**保留原因**: 注释内容不影响用户体验，仅供开发参考。
-
-### 3. 目录名称
-- `frontend/ruoyi-ui/` - 前端项目目录名
-
-**保留原因**: 修改目录名需要大量配置调整，风险较高。
-
----
-
-## 🎯 清理效果
-
-### 用户可见部分
-✅ **100% 清理完成**
-- 首页无若依介绍
-- 导航栏无若依链接
-- README 无若依内容
-- 版权信息已更新
-
-### 代码内部
-⚠️ **部分保留**
-- 核心工具函数保留
-- 技术性文件保留
-- 不影响业务功能
-
----
-
-## 📊 清理统计
-
-| 类型 | 数量 | 状态 |
-|------|:----:|:----:|
-| 删除组件 | 2 | ✅ |
-| 修改文件 | 4 | ✅ |
-| 删除目录 | 1 | ✅ |
-| 更新文档 | 2 | ✅ |
-| 删除代码行 | ~1100+ | ✅ |
-
----
-
-## ✨ 总结
-
-1. ✅ 所有面向用户的若依介绍已完全清理
-2. ✅ 页面已替换为盘古用户平台品牌内容
-3. ✅ 前端服务运行正常
-4. ✅ 不影响任何业务功能
-
-**清理完成度**: 用户可见部分 100% ✨
-
----
-
-*文档维护: 湖北新华业务中台研发团队*
-*最后更新: 2026-02-02*

frontend/ruoyi-ui/README.md

@@ -1,199 +0,0 @@
-# 盘古用户平台 - 前端项目
-
-> 统一用户管理系统前端
-> 
-> **开发团队**: 湖北新华业务中台研发团队
-
----
-
-## 📦 技术栈
-
-- **前端框架**: Vue 3
-- **UI 组件库**: Element Plus
-- **构建工具**: Vite
-- **状态管理**: Pinia
-- **路由管理**: Vue Router 4
-- **HTTP 客户端**: Axios
-
----
-
-## 🚀 快速开始
-
-### 环境要求
-
-- Node.js: 16+
-- npm: 8+
-
-### 安装依赖
-
-```bash
-npm install
-```
-
-### 开发模式
-
-```bash
-npm run dev
-```
-
-访问地址: http://localhost:80
-
-### 生产构建
-
-```bash
-npm run build:prod
-```
-
-构建产物在 `dist/` 目录
-
----
-
-## 📁 项目结构
-
-```
-ruoyi-ui/
-├── public/              # 静态资源
-├── src/
-│   ├── api/            # API 接口
-│   ├── assets/         # 资源文件
-│   ├── components/     # 公共组件
-│   ├── layout/         # 布局组件
-│   ├── router/         # 路由配置
-│   ├── store/          # 状态管理
-│   ├── utils/          # 工具函数
-│   ├── views/          # 页面组件
-│   │   ├── school/     # 学校管理
-│   │   ├── member/     # 会员管理
-│   │   ├── student/    # 学生管理
-│   │   ├── application/ # 应用管理
-│   │   └── base/       # 基础数据
-│   ├── App.vue
-│   └── main.js
-├── .env.development     # 开发环境配置
-├── .env.production      # 生产环境配置
-├── vite.config.js       # Vite 配置
-└── package.json
-```
-
----
-
-## ⚙️ 配置说明
-
-### 环境变量
-
-**开发环境** (`.env.development`):
-```bash
-VITE_APP_TITLE = '盘古用户平台'
-VITE_APP_BASE_API = '/dev-api'
-```
-
-**生产环境** (`.env.production`):
-```bash
-VITE_APP_TITLE = '盘古用户平台'
-VITE_APP_BASE_API = '/prod-api'
-```
-
----
-
-## 🎯 核心功能模块
-
-| 模块 | 路由 | 说明 |
-|------|------|------|
-| 首页 | `/index` | 统计数据展示 |
-| 学校管理 | `/school` | 学校、年级、班级管理 |
-| 会员管理 | `/member` | 家长/教师用户管理 |
-| 学生管理 | `/student` | 学生信息、批量导入 |
-| 应用管理 | `/application` | 第三方应用接入 |
-| 基础数据 | `/base/*` | 年级、班级、学科、区域 |
-
----
-
-## 🔧 开发规范
-
-### 代码规范
-
-- 遵循 Vue 3 Composition API 规范
-- 组件命名使用大驼峰 (PascalCase)
-- 文件命名使用小写 + 连字符 (kebab-case)
-- 注释使用中文
-
-### 组件命名
-
-```javascript
-// ✅ 正确
-components/
-  ├── SchoolDialog.vue
-  ├── MemberDialog.vue
-  └── StudentDialog.vue
-
-// ❌ 错误
-components/
-  ├── schoolDialog.vue
-  ├── member-dialog.vue
-  └── studentdialog.vue
-```
-
-### API 调用
-
-```javascript
-// api/school.js
-import request from '@/utils/request'
-
-export function listSchool(query) {
-  return request({
-    url: '/school/list',
-    method: 'get',
-    params: query
-  })
-}
-```
-
----
-
-## 🐛 常见问题
-
-### 1. 端口被占用
-
-修改 `vite.config.js`:
-```javascript
-server: {
-  port: 8080, // 修改为其他端口
-}
-```
-
-### 2. API 请求跨域
-
-开发环境已配置代理，生产环境需在 Nginx 配置跨域。
-
-### 3. Element Plus 按需引入
-
-项目已配置自动导入，无需手动引入组件。
-
----
-
-## 📝 更新日志
-
-### v1.0.0 (2026-02-02)
-
-- ✅ 完成首页统计数据展示
-- ✅ 完成学校管理模块
-- ✅ 完成会员管理模块
-- ✅ 完成学生管理模块
-- ✅ 完成应用管理模块
-- ✅ 完成基础数据管理模块
-
----
-
-## 👥 团队
-
-**湖北新华业务中台研发团队**
-
----
-
-## 📄 许可证
-
-本项目为内部项目，未开源。
-
----
-
-*最后更新: 2026-02-02*

pangu-system/src/main/java/com/pangu/application/controller/ApplicationController.java

@@ -20,7 +20,7 @@ import java.util.List;
  * @author pangu
  */
 @RestController
-@RequestMapping("/application")
+@RequestMapping("/api/application")
 @RequiredArgsConstructor
 @PreAuthorize("hasRole('admin')")
 public class ApplicationController extends BaseController {

pangu-system/src/main/java/com/pangu/base/controller/GradeController.java

@@ -17,7 +17,7 @@ import java.util.List;
  * @author pangu
  */
 @RestController
-@RequestMapping("/grade")
+@RequestMapping("/api/grade")
 public class GradeController extends BaseController {
 
     @Autowired

pangu-system/src/main/java/com/pangu/base/controller/PgClassController.java

@@ -16,7 +16,7 @@ import java.util.List;
  * @author pangu
  */
 @RestController
-@RequestMapping("/class")
+@RequestMapping("/api/class")
 public class PgClassController extends BaseController {
 
     @Autowired

pangu-system/src/main/java/com/pangu/base/controller/RegionController.java

@@ -16,7 +16,7 @@ import java.util.List;
  * @author pangu
  */
 @RestController
-@RequestMapping("/region")
+@RequestMapping("/api/region")
 public class RegionController extends BaseController {
 
     @Autowired

pangu-system/src/main/java/com/pangu/base/controller/SubjectController.java

@@ -16,7 +16,7 @@ import java.util.List;
  * @author pangu
  */
 @RestController
-@RequestMapping("/subject")
+@RequestMapping("/api/subject")
 public class SubjectController extends BaseController {
 
     @Autowired

pangu-system/src/main/java/com/pangu/member/controller/MemberController.java

@@ -15,7 +15,7 @@ import org.springframework.web.bind.annotation.*;
  * @author pangu
  */
 @RestController
-@RequestMapping("/member")
+@RequestMapping("/api/member")
 public class MemberController extends BaseController {
 
     @Autowired

pangu-system/src/main/java/com/pangu/school/controller/SchoolController.java

@@ -22,7 +22,7 @@ import java.util.List;
  * @author pangu
  */
 @RestController
-@RequestMapping("/school")
+@RequestMapping("/api/school")
 public class SchoolController extends BaseController {
 
     @Autowired

pangu-system/src/main/java/com/pangu/student/controller/StudentController.java

@@ -27,7 +27,7 @@ import java.util.List;
  * @author pangu
  */
 @RestController
-@RequestMapping("/student")
+@RequestMapping("/api/student")
 @RequiredArgsConstructor
 public class StudentController extends BaseController {
 

pangu-system/src/main/java/com/pangu/system/controller/SysDeptController.java

@@ -13,7 +13,7 @@ import java.util.*;
  * @author 湖北新华业务中台研发团队
  */
 @RestController
-@RequestMapping("/system/dept")
+@RequestMapping("/api/system/dept")
 public class SysDeptController extends BaseController {
 
     @Autowired

pangu-system/src/main/java/com/pangu/system/controller/SysDictController.java

@@ -14,7 +14,7 @@ import java.util.*;
  * @author 湖北新华业务中台研发团队
  */
 @RestController
-@RequestMapping("/system/dict")
+@RequestMapping("/api/system/dict")
 public class SysDictController extends BaseController {
 
     @Autowired

pangu-system/src/main/java/com/pangu/system/controller/SysLogController.java

@@ -14,7 +14,7 @@ import java.util.*;
  * @author 湖北新华业务中台研发团队
  */
 @RestController
-@RequestMapping("/system/log")
+@RequestMapping("/api/system/log")
 public class SysLogController extends BaseController {
 
     @Autowired

pangu-system/src/main/java/com/pangu/system/controller/SysMenuController.java

@@ -13,7 +13,7 @@ import java.util.*;
  * @author 湖北新华业务中台研发团队
  */
 @RestController
-@RequestMapping("/system/menu")
+@RequestMapping("/api/system/menu")
 public class SysMenuController extends BaseController {
 
     @Autowired

pangu-system/src/main/java/com/pangu/system/controller/SysPostController.java

@@ -14,7 +14,7 @@ import java.util.*;
  * @author 湖北新华业务中台研发团队
  */
 @RestController
-@RequestMapping("/system/post")
+@RequestMapping("/api/system/post")
 public class SysPostController extends BaseController {
 
     @Autowired

pangu-system/src/main/java/com/pangu/system/controller/SysRoleController.java

@@ -14,7 +14,7 @@ import java.util.*;
  * @author 湖北新华业务中台研发团队
  */
 @RestController
-@RequestMapping("/system/role")
+@RequestMapping("/api/system/role")
 public class SysRoleController extends BaseController {
 
     @Autowired