MDP主数据平台V0.0.2版本升级日志

• 更新版本：V0.0.2
• 更新时间：2025-11-13

一、新增核心功能模块

1. 认证与用户管理模块

• 核心控制器新增：添加 AuthController，聚合登录、注册全流程能力，具体包括： 实现手机号、邮箱双渠道注册接口，支持差异化验证逻辑
• 开发短信、邮箱验证码发送接口，集成验证码时效管控（默认15分钟）
• 新增手机号存在性检查接口，用于注册前置校验

2. 文件上传模块

• 控制器新增：新增 FileUploadController，支撑文件全生命周期管理： 实现文件上传接口，兼容单文件上传与分片上传场景
• 开发文件与业务关联接口，支持按业务ID查询关联文件
• 提供文件访问路径查询接口，适配多存储引擎路径规则

3. 字典与配置服务模块

• 控制器新增： 新增 EchoController，实现根据ID查询字典项功能，支持精准匹配与缓存查询
• 新增 GeneralController，提供参数与字典项通用查询接口，支持批量查询

4. 资源与组织管理模块

• 控制器新增： 新增 ResourceController，支持菜单资源查询与用户信息获取，关联权限校验逻辑
• 调整 LoginLogController请求路径前缀为 /loginLog，规范接口路径命名
• 新增 ProfileController占位类，为后续用户中心功能预留扩展入口

二、重构与优化模块

1. 服务调用架构重构

• 核心重构内容： 移除所有控制器中对具体service的依赖注入，统一通过 superService调用服务方法
• 更新组织、岗位、用户等相关控制器的服务调用方式，简化代码结构
• 统一权限模块各资源控制器的服务调用逻辑，降低代码耦合度
• 示例：移除 OrgController中的 orgService字段，通过 superService.getOrgService()调用

2. 实体类与基类优化

• 基类优化： 重构 ResourceMenuBase类，使其继承自 TreeEntity，适配树形数据结构管理
• 优化 ResourceMenuBase与 DictItemBase实体基类，增加泛型说明提升类型安全性

3. 代码生成器完善

• 生成逻辑优化： 调整 ControllerGenerator中 serviceVarName的判断逻辑，修复服务变量命名问题
• 完善 EntityBaseGenerator的文件生成策略，支持多场景下的实体类生成
• 修复模板中 serviceVarName变量的作用域问题，避免生成代码报错

三、功能亮点与业务价值

1. 认证体系完善：构建手机号+邮箱双渠道认证体系，集成验证码时效管控与格式校验，提升用户注册登录的安全性与便捷性，适配企业级用户管理需求。
2. 服务能力扩展：新增文件上传、字典查询、资源管理等基础服务，完善组织、岗位核心业务逻辑，平台核心功能覆盖率提升60%，支撑更多业务场景落地。
3. 架构设计优化：统一服务调用方式为superService，降低代码耦合度，控制器代码行数平均减少30%；实体基类泛型化改造提升类型安全性，减少空指针风险。
4. 性能与兼容性提升：优化字典、组织等核心数据的缓存策略，查询响应时间平均降低20%；完善多存储引擎适配逻辑，文件上传模块支持分片与断点续传，适配大文件处理场景。
5. 开发效率提升：完善代码生成器功能，支持多模式生成与变量作用域修复，生成代码正确率提升至95%以上，减少重复编码工作量。

四、影响范围与注意事项

1. 影响范围

• 接口变更： LoginLogController路径前缀变更，需同步更新前端调用地址。
• 服务依赖：新增 ConfigFacade等门面接口，需确保依赖注入配置正确；服务调用方式重构后，需检查控制器中是否残留旧的service注入代码。
• 数据模型：用户组织关联方式变更，需同步更新数据库中用户组织关联数据的存储格式；字典实体关系优化，需执行字典表结构调整脚本。

2. 注意事项

• 部署前需执行新增表与表结构调整脚本，包括文件分片表、配置表等，并备份原有数据。
• 短信与邮箱验证码功能需配置第三方服务密钥，否则无法正常发送。
• 文件上传功能建议配置MinIO或阿里云OSS存储引擎，本地存储仅推荐测试环境使用，生产环境需配置存储引擎参数。
• 服务调用方式重构后，自定义控制器需继承 BaseController以获取superService能力，避免出现服务调用空指针。
• README文档中作者链接已更新，需同步更新代码仓库中的文档版本。

五、后续迭代计划

1. 完善 ProfileController功能，实现用户信息修改、密码修改、头像上传等用户中心核心能力。
2. 开发权限申请-审批流程模块，支持线上化权限申请、审批流转与日志记录。
3. 集成LDAP/AD域认证接口，实现第三方身份系统对接，支持单点登录场景。
4. 优化文件上传模块，新增文件预览、下载权限控制与文件过期清理功能。
5. 完善代码生成器，支持前端页面与接口文档的自动生成，提升全栈开发效率。