- 全书功能按已交付、在建、按批次、依赖外部四档标注落地状态
- 每行功能均对应后端控制器、前端页面与交付状态
- 明确不交付自研人脸算法、无感通行、实时增量同步等
- 大模型四出口与邮件短信通道为接口就位、按批次补齐
- 清单可用于合同、评审与评估逐项核验追问
明·如归 · 宿舍管理白皮书 ｜ 附录
说明：本清单是全书四十六章正文的能力索引。每一行都对应到具体功能、后端位置、前端页面与落地档。落地档四档：已交付（生产环境跑着、当场可演示）、在建（部分实现，本实例可预览）、按批次（接口已就位、真实实现按投产前批次补齐）、依赖外部（需学校侧或第三方配套）。清单不重述理由，只重列事实——数字口径以 D.6 基线表为准。
A.1 已交付（生产环境跑着、当场可演示）
| 功能 | 后端位置 | 前端页面 | 备注 |
|---|---|---|---|
| 住宿资源管理（校区、楼、层、房间、床位、户型、物资、收费） | BuildingController 族 4 个控制器 | 管理端资源管理 6 页 | 五级层级 + 床位并发唯一 |
| 住宿分配管理（查询、调整、待分配、记录、统计） | AssignmentController 族 5 个 | 管理端分配 5 页 | 三维统计、快照归档 |
| 新入住预分配（批次、规则、五步流程、混编、比例） | FreshmanController + 规则控制器 | 管理端预分配 3 页 | 三条硬不变量写死 |
| 智能预排（只读预览、评分可回放） | 智能预排管理器 + 分配求解器 | 预览明细页 + 未名单页 | 不落库，走人工确认 |
| 人员信息管理（学生、教师、历史、住宿记录） | StudentController + AccountController | 管理端人员 4 页 | 六级组织树 |
| 外出申请与销假（多级审批） | 请假控制器 + 请假管理器 | 管理端 3 页 + 学生端 + 教师端审批 | 已批假期自动跳考勤 |
| 在住登记与考勤（五路来源、假日、调休、考勤日型） | 考勤控制器 + 自动考勤控制器 + 假日控制器 | 管理端考勤 4 页 + 移动端打卡 + 教师端登记 | 单点考勤日历裁决 |
| 防替打 | 后端按登录身份拦截 | 移动端打卡页 | 时间窗 + 受信任证书 + 半径三条件 |
| 住宿变更（调宿、退住、走读、记录） | 住宿变更控制器 | 管理端变更 3 页 + 学生端调宿申请 + 移动端 | 状态变更非删除 |
| 检查与评级（卫生、文明、物品、违纪、积分、星级、奖惩） | 评分控制器 + 检查记录控制器 | 管理端评级 4 页 + 教师端评分 + 移动端检查 | 四类检查 + 三维评分 |
| 设施服务（设备台账、报修、评价） | 设施控制器族 3 个 | 管理端报修 3 页 + 移动端报修申请 + 评价 | 报修四状态 + 处理时限 |
| 通知公告 | 通知中心控制器 | 管理端消息 + 学生端消息 + 移动端 | 站内 + 实时推送 |
| 角色与权限（55 权限码 + 三层角色模型 + 双轨数据范围） | 每控制器 RequirePermission 属性 | 管理端配置 6 页 | 后端校验 + 前端展示 + 审计 |
| 数据字典与元数据 | 字典控制器 + 枚举控制器 | 管理端字典 + 字段元数据页 | 运行时字段增删 |
| 组织与账号（六级树 + 用户组 + 成员） | 学校控制器 + 账号控制器 | 管理端组织 + 账号页 | 学生/教师独立树 |
| 操作日志与审计（内容快照） | 审计控制器 + 日记管理器 | 管理端日志页 | 每次写操作留执行者、时刻、目标、前后 |
| 数据质量五规则（一人多占、性别不符、离校在住、证件校验位、通行无主） | 质量扫描服务 + 质量规则控制器 | 管理端问题工作台 | 按 (规则, 实体, 待处理) 去重 |
| 归寝异常三检测器（连续未归、作息突变、同寝连带） | 归寝异常扫描服务 + 归寝异常控制器 | 管理端异常工作台 + 教师端预警列表 + 大屏计数 | 四元组去重 |
| 定时任务三处理器（自动考勤、质量扫描、归寝异常） | 定时任务控制器 + 处理器目录 | 管理端任务列表 + 执行历史 + 手动执行 | 幂等、并发控制 |
| 开放接口（客户端管理、独立鉴权、限流、事件回调） | 开放接口控制器 + 四个开放接口文件 | 管理端客户端配置页 | 回调走哈希签名 |
| 连接器 5 类（通用接口门禁、海康设备协议、两种单点登录、教务学籍同步） | 集成控制器族 | 管理端连接器配置 | 只接事实、不下结论 |
| 地图服务 5 家（OpenStreetMap、CARTO 内置；天地图、高德、百度配钥） | 地图配置控制器 | 管理端地图配置页 + 前端统一入口 | 同时仅一家启用 |
| 实时大屏与推送 | 两条实时通道（站内消息、大屏推送） | 大屏页 + 五维下钻 | 与统计接口口径一致 |
| 一人一档 360 画像 | 360 画像接口 | 管理端画像页 | 五维聚合 |
| 住宿可视化（全景、楼栋图） | 全景外链 + 楼栋图 | 管理端预览页 | 不承诺设备侧算法 |
| 认证链 12 种（本地口令 + 多种票据：两种单点登录、企业微信、超星、微哨系 ×4、为笑、校园应用） | 认证层各实现 | 登录页 | 学校选一种接入 |
| 数据迁移工具（旧库 → 当前库） | 迁移工具独立程序 | 无前端页 | 幂等可重复执行 |
| 幂等迁移脚本 18 个 | 迁移目录结构化脚本 | 无前端页 | 启动自动应用 |
| 应急联系人（家长联系方式） | 应急联系人控制器 + 管理器 | 管理端 + 学生端 | 敏感字段脱敏 |
| 安全设施（脱敏、跨站脚本清洗、跨站请求伪造防护、限流、Cookie 安全属性） | 安全层各组件 | 全站生效 | 登录 10/min、导入 5/min |
A.2 在建（部分实现，本实例可预览）
| 功能 | 当前状态 | 补齐时点 |
|---|---|---|
| 连接器协议扩展（除已实证 5 类之外） | 通用协议框架已就位 | 依赖学校侧外部接口具体评估 |
| 地图服务凭据管理界面完善 | 已可配钥；界面体验按批次优化 | 下一批 |
| 字段级加密扩面 | 当前覆盖口令与最小必要项 | 学校合规要求到位后扩 |
A.3 按批次（接口已就位、真实实现待补）
| 功能 | 已就位 | 待补 |
|---|---|---|
| 大模型四出口（分配解释、约束式查询、问数、周报草稿） | 统一接口 + 白名单 + 确定性测试桩 | 真实模型供应商与合规审批 |
| 邮件通道 | 通道注册接口已实现，标记不可用 | SMTP 配置与生产化 |
| 短信通道 | 通道注册接口已实现，标记不可用 | 短信供应商与签名模板 |
| 浏览器推送通道 | 通道注册接口已实现，标记不可用 | 浏览器推送证书与订阅管理 |
| 企业微信消息模板 | 认证链已支持，消息模板未接 | 企业微信侧配置 |
| 时间戳/游标增量同步 | 全量幂等对账已投产 | 增量策略与列扩展 |
A.4 依赖外部（学校侧或第三方配套）
| 功能 | 外部依赖 | 本系统边界 |
|---|---|---|
| 门禁/闸机/人脸设备接入 | 设备厂商与算法 | 只接受设备识别结果作为考勤来源之一 |
| 教务系统接口 | 学校教务源 | 只对接已实证通道，其他教务源需专项评估 |
| 统一身份认证 | 学校或第三方身份源 | 已就位 12 种认证链；其余按连接器框架扩展 |
| 移动打卡受信任证书 | 证书与局域网内网环境 | 学校侧准备证书；系统强制安全来源 |
| 政策合规审批 | 上级主管部门 | 系统提供落地能力，不代替合规审批 |
A.5 明确不做的事
以下能力不在本系统交付范围，正文与投标承诺里一律不出现：
- 自研人脸识别、活体检测、防替考级算法。设备侧算法由厂家负责，本系统只接结果。
- 无感通行分析。作息突变检测的源是打卡更新时刻，不是门禁时间——不使用"无感通行"表述。
- 一键智能分配已投产。智能分配为只读预览；落库需人工确认走既有分配通道。
- 实时增量同步。当前实现为按锚点全量对账、幂等；不承诺"实时"。
- AI 助手已上线、对话式查询可用。大模型四出口为测试桩；模型接入按批次。
- 多渠道短信触达、邮件通知、微信模板消息。当前只有站内消息 + 实时推送双通道。
- 支持所有主流教务系统。连接器有 5 个具体通道，其余按专项评估。
- 客户案例与现场照片。这本书不写客户案例；旅程篇按已验证产品事实与方法论写作。
清单的意义：任何一份份合同、一次评审、一场评估都可以拿着这张表逐项核验。每一行都能被追问"给我看一下"——这是这本书与营销材料唯一实质的区别。