附录 C　术语与品牌口径速查

明·如归 · 宿舍管理白皮书 ｜ 附录

说明：本速查表是第四十六章"术语与品牌口径"的一页版本，供评审、监理、写材料时随手核对。不解释理由、不重述定义——只给"这个词怎么写、不要怎么写"。

C.1 业务术语速查

术语	单一定义	不要混用
住宿	状态：在学校里有床位	≠ 已分配（动作）
在住	分配记录的当前状态	≠ 住宿（宽泛）
分配	动作：把床位和人挂在一起	≠ 预排（只读预览）
床位	最小分配单位，一人一床	≠ 房间（床位容器）
房间	床位容器，有性别、容量、户型	≠ 房源（口语）
考勤	业务链统称	≠ 打卡（单次动作）
打卡	一次具体的动作	≠ 归寝（状态判定）
归寝	当晚在寝/晚归/未归的判定结论	≠ 考勤（更宽）
五路来源	学生打卡、宿舍长、宿管、闸机、人脸	缺一不可
预警	系统按规则识别的异常事实	≠ 通知（广义）
告警	预警经通道派发的送达形态	≠ 消息（站内一条）
记录	单条事实	≠ 快照（某一时点）
快照	某一时点的完整状态	≠ 档案（时间排列）
档案	一个人的所有记录按时间排列	≠ 画像（维度聚合）
画像	一个人的所有记录按维度聚合的判断视图	≠ 360 画像（更专）
智能预排	已投产；只读预览、评分可回放、人工确认落库	≠ 智能分配（外部口语）
自动分配	按批次执行的五步流程	≠ 智能预排（更专）
治理	让规则清晰、责任可追、数据可用	≠ 管理（日常运转）
底座	名单进得来、床号对得齐、台账理得清	十年前的能力，不宣讲

C.2 三档表述口径

档	允许写法	禁止写法
写实（已投产）	具体规则、代码级细节、数字	加"部分支持""计划中"
写批次（接口在、真实实现待补）	"接口已就位""按投产前批次补齐""列投产前批次"	已有、内置、全面支持
写范围（明确不做）	"我们不做这件事""别的方案里请自行评估"	空白、空壳、没做、缺失

C.3 边界与不承诺表述

明写"不做"或"依赖外部"——避免使用方误以为本系统兜底：

• 自研人脸识别、活体检测、防替考级算法。
• 无感通行分析。
• 一键智能分配投产。
• 实时增量同步。
• AI 助手已上线、对话式查询可用。
• 多渠道短信触达、邮件通知、微信模板消息。
• 支持所有主流教务系统。
• 客户案例、现场照片、试点学校名单。

C.4 禁词清单

互联网黑话（一律改用日常动词）：

• 一切将业务动作包装成军事或商业隐喻的说法（具体清单以 OUTLINE D.1 与这本书 46.1 节的完整列表为准），一律改用日常动词。

技术内幕词（不入正文；政策原文名与招标可核验数字例外）：讲架构层与运维层的名词一律不进入正文，改说业务人员日常词汇（具体清单以 OUTLINE D.1 为准）。

内部痕迹（禁止出现在正文）：

• 章内自指（第一人称指涉自己的章节段落）与把使用方写成第二人称的表述。
• 状态标记符号与内部编号（对勾、新增、扳手、叉号及 plan 编号）。
• 指向纪律条款的引用（"按 D.4 三档表述""见 D.6 基线表"）。
• 章末附录式小尾巴（"验收时看什么""自查表""阅读地图"）。
• 取证状态自述（"该数据无法核实，所以我们不写百分比"）。
• 立论块、标签块、无编号 ### 小节。

作者自称：指涉全书用"这本书"；不使用其他章内自指与第二人称表述。

C.5 数字口径速查

唯一真源是 D.6 基线表；任何一处数字与其他章节不一致，评审者立即有理由怀疑整份材料。

