:fire::fire::fire: Claude Code 工程最佳实践 | 主数据平台 1.7.0 发布，移动端上线

steady_kilo

更新版本：V1.7.0
升级简介： 新增权限组申请与审核（开发者自助申请、运营逐组审批）；开放平台接口在线调试；Feign 内部接口统一迁移 /inner/** 并接入令牌鉴权；附件体系与文件存储增强（公开桶）；用户体系增强（身份证号等）；移动端（uniapp）登录与分享增强。

后端 50 次提交、前端 50 次提交、移动端 12 次提交、文档 27 次提交。
后端日志

• 权限组申请与审核（新特性）
• feat(开放平台): 开发者可为应用申请权限组（一单一组、批量提交、申请理由必填），支持撤销与删除，全部接口强制应用归属校验
•

• feat(开放平台): 控制台新增「权限申请审核」：逐组通过/退回（退回必填意见），通过即幂等写入应用授权关系（mdo_app_group_rel）
•

• feat(开放平台): 权限组（mdo_scope_group）新增简介字段；新增权限组申请单表（mdo_app_scope_apply）


• 接口在线调试（新特性）
• feat(开放平台): 开放平台文档页新增接口在线调试：REST 风格路径调试、调试参数组装、业务参数处理与验证
•



• refactor(网关): REST 请求版本号获取及 RouteContext 构造逻辑优化，移除 ApiCallLogId 字段简化 OpenContext 构建


• Feign 内部接口统一治理（/inner/**）
• refactor(内部调用): 内部服务间调用的 30 个端点全部从业务 Controller 抽出，统一迁移至 /inner/** 前缀，与业务接口彻底隔离
• feat(内部调用): 内部调用鉴权 InnerAuthInterceptor（校验 X-Inner-Token 头）+ InnerTokenRequestInterceptor（Feign 自动注入令牌），未配置令牌默认拒绝
• refactor(内部调用): Feign 客户端声明统一为 path 属性 + 方法级相对路径；修复 FileApi 返回类型不匹配、OauthLogApi/DashboardOpenApi 端点缺失 404
• refactor(内部调用): 删除已重构的 mdc_resource_uri 相关全部代码（Entity/Mapper/Service/Controller 共 9 个文件）


• 附件体系与文件存储
• feat(附件): 消息任务内容附件关联、帮助文档内容附件关联管理；新增释放业务关联附件接口，支持按业务批量删除
•

• feat(文件): 文件存储支持公开桶永久访问地址与签名地址自动切换


• 用户体系
• feat(用户): 新增身份证号字段及唯一性校验；本机密码修改功能
• feat(用户): 新增查询当前用户受限字段规则接口
• fix(用户): 修复单体查询组织关联数据获取方式（改走关系查询）；性别字段枚举值修正；移除 UserinfoVo 岗位和组织冗余字段


• 重构与优化
• refactor(开放平台): @Open 注解新增 description（接口中文描述）与 permission（权限控制标记）属性，启动注册时中文描述自动写入 mdo_api.description，网关侧零改动；删除 ApiRegister 死代码
• refactor(事件): 事件编码统一为 EventTypeCode 常量（冒号格式 org:add），回调接收参考实现（NotifyCallbackController）对齐修复
• fix(mdp-sdk): 修复泛型反序列化丢失元素类型问题；私钥解析及签名工具依赖与测试优化
• feat(开发者中心): 新增我的事件推送、接口回调日志分页查询；事件推送新增通知加密模式字段
• refactor(数据库): 统一数据库表主键及字段注释规范（生成 106 条注释修正 ALTER）；清理并优化资源 API 数据插入记录
• chore: NextDoc4j 配置属性描述文本修正；smart-doc.json 配置调整并移动文件位置


• 修复
• fix(开放平台): 修复接口查询条件逻辑错误；修复组织模块用户删除标记条件筛选逻辑错误
• fix(开放平台): 修复分页查询接口的应用归属校验逻辑（开发者端）



前端日志

• 权限组申请与审核：开发者中心应用详情「权限」Tab（已有权限/可申请权限/申请记录三页签、权限组卡片、组详情弹窗）；控制台「权限申请审核」页（组详情先行查看、退回必填意见）
• 接口在线调试：调试页支持请求前缀风格（pathType）参数、协议参数管理及持久化；文档页模式记忆（刷新/切换自动恢复）
• 开发者中心日志体系：应用日志模块重构为按 appId 查询 + 详情抽屉；接口调用/事件推送/回调任务支持字段回显
• 文件与编辑器：公开桶图片上传、markdown 编辑器公共上传接口图片上传；bytemd 插件支持完善、移除 math 插件、注册 mermaid 空语言消除警告；修复内容为空时旧内容不清空、查看模式表单只读问题
• 用户体系：用户详情增加岗位与组织信息展示；用户性别枚举统一回显；修复受限字段规则接口地址及缓存判断逻辑
• 交互与工具链：多处弹窗由 Modal 替换为 Drawer 抽屉并实现抽屉堆栈管理（Esc 关闭最上层）；全局消息提示替换为 MessageBridge 机制；日期范围编解码器重构支持多字段复用；后端 Long 类型前端统一为 number | string；修复 vxe-table 默认排序未应用、帮助文档查看模式只读、日志抽屉只读隐藏底部按钮
• 构建：Node.js 版本要求升级为 24；构建配置统一替换 neverBundle 并更新构建参数

移动端日志（uniapp）

• feat: 新增全局分享功能支持
•

• feat(登录): 用户协议勾选与协议浏览、sa-token 登录异常码识别及 token 刷新逻辑
• feat(用户): 用户资料页完善（头像上传、只读信息展示）；用户信息获取流程优化（增加 id 字段）
• refactor: 接口调用路径统一添加服务前缀

数据库与文档

• 数据库
• mdo_scope_group 新增 intro（简介）列
• 新增 mdo_app_scope_apply（权限组申请）表
• 新增菜单「权限申请审核」及配套按钮、9 条接口权限数据


• 文档
• 开放平台二开文档全新上线：架构设计、表结构设计、接口开发与发布、调用链路与扩展点、应用审核与授权、SDK 开发
• 新增前端业务组件文档及侧边栏配置；前端文档内容与结构优化
• 完善权限文档（字段权限自定义脱敏及授权逻辑）、事件回调文档（事件订阅示意图、回调与接口说明）
• 文档站集成百度统计、应用 URL 全部切换 HTTPS；README 项目介绍全面更新



升级注意事项

• 内部 Feign 调用全部迁移至 /inner/：必须在所有服务（调用方与被调方）的配置中心/Nacos 中配置一致的 mdp.inner.token，未配置时内部接口一律 403；发布时需被调方先于调用方发布，否则滚动发布期间内部调用会 404/403。单体（boot-server）模式为本地直调，不受 token 影响
• mdc_resource_uri 表及代码已删除：该表能力由 mdc_resource_api 承载，升级前请确认无残留依赖
• @Open 注解新增属性均有默认值，向后兼容；重启后 mdo_api.description 会自动刷写为注解中的中文描述
• 事件编码统一为冒号格式（org:add 等）：若二开中有订阅事件推送并自行判断 method 的代码，需对齐 EventTypeCode 常量
• 前端 Node.js 要求 ≥ 24；多处弹窗改为 Drawer 抽屉，自定义页面如有继承这些弹窗需回归
• 权限组申请要求申请理由必填；审核退回后开发者可重新申请同一权限组

:star2: 关注我们

MDP（Master Data Platform）主数据平台 —— 基于 Java 17、SpringBoot 3.x、SpringCloud、Vue3 + TypeScript 的企业级中后台快速开发平台，内置权限管理、单点登录、代码生成、数据同步、监控审计等核心能力，开箱即用，助力企业数字化建设。

专注于单点登录解决方案。内置用户中心、开发者平台、管理后台 3 个应用。包含：单点登录、Oauth2 登录、用户身份管理、应用申请、应用接入、主数据维护、主数据订阅、主数据广播、应用接口调用、接口管理管理和查看、系统配置等功能。

项目持续迭代中，欢迎 Star、Fork、提 Issue 参与共建！

• github：https://github.com/henhen6/mdp
• gitee：https://gitee.com/henhen6/mddata
• gitcode：https://gitcode.com/henhen6/mdp

原文链接

epic_ai

已阅，受益匪浅，楼主加油更新。

iris228

内置用户中心、开发者平台、管理后台 3 个应用。

讲得挺透，fire这块就该这么理解。