# DMS 智能门禁门锁系统最终集成状态报告 (DMS Final Status)

- **报告标识**: `DMS_FINAL_INTEGRATION_STATUS_R4`
- **验证轮次**: Round 4 最终确认与口径纠偏
- **验证环境说明**: **文档示例凭据对应的可访问DMS环境**

---

## 1. 真实网络协议与接口契约验证结论

在真实网络与文档示例凭据对应的可访问 DMS 环境下，系统已完成针对外部 DMS 平台的探测与协议校验：

| 验证项 | 判定状态 | 详细验证事实与依据 |
| :--- | :---: | :--- |
| **平台登录认证 (AUTH)** | **PASS** | 成功向 DMS 官方服务地址 (`https://dms.dmsiot.com/public/rest/third-party-app/token/get`) 发起认证并获取有效 Token，HTTP 状态码 200 |
| **Token 有效期 (TOKEN TTL)** | **7200 (runtime verified)** | 运行时验证服务端返回 `expires_in: 7200`，本地缓存与过期调度已验证 |
| **Cookie 认证机制 (Cookie token)** | **runtime verified** | 运行时验证 DMS 接口要求在请求头携带 `Cookie: token=...`，请求适配器与拦截机制全链路兼容 |
| **只读接口连通性 (Read-only API connectivity)** | **PASS** | 楼栋、楼层、房间、门锁 4 个标准只读查询接口网络连接通畅，均返回 HTTP 200 |
| **空数据响应契约 (Empty-response contract)** | **PASS** | 响应报文符合平台标准空列表外层 JSON 契约结构 |
| **真实资源数据行级映射 (Row-level mapping)** | **NOT_RUNTIME_VERIFIED_DUE_TO_NO_RESOURCE_DATA** | 该环境下查询结果为 `BUILDING=0, FLOOR=0, ROOM=0, LOCK=0`。因完全缺乏具体空间与设备数据，具体资源属性（如 `room.id`, `placeId`, `lock.id`, `hardwareId`）的行级字段映射**尚未在运行时通过真实数据验证** |
| **真实变更操作 (Real Mutation)** | **BLOCKED_EXTERNAL** | 外部环境中无真实测试房间/门锁资源，无法下发密码创建/删除等写指令，处于外部客观阻塞 |
| **真实物理硬件实体验证 (Physical Hardware)** | **BLOCKED_EXTERNAL** | 缺乏指定联调的实体智能门锁硬件环境，处于外部客观阻塞 |

> **关键校准说明**：
> - 外部环境准确定位为“**文档示例凭据对应的可访问DMS环境**”，不作任何未经证实的主观推断；
> - 明确区分“接口空响应结构通过”与“真实设备数据行级映射验证”，严禁将缺少资源数据的空响应夸大为“真实资源数据已完全验证”。

---

## 2. 门禁业务管理策略 (Provisional Policies)

当前系统实现遵循以下**暂行策略 (Provisional)**，在系统中已完整落地并在 Mock 环境下通过全生命周期测试：

| 业务场景 | 当前系统落地策略 | 确认状态 | 说明 |
| :--- | :--- | :---: | :--- |
| **学员请假 (Leave)** | `KEEP_ACCESS` (保留权限) | **PROVISIONAL / CUSTOMER_CONFIRMATION_REQUIRED** | 请假期间学员宿舍门锁授权保持有效，不自动注销密码 |
| **学员调宿 (Transfer)** | `GRANT_NEW_THEN_REVOKE_OLD` (先授新后销旧) | **PROVISIONAL / CUSTOMER_CONFIRMATION_REQUIRED** | 调宿时先成功下发新房间门锁授权，再回收原宿舍权限，防止学员锁在门外 |
| **多门锁绑定 (Multi-Lock)** | `PRIMARY_LOCK_ONLY` (仅主锁) | **PROVISIONAL / CUSTOMER_CONFIRMATION_REQUIRED** | 宿舍存在多个锁具时仅向主锁下发开锁凭证 |
| **授权有效期 (Validity Window)** | `ACCOMMODATION_WINDOW` (住宿周期优先，回退培训计划结束时间) | **PROVISIONAL / CUSTOMER_CONFIRMATION_REQUIRED** | 优先以学员实际住宿分配起止时间为准，无明确时间时回退为培训计划结束时间 |
| **凭证下发与安全查看 (Credential Delivery)** | `ADMIN_ONE_TIME_DISPLAY` (管理员单次查看) | **PROVISIONAL / CUSTOMER_CONFIRMATION_REQUIRED** | 下发的临时密码明文不在数据库中持久化、不入日志，仅限管理员操作时单次展示 |

---

## 3. 验收结论

- DMS 平台认证链路与只读空响应契约已验证。
- 业务流转暂行策略已在代码中完整实现并在 Mock 环境下闭环。
- 真实物理资源接入、行级数据映射与设备写操作联调属于外部客观前置依赖。