鼠仓 MouseKeeper — 实验小鼠管理工作站

目的：研究员进入动物房前，在浏览器上即看到所有房间笼位占用、每笼鼠数与待办标记，替代"挨个掀笼卡"。

触发：任何成员打开"笼位"页，选择房间与笼架。

处理规则：

• 笼位格显示：笼号、在养鼠数；鼠标悬停/点按展开笼详情面板；
• 笼格颜色语义：空笼 = 白；正常 = 蓝边；有未完成提醒（待断乳/待分笼/待鉴定）= 黄边黄底；
• 选中空笼位可发起"放入新笼"；选中占用笼可发起"移动笼子到空位"；
• 笼详情面板列出每只鼠：ID、性别（公蓝/母粉）、日龄、基因型徽标、状态标记。

结果与状态变化：移动笼子即时持久化并写入笼位历史（笼子 X 于 T 时刻从 A1 移至 B4，操作人 Y）。

异常：目标笼位已被占用时移动按钮置灰并提示"该笼位已占用"；笼架无数据时显示空态引导"先创建房间与笼架结构"。

目的：每只鼠一页档案，聚合身份、谱系、鉴定、所属计划与操作历史，是全局检索与扫码跳转的落点。

触发：建档（手动录入 / 从窝次批量生成仔鼠档案）、笼位面板点击鼠 ID、扫码跳转。

处理规则：

• 手动建档：必填字段见 3.2 表；外购鼠允许填"周龄"反推出生日期并标记 约；
• 从窝次生成：选择窝次 → 按存栏数（经数量修正后）输入公/母数量 → 批量生成档案，自动继承父母本品系、出生日期=窝次出生日期、初始笼位=繁殖笼；
• 档案页时间线倒序展示全部事件：换笼、鉴定、配种参与、计划分配、终态（含快速登记死亡的两段留痕，见 FR-8a）；
• 检索支持 mouse_id 精确、品系/基因型/计划/状态组合筛选。

字段可编辑性：出生日期、性别、来源在存在下游事件（鉴定、繁育）后锁定，可解锁修改（留痕）；终态小鼠档案整体只读。

异常：删除档案仅允许"无任何下游事件且建档 24h 内"的情形，二次确认后执行；其余情况以"淘汰"终态替代删除，保证谱系不断链。

目的：换笼间里戴手套不方便打字 —— 手机扫笼卡二维码后，三步内完成当日现场操作。

触发：手机浏览器进入"扫码"页调起摄像头；扫出笼 ID 或鼠 ID。

扫出笼子后的操作面板（按频次排序）：

1. 快速换笼：扫新笼位或从空位列表选择 → 确认；
2. 观察记录：选择预设项（正常/精神差/打斗受伤/死亡）+ 可选备注；选"死亡"→ 进入 FR-8 登记流程：死因已知时直接选择完整死因枚举；现场无法判断时选用快速登记（初判 + 归因确认，见 FR-8a）；
3. 产仔登记（繁殖笼专属入口）：输入仔鼠数与出生日期 → 生成窝次；
4. 查看本笼待办：跳转 FR-6 该笼的未完成提醒。

结果与反馈：每次操作返回绿色成功条并震动一次（Assumption, TBD：目标机型支持浏览器震动 API）；连续扫码模式下成功条 1.5 秒后自动回到摄像头，支持不换页连续处理多笼。

异常：扫出未注册 ID → 提供"以此 ID 现场建档"入口；摄像头不可用（权限拒绝/老旧浏览器）→ 降级为手动输入笼号；网络中断 → 操作进入本地待同步队列并在顶部显示"待同步 N 条"，恢复后自动重传（防换笼间信号死角丢数据）。

目的：谁和谁配、哪天合的笼、仔鼠哪天该断乳、祖代是谁 —— 全部可追，替代研究生个人备忘录。

触发：创建繁育对（选 1 公 + 1~2 母 Assumption, TBD：支持 1 公 2 母合繁）；产仔登记；分笼/结束繁育对。

