研发库房管理 H5 — 冷启动文件

版本: 2.3 ｜ 更新: 2026-08-30 ｜ 用途: 研发库房样品出入库管理系统的冷启动/重建/排障手册
⚠️ 功能保全铁律（用户 2026-08-30 定稿）：本系统功能只增不减，改版前先读本文件“功能清单”，改完按“改版验证清单”逐项验证，功能不允许丢失。
⚠️ 测试铁律（用户 2026-08-30 强调）：测试必须用独立库（STORE_DB=/tmp/store_test.db + STORE_PORT=13599 起独立实例），严禁操作生产库；测试数据必须即时删除清理，严禁残留污染生产数据（曾两次残留被用户发现）。
地址: http://82.156.85.124:13545/store/ ｜ 服务: rd-store.service（systemd，:13545）
数据库: /home/ubuntu/docs/store/store.db（SQLite，samples/requests/history 表，软删除保留历史）
附件: /home/ubuntu/docs/store/attachments/ ｜ 前端: ~/.hermes/scripts/rd_store.html（单文件零外链）｜ 后端: rd_store.py

<code> 物料编码（A+10位数字，唯一，自动随机/手动/反查）

 ↓

样品入库登记（新样品，全字段+图纸+备注，数量→生成个体编号 N1~Nn）

 ↓

出库申请（选样品显示详情+选编号，默认顺序，备注信息）→ 审核人批准 → 生成准出编号（ZC-YYYYMMDD-NNN）→ 扣库存

 ↓ 测试后重新入库（申请-审核制，三种模式）

原样品（原物归库）/组合样品（新建）/组合样品（原物归库）→ 填写审核人 → 📨 提交入库申请（待审核）→ 审核人批准 → 执行入库（恢复在库/新建组合样品/各准出编号抵消台账）

 ↓ 破坏性测试报废

销毁申请（按准出编号）→ 输入准出编号→确认→显示对应样品信息→审核人批准→该编号作废(已销毁)

 ↓

领料人台账：出库挂人名下，未抵消 = 出库总量 - 归还总量 - 销毁总量（销毁也抵消）；最新记录在上 <code>

• samples 表（软删除）：id/data(JSON)/deleted/deleted_at/created_at
• data 含：id/name/material_code(A+10位唯一)/model/spec/supplier{name,addr,phone}/waybill/qty/project/purpose/in_time/operator/photo/status(新样品|入库留样保存)/location/drawing/remark(备注追加不覆盖)/combine/units[](个体编号N1~Nn: no/status/pass_no/out_log[])/compose_pass/hist[](出入库历史含备注)
• requests 表：申请记录（kind 出库|销毁 / sample_id/qty/units[](编号)/receiver/auditor/status/pass_no/settled(台账抵消)/settle_time/note(备注)）
• history 表：出入库流水（note 含“审核批准，备注：xxx”）

• 物料编码：A+10位数字，样品唯一标识；自动随机生成（去重50次）或手动录入；已有编码拒绝重复建档并显示该物料全部信息
• 个体编号：数量 N → 生成 N1~Nn；出库按编号（默认顺序=最小在库编号），重新入库按编号匹配；追加数量编号顺延
• 准出编号：ZC-YYYYMMDD-NNN，审核批准时生成；只有贴准出编号样品可做研发测试（测试才有效）；每次出库须重新申请生成新准出编号
• 销毁：按准出编号销毁（申请校验编号存在/未销毁/未归还+防重复申请）；批准后该编号作废；已销毁编号不可再销毁/重新入库/出库
• 台账抵消：原样品/组合样品原物归库 → 各准出编号 settled=true；未抵消 = 出库总量 - 归还总量 - 销毁总量（销毁也抵消）
• 审核人默认武燕青（所有申请表单自动填入，可改）
• 销毁原因写入销毁申请备注（审核中心可见）
• 申请全部显示备注（出库/销毁/入库，待审核+已处理列表均显示）
• 备注：出库申请“备注信息”贯穿样品历史/流水/台账；样品备注追加不覆盖
• 库存只走出入库/销毁流程；删除样品=软删除（历史保留可恢复）
• 历史保护：编辑只改白名单字段；SQLite+软删除+git 三重保障

<code> 重启：sudo systemctl restart rd-store.service 日志：journalctl -u rd-store.service -n 50 防火墙：腾讯云轻量 13545 TCP（lhins-1dai07vu ap-beijing） 数据库：sqlite3 ~/docs/store/store.db（samples 表 deleted=1 即回收站） 测试隔离：STORE_DB=/tmp/store_test.db STORE_PORT=13599 venv/bin/python rd_store.py（独立实例，测完删库） 前端改完即生效（读文件）；后端改完需重启 <code>

• 人员选择 = 文本框下拉列表（2026-08-30 用户定稿）：所有人员字段（操作人 iOp/bOrigOp/cOp/apOp、领料人 oRecv、审核人 oAud/dAud、申请人 dRecv）均用 combo 组件：
• 下拉选项 = 钉钉通讯录全量（/api/store/meta 的 people，实时拉取+快照兜底）
• 点击/输入文本框 → 弹出下拉（输入即时过滤），选择后自动收起（comboDDs）
• 下拉用普通流布局（不绝对定位）→ 不遮挡下方内容，展开时推挤下方
• 可自定义输入新人员（文本框）
• 项目选择（iProj/oProj）同 combo 组件（历史项目列表）
• combo 绑定列表维护位置：fillDatalists() 中 `['iOp','oRecv','oAud','dRecv','dAud','bOrigOp','cOp','apOp']`——新增人员字段必须同步加入此列表（曾因 bOp 改名漏绑导致原样品/组合入库人员无下拉）
• 样品选择下拉：名称后不加括号内容（曾导致用户无法选择编号）；出库编号下拉只显示纯编号
• ⚠️ fillDatalists 必须用 setDL 安全填充（元素不存在不报错）——曾因删除 hisMat datalist 导致 combo 绑定全部中断
• ⚠️ getElementById 赋值前必须判空——销毁改准出编号后 dSamp 删除导致 renderSampSelect 中断、出库编号下拉空白（用户无法选编号）
• 页面禁缓存（meta no-cache + 服务端 no-store）——微信缓存旧 JS 曾导致下拉空白/样品不存在

<code> ① 8 个人员字段 combo 绑定正常（iOp/oRecv/oAud/dRecv/dAud/bOrigOp/cOp/apOp）——点输入框弹出钉钉全量下拉，选中自动收起 ② fillDatalists 无 null 报错（必须用 setDL 安全填充）；renderSampSelect 无 null 报错（getElementById 判空） ③ 主流程走通：入库→出库申请(选编号)→审核(准出编号)→重新入库申请→审核批准执行(台账抵消)→按准出编号销毁；审核人默认武燕青 ④ 物料编码：自动生成格式 A+10位 / 手动查重 / 反查显示物料信息 ⑤ 样品档案：搜索/筛选/详情/软删除→回收站→恢复/追加数量 ⑥ 台账：未抵消=出库-归还-销毁；最新在上；备注显示 ⑦ 数据不丢：SQLite 软删除 + git 提交 ⑧ 测试用独立库（STORE_DB/STORE_PORT），测完删库，生产零污染 <code>