明·如归 · 智慧宿管平台

系统内有 2 个实时推送 Hub：通知 Hub（站内信、预警告警、系统公告的实时送达）和大屏 Hub（定时推送统计口径到实时可视化界面）。不承诺微信/企业微信消息推送、短信、邮件——这些通道在通道注册接口上标记为“预留未启用”。两条实时通道仅是本系统内的即时消息通道。

不会默认公开。系统规定室友信息由本人主动查看才出现，不默认公开、不群发，因为“同宿舍不等于互相同意公开家庭住址”。同时，“报到前就知道室友是谁”是官方信息能压过野生攻略的凭据之一，但分寸写死：只有在学生主动查看时展示。

不能承诺“两周上线”或“两个月见效”。 文档明确：一周内能完成的只有“基础设施安装”（接口连通、页面打开、登录进入）。真正的业务上线至少需要一个学期，因为要经历新生入学、学期中调宿、考勤扫描、周期报表等新场景。实施陪跑分五步：账先摊开、认领会主、配规则、试点一栋、全量与陪跑。试点实测数据是唯一诚实的工期口径，先小范围量出真实工时，再按规模推算。

系统的应对原则是：

• 降级不造假：地图服务不可用时显示空白底图加文字地址，不画假位置点；门禁离线时考勤照常运转，不补录假数据；企业微信推送失败时站内消息照常，外部通道留失败日志供重试。
• 留痕不猜测：通行记录时间戳和设备状态原样存储，错误数据标出来交给质量规则，不在存储层用算法修正。
• 测试连接独立：新配置设备通道先测试连接，通了再启用，不通不会误写入业务数据。

数据字典是把枚举类字段的可能取值统一管理起来，避免同一含义出现多种填法（如“壮族”“壮”“戗族”）。每个字典项包含名称、编码、排序号、启用状态、父级编码五列。名称给人看，编码给系统用且一般不改；停用不删除，历史数据仍能显示。系统里民族、政治面貌、学籍状态、籍贯、宿舍类型、报修类别等字段都应归字典管，自由文本只留在“备注”类字段。这样统计时不会出现三类变三行，也无需每学期人工裁决。

四类大模型出口共用三把白名单，且写死在代码里、不给临时开启的配置开关：

• 数据范围：大模型只能访问异常类、质量类、住宿类 3 类数据，不能访问证件号明文、口令散列、财务数据；
• 操作范围：只能生成"读"结果，不能生成"写"操作——即使用户说"帮我调宿"，也只返回跳转链接而不直接改数据；
• 输出格式：输出必须是预定义的结构化字段，不能自由发挥，前端按结构渲染以防注入。

采用三年分步走策略：

• 第一年：跑通能力篇与数据篇（床位、组织、身份、权限、考勤、服务、单据、统计），重点是"数据能被真实采集、真实查询"，智能化不做花活；
• 第二年：三张检测器、六维聚合、决策仪表盘、报表引擎全部投产，让回溯性智能化成熟；大模型出口用测试桩走完整链路但不接真实模型；
• 第三年：在学校使用满两学年、积累真实样本后，评估大模型出口接入真实模型的可行性；接不接是每年的成本收益判断，而非产品口号。

一校一实例指每所学校一套独立实例——自己的存储、账号体系、备份策略。学生住宿数据不与其他学校混在同一张表里，管理员导出报表也看不到别的学校名字。这样学校能独立回答“我们学校的谁在什么时间导出过什么”。文档强调，这不仅是技术选择，更是数据敏感的立场：学生住宿数据不应和别人共用同一个“保险柜”。同时，一校一实例不等于一家一套代码，而是同一套代码多次上线、各校在配置里差异化。

系统坚持三个诚实原则：

1. 能算就不学——床位需求预测用算术、考勤判定用日历规则、预警用阈值，能用明规则算出的一律不上模型，让"可解释"成为默认；
2. 能桩就不真——四类大模型出口都跑测试桩（结构对、内容固定），在没有真实样本前不做真接入，让"上线"和"演示"分开；
3. 能边界就不越——四条硬边界写死在产品层，不给配置口子，让系统"能长成什么样"提前有天花板，避免学校逐步放开时踩坑。

系统可选认证链有 12 种，包括：

• 本地口令：兜底，永远存在；
• 单点登录：CAS、OIDC；
• 企业微信：账号、扫码、小程序三种入口；
• 微信：服务号、小程序两种入口；
• 校园 App 票据、短信验证码、临时令牌等。
  认证依赖第三方站点，但保底有本地口令入口。学校统一认证挂掉时，宿管仍可用本地口令进入系统处理应急事务。

