feat(mcp): 新增设备转固定资产写工具 device.lifecycle.fixed_asset.update(REQ-20261117-0003)

按 SN 精确匹配把 device_life_cycle.asset_state 转为固定资产(1),memo 写来源状态文案;
已是固定资产/已报废守卫拒绝,null 按库存商品处理;只写 asset_state/memo/modify_id/
modify_time 四列,不联动资产卡片/金蝶;零行级权限,prod 只绑研发专用 scope 6。
DeviceLifeCycle 实体补 memo 字段映射(DB 列早已存在,老系统从未映射)。
This commit is contained in:
my_local_kimi_dev2
2026-11-17 09:41:24 +08:00
parent e042f62c34
commit 37ce5a3443
6 changed files with 449 additions and 0 deletions
@@ -1287,6 +1287,31 @@
---
## 55. device.lifecycle.fixed_asset.update
设备转固定资产(写操作,REQ-20261117-0003),研发/运维专用。
- 分类:admin | 类型:写(readOnlyHint=false)
- 入参:`snCode`(必填,trim 后非空,**精确匹配** `sn_code`,不模糊)。
- 行为:`sn_code=? AND soft_delete=0 ORDER BY id ASC LIMIT 1` 定位记录(重复 SN 取最早一条,与老系统同口径);
UPDATE 该行的 `asset_state=1`(固定资产)、`memo='从<原状态文案>变成固定资产'`、
`modify_id=调用方用户 id`、`modify_time=now()`——只写这四列,
不动 exchange_state/last_op_*/jindie_* 等流转与同步字段。
- 守卫(王恒 2026-11-17 拍板):已是固定资产(1) → INVALID_ARGUMENT「不允许重复转换」
(工具目标状态固定为 1,固定资产永远不会被改成其他状态);已报废(4) → INVALID_ARGUMENT;
asset_state 为 null 的历史行按 0(库存商品)处理。允许来源:0库存商品/2出租/3售出/5费用化/null。
- 返回:`snCode/deviceType/deviceTypeText/oldAssetState/oldAssetStateText/newAssetState/
newAssetStateText/memo/modifyTime/requestId`。
- 权限:零行级权限,访问控制完全靠专用 scope 门禁——prod 只绑研发专用 scope 6(code=code)、
dev 只绑测试专用 scope(code=test,seed-dev.sql kind=write 自动段覆盖);必须用户身份 Token
(操作人落 modify_id + audit_log),服务身份 Token 拒绝。
- 联动边界:只改 device_life_cycle 一表;**不**生成 m2 asset_info 资产卡片
(卡片由设备上线队列任务驱动,另一条链路)、**不**触发金蝶同步。
详细设计见 [device-lifecycle-fixed-asset-mcp-design](device-lifecycle-fixed-asset-mcp-design.md)。
---
## 附录:在线查看工具清单
```bash