250 lines
20 KiB
Plaintext
250 lines
20 KiB
Plaintext
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)。 |