3.3 KiB
资产管理模块
原 n2tpm 盘点接口兼容
当前服务保留自身 /apis 上下文，并提供原盘点协议的以下 POST 接口：
/apis/n2tpm/webmvc/Inventory/Login/apis/n2tpm/webmvc/Inventory/GetInventory/apis/n2tpm/webmvc/Inventory/GetInventoryDetail/apis/n2tpm/webmvc/Inventory/SaveDeviceInventoryInfo/apis/n2tpm/webmvc/Inventory/AccepteOrHandoverDocForInventory/apis/n2tpm/webmvc/Inventory/UploadPicture/apis/n2tpm/webmvc/Inventory/GetDevice
接口请求字段、响应中的业务字段及 code/msg/data 包装与原项目一致。若外部设备必须继续访问
/n2tpm/webmvc/Inventory/**，请在网关将该路径转发到本服务的
/apis/n2tpm/webmvc/Inventory/**，无需修改前端和现有 /apis 接口。
部署
- 执行
src/main/resources/db/migration/V20260918__asset_management.sql。 - 重启后端并重新登录前端，使动态菜单和角色权限重新加载。
- 管理员菜单中会出现“资产管理”，包含“资产台账”“设备台账”“资产盘点”。
盘点流程
盘点状态依次为：草稿（DRAFT）→ 盘点中（IN_PROGRESS）→ 待审核（PENDING_AUDIT）→ 已完成（COMPLETED）→ 已关结（CLOSED）。
创建盘点单时会把当前资产/设备台账固化为盘点快照。盘点支持按明细操作，也支持输入或扫描资产、设备编号定位明细。实盘数量和账面数量不一致时会自动判断盘盈或盘亏；部门、地点变化时会判断为异常，也可人工指定结果。
协同服务接口
推荐接口：
POST /apis/assetInventory/collaboration/create
Content-Type: application/json
{
"externalRequestId": "外部系统唯一请求号",
"planName": "月度设备盘点",
"scopeType": "DEVICE",
"deadline": "2026-09-30 18:00:00",
"remark": "由协同服务创建"
}
externalRequestId 是租户内幂等键，外部服务重试时会返回原盘点单，不会重复建单。接口沿用系统登录会话和租户隔离机制。
为兼容参考工程中的调用路径，同时保留：
POST /apis/tpmDouble/cteatePdTasks
该兼容接口固定以全部设备台账创建盘点任务，可选传入 externalRequestId、planName、deadline 和 remark。
外部服务回传单项盘点结果
推荐使用：
POST /apis/assetInventory/collaboration/record
Content-Type: application/json
为兼容原设备项目的调用路径，同时支持：
POST /apis/deviceInventory/doDevicePlan
Content-Type: application/json
按盘点单号和设备编码回传示例：
{
"inventoryNo": "PD20260918131230171",
"deviceSn": "QC-SPI-01",
"remark": "外部采集服务确认设备在位"
}
也可以传 inventoryId 与 detailId，或者使用 targetCode、deviceCode、assetCode 作为对象编码。回传成功后，明细由“未盘点”更新为“已盘点”，主单自动进入“盘点中”并刷新已盘数量。重复回传同一明细按幂等成功处理，不会重复计数。若外部系统能够判断差异，可将 inventoryStatus 传为 NORMAL、SURPLUS、SHORTAGE 或 ABNORMAL。
接口沿用本系统认证与租户隔离，外部服务调用时需携带有效登录令牌或会话。