Commit Graph

142 Commits

Author SHA1 Message Date
神码-方晓辉 c2a3997e89 refactor: 品牌名称 若依 -> 盘古
- 更新文档、注释、配置中的"若依"为"盘古"
- 涉及文件:规则文件、运维文档、代码注释、package.json等
2026-02-03 20:48:55 +08:00
神码-方晓辉 9128118cbf refactor: 后端目录重命名 ruoyi -> pangu
- ruoyi-admin -> pangu-admin
- ruoyi-common -> pangu-common (含所有子模块)
- ruoyi-extend -> pangu-extend (含所有子模块)
- ruoyi-modules -> pangu-modules (含所有子模块)
- 更新所有 pom.xml 中的 artifactId 和依赖引用
- 更新 build.sh 和相关文档
2026-02-03 20:47:45 +08:00
神码-方晓辉 086c0a0988 refactor: 前端目录重命名及配置优化
- frontend/ruoyi-ui 重命名为 frontend/pangu-ui
- 修改系统标题为"盘古用户认证中心"
- 开启验证码功能
- 移除登录页默认账号密码
2026-02-03 20:37:48 +08:00
神码-方晓辉 0c607378e9 chore: 统一 author 为 pangu 2026-02-03 20:26:45 +08:00
神码-方晓辉 6b56c831cb fix: 优化教育身份操作日志描述
日志描述改为:学校 / 年级 / 班级 / 学科
2026-02-03 20:18:22 +08:00
神码-方晓辉 14f42f6b69 feat: 新增会员操作日志功能
1. 新增 pg_member_log 表记录会员操作
2. 新增操作类型枚举 MemberOperType
3. 新增 PgMemberLogService 记录和查询日志
4. 在以下操作位置添加日志记录:
   - 用户登录
   - 修改密码
   - 修改用户信息
   - 新增/修改/删除教育身份
   - 切换教育身份
   - 新增/修改/解绑亲子关系
5. 新增 H5 查询操作日志 API
2026-02-03 20:10:04 +08:00
神码-方晓辉 5de0f3ed50 fix: 短信登录不再校验图形验证码
发送短信时已经验证过图形验证码,登录时无需再次验证。
避免用户输入两次图形验证码,提升体验。
2026-02-03 19:01:04 +08:00
神码-方晓辉 d543b868b1 docs: 添加H5前端同步变更记录(附录C)
- 注册流程简化
- 教育身份改为数组
- 基础数据前端缓存策略
2026-02-03 17:56:38 +08:00
神码-方晓辉 8ba5e3e174 perf: 学校管理页面区域树默认折叠
移除 default-expand-all,减少首次渲染节点数量
2026-02-03 17:43:29 +08:00
神码-方晓辉 d0d0f0ee6d perf: 所有基础数据下拉统一使用 Store 缓存
修改以下组件使用 baseDataStore:
- business/school/components/GradeDialog.vue (年级)
- business/school/components/ClassDialog.vue (班级)
- school/index.vue (区域树)
- school/components/GradeDialog.vue (年级)
- school/components/ClassDialog.vue (年级+班级)
- member/components/MemberDialog.vue (区域树)

登录后预加载数据,后续全部命中缓存
2026-02-03 17:40:59 +08:00
神码-方晓辉 e8489536d6 fix: 每次登录后强制刷新基础数据
fetchXxx(true) 传入 force=true,确保登录后拉取最新数据
2026-02-03 17:36:31 +08:00
神码-方晓辉 81b1d5327b perf: 其他页面使用 Store 缓存基础数据
- EducationDialog.vue: 区域树、学科列表使用 Store
- school/index.vue: 区域树使用 Store