处理规则：

• 繁育对要求参与者均为在养、未处于另一"合笼中"繁育对；
• 产仔登记后生成窝次 L-编号，仔鼠档案按 FR-2 批量生成，谱系自动挂接父母；
• 1 公 2 母笼内产仔时，母本归属允许标记"不确定"，谱系树中该窝母本显示"母A 或 母B"，待基因型鉴定后可人工确认修正；
• 谱系视图：以任意鼠为中心，向上两代、向下两代渲染谱系树；点击节点跳转档案；
• 近交提示：所选公母在谱系树两代内存在共同祖先时，创建繁育对页面显示黄色提示（不阻断，仅提示）。

异常：参与繁育的任一方进入终态时，其"合笼中"繁育对自动置为"已结束"并生成一条提醒通知创建人。

目的：把"送检-回收结果-按结果分笼"从 Excel 三张表合并成一条流水线。

流程：从窝次或筛选结果勾选小鼠 → 生成送检批（检测项目如 Cre PCR，系统生成送检清单含鼠 ID 与取样要求）→ 结果回收时逐条录入阳性/阴性/杂合/无效 → 档案基因型更新、谱系同步、"待鉴定"提醒关闭。

处理规则：

• 结果录入支持按送检清单顺序的键盘速录模式（+/-/±/F 四键）；
• "无效"结果自动重新挂入该鼠待办"需重新取样鉴定"；
• 分笼辅助视图：同一窝次按鉴定结果分组列出，勾选目标基因型 → 一键分配新笼并生成换笼操作记录。

目的：把日期驱动的工作从人脑迁移到系统待办。

展示：首页待办列表按到期日升序；笼位看板对应笼格变黄；每日 8:00 向相关操作人生成站内汇总（无邮件/IM 推送，Assumption, TBD：团队接受进系统看）。提醒被处理后关闭；到期未处理每天重复置顶，不产生升级通知（死亡归因确认除外，见 FR-8a）。

目的：伦理年审时一键回答"这个编号下实际用了多少只鼠、都是谁、怎么处理的"。

触发：PI 创建计划并填写伦理编号与批准上限；成员将小鼠分配至计划。

处理规则：

• 分配校验：仅在养小鼠可分配；一只小鼠同时只属于一个进行中计划；
• 实际用鼠数 = 该计划下已进入任一终态的小鼠数（含快速登记的死亡，与安乐死口径一致；死因未确认不阻断计数，报表单列「原因待确认」数量），只读，实时回写；
• 当实际用鼠数达到批准上限的 90% 时，计划卡片与首页显示黄色预警；达到 100% 时阻断新的分配操作并提示"已达伦理批准上限"，须修改批准上限（留痕）后才可继续；
• 计划关闭（完成/中止）后其小鼠保留关联，只读。

目的：终态登记是合规证据链的最后一环，必须"原因必填、操作留痕、数量回写"。本节定义完整登记流程（含完整死因枚举与撤销规则）；现场无法判定死因时的快速登记见 FR-8a。

触发：档案页、扫码工作台、或筛选列表批量选择 → "登记离群"。

处理规则：

• 三选一终态：已用于实验（安乐死）/ 自然死亡 / 淘汰；
• 原因必填：预设枚举（实验终点 / 人道终点-发病 / 人道终点-体重下降 / 基因型不符 / 超龄 / 其他-备注必填）；
• 批量登记时对每只鼠继承同一原因，可逐只修改；
• 确认弹窗列出将受影响的小鼠清单与所属计划，输入确认文字 确认 后执行；
• 执行后：状态置终态、笼内移除、实际用鼠数回写计划、时间线写入操作人/时间/原因；
• 撤销（当日留痕撤销）：
  • 「已用于实验」与快速登记（初判）的「自然死亡」：登记当日可撤销，不限定操作人（防误操作毁数据、容纳低体温蛰伏等误判，见 FR-8a）；
  • 直登完整死因的「自然死亡」与「淘汰」：不可撤销（产品判断：这两类死因明确、不存在误判空间，撤销反而破坏审计链）；
  • 所有撤销均留痕，用鼠数同步回退。

