Феҳристи ҳуҷҷатҳо

术语与品牌口径

本文档统一宿舍管理白皮书中全部核心术语的定义、边界与写法,规范品牌名称与数字口径,解决同一概念前后表述不一致导致评审与验收判断漂移的问题。

  • 住宿/在住/分配不可互换,前者状态、后者动作
  • 智能预排只读预览,人工确认后才走分配通道落库
  • 品牌名明·如归用中文中间点,不写拼音不加粗
  • 71控制器、795端点、139页面等数字须锚定基线表
  • 政策引用需全称+文号+发布时间+发布机关

明·如归 · 宿舍管理白皮书 | 第九篇 全典篇

同一件事在书里前后有两个说法,评审者的判断就会漂移。现在把这本书反复出现的所有术语做一次统一——每个术语给一个定义、给一段边界、给一句常见误用。品牌口径同理:"明·如归"这四个字应该怎么写、什么时候可以省略、不能怎么写——一次性写清楚。

46.1 核心术语表

住宿 / 在住 / 分配——三者不能互换。

  • 住宿:一种状态。学生在学校里有床位。
  • 在住:一条具体的分配记录的当前状态。有责任人、有时刻、有出处。
  • 分配:一个动作。把某个床位和某个人挂在一起。带事务、带并发保护、带审计。
  • 误用:把"这个学生在住"写成"这个学生已分配"——前者是状态、后者是动作;后者隐含"刚刚做过一次操作"。

床位 / 房间 / 房源——三者粒度不同。

  • 床位:最小分配单位。一人一床。
  • 房间:床位容器。有性别属性、容量、户型、朝向。
  • 房源:口语化。正式文本用"房间与床位"或"住宿资源"。

考勤 / 打卡 / 归寝 / 五路来源——四个词的分工。

  • 考勤:整个业务链的统称。
  • 打卡:某一次具体的动作。学生自助、宿舍长登记、宿管登记都算打卡。
  • 归寝:状态判定结论。当晚在寝/晚归/未归。
  • 五路来源:学生打卡、宿舍长登记、宿管登记、闸机刷卡、人脸识别。

预警 / 告警 / 通知 / 消息——四级层次。

  • 预警:系统按规则识别出的异常事实(归寝异常、质量问题)。
  • 告警:预警经过通道派发后的送达形态。
  • 通知:广义,包括预警、告警、系统公告。
  • 消息:站内通知流里的一条具体条目,走系统内部实时推送通道送达。

画像 / 档案 / 记录 / 快照——四种数据聚合方式。

  • 记录:单条事实。一次打卡、一次报修。
  • 快照:某一时点的完整状态。分配变更记录、审计留痕。
  • 档案:一个人的所有记录按时间排列。
  • 画像:一个人的所有记录按维度聚合后形成的判断视图。360 画像 = 五维聚合。

智能分配 / 智能预排 / 自动分配——三者不是一回事。

  • 智能预排:本系统已投产的能力。只读预览、评分可回放、人工确认后走既有分配通道落库
  • 自动分配:按批次执行的五步流程(新生导入 → 分批 → 规则匹配 → 床位分配 → 结果落库)。
  • 智能分配:外部对"智能预排"的口语称呼。正式文本避免使用,防止误读为"AI 一键分完"。

治理 / 管理 / 运维——三种视角。

  • 管理:让日常运转起来。分床、点人、批请假、修东西。
  • 治理:让规则清晰、责任可追、数据可用。字典型、审计型、工作台型的所有能力。
  • 运维:让程序持续跑着。备份、监控、恢复、升级。

边界与禁写术语(对照 D.1 与 D.6):

  • 互联网黑话不入正文:一切将业务动作包装成军事或商业隐喻的说法(具体清单见 D.1 与附录 C),一律改用日常动词。
  • 技术内幕词不入正文:讲架构层与运维层的名词一律不进入正文,改说业务人员日常词汇(政策原文名与招标可核验数字例外)。
  • 明确不承诺的表述:AI 助手已上线、对话式查询可用、无感通行分析、多渠道短信触达、一键智能分配投产、实时增量同步、自研人脸算法

46.2 品牌口径

"明·如归" 是这本书里唯一的产品与品牌名。标准写法:

  • 正式全称:明·如归(中间点用中文"·",不用英文"·"、不用空格、不用连字符)。
  • 首次出现明·如归 · 宿舍管理白皮书(用于每一页页眉与章首引用块)。
  • 正文单用明·如归这套系统不加引号、不加粗、不写成"明如归""明 · 如归"以及任何拼音形式
  • 英文/拼音名不出现——品牌语只用中文。
  • 口号性表述:全书不承诺"如你所归、如你在home"这类半中半英的口号;"如归"两个字承担全部情感重量。