所有基础数据调用统一使用 Store,命中缓存后秒加载
2026-02-03 17:25:10 +08:00
神码-方晓辉 4243f6581d perf: 登录后预加载基础数据,区域管理使用 Store 缓存
- permission.js: 登录后并行预加载年级/学科/区域/班级数据
- region/index.vue: 使用 Store 缓存,避免每次请求 1MB 数据
- 第二次进入页面秒开,无需重复请求
2026-02-03 17:23:27 +08:00
神码-方晓辉 24625133e3 perf: 优化区域管理页面性能
- 使用后端 /region/tree 接口,避免前端递归构建树
- 默认折叠树节点,减少 DOM 渲染
2026-02-03 17:17:28 +08:00
神码-方晓辉 124013703f feat: 基础数据前端缓存 - 使用 Pinia Store 实现
- 新建 baseData Store,缓存年级/学科/区域/班级数据
- 支持 localStorage 持久化,24小时过期
- 编辑/删除操作自动清除对应缓存
- 修改四个管理页面(grade/subject/region/class)使用 Store
2026-02-03 17:14:58 +08:00
神码-方晓辉 bf67282825 feat: 学生管理页面展示多会员绑定信息
- 列表页"归属用户"列:单人显示昵称/手机号,多人显示"N人绑定"并用tooltip展示详情
- 编辑弹窗:使用Tag组件展示所有绑定的会员信息
2026-02-03 17:04:07 +08:00
神码-方晓辉 df1f2932c4 feat: 学生多会员绑定重构 - 支持一个学生被多个会员绑定
主要变更:
1. 新建 pg_member_student 关联表,实现学生与会员的多对多关系
2. 移除 pg_student.member_id 字段
3. 后端服务层全部改用关联表查询和操作
4. H5 接口支持 relation 字段(父亲/母亲/其他)
5. 前端学生选择弹窗显示已绑定会员数量
6. 更新需求文档
2026-02-03 16:56:18 +08:00
神码-方晓辉 729f2c71f1 feat: 会员教育信息重构 - 支持多教育身份管理
主要变更:
1. 去掉身份类型字段,会员与教育信息改为一对多关系
2. 新增 pg_education 表及相关实体、服务
3. 管理后台支持添加、编辑、删除多个教育身份
4. 新增会员时支持一次性保存会员信息、教育身份、亲子关系
5. 修复学生选择弹窗学校年级班级不显示问题
6. 添加区域路径接口用于级联选择器回显
2026-02-03 16:35:57 +08:00
神码-方晓辉 acdade6725 feat: 添加微信登录接口和技术方案文档 2026-02-03 15:31:56 +08:00
神码-方晓辉 f0d8a6c571 feat: H5教育身份接口增加省市区信息返回
- 修改 H5EducationVo 添加省市区字段
- 修改 H5MemberServiceImpl 的 buildEducationVo 方法,从学校的regionId解析省市区信息
- 保存教育身份时自动从学校获取regionId保存到会员表
- 添加日志记录省市区信息便于调试
- 更新 pangu-project.mdc 文档,添加 build.sh 工具使用说明
- 优化管理后台会员和学生相关组件
2026-02-03 11:53:55 +08:00
神码-方晓辉 e35b4098e6 v1.0.1 2026-02-03 09:45:55 +08:00
神码-方晓辉 dab220d0a2 feat: 添加Swagger UI支持
- pom.xml: 添加springdoc-openapi-starter-webmvc-ui依赖
- application.yml: 添加swagger-ui路径排除配置
- application.yml: 添加H5模块到API分组
- vite.config.js: 添加Swagger代理配置
2026-02-03 09:25:37 +08:00
神码-方晓辉 dcadd41e2b fix: 修复H5登录Token校验问题,添加测试报告
问题修复:
- H5AuthServiceImpl: 登录时设置extra信息(tenantId,userId,userName,clientid)
- SecurityConfig: H5设备跳过clientId校验,避免NPE

测试文档:
- 新增 docs/03-测试文档/H5接口测试报告.md
- 覆盖基础数据、认证、会员模块共16个测试用例
- 测试手机号: 15889762069
- 真实短信发送测试通过
2026-02-02 22:11:15 +08:00
神码-方晓辉 1ae754e56c docs: 补充短信模板内容
- 登录模板: 【湖北新华教育服务平台】您正在申请登录,验证码为:${code}
- 注册模板: 【湖北新华教育服务平台】您正在申请注册,验证码为:${code}
2026-02-02 21:56:19 +08:00
神码-方晓辉 e98fe86124 feat: 配置阿里云短信服务参数
从192.168.71.56服务器nacos获取阿里云短信配置:
- AccessKey: LTAI5tQLorTxf9Fzzh93pfGN
- 签名: 湖北新华教育服务平台
- 登录模板: SMS_461020580
- 注册模板: SMS_473140005

更新文件:
- application-dev.yml: 写入阿里云AccessKey和签名
- application.yml: 配置短信模板ID
- 技术方案文档: 更新阿里云账号和模板信息
2026-02-02 21:54:05 +08:00
神码-方晓辉 e13c9a7de3 docs: 完善阿里云短信配置说明
配置文件更新:
- application-dev.yml: 优化阿里云短信配置,添加环境变量支持
- application.yml: 完善H5短信配置注释,分组显示

文档更新:
- 添加阿里云准备工作步骤
- 添加短信模板示例
- 添加环境变量配置说明(推荐生产环境使用)
2026-02-02 21:51:07 +08:00
神码-方晓辉 0b35da7f85 docs: 添加H5接口Swagger文档注解
Controller层:
- H5AuthController: 添加详细的接口说明、参数说明、返回值说明
- H5MemberController: 添加认证要求、操作说明
- H5BaseDataController: 添加数据获取流程说明