定时任务三处理器包括：

• 自动考勤：每晚 23:00 日执行，按考勤日历过滤非考勤日，拉取当日五路来源，汇成考勤日志，未归状态入库；支持手动补跑。
• 质量扫描：按配置周期依次跑五条规则，生成或更新问题工作台记录并触发通知；支持手动执行。
• 归寝异常预警：每晚自动考勤之后依次跑三个检测器，生成预警，站内警报 + 可选事件回调派发；支持手动回捞。

每个处理器有独立执行历史，记录开始/结束时间、耗时、扫描条数、生成条数、失败原因等。

不需要写代码。管理员在“字段管理”页面填写六项即可：挂哪个对象、字段键、显示标签、字段类型、绑定字典、校验规则。保存后自动生效：表单页多出输入框，列表页可按它筛选，导出模板自动追加该列，接口返回结构也自动带上，下游系统不用改代码。字段还可配置角色可见性，例如“健康备注”只对校医角色及其上级可见。

大模型四出口包括：分配解释、约束式自然语言查询、问数、周报草稿。当前全部为确定性测试桩，真实模型接入按投产前批次推进，不能宣传为“AI 助手已上线”。

共享纪律是：模型只出建议、不执行操作；操作由人点击确认触发；每次触发留审计。约束式自然语言查询不自动执行；问数只读且有三把白名单，模型不碰写路径；周报草稿发布前需人工确认。

字段键必须以字母开头，仅含字母、数字、下划线，长度不超过 50。这条规则是为了防注入和乱码：例如字段键叫 select 会破坏前端查询语法；叫“宿舍类型”在不同编码环境下会变乱码；带分号或注释符可能造成查询注入。字段键是给系统用的稳定标识，显示名是给人看的，可以随时改中文名，但字段键要稳定不变，两者不能混用。

打开问题工作台（或要求厂商给你看），回答三个问题：

• “上一次全量扫描是什么时候？” —— 如果不是最近一周内，那这个工作台是“看着好看”；
• “当前有多少条待处理？” —— 如果超过 100 条，说明修复跟不上扫描；
• “待处理里最久的那一条已经多少天了？” —— 如果超过一个月没人动过，说明问题工作台没有 owner——没有 owner 的质量运营等于没有质量运营。
  数据是活的，它会生病。系统的责任是每天量一次体温、有问题当天开单子、开完有人签字。

文档将选型主张压成四把尺子：

• 数据主权：住宿与作息数据的所有权、控制权、解释权归学校，厂商只在受托位置暂存。
• 源头治理：错的数据应当死在入口，不该活着进报表。
• 配置化程度：学校的特殊性应该由配置消化，不应该由代码消化。
• 判断能力：智能是判断，不是对话；判断必须可追溯。

每把尺子都给出当场可验的方法，用于把选型讨论从“感觉”拉到“当场可验”。

系统提供批次表 + 预分配比例 + 求解预览 + 未分配名单四件套。学校可按年灵活调整床位数、时间窗、混编策略；正式分配前可先跑三次预览（扩招15%、缩招15%、正常），看哪种床位组合最稳。求解器能承受“床位不够”的情况，未分配名单清晰，并有兜底手工分配路径。

因为这些政策文件尚未确认文号。白皮书的引用纪律是：未确认文号的具体政策一律按“对标/参照”表述，不做硬引用，只写方向、不写文号，例如“对标教育数字化战略”“参照高校学生公寓管理相关要求”。待文号确认后，才会按 D.1 和 D.2 的格式补入政策文件表，并回写正文。这样做的目的是宁可少引，不可错引，避免因引用不实文号而失去评审信任。

文档提出最狠的量法：让系统当场回答“昨晚谁最需要有人去看一眼”。 若只给全楼未归名单，等于没有回答；若能筛出“连续N晚未归、无请假备案、同寝无人应答”并标出依据，才算有判断能力。还要追问两个细节：每条结论点开的原始记录是哪几条；通知昨晚几点送达了谁的手机、有没有人认领。也可问“今年九月和去年九月，这栋楼的晚归曲线有什么不同”，按批次可比、按口径可回溯才叫数据积累。

一条“中外混住”政策需要落成六个配置点：

• 混编开关：勾选“允许同楼”、不勾“允许同室”；
• 预分配比例：楼级成员比例设30%上限；
• 求解器软约束：每间至少一名中国籍；
• 质量规则：核查某楼留学生比例>30%；
• 检查模板：按“有/无留学生”两套；
• 消息模板：留学生走英文、中国学生走中文。
  学校需要一次配齐。