4.1 KiB
4.1 KiB
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 环境下闭环。
- 真实物理资源接入、行级数据映射与设备写操作联调属于外部客观前置依赖。