术语	数字	统计口径
控制器	71	后端控制器目录里的 *.cs 文件
端点	795	网络接口方法特性声明逐条计数
业务管理器	111	Domain/Managers/（含成员 7 个）
数据模型与传输对象文件	115	Domain/Models/
业务实体	91	数据上下文里的实体集合声明去重
前端页面	139	views/**/*.vue；管端 100 + 移动 20 + 教师 9 + 学生 7 + 通用 3
权限码	55 在用 / 57 目录	后端拦截值 / 菜单展示值
幂等迁移脚本	18	Domain/Migrations/*.sql
定时任务处理器	3	自动考勤、质量扫描、归寝异常
数据质量规则	5	一人多占、性别不符、离校在住、证件校验位、通行无主
归寝异常检测器	3	连续未归、作息突变、同寝连带
集成连接器	5	通用接口门禁、海康设备协议、两种单点登录、教务学籍同步
地图服务	5	OpenStreetMap、CARTO、天地图、高德、百度
认证链	12	本地、CAS、OIDC、企业微信、超星、微哨系 ×4、为笑、DS7
实时推送通道	2	站内消息、大屏推送
后台服务	5	设备管理、设备同步、自动考勤、通知推送、大屏推送
组织层级	6	学校→校区→学院→专业→班级→…
考勤来源	5	学生打卡、宿舍长、宿管、闸机、人脸
住宿状态	5	无记录、在寝、晚归、未归、假期
大模型出口	4	分配解释、约束式查询、问数、周报草稿
测试文件	17	backend/tests/

统计一律排除：bin/ obj/ node_modules/ dist/。

C.6 品牌口径

"明·如归"：

• 正式全称：明·如归（中文中间点，无空格、无引号、不加粗）。
• 页眉与章首引用块：明·如归 · 宿舍管理白皮书。
• 正文单用：明·如归 或 这套系统。
• 不写成："明如归""明 · 如归"以及任何英文或拼音形式。
• 不承诺口号："如你所归、如你在 home"等半中半英表达；"如归"两字承担全部情感重量。
• "如归"三件事：知道该找谁、说了有人应、应对有留痕。超出这三件事的品牌描述都是虚的。

C.7 版本与批次

• 正文只用"批次"（P1–P6）指代交付节奏，不用版本号。
• 具体发布日期、内部任务编号、里程碑代号——不写入正文，属合同与变更日志。
• P1 底座 → P2 日常运转 → P3 治理与判断 → P4 智能化 → P5 外部接入 → P6 模型接入；顺序不能颠倒。

C.8 常见误用对照

给评审、写合同、写验收的同志最常用的一页速查。左列是评审材料里最容易看到的写法，右列是这本书定义的正确写法。

常见误写	正确写法
AI 一键分完	智能预排 + 人工确认落库
已接入所有主流教务	5 个连接器已实证、其他按连接器框架扩展
支持多渠道消息	站内 + 实时推送 + 企业微信；短信/邮件按批次
无感通行	闸机与人脸作为第五路考勤来源
数据实时同步	全量对账 + 幂等复跑；增量按批次
全面字段加密	口令与最小必要项已加密；扩面按批次
完整的权限体系	55 个权限码 + 双层控制（前端菜单 + 后端接口）
智能预警	三检测器 + 四元组去重 + 五层送达
一整套自动化	三处理器 + 幂等四道防护 + 手动兜底
AI 助手	大模型四出口（当前是测试桩）
支持各种身份源	12 种认证链已投产 + 本地口令保底
独家地图能力	5 家地图 + 同时仅一家启用 + 坐标互转

这份对照表可以直接抄进合同的技术附件。合同上写左列、系统实际是右列——评审和验收时就会起争执；合同上写右列、每一行都能当场演示。

C.9 三条关于术语与口径的常见误解

误解一：术语是文风问题。术语是责任边界。合同上写"AI 智能分配"、系统做的是"只读预览的智能预排"——这两者不是一件事、评审和验收时会有完全不同的判定标准。写"AI 智能分配"意味着厂商要承担自动落库的准确率责任、写"只读预览"意味着所有出错都能被人工拦下。术语的差别就是责任的差别。

误解二：数字口径小差异没关系。795 与"大约 800"、55 与"50 多个"、18 与"接近 20"——在白皮书与合同里是完全不同的表述。精确数字意味着可核验、模糊数字意味着可推诿。厂商敢写精确数字、说明他知道自己做了什么；写模糊数字、说明他自己也没统计过。

误解三：品牌口径不影响功能。恰恰相反——"明·如归"这四个字的写法本身就是产品立场的表达。中文中间点是"这不是一个英文缩写、不是云平台代号、不是技术栈标签"。写成"明如归"、写成任何拼音形式、写成首字母缩写——这些写法每一次都在把这个产品往"通用技术品"的方向推。品牌口径守的是产品定位。

C.10 一句话收口

术语与品牌不是文字问题，是可核验性问题。任何一个词飘起来、任何一个数字漂移、任何一个承诺超出边界——评审者就能把整份材料归到"营销文案"那一堆里。速查表存在的意义，是让这本书始终站在"能对账"的那一侧。