# 01 设备与设备任务（`device`）

## 1.1 业务目标

- 维护 **本应用视角** 的电梯设备与平台设备（`DeviceService`）的关联数据。
- 支持 **重组/绑定**：按区域、标签、组织等条件选择楼层，将 **人员** 或 **规则** 批量下发到设备侧（经远程服务）。
- 通过 **设备任务**（`AcsDeviceTaskService` / `AcsDeviceTaskServiceImpl`）在楼层维度 **有界并行** 执行远程步骤，并 **按完成顺序** 推进任务上的 `bindDevices` 等进度（与走查约定 §9 一致）。

## 1.2 主接口 `AcsElevatorDeviceService`

| 方法 | 行为概要 |
|------|----------|
| `add` / `edit` / `delete` | 电梯设备增删改，写本库并协调平台设备信息 |
| `get` / `getById` / `getFo` | 分页列表、单条、表单选项数据 |
| `getBuildingId` / `getBusinessId` | 从查询条件解析楼宇或租户 |
| `devicePage` | 走 **平台** 设备分页，与 `Acs` 表关联展示 |
| `listUnbindFloors` / `listFloors` / `listCondition` / `listConditionByLabelIds` | 绑定时待选楼层、已绑楼层、条件筛选（标签等） |
| `bindingFloors` / `bindingPerson` | 启动绑定：创建/更新设备任务，异步 `updateFloors` |
| `getTask` / `setTaskStop` | 查询任务进度、停止任务 |

**实现类**：`device/impl/AcsElevatorDeviceServiceImpl.java`。

## 1.3 设备任务 `AcsDeviceTaskService`

| 方法 | 行为概要 |
|------|----------|
| `updateFloors` | 在 **增加楼层 / 删除楼层** 两路上，将远程调用按 **每批 `UPDATE_FLOORS_FLOOR_PARALLEL` 个楼层** 提交到 `elevatorRemoteBoundedExecutor`；`FeignThreadLocalUtil` 在子任务中恢复租户上下文；每步成功再 `advanceBindProgressOne` 更新 `bindDevices`。 |

**实现类**：`device/impl/AcsDeviceTaskServiceImpl.java`。

## 1.4 用例级视图（操作者：管理员 / 系统）

```mermaid
flowchart TB
  subgraph 电梯设备管理
    A[增删改电梯设备]
    B[分页查询/详情]
  end
  subgraph 重组绑定
    C[选楼层/人员或规则]
    D[启动 bindingFloors/bindingPerson]
    E[异步 updateFloors]
  end
  A --> B
  C --> D --> E
```

## 1.5 时序：启动楼层绑定后异步推进（概念）

```mermaid
sequenceDiagram
  participant Web as Web/Controller
  participant Dev as AcsElevatorDeviceServiceImpl
  participant Task as AcsDeviceTaskService
  participant Pool as 有界线程池
  participant Remote as 人员/规则 Feign
  Web->>Dev: bindingFloors(参数)
  Dev->>Task: 异步 updateFloors(...)
  loop 每批楼层
    Task->>Pool: invokeAll(子任务)
    Pool->>Remote: add/delete 单楼层步骤
    Remote-->>Task: 成功
    Task->>Task: advanceBindProgressOne(taskId)
  end
```

## 1.6 设备设置子域 `device/setting`

- **`AcsDeviceSettingService`**：如体温相关设置查询（`getTemperatureSetting`）。
- **`AcsDeviceImageStoreAppBindService`**：设备与图库应用绑定/解绑等（实现见 `setting/impl`）。

## 1.7 与邻域关系

- **规则/人员**：`updateFloors` 内调 `PersonRuleService`、`ImageRuleRefService` 等，取决于绑定参数是 `personId` 还是标签/组织。
- **data 层**：`AcsDeviceTaskDao`、设备相关 DAO 在 **data 模块**。