DTO/VO层:
- 所有字段添加@Schema注解,包含描述、示例值、枚举值等
- 标注必填/选填、数据格式要求

其他:
- 统一作者为pangu
2026-02-02 21:48:36 +08:00
神码-方晓辉 a47536315b docs: 更新H5接口文档,添加短信防刷配置说明 2026-02-02 21:44:46 +08:00
神码-方晓辉 5fe9d1117f feat: 增强H5短信接口防刷机制
新增配置类 H5SmsProperties,支持以下配置项:
- enabled: 是否启用短信发送(测试模式)
- code-length: 验证码长度
- code-expire-minutes: 验证码有效期
- send-interval-seconds: 同手机号发送间隔
- daily-limit-per-phone: 手机号每日上限
- minute-limit-per-ip: IP每分钟上限
- daily-limit-per-ip: IP每日上限
- blacklist-minutes: 黑名单封禁时长
- blacklist-trigger-count: 触发黑名单的失败次数
- sms-config-name: 短信配置名称
- login/register-template-id: 短信模板ID

防刷策略:
1. 图形验证码校验
2. 手机号黑名单检查
3. IP黑名单检查
4. 发送间隔限制
5. 手机号每日上限
6. IP每分钟上限
7. IP每日上限
8. 验证码连续失败自动封禁
2026-02-02 21:43:38 +08:00
神码-方晓辉 905e263ca8 feat: 新增H5会员管理接口模块
需求文档:
- 新增H5会员接口需求与技术方案文档

认证模块(/h5/auth):
- 图形验证码获取
- 阿里云短信验证码发送
- 密码登录
- 短信验证码登录
- 会员注册
- Token刷新
- 退出登录

会员模块(/h5/member):
- 获取会员信息
- 修改会员信息(昵称/性别/生日)
- 修改密码
- 教育身份管理(教师)
- 学生绑定管理(家长/教师均可)

基础数据模块(/h5/base):
- 区域树查询
- 学校列表查询
- 年级列表查询
- 班级列表查询
- 学科列表查询

