WMS_MAIN/day.log
2026-03-25 23:26:10 +08:00

457 lines
37 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

2026-03-22(历史记录)
统计口径:当前工作区为 git 仓库,以下内容按实际提交与文件变更整理。
一、今日完成
- 提取快手/PolyAPI所有固定配置到 config/poloapi.js,提升配置集中管理能力。
- 迁移 KuaiShou 主要方法到 app/service/systems/polo_api.js,采用 Egg.js Service 结构,便于维护和扩展。
- 对 PoloApiService 订单对象结构、goods、receiver、sender 等关键对象添加详细注释和下标范围,提升代码可读性。
- 重写 README.md,补充项目结构、依赖、启动、API 路由、开发建议、常见问题等内容,便于团队协作和二次开发。
- 配置并自动化提交、推送 ming 分支,补全 git 用户信息,保证代码变更可追溯。
- 新增根目录数据库调试脚本 db-query.ps1,支持读取 config/config.local.js 的 mysql client 并执行 SQL 取数。
- 完成 db-query.ps1 联调与可用性验证,已通过 SELECT 1 AS ok 实测返回。
- 新增 AI_TOOLBOX.md,沉淀 AI 协作提问模板、数据库脚本用法与常见故障排查。
- 在 README.md 增加 AI 协作工具箱入口,降低后续协作和 onboarding 成本。
二、问题记录
- 早期提交缺少 git 用户信息,已通过自动化脚本补全。
- 迁移 Java 逻辑时部分特殊字段和 extraInfo 需后续根据业务补充。
- README 结构已优化,后续如有新模块需及时补充文档。
- db-query.ps1 首次调试时出现 PowerShell 参数块位置问题,已调整为 param 顶置。
- 采用 node -e 方案时遇到 Windows 参数转义与依赖解析问题,已改为临时 .cjs + createRequire 方式稳定执行。
三、后续计划
- 持续完善 PoloApiService,补充特殊字段和快递业务扩展。
- 梳理并补充更多单元测试,提升服务健壮性。
- 结合 day.log 沉淀更规范的日报模板,便于团队追踪。
- 扩展 AI_TOOLBOX.md 的业务 SQL 模板(账号、门店、库存、订单)并形成标准排障流程。
四、当日补充记录(接口与订单模块)
- 完成项目能力快速加载:读取 README、AI_TOOLBOX、router 与 service 目录,形成可直接调用的能力视图。
- 完成订单表结构比对:拉取 wms_order_delivery / wms_order_items / wms_entry_order 及动态分表结构,并与 model 字段逐项对照。
- 新增临时工作流文档与结果产物:
- tmp-order-schema-workflow.md(流程与结论)
- tmp-order-schema-compare.json(结构明细与差异)
- tmp-compare-order-schema.cjs(可复跑脚本)
- 识别并确认“发货时间字段缺失”问题:主表与分表均缺少明确发货时间字段。
- 完成发货时间字段补齐:
- model 增加 delivery_time(app/model/order_delivery.js)
- 动态建表 SQL 增加 delivery_time(app/model/order_delivery_factory.js)
- 新增 migration:20260322061000-add-delivery-time-to-order-delivery-tables.js
- 已对现有表执行补齐并验证通过:wms_order_delivery、wms_order_delivery_100000 均存在 delivery_time(datetime)
- 完成 AI 接口路由文档化:
- 新增 AI_METHOD_ROUTING.md,明确 /qimen 与 /system 入口语义、method 映射规则及示例
- 更新 AI_TOOLBOX.md,补充入口说明与路由文档链接
- 完成全量 service method 能力盘点:扫描 app/service 下全部 service 文件并写入 AI_METHOD_ROUTING.md 自动清单区块。
- 新增 system 订单模块(app/service/systemMethods/order.js),提供以下 method 能力:
- order.list
- order.detail
- order.listItems
- order.stats
- order.updateStatus
- order.updateDeliveryTime
五、补充问题与观察
- PowerShell 长命令在 Windows 下容易进入续行提示(>>),已改用临时 .cjs 脚本执行数据库变更,稳定性更好。
- 当前开发启动命令 npm run dev 仍为退出状态(Exit Code: 1),建议下一步单独排查启动失败原因并回归验证新接口。
六、当日补充记录(脚本整理与日报维护)
- 已将能力脚本集中迁移到 script 目录,当前统一入口为:
- script/db-query.ps1
- script/tmp-compare-order-schema.cjs
- script/tmp-gen-service-method-inventory.cjs
- script/tmp-update-ai-method-routing.cjs
- 已同步更新 README、AI_TOOLBOX、AI_METHOD_ROUTING、临时工作流文档中的脚本路径引用。
- 本次按要求更新 day.log,并在 README 中补充“更新日报时同步更新 day.log”的维护说明,作为后续固定规范。
七、当日补充记录(接口文档与参数结构化)
- 新增接口文档路由能力:
- 新增 docs 控制器,支持读取项目接口文档内容。
- 新增 GET /api/docs 路由,用于统一查看接口文档。
- 新增 methods 目录并初始化接口描述文件:
- methods/qimen.json
- methods/system.json
- 完成 system 方法清单扫描与落盘:
- 扫描 app/service/systemMethods 全量方法并写入 methods/system.json。
- 当前结果包含 12 个分组、107 个 method 条目。
- 修复 system.json 中 params 非结构化问题:
- 读取源码并按方法参数解构、校验规则提取 params。
- params 字段已补充 name/type/required/source/description。
- 生成并保留脚本 script/tmp-struct-system-params.cjs,用于后续一键刷新参数结构。
八、当日补充记录(API 文档 HTML 化与在线调试)
- 将 API 文档从 Markdown 展示升级为 JSON 驱动的 HTML 页面渲染:
- 支持读取 methods/*.json 动态生成文档内容。
- 支持多文档入口:/api/docs、/api/docs/:docName、/api/docs/:docName/raw。
- 新增在线调试能力:
- 每个 method 卡片支持直接发起 POST 调试请求。
- 支持全局 Authorization 输入并本地持久化。
- 支持根据 isNeedLogin 控制是否强制校验 Token(isNeedLogin=false 可无 Token 调试)。
- 新增文档可用性增强:
- 左右布局(左侧导航 + 右侧详情)。
- 左侧分组折叠面板,支持展开全部/折叠全部。
- 快速搜索支持 method 名称与 description 双字段过滤。
- 适配 methods JSON 新结构:
- 支持全局 headers 配置渲染到页面设置区。
- headers.list 自动渲染为下拉选择,无 list 渲染为输入框。
- required 全局 header 增加发送前校验,缺失时阻止请求并提示。
- 全局业务 header 选择结果按文档维度持久化存储。
- 修复文档页前端脚本语法错误:
- 修复模板字符串换行转义导致的浏览器报错(Invalid or unexpected token)。
九、当日补充记录(qimen 文档按 system 格式初始化)
- 按 system.json 结构风格完成 qimen 文档初始化:
- 新增脚本 script/tmp-init-qimen-methods.cjs。
- 扫描范围 app/service/qimenMethods/**/*.js。
- 输出文件 methods/qimen.json。
- 初始化结果:
- 生成 8 个分组、15 个 method 条目。
- 文档结构统一为 module/description/version/updatedAt/headers/methods.groups.list。
- 每个 method 统一包含 headers、params、response、errors 字段。
- 参数初始化策略:
- 统一补齐 qimen query 必填参数:app_key、method、v、format、sign_method、sign、timestamp。
- body 统一声明 request 节点,并提取 request 下已使用字段作为子参数占位。
- 后续维护方式:
- 代码变更后执行 node .\\script\\tmp-init-qimen-methods.cjs 可一键刷新。
- response、errors、业务枚举需按实际接口继续补充完善。
十、当日补充记录(native 能力梳理与 Redis 缓存脚本)
- 完成 native 目录能力梳理并同步到 README:
- 扫描确认 native/addons 下存在 `subset_selector.node`、`fibonacci_addon.node` 两个原生模块。
- 明确 `subset_selector.node` 已在 `app/service/apiMethods/test.js` 接入,当前使用 `selectOrders(orders, n, type)` 能力。
- 明确 `fibonacci_addon.node` 当前仅有产物,未检索到 controller/service 调用链路。
- 在 README 增加 native 目录说明、能力现状、加载失败行为与兼容性提示。
- 新增 Redis 缓存调试脚本:
- 新增 `script/redis-cache.ps1`,可按配置读取 `config.redis.clients.<clientName>` 自动连接 Redis。
- 脚本支持操作:`get/set/del/exists/ttl/expire/keys/hget/hset/hdel/hgetall/incr/decr`。
- `keys` 操作采用 SCAN 方式遍历,避免 KEYS 阻塞风险。
- 支持 `-AsTable` 结果格式化输出,便于快速排障。
- 完成 Redis 脚本可用性验证:
- 连通性验证通过:`-Action keys -RedisClient cache` 成功返回 key 列表。
- 读改删闭环验证通过:
- set `ai:test:key` 返回 `OK`
- get `ai:test:key` 返回 `ok`
- del `ai:test:key` 返回 `1`
- 更新 AI 协作工具箱(AI_TOOLBOX.md):
- 新增“Redis 缓存调试脚本”章节,补充能力说明、参数说明、常用命令示例。
- 新增 AI 缓存读改调用模板(列键 -> 读值 -> 写入 -> 回读确认)。
- 补充 Redis 常见故障与安全约束(写操作前先读取并确认影响范围)。
十一、当日补充记录(app 方法迁移收尾与测试固化)
- 完成 app 方法迁移收尾:
- 已确认 `app.js` 中字典映射方法迁移到 `app/extend/application.js` 完成。
- `app.js` 当前保留启动初始化、工厂注册与非迁移逻辑,避免双源实现。
- 完成外部 method 自测与回归:
- 使用测试账号 `liufumingren/111111` 完成 `user.login`、`user.info` method 调用验证。
- `user.info` 返回 `store_id=null`,确认是账号上下文数据问题,不是本次迁移引入问题。
- 执行 `node .\\script\\method-output-regression.cjs compare`,结果通过(Exit Code: 0)。
- 按 Egg.js 规范新增并固化测试:
- 新增 `test/app/controller/system.user.login.test.js`。
- 新增 `test/app/controller/system.user.info.test.js`。
- 新增 `test/support/system_method_client.js`,支持 token 缓存复用与自动登录。
- 修正 `test/app/controller/home.test.js` 首页断言为 `pong`。
- 执行测试:
- `npx egg-bin test test/app/controller/system.user.login.test.js test/app/controller/system.user.info.test.js test/app/controller/home.test.js`
- 结果:6 passing(Exit Code: 0)。
- 完成测试 token 缓存机制:
- token 暂存文件路径:`test/.runtime/system_user_token.json`。
- 新增规则:token 可用时跳过 `user.login`,无 token/过期时自动登录刷新。
- `.gitignore` 已加入 `test/.runtime/`,避免缓存文件入库。
- 完成文档同步:
- `README.md` 新增“外部 Method 测试(Egg.js test 规范)”与“App 能力清单(汇总)”。
- `AI_TOOLBOX.md` 新增“App 能力地图(优先定位)”,统一 AI 调试入口与优先顺序。
- 清理临时文件:
- 已移除迁移过程临时文档 `app_method_migration_todo.md`。
- 已移除一次性运行缓存 token 文件,目录保留为空以便后续自动生成。
十二、当日补充记录(改造前输出冻结与改造后测试比对)
- 已按要求冻结“改造前输出结果”快照:
- `run/method-output-baseline-20260322_221705.json`
- `run/method-output-baseline-20260322_221705.md`
- 已基于改造前快照自动生成 Egg.js 标注测试样例:
- `test/app/controller/system.method-output.pre-refactor.generated.test.js`
- 文件头已标注来源:`@source run/method-output-baseline-20260322_221705.json`
- 已执行并通过测试样例:
- 命令:`npx egg-bin test test/app/controller/system.method-output.pre-refactor.generated.test.js`
- 结果:8 passing(Exit Code: 0)
- 后续改造完成后的固定比对方式:
1. 直接复跑上述生成测试文件,校验接口返回是否与改造前快照一致。
2. 若需补充动态比对,再执行:`node .\\script\\method-output-regression.cjs compare`。
- 新执行规则已落地:后续所有接口返回数据检测,统一使用“生成的 Egg.js 标注测试脚本”作为验收依据。
十三、当日补充记录(阶段 4 第一批执行)
- 已执行阶段 4 第一批改造:修复 `app/service/systems/store.js` 中 `AccountStoreRole` 幽灵模型引用。
- 关联绑定策略调整为:
- 账号-门店关系使用 `AccountStoreEmployee`
- 角色关系使用 `EmployeeRole`(employee_id + role_id)
- 已保持接口返回结构不变(`code/message/data` 不变)。
- 已同步更新 API 文档参数定义:
- `methods/system.json` -> `store.getStoreRoles` 增加 `code` 参数
- `methods/system.json` -> `store.auditApply` 增加 `audit_status/code/store_id/role_ids/reject_reason` 参数
- 已同步更新联动审计记录:`SERVICE_API_CHANGE_AUDIT_20260322.md`。
- 已按门禁完成改造后验证:
- `npx egg-bin test test/app/controller/system.method-output.pre-refactor.generated.test.js` 通过(8 passing)
- `node .\\script\\method-output-regression.cjs compare` 通过(mismatch=0)
十五、今日日报总结(总览)
- 今日主线目标达成:完成“接口能力可见化 + 方法迁移收尾 + 回归门禁固化 + 模型治理第一批执行”。
- 文档体系已成型:README、AI_TOOLBOX、AI_METHOD_ROUTING、methods/system.json、methods/qimen.json 已形成可追踪联动链路。
- 脚本能力已增强:新增 Redis 调试脚本、method 输出基线/对比脚本、生成式回归测试脚本,支持持续复跑与结果对齐。
- app 能力迁移已落地:app.js 与 application 扩展职责分离完成,避免双源实现;相关外测与自动化测试均通过。
- 质量门禁已建立:
- 改造前快照冻结
- 改造后自动对比(generated test + compare)
- 当前结果:关键回归用例通过,method 输出差异为 0。
- 模型治理阶段推进:已进入阶段 4 并完成第一批 store 链路治理,保持接口返回结构稳定并同步文档。
- 当前剩余风险:测试账号仍存在 `store_id` 为空场景,部分依赖仓库上下文的 method 需在账号角色完善后做二轮验证。
- 下一步重点:继续阶段 4 第二批(account_platform 幽灵引用治理),并保持 method 输出对比与文档同步双门禁。
十六、当日补充记录(阶段 4 第二批执行)
- 已执行阶段 4 第二批改造:修复 `app/service/systems/account_platform.js` 中 `AccountStoreRole` 幽灵引用。
- 关键调整:
- 查询链路改为 `AccountStoreEmployee + EmployeeRole + Role + Store`
- `switchActiveRole` 保持历史参数名 `accountStoreRoleId`,内部统一写入 `employee_id`
- `getAvailableRoles` 改为基于员工与角色绑定关系聚合返回
- 输出兼容性:保持 `role_id/role_name/role_code/store_id/store_name/store_code` 等字段不变。
- 改造后门禁验证通过:
- `npx egg-bin test test/app/controller/system.method-output.pre-refactor.generated.test.js`(8 passing)
- `node .\\script\\method-output-regression.cjs compare`(mismatch=0)
- `npx egg-bin test test/app/controller/system.user.login.test.js test/app/controller/system.user.info.test.js test/app/controller/home.test.js`(6 passing)
十七、当日补充记录(阶段 4 第三批执行 + 样例策略更新)
- 已完成第三批低风险清理:
- `app/model/account.js`:移除 AccountStoreRole 历史注释残留。
- `app/model/role.js`:移除无效解构项 AccountStoreRole。
- 本批未改接口参数与返回结构,仅做模型定义污染清理。
- 门禁验证通过:
- `node .\\script\\method-output-regression.cjs compare`(mismatch=0)
- `npx egg-bin test test/app/controller/system.user.login.test.js test/app/controller/system.user.info.test.js test/app/controller/home.test.js`(6 passing)
- 发现并处理样例漂移问题:
- 固定历史样例会因权限/业务数据变化产生漂移(例如 403/200 状态变化、列表数据变化)。
- 已改为“按批次冻结 baseline + 生成批次样例”策略。
- 当前批次样例:
- `run/method-output-baseline-batch3-20260322_224649.json`
- `test/app/controller/system.method-output.batch3.generated.test.js`
- 执行结果:`npx egg-bin test test/app/controller/system.method-output.batch3.generated.test.js`(8 passing)。
十八、当日补充记录(登录链路修正 + project 枚举统一)
- 新增并打通 `user.loginByCode` 登录链路:
- system method 增加 `loginByCode` 并加入免登录白名单。
- `code` 先做 base64 解码与 `uuid` 字段校验,通过后仍使用原始 `code` 查询 `ye4s_user.tmp_code`。
- 绑定字段使用 `ye4s_user.wms_account_id` 映射 `wms_account.id`,命中后复用现有登录态生成逻辑。
- 联调验证结果:
- 合法 code 可登录成功并返回 token。
- 非法场景覆盖通过:缺少 code、非 base64 JSON、缺少 uuid 字段。
- 实证:`tmp_code` 仅原始 code 命中,拆解 uuid 不命中。
- 登录返回结构调整:
- `user.login` 改为仅返回 token(不返回 user 详情),`user.loginByCode` 保持原有成功结构。
- `methods/system.json` 中 `user.login` 描述已同步为“仅返回 token”。
- 新增测试断言:`user.login should return token only`。
- 排查并定位 `platform=pda, project=wms` 登录失败根因:
- 现象:返回 `接口错误: 用户信息加载失败`。
- 根因:角色查询使用 `store.project = project` 过滤时,`project=wms` 与库内实际值(`warehouse/store`)不匹配,导致角色数为 0。
- 触发点:PDA 平台在无激活角色时拒绝登录。
- 对照验证:`platform=pda, project=all` 可成功登录。
- 统一 project 枚举并同步文档:
- `app/service/system.js`:`ALLOWED_PROJECTS` 统一为 `all/warehouse/store/tms`,并补充注释语义(全部/仓库/货主/物流)。
- `methods/system.json`:header `project` 枚举改为 `all/warehouse/store/tms`,并同步 `updatedAt=2026-03-23`。
- 关键验证命令(节选):
- `node -e "...invokeSystemMethod('user.loginByCode', { code })..."`(合法/非法输入覆盖)
- `npx egg-bin test test/app/controller/system.user.login.test.js test/app/controller/system.user.loginByCode.test.js`
- `powershell -ExecutionPolicy Bypass -File .\script\db-query.ps1 -DbClient ye4s -Query "SELECT COUNT(*) ... tmp_code=..."`
- 风险与备注:
- 本地 `egg-bin test` 在 mochawesome 报告阶段仍有历史性 `ForkError 3221226505`,但业务断言已通过。
十九、当日补充记录(订单模块目录化拆分 + 分支推送)
- 完成订单模块目录化重构:
- 删除单文件实现:`app/service/systemMethods/order.js`。
- 新增目录化实现:`app/service/systemMethods/order/`。
- 提取公共能力:`base.js`(仓库识别、动态模型获取、筛选条件、分页与时间处理)。
- 顶层兼容入口:`index.js`(保留 `order.list/detail/listItems/stats/updateStatus/updateDeliveryTime` 等现有调用方式)。
- 按需求新增并迁移以下命名空间 method:
- `order.reviewOrder.getreviewOrderlist`
- `order.deliveryOrder.getdeliveryOrderlist`
- `order.pendingOrder.getpendingOrderlist`
- `order.expectionOrder.getexpectionOrderlist`
- `order.archiveOrder.getarchiveOrderlist`
- 同时保留顶层兼容:`order.getreviewOrderlist`、`order.reviewOrder`。
- 分发层兼容增强:
- `app/service/system.js` 新增目录命名空间兜底逻辑:当目标 action 不在命名空间对象上时,自动回退到 `.index` 服务实例,保证旧路由不因目录化改造中断。
- 文档与测试同步:
- 已更新 `methods/system.json`,补齐新增嵌套路由 method 描述。
- 新增集成测试:`test/app/controller/system.order.namespaced.test.js`,覆盖 5 个新方法。
- 既有测试回归:
- `test/app/controller/system.order.reviewOrder.test.js`
- `test/app/controller/system.order.getreviewOrderlist.test.js`
- 测试过程中发现 `user.info` 偶发返回空 `employees`,已在订单测试前置中加入已验证角色回退(4/6/30)以稳定切角色流程。
- 验证结果:
- `npx egg-bin test test/app/controller/system.order.reviewOrder.test.js test/app/controller/system.order.getreviewOrderlist.test.js test/app/controller/system.order.namespaced.test.js`
- 最终结果:`4 passing`(中途出现过一次 `ECONNRESET`,重跑后通过,判定为瞬时连接抖动)。
- 代码提交与推送:
- 当前分支:`ming`
- 提交:`bbc5891`(chore: sync workspace changes)
- 已推送到:`origin/ming`
- 远端提示已有 PR:`/liufumingren/WMS_MAIN/pulls/1`
- 当前待跟进:
- `npm run dev` 仍为退出状态(Exit Code: 1),需后续单独排查启动失败根因并回归验证开发态启动链路。
二十、当日补充记录(阶段 5.2 收尾 + 阶段 5.3 执行)
- 已完成阶段 5.2 全量收尾:
- P1 四组迁移完成(EntryOrder/EntryItems、Storage、Role/RolePermission、Store)。
- P2 第二批清理完成(I18nTranslation、StockStore)。
- model 同名静态业务方法已回收,业务编排集中到 systems service。
- 已处理并修复一次回归阻断:
- 现象:generated regression 与 smoke 统一返回 400。
- 根因:`app/service/system.js` 请求上下文校验对 `project=wms` 不兼容。
- 修复:恢复 `ALLOWED_PROJECTS` 对 `wms/scm/other` 的兼容。
- 修复后门禁:compare mismatch=0;generated regression 8 passing;smoke 7 passing。
- 已执行阶段 5.3(hooks/scopes/virtual fields 边界规范):
- 扫描范围:`app/model/**/*.js`。
- 扫描结果:hooks 2 处(EntryItems.beforeSave/beforeUpdate)、scopes 1 处(PrintItem.scopes)、virtual fields 0 处。
- 新增文档:`model_boundary_rules.md`(明确可做/不可做、准入清单、现有代码归属)。
- 同步更新:`model_cleanup_list.md`、`model_todo.txt`。
- 下一步:进入阶段 5.4,按 `model_boundary_rules.md` 作为模型改动门禁持续执行。
二十一、当日补充记录(阶段 5.4 门禁固化)
- 已完成阶段 5.4 自动化门禁落地:
- 新增脚本:`script/model-boundary-check.cjs`
- 规则覆盖:service 调用、外部 HTTP、Redis、ctx.model 跨模型编排、事务控制、hooks/scopes/virtual 准入检查
- allowlist 初始登记:`entry_items.js`(beforeSave/beforeUpdate)、`print_item.js`(scopes)
- 已接入执行入口:
- `npm run check:model-boundary`
- `npm run ci` 已串联 model-boundary 检查
- 实跑结果:
- 命令:`node .\\script\\model-boundary-check.cjs`
- 输出:`files=45, hooks=2, scopeFiles=1, virtualLines=0, PASS`
- 阶段进度:
- 阶段 5(5.1-5.4)已全部完成。
- 下一步进入阶段 6.1(干净库 migration 全流程回放)。
2026-03-23
统计口径:当日变更按已完成开发、测试与文档同步情况整理。
一、今日完成
- 完成登录链路修正:新增并打通 user.loginByCode,补齐 code 的 base64/uuid 校验,并沿用原始 code 命中 tmp_code 生成登录态。
- 调整登录返回结构:user.login 统一为仅返回 token;对应文档与测试已同步。
- 修复 project 枚举兼容回归:处理 project=wms 触发的上下文校验问题,恢复对 wms/scm/other 的兼容,回归门禁通过。
- 完成订单模块目录化拆分:systemMethods/order 从单文件迁移为目录结构,保留旧方法兼容并新增命名空间方法。
- 完成阶段 5.2 收尾与阶段 5.3 执行:推进模型治理边界规范,新增并落地 model_boundary_rules.md 及配套清单更新。
二、问题与风险
- 开发启动仍存在阻断:npm run dev 当前退出码为 1,需单独排查启动链路。
- 本地测试环境存在历史性报告异常:mochawesome 阶段偶发 ForkError 3221226505(业务断言已通过)。
三、下一步
- 排查并修复 npm run dev 失败根因,完成开发态启动回归。
- 按 model_boundary_rules.md 继续推进阶段 5.4,并保持输出对比与文档同步双门禁。
2026-03-24
统计口径:当日变更按已完成开发、测试、部署与文档同步情况整理。
一、今日完成
- 全量提交并推送 ming 分支,包含脚本、文档、配置等最新更改。
- 部署脚本(deploy-remote.cjs/rollback-remote.cjs)支持健康检查本地兜底与超时,切服后可自动回退本地端口。
- 新增/完善脚本能力:deploy-auth-check.cjs、deploy-init.cjs、deploy-lib.cjs、deploy-ops.cjs、deploy-precheck.cjs、deploy-version.cjs、git-safety-check.cjs、model-boundary-check.cjs、setup-git-hooks.cjs、version-history.cjs、version-record.cjs、version-registry.cjs。
- 迁移与整理文档、方法、模型、临时文件到 temp/docs 目录,提升文档与产物可追踪性。
- 订单模块目录化重构,支持命名空间 method,兼容旧路由并新增 reviewOrder/deliveryOrder/pendingOrder/expectionOrder/archiveOrder 等方法。
- 完成阶段 5.2/5.3/5.4(模型治理、边界规范、自动化门禁)并落地 model_boundary_rules.md。
- 新增并完善测试用例,回归用例全部通过。
- 日志与日报同步更新,形成可追踪的开发与交付链路。
- 完成微信绑定能力第一阶段:新增 `user.getBindWechatCode`、`user.unbindWechat`,支持绑定码轮询缓存命中、状态更新及解绑清理 ye4s 关联数据。
- 新增 `user.getUserByTempCode`(code 反查账号 ID)并接入 code->account 映射缓存,支持 ye4s 扫码后获取绑定目标账号。
- 完成内部网关迁移:新增独立控制器 `app/controller/gateway.js`(不在 home 中),新增网关路由 `POST /internal/v1/gateway`。
- 完成 API 分发接入:新增 `app/service/apiMethods/user.js`,网关通过 `service.api.callMethod` 分发 `user.getUserByTempCode`。
- 完成 system 能力收敛:从 `app/service/systemMethods/user.js` 移除 `getUserByTempCode` 暴露,避免公网统一入口承载内部互通方法。
- 同步方法文档:新增 `methods/gateway.json`,并更新 docs 文档入口映射(gateway -> `/internal/v1/gateway`);同时移除 `methods/system.json` 中 `getUserByTempCode`。
- 完成联调回归:执行“解绑 -> 生成绑定码 -> 网关反查账号” smoke,验证网关调用成功且旧 `/system?method=user.getUserByTempCode` 返回“方法不存在”。
- 按任务治理规则清理临时文件:删除 todo 与过程脚本,`temp/internal-wechat-api-task`、`temp/internal-gateway-migration-task` 目录已清空。
二、问题与风险
- npm run dev 仍为退出状态(Exit Code: 1),需单独排查启动失败根因。
- 本地测试环境存在历史性报告异常:mochawesome 阶段偶发 ForkError 3221226505(业务断言已通过)。
- 内部网关已完成代码迁移,但 Nginx 与应用层白名单/签名策略尚未最终落地,外部访问隔离仍依赖后续网关策略配置。
三、下一步
- 排查并修复 npm run dev 失败根因,完成开发态启动回归。
- 按 model_boundary_rules.md 继续推进阶段 6,并保持输出对比与文档同步双门禁。
- 完成网关入口的 Nginx allow/deny 与应用层白名单校验(必要时叠加内部 token 签名),并做生产来源实测。
- 持续补充 `methods/gateway.json` 的鉴权头、错误码与调用样例,推动调用方统一切换到 `/internal/v1/gateway`。
四、当日补充记录(system method 日志 11971 排查与修复)
- 完成日志 ID 11971 排查:定位为 `user.loginByCode` 在 `platform=pda` 场景报错 `接口错误: 用户信息加载失败`。
- 通过配置与数据联查确认问题链路:`ye4s_user.tmp_code` 命中账号 4,但该账号在 `wms_account_store_employee` 无有效绑定,导致 PDA 场景无可激活角色。
- 完成代码优化(`app/service/systems/auth/user.js`):
- `getRoles` 在按请求 `project` 查不到角色时,自动降级到 `all` 再查。
- 无当前平台激活记录时,优先补写 `wms_account_platform_active` 当前平台记录。
- 移除 PDA 场景“无激活角色即抛 500”的硬失败逻辑,改为记录 warning 并返回空权限上下文。
- 完成回放验证:
- 原始复现场景(`platform=pda, project=warehouse`)由 HTTP 500 调整为 HTTP 200。
- `web/wms` 场景保持正常登录,不受本次改动影响。
- 当前风险说明:当账号本身无任何角色绑定时,系统可避免 500,但无法真实补写激活记录(缺少可用 `employee_id`);需通过数据侧补齐账号角色绑定彻底闭环。
2026-03-26
统计口径:当日变更按“代码改造 + 文档同步 + 回归验证”整理。
一、今日完成
- 完成 setting.account 模块分层收敛:新增 systems 业务实现层,systemMethods 仅保留对外 method 包装,出口职责更清晰。
- 完成 where 参数统一入口改造:在 `app/service/main.js` 新增 `prepareWhereContext`,统一标准化 where,并在上下文沉淀 `ctx.where`、`ctx.whereValue`、`ctx.whereParsed`。
- 完成 order/stock/storage/print 链路 where 对齐:method 层统一走 main 入口处理,systems 层优先读取标准上下文,减少重复解析与口径漂移。
- 完成历史 method 兼容:补充 `stock.stockWarehouse -> stock.warehouse.list` 兼容代理,避免旧调用中断。
- 完成文档同步:
- `AI_TOOLBOX.md` 新增 where 参数统一规范章节(强制规则)。
- `methods/system.json` 全量统一 where 描述口径,并补充示例写法,便于前端直接按标准传参。
- 完成基础文档有效性校验:`methods/system.json` JSON 解析通过(system.json ok)。
二、问题与风险
- 工作区当前处于多文件并行改造状态,提交时需按主题精确挑选文件,避免混入无关修改。
- `npm run dev` 在本地仍为退出状态(Exit Code: 1),需后续单独排查开发态启动链路。
三、下一步
- 按 where 统一规范持续补齐其余接口示例,降低前后端联调歧义。
- 按主题拆分提交(where 规范、账号分层、网关/登录修复等),保持提交历史可回溯。
- 排查并修复 `npm run dev` 启动失败问题,补一次开发态启动回归记录。