通通锁列表
这一页干什么
查看本店 通通智能锁 列表，把每一把锁 绑定到 PMS 房间，并从这里进入密码管理、锁配置、制 IC 卡、云 IC 卡、开锁记录等操作。
从哪里打开
| 入口 | 操作 |
|---|---|
| 顶部导航 | 点 门锁（进入通通锁列表） |
| 左侧菜单 | 门锁管理 → 通通锁（当前页高亮） |
前置条件：在 系统设置 或门店资料中已配置通通锁接口；未配置时列表可能为空或无法拉取。
公共顶栏
顶栏与多数业务页共用，详见 顶部导航栏 `page-nav-header`。
筛选与导入
| 控件 | 业务逻辑 |
|---|---|
| 锁别名（模糊） | 按锁别名关键字过滤；留空则不过滤别名 |
| 分组 ID（可选） | 按通通锁分组 ID 精确/筛选；可与别名组合 |
| 查询 | 按当前条件重新拉取列表（分页从第 1 页起） |
| 导入门锁信息 | 上传通通酒店后台导出的 XLS，写入楼栋、楼层等制卡辅助信息 |
工具栏下方灰色提示：XLS 需在通通酒店后台 「对接门锁 → 导出门锁信息」 下载，表头应含 锁 Id、楼栋编号、楼层编号、锁 Mac。导入成功后，列表 楼栋 / 楼层 列会显示对应编号；未导入时这两列可能为空。
列表 — 每一列的业务逻辑
| 列 | 业务逻辑 |
|---|---|
| lockId/Name | 通通锁 ID 与锁名称；点击可复制 |
| lockAlias | 锁别名（如「4121房门锁」）；点击可复制 |
| 房间 | 下拉绑定 PMS 房间；选「未绑定」则解除关联。已绑其它锁的房间会置灰不可选（当前锁已绑定的房间除外） |
| 楼栋 / 楼层 | 来自「导入门锁信息」XLS；制卡/发卡器按楼栋楼层寻卡时使用 |
| lockMac/电量 | 锁 Mac 与电量百分比 |
| 支持项/Features | 锁能力摘要（如键盘密码、IC 卡、蓝牙、网关等） |
| 网关 | 是否已接网关（是/否） |
| lockData / groupId/name / bindDate | 锁数据摘要、分组、绑定时间等（运维/对接用，点击可复制） |
绑定房间
- 下拉按 房型分组 列出本店房间；已绑定其它锁的房间不可重复选（显示为禁用）。
- 当前锁已绑定的房间会带 (通通锁) 标记，便于识别。
- 改选后立即保存绑定关系；办理入住发密码、制 IC 卡 都依赖「锁 ↔ 房间」已正确绑定。
行内操作按钮
| 按钮 | 干什么 | 说明 |
|---|---|---|
| 操作记录 | 打开弹窗 | 该锁的开锁/操作历史（通通锁侧记录） |
| 发还记录 | 打开弹窗 | 本房门卡 发放/归还 台账（与订单制卡联动） |
| 密码 | 打开弹窗 | 管理该锁的 键盘密码（入住发码、临时密码等） |
| 配置 | 打开弹窗 | 锁开关类配置（如远程开关、常开模式等，以锁型号为准） |
| 制IC卡 | 打开弹窗 | 连接 本机发卡器 写入 IC 卡（H5/PC 制卡场景） |
| 云IC卡 | 打开弹窗 | 管理 云 IC 卡（无需实体发卡器的卡号） |
上述功能多以 弹窗 形式打开，不离开列表页。与订单联动发密码/制卡时，也可从 办理入住/退房、订单详情 入口操作，底层仍是同一套锁与房间绑定。
以下按按钮逐一说明各弹窗界面与业务逻辑。
操作记录
| 区域 | 业务逻辑 |
|---|---|
| 标题栏 | 显示锁 ID、总条数、最近刷新时间；出错时顶部会有错误提示 |
| 日期筛选 | 选开始/结束日期，可设条数（默认 50），点 筛选 重新拉取 |
| 刷新 / 关闭 | 刷新当前条件的数据；关闭回到列表 |
| 表格 | 时间、锁 ID、类型、方式、操作者、电量、设备时间、服务器时间、凭证 ID 等；可横向滚动查看 |
常见用途：核对谁、何时、用什么方式开门；排查 强拆报警、常开关闭 等异常事件。类型含开锁/关锁/密码/IC/指纹/远程/报警等（以列表显示为准）。
注意：需已选中有效锁；无记录时可放宽日期范围或增大条数再试。
发还记录
| 区域 | 业务逻辑 |
|---|---|
| 标题 | {房号} 房 · 发还记录（如 4121 房） |
| 摘要 | 未还 N 张 · 共 M 条 — 统计当前房间尚未归还的实体门卡 |
| 每条记录 | 卡号、关联订单、来源（前台 / 大堂机 / 补卡）、发出时间；已还卡另有收回时间 |
| 状态 | 未还（红）、已还（绿）、挂失、坏卡 |
| 分页 | 每页 10 条，上一页 / 下一页 |
| 关闭 | 底部按钮关闭弹窗 |
前置条件：该锁已在 房间 列绑定 PMS 房号；未绑定时会提示无法查询。
常见用途：退房前核对门卡是否全部收回；查某订单发了几张卡、从哪发出。
与订单关系：办理入住/制 IC 卡时写入 cardIssueLog；订单详情里也可查看同一房间的门卡台账。
密码管理
| 区域 | 业务逻辑 |
|---|---|
| 顶部按钮 | 获取随机密码、添加自定义密码、删除所有密码（不可恢复，慎用） |
| 列表列 | 密码 ID、密码、类型（如限期）、开始/结束时间、发送状态、创建时间、备注 |
| 行操作 | 复制密码 发给客人；修 改有效期或备注；删 除单条 |
| 刷新 / 关闭 | 重新拉取列表；关闭弹窗 |
常见流程：点「获取随机密码」→ 设有效期 → 确定 → 复制密码告知客人（短信/微信）。
注意：密码下发依赖锁在线或后续联网同步；发送状态 列可查看是否已成功下发。需权限位 locks_manage_password。
配置
| 区域 | 业务逻辑 |
|---|---|
| 基本信息 | 只读：lockId、lockName、lockAlias、lockMac、电量、是否有网关、WiFi 省电、featureValue、bindDate |
| 常规配置（可离线） | 锁名称、管理员开锁密码、反锁开关、防撬通知、重置键、锁声音、音量(0~5)、双重验证等 |
| 保存设置 / 关闭 | 修改后点 保存设置；管理员密码留空表示不修改 |
注意：无网关时部分远程项会延后同步，锁下次联网后生效；需立刻生效可用通通锁 App 蓝牙直连。网关相关项（常开、自动上锁等）在下方网关配置区（以锁型号为准）。
制 IC 卡（本机发卡器）
| 区域 | 业务逻辑 |
|---|---|
| 连接 | 通过 WebSocket ws://127.0.0.1:9002 连接本机 HotelCardAssistant + USB 发卡器 |
| 标签页 | 制卡、读卡验卡、回收、挂失、设备 |
| 制卡表单 | 锁别名、卡类型（房间卡等）、lockMac、楼栋/楼层、截止时间、卡号 |
| 开关 | 「先写酒店专用卡到空白卡」；「使用云端 hotelInfo」（推荐，自动拉取制卡参数） |
| 写房间卡 | 将 lockMac、楼栋楼层等写入物理 IC 卡扇区；写成功后自动读卡号 |
| 调试日志 | 底部黑框记录连通、参数拉取、写卡结果，便于排查 |
默认截止时间：次日 + 酒店退房时刻（来自 check_out_time_str）。
前置条件：PC/H5 前台电脑已安装发卡助手；列表已 导入门锁信息 XLS 或手动填写 lockMac/楼栋/楼层。
与云 IC 卡区别：本弹窗 写物理卡扇区；云 IC 卡只登记 UID 到云端，不写扇区。
写卡成功后会可选登记到通通云并写入 发还记录（与订单制卡联动）。
云 IC 卡
| 区域 | 业务逻辑 |
|---|---|
| 说明 | 将物理卡 UID（卡号） 登记到通通云；锁联网或经网关同步后，客人刷卡即可开门，无需本机写扇区 |
| 添加云 IC 卡 | 手填 UID 或点「读卡号」（需本机发卡助手 + 发卡器读 UID） |
| 列表 | cardId、卡号 UID、名称、开始/结束时间 |
| 删除 / 清空全部 | 删单条或清空该锁下全部云卡（清空不可恢复） |
| 刷新 / 关闭 | 重新拉取；关闭弹窗 |
常见场景：已有空白 IC 卡或预发卡，只需把 UID 登记到云端；或制 IC 卡写扇区后同步登记 UID。
注意：客人刷卡前确认锁已联网或经网关完成同步。
分页
| 控件 | 业务逻辑 |
|---|---|
| 上一页 / 下一页 | 翻页；首页/末页时对应按钮禁用 |
| 页码信息 | 显示「当前页 / 总页数（共 N 条）」 |
怎么操作（常见流程）
- 顶栏点 门锁 进入列表；必要时在通通后台导出 XLS 后点 导入门锁信息。
- 用 锁别名 / 分组 ID 查询，找到目标锁。
- 在 房间 列下拉绑定房号（如 4121）。
- 需要时点 密码 发入住密码，或点 制IC卡 / 云IC卡 制卡；查历史点 操作记录 或 发还记录。
注意点
- 房间未绑定锁时，订单里 密码开门 / 制 IC 卡 会提示未绑定。
- 楼栋/楼层 为空不影响绑定房间，但可能影响发卡器按楼层寻卡，建议导入 XLS。
- 一把锁只能绑一个房间；换绑前请确认原房间不再使用该锁。
- 部分按钮受操作员 权限 控制；无权限时按钮不可用或打开为空。
相关页面
| 操作 | 链到 |
|---|---|
| 顶栏门锁入口 | 顶部导航栏 `page-nav-header` |
| 入住发密码 / 制卡 | 办理入住/退房 `page-booking-order` · 订单详情 `page-op-order` |
| 房态右键制 IC 卡 | 房态视图 `page-fangtai-status-view` |
| 通通锁接口配置 | 系统设置 `page-setting` |
| 产品能力概览 | 门锁 · 制卡 · 读证 |