AlexStocks opened a new issue, #1630:
URL: https://github.com/apache/dubbo-admin/issues/1630

   ## 目标与已有工作
   
   修正调试页默认生成非法 char,以及 Mock 返回值不符合方法声明的问题。本任务只覆盖 #3792 的 A2/A3,不实现新的泛化模式或后端调用能力。
   
   定位基线:Admin `0db71b07b9d94b2f57e3ffd22af5e55e6083e63f`。
   
   - 
[`debug.vue`](https://github.com/apache/dubbo-admin/blob/0db71b07b9d94b2f57e3ffd22af5e55e6083e63f/ui-vue3/src/views/resources/services/tabs/debug.vue#L404):`generateDefaultValue`
 / `generateRequestTemplate`。
   - [`service.ts` 
Mock](https://github.com/apache/dubbo-admin/blob/0db71b07b9d94b2f57e3ffd22af5e55e6083e63f/ui-vue3/src/mocks/handlers/service.ts#L128):方法声明、method
 detail 和 invoke handler。
   - 已有 [PR #1527](https://github.com/apache/dubbo-admin/pull/1527) 
负责前端大整数文本保留;本任务必须保留其工作边界,不重写 `handleInvoke` 的数字解析。
   
   ## 允许修改什么
   
   1. `ui-vue3/src/views/resources/services/tabs/debug.vue` 中的参数默认值生成:`char` / 
`java.lang.Character` 生成合法单字符,如 `"a"`;已有字符串、布尔、数值、数组和对象模板保持原有行为。
   2. `ui-vue3/src/mocks/handlers/service.ts`:用 `methodName + signature` 精确查找 
method detail 和 invoke fixture。`query` 返回符合 `UserDTO` 的对象,`create/delete` 返回 
Boolean。
   3. 增加至少一组同名、不同 signature 的最小 Mock fixture,用于证明重载选择;未知组合返回明确 Mock 错误,不回退成 
`query` 或固定 User 对象。
   4. 新增 `ui-vue3/src/views/resources/services/tabs/debug.spec.ts` 和 
`ui-vue3/src/mocks/handlers/service.spec.ts`。仅当测试确实需要时,提取参数模板生成的纯函数到同目录 
`debug-template.ts`;不建立通用类型系统或模板框架。
   
   ## 禁止做什么
   
   - 不改后端 decoder 来接受空 char,不放宽真实 API 的 signature 或参数校验。
   - 不改 HTTP 路由、认证、通用 API client、全局错误模型,不升级包或引入新依赖。
   - 不修改 #1527 的无损数字解析,不重复实现 `lossless-json` 包装。
   - 不使用 Mock 结果证明真实 RPC、注册中心发现、Provider metadata 或跨语言互操作通过。
   - 不为让新增 fixture 通过而改变真实 API 的 wire 格式;Mock 应跟随当前真实 envelope。
   - 不运行会全量改写 `src/` 的 `yarn build` / `yarn format` 作为验证步骤。当前 `build` 脚本包含全目录 
Prettier;构建使用直接的 `yarn vite build`。
   
   ## 怎么验证对错
   
   | 输入/场景 | 必须观察到的结果 |
   |---|---|
   | metadata 参数分别为 `char`、`java.lang.Character` | 模板中的值是单字符;不是空字符串 |
   | 现有 String、Boolean、int、数组和对象模板 | 与修改前行为相同 |
   | `query` 的声明 signature | 返回 UserDTO 对象 |
   | `create` / `delete` 的声明 signature | 返回 Boolean,不能返回 UserDTO |
   | 同名方法的两个不同 signature | method detail、参数模板和 Mock 返回值各自匹配,不串用 |
   | 不存在的 method/signature | 明确错误,不回退为另一方法的成功响应 |
   
   执行顺序:
   
   1. 用现有组件/MSW 测试入口先复现错误;核心断言至少在旧实现上失败一次。
   2. 实施最小修复后,在 `ui-vue3` 执行 `yarn test 
src/views/resources/services/tabs/debug.spec.ts 
src/mocks/handlers/service.spec.ts`,记录两份用例实际执行数量;不得只写“相关测试通过”。
   3. 执行 `yarn eslint src/views/resources/services/tabs/debug.vue 
src/views/resources/services/tabs/debug.spec.ts src/mocks/handlers/service.ts 
src/mocks/handlers/service.spec.ts` 和 `yarn vite build`;若提取了 
`debug-template.ts`,同时定向 lint 该文件。如全量类型检查有基线错误,保留原输出,单独列出,不顺手修复无关错误。
   4. 使用 `yarn dev:mock` 检查实际调试页面的模板、重载选择及三种方法返回展示。这一结果标为 UI Mock 验证。
   5. 执行 `git diff --check`,确认没有全量格式化和锁文件变更。
   
   ## 交付与人员
   
   - 一份前端 PR,包含最小修复、行为测试及 Mock 验证记录。
   - 负责人角色:前端 1 人;可与后端和两个 harness 任务并行。
   - 与 [#3742](https://github.com/apache/dubbo-go/issues/3742) 的模式选择/typed 
result 功能分开,本任务不声称完成它们。
   
   ## 接手与提交约束
   
   - 本任务从审计总单 [Dubbo-Go #3792](https://github.com/apache/dubbo-go/issues/3792) 
拆出。首次修改前,记录目标仓库实际 Base/Head SHA,重读总单及本任务关联 PR 的当前状态;以下固定源码用于定位,不能假定接手时的 develop 
未变化。
   - 生产代码与测试 harness 的权限以本 Issue 
为准。发现超出允许范围的问题,提交最小复现和关联阻塞项;不得通过改依赖、改协议、改测试期望或隐式降级扩大范围。
   - 使用独立分支/工作区,保留其他人的修改。PR 仅关闭本子任务,不能使用 `Fixes apache/dubbo-go#3792` 或关闭 [功能总单 
#3742](https://github.com/apache/dubbo-go/issues/3742)。
   - 交付记录必须包含:实际改动路径、Base/Head SHA、完整命令、退出码、断言结果、跳过项和阻塞项。测试 PASS、产品 FAIL、环境 
BLOCKED、未执行 NOT_RUN 分开记录;不能用“命令退出 0”替代实际断言。
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to