# 资产管理模块

## 原 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` 接口。

## 部署

1. 执行 `src/main/resources/db/migration/V20260918__asset_management.sql`。
2. 重启后端并重新登录前端，使动态菜单和角色权限重新加载。
3. 管理员菜单中会出现“资产管理”，包含“资产台账”“设备台账”“资产盘点”。

## 盘点流程

盘点状态依次为：草稿（DRAFT）→ 盘点中（IN_PROGRESS）→ 待审核（PENDING_AUDIT）→ 已完成（COMPLETED）→ 已关结（CLOSED）。

创建盘点单时会把当前资产/设备台账固化为盘点快照。盘点支持按明细操作，也支持输入或扫描资产、设备编号定位明细。实盘数量和账面数量不一致时会自动判断盘盈或盘亏；部门、地点变化时会判断为异常，也可人工指定结果。

## 协同服务接口

推荐接口：

```http
POST /apis/assetInventory/collaboration/create
Content-Type: application/json
```

```json
{
  "externalRequestId": "外部系统唯一请求号",
  "planName": "月度设备盘点",
  "scopeType": "DEVICE",
  "deadline": "2026-09-30 18:00:00",
  "remark": "由协同服务创建"
}
```

`externalRequestId` 是租户内幂等键，外部服务重试时会返回原盘点单，不会重复建单。接口沿用系统登录会话和租户隔离机制。

为兼容参考工程中的调用路径，同时保留：

```http
POST /apis/tpmDouble/cteatePdTasks
```

该兼容接口固定以全部设备台账创建盘点任务，可选传入 `externalRequestId`、`planName`、`deadline` 和 `remark`。

### 外部服务回传单项盘点结果

推荐使用：

```http
POST /apis/assetInventory/collaboration/record
Content-Type: application/json
```

为兼容原设备项目的调用路径，同时支持：

```http
POST /apis/deviceInventory/doDevicePlan
Content-Type: application/json
```

按盘点单号和设备编码回传示例：

```json
{
  "inventoryNo": "PD20260918131230171",
  "deviceSn": "QC-SPI-01",
  "remark": "外部采集服务确认设备在位"
}
```

也可以传 `inventoryId` 与 `detailId`，或者使用 `targetCode`、`deviceCode`、`assetCode` 作为对象编码。回传成功后，明细由“未盘点”更新为“已盘点”，主单自动进入“盘点中”并刷新已盘数量。重复回传同一明细按幂等成功处理，不会重复计数。若外部系统能够判断差异，可将 `inventoryStatus` 传为 `NORMAL`、`SURPLUS`、`SHORTAGE` 或 `ABNORMAL`。

接口沿用本系统认证与租户隔离，外部服务调用时需携带有效登录令牌或会话。