安全配置:
- 放行H5公开接口(/h5/auth/**、/h5/base/**)
2026-02-02 21:39:12 +08:00
神码-方晓辉 e8c4f3f568 style: 学生弹窗归属用户改为只读红色标签
- 归属用户字段改为只读展示
- 展示格式:会员昵称(手机号)
- 红色字体显示
- 移除选择/清除按钮
2026-02-02 21:12:20 +08:00
神码-方晓辉 43ee2dbf87 refactor: 删除学生管理中的学科字段
前端:
- 列表页删除学科列
- 编辑弹窗删除学科下拉框

后端:
- PgStudent 实体删除 subjectId 字段
- StudentVo 删除 subjectId 和 subjectName 字段
- Service 层删除学科关联查询

需求文档:
- 删除学生数据项中的学科字段
- 删除表格列定义中的学科列

数据库需执行:ALTER TABLE pg_student DROP COLUMN subject_id;
2026-02-02 21:11:37 +08:00
神码-方晓辉 b5c2692aab feat: 学生导入重新选择文件时自动覆盖之前的记录
在 beforeUpload 中调用 clearFiles() 清空文件列表,
实现"选择即覆盖"效果,无需手动删除再重新选择

同步更新需求文档
2026-02-02 21:04:40 +08:00
神码-方晓辉 e1ea099a38 fix: 修复学生管理左侧树筛选条件未正确传递的问题
问题:点击年级/班级节点时,只传了当前节点ID,未带上父级条件
修复:
1. 参数名改为与后端一致(schoolGradeId、schoolClassId)
2. 点击年级节点时,同时传递 schoolId + schoolGradeId
3. 点击班级节点时,同时传递 schoolId + schoolGradeId + schoolClassId

同步更新需求文档
2026-02-02 21:00:57 +08:00
神码-方晓辉 904c7c9500 feat: 学生导入增加教师身份校验
当会员手机号对应的会员身份为"教师"时,校验规则:
1. 教师必须已设置学校信息,否则提示"未设置学校信息,无法绑定学生"
2. 教师所属区域必须与学生所属区域一致
3. 教师所属学校必须与学生所属学校一致
4. 教师所属年级必须与学生所属年级一致
5. 教师所属班级必须与学生所属班级一致
不一致则导入失败并返回具体原因

同步更新需求文档
2026-02-02 20:53:44 +08:00
神码-方晓辉 18b9a09348 fix: 会员列表昵称列自适应宽度填充表格 2026-02-02 20:43:24 +08:00
神码-方晓辉 a384b27033 fix: 优化会员列表页列宽度
- 会员编号:160 → 185(显示完整编号)
- 手机号:150 → 145
- 昵称:min-width 100 → 固定 120(减少浪费空间)
2026-02-02 20:42:49 +08:00
神码-方晓辉 3d70bd0356 fix: 会员管理编辑页绑定学生显示学校、年级、班级
修改 selectByMemberId 接口返回 StudentVo 而非 PgStudent,
包含学校名称、年级名称、班级名称等关联数据
2026-02-02 20:40:09 +08:00
神码-方晓辉 6eb0643ae7 docs: 更新需求文档中出生日期格式说明
1. 会员管理:出生日期格式 YYYY-MM-DD
2. 学生管理:出生日期格式 YYYY-MM-DD
3. 学生导入:出生日期格式 YYYY-MM-DD,用户手机号改为会员手机号
2026-02-02 20:35:46 +08:00
神码-方晓辉 4e54dc8422 fix: 会员管理出生日期只显示年月日(YYYY-MM-DD)
去除时分秒显示,保持格式一致
2026-02-02 20:34:50 +08:00
神码-方晓辉 26efdc42fc feat: 会员管理手机号列添加眼睛按钮切换显示
点击眼睛图标可切换手机号的脱敏/完整显示
2026-02-02 20:33:57 +08:00
神码-方晓辉 cca0902d28 fix: 学生管理出生年月改为出生日期(YYYY-MM-DD)
1. 新增/编辑弹窗:日期选择器从月份改为日期
2. 列表页:出生日期列显示完整日期格式
2026-02-02 20:33:10 +08:00
神码-方晓辉 c18970ee98 fix: 修复学生导入时创建会员缺少member_code的问题
创建会员时自动生成会员编码(M+时间戳+4位随机数)
同时设置注册时间
2026-02-02 20:25:45 +08:00
神码-方晓辉 da75094367 fix: 修复学生导入上传认证失败的问题
使用自定义上传方法(http-request)替代原生action,
通过项目的request工具发送请求,自动走Vite代理并携带token
2026-02-02 20:19:48 +08:00
神码-方晓辉 ea1524ea67 feat: 实现学生批量导入功能
1. 新增 POST /business/student/import 接口
2. 实现导入业务逻辑:
   - 校验必填字段(姓名、学号、会员手机号、学校、年级、班级)
   - 根据名称匹配学校、年级、班级
   - 根据手机号查找或创建会员(不存在则自动创建家长账号)
   - 检查学号唯一性
   - 返回导入结果(成功数、失败数、失败明细)
2026-02-02 20:11:56 +08:00
神码-方晓辉 eb7ef037f0 fix: 学生导入模板出生年月改为出生日期(YYYY-MM-DD) 2026-02-02 20:06:43 +08:00
神码-方晓辉 4eea1eef34 fix: 修复学生导入模板下载功能
使用 axios (request) 替代 fetch,走 Vite 代理正确转发请求
2026-02-02 20:04:14 +08:00
神码-方晓辉 ca433d6ab9 feat: 完善学生导入模板下载功能
1. 后端新增接口 /business/student/template
   - 使用 ExcelUtil 导出模板
   - 包含示例数据方便用户参考

2. 前端修复模板下载:
   - 使用 fetch 下载文件
   - 文字"用户手机号"改为"会员手机号"

3. 新增 StudentImportDto 导入数据对象
   - 字段:姓名、学号、会员手机号、区域、学校、年级、班级、性别、出生年月
2026-02-02 20:02:41 +08:00
神码-方晓辉 6784e32e1e fix: 修复学生管理模块问题
1. 后端修复:
   - 添加 StudentVo 视图类,包含学校名、年级名、班级名、学科名、会员昵称等关联数据
   - Service 返回 StudentVo,关联查询各表数据

2. 前端修复:
   - StudentDialog 改为自获取 schoolTree 和 subjectList
   - 修复字段名适配(studentId/studentName)
   - 编辑时完整回显学校/年级/班级三级路径
   - 添加 MemberSelectDialog 会员选择弹窗

3. ImportDialog 完善:
   - 修复 token 获取方式适配 RuoYi 框架
   - 完善上传进度显示

4. index.vue 修复:
   - 表格列字段名适配后端返回数据
   - 添加日期格式化函数
2026-02-02 19:57:14 +08:00
神码-方晓辉 9883fddb67 fix: 学生管理左侧学校树字段映射修复
将 el-tree 的 label 属性从 'label' 改为 'name',
与后端 SchoolTreeNode 返回的字段名保持一致。
2026-02-02 19:49:12 +08:00