目的：动物福利要求尸体及时移出（登记不能被任何确认流程阻塞），但现场往往无法立即判定死因。本模块提供快速登记（初判）模式，设计原则是「事实与归因分离」：死亡是客观事实 → 登记即生效；死因是实验数据 → 由最了解实验语境的分配人在 48h 内补全。系统不设权限限制，本模式对所有成员开放——选择它的是登记策略，而非身份。

触发与范围：任何成员在扫码工作台（FR-3）或档案页选择「快速登记（初判）」。初判记录的状态同样立即生效；后续补全死因走归因确认闭环。范围仅限「自然死亡」——「已用于实验（安乐死）」与「淘汰」是明确决策，始终走 FR-8 完整登记。

处理规则：

与其他模块的衔接：

• S-1 留痕：快速登记记录采用双操作人结构——发现人与归因确认人，时间线分两段、只增不改；
• FR-8 撤销：快速登记（初判）记录登记当日可撤销，不限定操作人；
• FR-7 用量核算：快速登记死亡计入实际用鼠数，与完整登记口径一致。

异常汇总：扫错鼠/笼 → 当日撤销（留痕）；对已终态个体重复登记 → 状态机拦截并提示"该鼠已终态"；误判复活 → 场景③分支 B 流程。

目的：月度盘点时用手机连续扫笼卡，系统自动比对"账面在养"与"实际扫码"。

处理规则：开始盘点 → 连续扫码累积清单 → 结束后生成差异报告（账面有而未扫到 / 扫到但账面已终态 / 位置不符）→ 差异项逐条处理（确认死亡补登记 / 修正笼位）。盘点期间系统只读提示其他成员暂缓批量操作。Assumption, TBD：盘点为月度频率。

目的：把 colony 健康的三个关键指标——死亡率、基因型性别比、HE/WT 比例——从 Excel 手工汇总变为实时聚合视图，支撑繁育决策（保留/合并哪些繁育对、品系是否存在生存或传递问题）。统计页为只读聚合，无独立录入；数据来自 FR-8/FR-8a 终态记录与 FR-5 鉴定结果，口径统一见 S-7。

1) 死亡率

• 指标：月度死亡率 = 当月死亡个体数 ÷ 当月平均在养数（S-7）；支持按品系、房间、月龄段、死因分类下钻；
• 视图：近 12 个月趋势、品系对比、死因构成比；快速登记且死因未确认的死亡计入死亡率分子，但在死因构成中单列「原因待确认」，不与确认死因混算；
• 除零保护：期间在养数为 0 时显示「—」，不显示 0%。

2) 基因型性别比

• 口径：按「有效鉴定结果 × 建档性别」交叉聚合，输出每种基因型的公/母数量与占比（S-7）；
• 视图：品系 → 基因型 → 公母计数与百分比；支持按窝次批次查看；
• 用途：X 连锁传递或性别致死偏离时直接可见（如某基因型公鼠占比持续异常低），辅助繁育对取舍。

3) HE/WT 比例（孟德尔期望对比）

• 口径：按繁育对/窝次聚合已鉴定子代的基因型分布，与配型的孟德尔期望对比；系统内置常见配型期望表（杂合×WT = 1:1、杂合×杂合 = 1:2:1、纯合×杂合 = 1:1），支持课题组自定义配型期望；
• 偏离预警：有效样本 ≥ 8 只且实际占比相对期望的偏差超过阈值（默认 1/3，S-2 可配 Assumption, TBD）时，繁育对卡片标黄并提示可能原因（纯合致死 / 鉴定错误 / 样本偏倚）；预警只提示不阻断；
• 视图：单繁育对分布条形图 + 跨窝累计分布。

异常：鉴定「无效」结果不计入任何比例的分母（S-7），避免拉偏统计；筛选条件下无数据时显示空态「暂无符合条件的记录」。