库存、借还与常用货架
本页说明物品进入实验室后的处理方式，包括查库存、借用、归还、常用货架、手动补录和批量导入。
库存管理页
库存管理页集中展示普通库存；订单记录和常用货架分别保留在对应页面。
主要用途
- 搜索名称、CAS 号、品牌、分类和位置。
- 从实验步骤中识别试剂并查询库存。
- 查看规格、剩余量、状态和备注。
- 借用库存。
- 手动入库。
- 编辑库存信息。
- 查看单个库存的操作记录。
- 删除库存条目。
- 导出库存。
访问权限
所有已登录账号均可进入库存页。
公用账户可以查库存、借用、归还和编辑库存基础信息。手动入库、删除库存和批量导入需要使用非公用账号。
借用前检查项
借用前，系统会检查状态和数量。历史记录缺少规格或剩余量时仍可登记借用，后续归还时补齐规格和最终剩余量。
检查项包括：
- 当前状态是否还能借
- 已知剩余量是否大于 0
同一条记录被他人先借走时，页面可能提示刷新后再试。
公用账户借用时
- 普通用户可以直接借用。
- 公用账户也可以借用，但要先选真实借用人。
公用账户不能作为实际借用人。
借用后的状态变化
借用成功后，这条库存通常会变成借用中，借用人和时间也会更新。系统会留下借用记录，方便后面归还和追踪。
归还入口
个人账号的日常归还从仪表盘的 当前借用 进入。
公用账户代登记借用后，借用记录绑定到实际借用人。
当前借用字段
- 名称
- CAS 号
- 规格
- 借用时剩余量
- 借用时间
- 借用人
点开一行后，还能看到英文名、别名、入库时间、入库用户、上次借用信息和备注。
归还填写方式
归还时通常有两种填法。
填使用量
适用于已知本次使用量，且借用时剩余量明确的场景。系统会根据借用时剩余量减去使用量，计算新的剩余量。
填剩余量
适用于仅知道当前剩余量的场景，直接填写当前剩余量即可。
共同要求
不管用哪种方式，结果都不能小于 0，也不能超过原来的规格。
缺少规格的历史借用记录会要求先补规格，再提交归还。最终剩余量为 0 时，可在归还弹窗中删除该借用库存，删除动作会写入库存操作日志。
归还后剩余量过低时，系统可能提示及时补充。
归还权限
基本规则是：
- 借用人本人可以归还。
- 管理员可以代为归还。
- 其他普通用户不能替别人归还。
所以公用账户借用时，真实借用人一定要选对，不然后面会影响归还。
查看库存操作记录
所有已登录账号都可以查看单个库存的操作记录：
- 在库存列表中展开目标库存。
- 点击“上次借用”右侧的 记录。
- 进入
/inventory/{内部码}页面查看按时间倒序排列的记录。
页面标题旁会显示库存名称、CAS 号和存放位置。名称过长时会自动截断，鼠标悬停可查看完整内容。
操作记录只展示三类：
- 入库：显示入库规格和入库操作人。
- 编辑：摘要显示发生变化的字段；展开行后显示修改前后的值。
- 借用：显示借用规格、借用人和“借用中”或“已归还”状态。归还状态与归还后剩余量会更新到原借用记录，不新增第二条记录。
搜索框可以匹配操作人和详情摘要。点击任意记录行可以展开更完整的信息。
页面只读取主数据库，不查询归档库；底部的“仅显示近期记录”表示归档中的更早操作未纳入，实际可见范围以主数据库当前保留的记录为准。
常用货架说明
常用货架与普通库存并不相同，可理解为对常用、共享或高频取用试剂的独立归组，便于按组查看。
分组方式
常用货架通常会按这些信息来整理：
- CAS 号
- 品牌
- 规格
- 存放位置
页面按组展示摘要；每一瓶的记录可从分组详情中查看。
显示内容
- 可用瓶数
- 总瓶数
- 已耗尽瓶数
- 分组状态
- 其他同组名称
- 备注
分组状态
- 有库存：还有可用的瓶。
- 快用完：这组里有快耗尽的物品。
- 已耗尽：这组已经没有可用瓶了。
“拿一瓶”操作说明
当某组还有可用瓶时，页面可能会出现 拿一瓶。
与借用操作的区别
“拿一瓶”会将一瓶常用试剂直接记为消耗。执行后，该瓶会被标记为已耗尽，剩余量清零，并留下相应记录。
后续仍需归还时，不应使用该操作，而应走普通库存的借用流程。
常用货架可执行操作
已登录用户通常可以：
- 查看常用货架
- 新增常用货架条目
- 补录或维护 CAS 主数据（名称、英文名、别名）
- 编辑分组
- 删除整组（仅管理员）
- 导出分组
“拿一瓶”（扣减 1 瓶）登录用户即可操作。
手动补录类型
库存管理页的“手动入库”
这个操作会创建普通库存，适合：
- 刚到货但没走订单流程的物品
- 线下原本就有、现在想补录进系统的物品
- 需要直接进入正式库存并参与借还管理的物品
公用账户不能使用库存管理页的“手动入库”。
常用货架页的“手动添加”
这个操作会直接创建常用货架物品，适合：
- 公共试剂补录
- 需要按组展示、按瓶消耗的常用品
如果系统提示“该 CAS 还未录入主数据”，先在常用货架页点 CAS 主数据管理 补齐名称信息，再继续本次手动添加。
这两种方式的共同点
- 都会检查 CAS 信息。
- 都会按规格和瓶数创建记录。
- 都需要先登录。
- 普通库存手动入库需要非公用账号。
批量导入
批量导入直接创建库存记录，订单数据由订单页面和购物车导入流程维护。
支持的文件
.csv.xlsx.xls
文件限制
- 单个文件不能超过 2MB。
页面支持的操作
- 下载模板
- 查看字段说明
- 拖拽或点击上传
- 预览并校验待导入记录
- 确认导入
- 查看成功和失败结果
- 查看错误明细
公用账户不能使用库存批量导入。
结果判读
预览页会分别显示：
- 总行数
- 成功数
- 错误数
- 错误明细
存在错误时无法确认导入。确认阶段会重新执行完整校验，并以全有或全无的事务方式写入；预览令牌仅限发起预览的用户使用，有效期为 15 分钟且只能消费一次。完成后建议回库存页抽查关键物品。
使用建议
如果是集中补录或整理台账，通常建议由管理员或指定维护人员处理。
搜索和筛选建议
库存、试剂订单和耗材订单的普通搜索支持半角空格分词。多个词需要命中同一业务字段，最多 8 个词。CAS 字段支持使用 && 连接多个精确 CAS，多个 CAS 之间按任一命中处理。
在库存列表里
建议优先顺序是：
- 先搜 CAS 号。
- 再搜中文名。
- 还不确定时，再补英文名、品牌、分类和位置。
这样做主要是因为 CAS 号最不容易重名，而名称和位置更容易出现不同写法。
在常用货架里
除了名称外，也可以重点搜：
- 别名
- CAS 号
- 品牌
- 分类
- 位置
利用展开行
如果列表里看不够清楚，可以展开一行看看更多信息，比如英文名、别名、创建人、入库时间和备注。
从实验步骤查库存
非公用账号可在库存页打开 实验步骤查库存，粘贴实验记录并解析试剂名称与 CAS。解析结果会带回库存页，详情见 实验步骤查库存。
操作流程
从查库存到借用再归还
- 先在库存里搜 CAS 号或名称。
- 看清规格、位置、剩余量和状态。
- 点击借用。
- 如果是公用账户，先选真实借用人。
- 借用后由实际借用人在仪表盘的当前借用查看。
- 实验结束后由实际借用人在当前借用里归还。
- 按使用量或剩余量提交。
已有实物，但系统里还没有
- 普通库存使用非公用账号去库存页手动入库。
- 常用公共试剂去常用货架页手动添加。
- 补齐名称、CAS、规格、数量和位置。
- 保存后回列表确认是否出现。
批量补录库存
- 使用非公用账号进入导入数据页。
- 先下载模板。
- 先用少量数据试导入。
- 确认没问题后再导完整文件。
- 完成后回库存页和常用货架抽查。
使用排障
库存可搜索但常用货架不可见
常用货架只显示已纳入常用货架流程的物品。完整记录请在库存管理页查看。
常用货架显示瓶数
这里重点展示“还能拿几瓶”，不展示每一瓶的精细剩余量。
“拿一瓶”后不可归还
该动作会直接记为消耗。
不可代他人归还
归还与借用人绑定。只有借用人本人或管理员可以完成。