docs: 登记 district.state.update 生产发布(REQ-20261117-0008)

This commit is contained in:
my_local_kimi_dev2
2026-11-18 10:40:32 +08:00
parent 435e9bd14b
commit ba2ffabf19
2 changed files with 8 additions and 1 deletions
+1 -1
View File
@@ -3,7 +3,7 @@
## ai-proj 关联信息
- **ai-proj 项目 ID:224**(项目名 xiaoqu_agent_service)。本仓所有需求/任务创建后应挂到该项目,关联任务前确保任务也在项目 224。
- 近期需求示例:REQ-20261117-0008(id 6623,站点状态修改 district.state.update,已实现并通过 576 个全量测试及 dev 真实「履约→演示→履约」/39 个资产联动恢复,待部署;prod 仅绑 scope 6)→ 任务 27566;REQ-20261117-0003(id 6618,设备转固定资产写工具 device.lifecycle.fixed_asset.update,已上线生产+冒烟通过,prod tool id 74 只绑研发专用 scope 6;拍板:报废(4)与已是固定资产(1)守卫拒绝、null 按库存商品、只写 asset_state/memo/modify_id/modify_time 四列、不联动资产卡片/金蝶;DeviceLifeCycle 实体补 memo 映射)→ 任务 27536;REQ-20261113-0009(id 6550,短信验证码提取 sms.vercode.latest.query,已上线生产+冒烟通过;验证码=登录敏感原语,全平台唯一显式排除业务 scope:prod 只绑研发专用 scope 6(tool id 73)、dev 只绑测试专用 scope)→ 任务 27164;REQ-20261107-0003(id 6443,出库单作废写工具 warehouse.out.void,已上线生产+冒烟通过,只绑研发专用 scope 6)→ 任务 26410;REQ-20261105-0020(id 6390,仓库出入库明细+在库物品 warehouse.out/in.details.list.query、warehouse.hardstock.list.query 3 工具,approved)→ 任务 26101;REQ-20261104-0015(id 6366,清机记录 hardware.cleanlog.list.query,已上线生产+冒烟通过)→ 任务 25998;REQ-20261012-0004(id 5977,空感 toilet.airquality list/detail/metrics/statelog 4 工具,已部署生产+冒烟通过)→ 任务 23488;REQ-20261013-0006(id 5988,代理角色用户查询工具 agent.user.list.query,approved)→ 任务 23566;REQ-20261012-0002(id 5975,客户换纸记录工具 district.paper.trace.list.query,released)→ 任务 23486;REQ-20260924-0009(id 5806,人流量统计工具+统计类限一个月,implementation 完成)→ 任务 22405;REQ-20260924-0003(id 5800,设备生命周期查询工具,implementation 完成)→ 任务 22391;REQ-20260921-0007(id 5778,设备电量消息查询工具,released)→ 任务 22306;REQ-20260919-0003(id 5747,出入库工具复查修复,released)→ 任务 22123。
- 近期需求示例:REQ-20261117-0008(id 6623,站点状态修改 district.state.update,已上线生产+只读核验通过,prod tool id 75 只绑研发专用 scope 6;576 个全量测试及 dev 真实「履约→演示→履约」/39 个资产联动恢复通过)→ 任务 27566;REQ-20261117-0003(id 6618,设备转固定资产写工具 device.lifecycle.fixed_asset.update,已上线生产+冒烟通过,prod tool id 74 只绑研发专用 scope 6;拍板:报废(4)与已是固定资产(1)守卫拒绝、null 按库存商品、只写 asset_state/memo/modify_id/modify_time 四列、不联动资产卡片/金蝶;DeviceLifeCycle 实体补 memo 映射)→ 任务 27536;REQ-20261113-0009(id 6550,短信验证码提取 sms.vercode.latest.query,已上线生产+冒烟通过;验证码=登录敏感原语,全平台唯一显式排除业务 scope:prod 只绑研发专用 scope 6(tool id 73)、dev 只绑测试专用 scope)→ 任务 27164;REQ-20261107-0003(id 6443,出库单作废写工具 warehouse.out.void,已上线生产+冒烟通过,只绑研发专用 scope 6)→ 任务 26410;REQ-20261105-0020(id 6390,仓库出入库明细+在库物品 warehouse.out/in.details.list.query、warehouse.hardstock.list.query 3 工具,approved)→ 任务 26101;REQ-20261104-0015(id 6366,清机记录 hardware.cleanlog.list.query,已上线生产+冒烟通过)→ 任务 25998;REQ-20261012-0004(id 5977,空感 toilet.airquality list/detail/metrics/statelog 4 工具,已部署生产+冒烟通过)→ 任务 23488;REQ-20261013-0006(id 5988,代理角色用户查询工具 agent.user.list.query,approved)→ 任务 23566;REQ-20261012-0002(id 5975,客户换纸记录工具 district.paper.trace.list.query,released)→ 任务 23486;REQ-20260924-0009(id 5806,人流量统计工具+统计类限一个月,implementation 完成)→ 任务 22405;REQ-20260924-0003(id 5800,设备生命周期查询工具,implementation 完成)→ 任务 22391;REQ-20260921-0007(id 5778,设备电量消息查询工具,released)→ 任务 22306;REQ-20260919-0003(id 5747,出入库工具复查修复,released)→ 任务 22123。
## ai-proj MCP 已知限制与真实契约
@@ -167,3 +167,10 @@
(真实站点改状态+改回、DB 复核恢复)→ push main → remote-deploy → 确认 ToolSyncService 新增
→ prod 绑 scope_tool(6, tool_id)(INSERT IGNORE)→ 生产只读核验(tools/list 可见、错误路径用例)
→ ai-proj 收尾(released + 实施记录)。
## 9. 生产上线记录(2026-11-18)
- 功能提交:`435e9bd14b76156f7c0a254fca59b4ca2dc1948d`,已推送 `origin/main`。
- 发布:`./deploy/deploy.sh remote-deploy` 成功;全量 576 个测试通过,生产 pid `3475488`,本地与生产 jar SHA-256 均为 `41a2375580e97a97c3904b5f8c2a0fd8d39898201ceaab5a65e46ec4f31224b4`。
- 注册与权限:`ToolSyncService` 新增 1 个工具,prod tool id `75`;`scope_tool` 唯一有效绑定为 scope `6`(code=`code`,研发专用)。
- 生产只读核验:公网未认证 `/mcp` 返回 401;真实 MCP 握手后 `tools/list` 共 75 个工具且本工具可见;不存在站点编号返回 `NOT_FOUND_OR_FORBIDDEN`,审计落为用户 812 的预期 error。未修改任何生产站点或资产。