"如归"的语义定位——不是产品口号,是判断:一个学生在楼里遇到问题时,能不能"像在家里一样知道该找谁、说了有人应、应对有留痕"。这三件事系统当场能照出来的就写、照不出来的转批次或转范围。任何超越这三件事的品牌描述都是虚的

版本与批次命名

  • 全书正文只用"批次"(P1–P6)指代交付节奏,不用版本号(v1.0、v2.0)。
  • 具体发布日期、版本号、内部任务编号不写入正文——这些属于合同与变更日志

46.3 数字口径的回扣

全典篇三个数字口径必须一致

  • 71 控制器 / 795 端点(按网络接口方法特性计,不是"业务接口")——出现在第四十二、四十五章与附录 B。
  • 139 前端页面(按 views/**/*.vue 计,四端合计:管理端 100 + 移动端 20 + 教师端 9 + 学生端 7 + 登录/403/404 三页)——出现在第四十二、四十五章与附录 A。
  • 91 实体 / 18 幂等脚本 / 111 管理器 / 55 权限码 / 3 定时任务 / 5 质量规则 / 3 检测器 / 5 连接器 / 5 地图服务 / 12 认证链——各章引用必须与 D.6 基线表一致,不自算、不改精度。

任何一个数字前后不一致,评审者就有理由怀疑整份材料。数字漂移不是文字问题,是可信度问题。

46.4 政策与标准口径

引用政策文件的三条纪律

  • 全称 + 文号 + 发布时间 + 发布机关。缺任一项,用"参照《XX》"的范围表述,不做"依据"式硬引用。
  • 原文名称照录(如"《高等学校学生公寓管理规定》"),不受禁词表约束——政策名里的架构运维层名词不因禁词而改写。
  • 不印链接。链接会失效、会跳错;只写文件名与文号,评审者自己去主管部门官网找。

未落实到位的政策原文按 D.7 待取证清单处理:只引已确认法名(《数据安全法》《个人信息保护法》《网络安全法》等);未确认文号的具体政策文件按"对标 / 参照"表述。

46.5 术语对照速查

前面几节用文字讲了 20 多个核心术语的分工。这里挑最容易混淆的十组做成对照表,供评审、写合同、写招标文件的同志直接查用:

常见误写正确写法差别
"系统里有 500 个学生已分配""系统里有 500 个学生在住"分配是动作、在住是状态
"AI 一键分完""智能预排 + 人工确认落库"预览不落库、不承诺自动执行
"无感通行分析""设备通行事件作为考勤第五路来源"不做位置轨迹拼接
"学生画像标签""360 画像 + 五维聚合"画像不是标签墙
"系统自动预警""三检测器命中 → 四元组去重 → 五层送达"有具体口径
"对话式查询已上线""自然语言查询接口在、真实模型按批次"当前是测试桩
"全量数据实时同步""按批次全量对账 + 幂等重跑"当前不是增量
"多渠道消息触达""站内消息 + 实时推送 + 企业微信"短信/邮件按批次
"自研识别算法""设备侧算法、系统只接收结果"系统不做识别
"多校共用一个云端""一校一实例、独立存储与备份"不共用保险柜

这十组术语的差别不是文字洁癖,是产品边界。写合同、写招标、写验收单的时候,把误写换成正确写法、每一条都对应一次现场演示、一次当场核验。

46.6 三条关于术语与口径的常见误解

误解一:术语是内部约定不用管。术语是这本书、这套系统与学校之间沟通的最小单元。合同上写"AI 智能分配"、系统里做的是"只读预览的智能预排"——两者不完全是一件事、评审和验收时会各说各话。术语统一不是给厂商方便、是给学校自己留一份"我们到底买了什么"的说明书。

误解二:品牌名可以随意变化。"明·如归"这四个字的中文中间点不是装饰——它标记了这个品牌是"明"系列下的一个产品线。写成"明如归"、"明-如归"、"明 如归"、"MingRugui"、"MING-RG" 都不是同一个东西。一份白皮书里品牌口径飘了、评审就会怀疑这份材料的严谨度

误解三:数字口径小偏差不影响大局。恰恰相反——一份白皮书里如果 795 端点这个数字前后不一致、评审就会怀疑其他数字也不一致数字漂移不是精度问题、是可信度问题。全书所有数字都锚定在 D.6 基线表上、任何一处不一致都以基线表为准修订。

46.7 一句话收口

术语与品牌口径不是文字洁癖,是把"这本书在讲什么"钉到一件事上。所有名词都指一个具体的动作、一张具体的表、一段具体的代码——评审者就能拿着这本书去核对系统、去签合同、去现场验收。任何一个术语飘起来、任何一个品牌语写成口号,都会把这本想做事的书拽回营销材料那一堆里。

这本书到这里正文就结束了。附录是四份可独立使用的清单——功能全清单、接口与数据清单、术语速查、引用文献与政策文件。正文给判断,附录给核验