duxingchen/KCGL
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,016 Commits 5 Branches 0 Tags
ba5394f70cf2ccb97fbee01c38f9cd892fbdb736
Commit Graph

321 Commits

Author SHA1 Message Date
yueli
8d83d4404e fix(borrow): 恢复选中审批单后的「一键带出」，并补上领用人自动回填 
现象
----
借库执行页选中一张已通过的审批单后，下方的「预计归还日期」「备注说明」
不再自动带出；「领用人」在改为用户下拉后也恒为空，库管每次都得手工补填。

根因（不在前端下拉框，而在后端持久化）
----
borrow_service.submit_approval 会把 reserve_for_items() 的返回值直接
set_items() 落库 —— 即审批单的 items_json **就是预占结果**。

而 reserve_for_items 内部是 `reserved.append({...})` **重建**字典，只保留
库存定位与数量，把申请端按明细传上来的 expected_return_time / is_indefinite
全部丢弃。执行页读的正是 firstItem.expected_return_time，读不到就落到
「清空」分支。

这是 2026-09-10 库存预占改造引入的回退：

    b57c21a  fix 前:  approval.set_items(items)           # 原始申请明细
    b57c21a  fix 后:  approval.set_items(reserved_items)  # 重建字典，字段丢失

数据完全吻合该提交的上线时刻（09-10 14:59）：
    最后一张「有日期」的审批单  id=40  创建于 09-10 09:30
    第一张「丢失日期」的审批单 id=41  创建于 09-10 16:20

修复
----
1) inventory_reservation.reserve_for_items：透传申请「意图字段」
   （expected_return_time / is_indefinite / remark）到预占结果。
   · 一条申请明细会被拆到多个批次行（同物料多批次），故按 base_id 建索引，
     把同一份意图回填到它拆分出的每一行；
   · **只透传意图，不透传库存定位与数量** —— 实扫可能换批次，
     这里写什么执行页就按什么释放，绝不能覆盖分配结果；
   · 跳过 None：无限期借用提交的 expected_return_time 本就是 null。

2) borrow.vue handleApprovalChange：实现领用人自动回填
   · 口径差异：审批单上的 borrower_name 是**完整 username**
     （「杜邢宸/duxingchen」），人员名单返回的是展示名（「杜邢宸」）。
     两边归一化到「斜杠前段」再比对，否则永远匹配不上；
   · borrower_name 优先，匹配不到才回退 applicant_id —— 库管代建时申请人是
     库管本人，回退到它会选错人；
   · 名单加载改为可重复 await：选中单据时要拿它反查，名单没回来就比对会
     误判为「找不到」而清空；
   · 匹配不到时保持未选，不回退到自由文本 —— 借用人 ID 是转交/归还责任链的
     唯一锚点，宁可让库管手选也不能猜。

可编辑性
----
三个字段均保持可改：领用人下拉、备注文本框无 disabled；日期选择器仅在勾选
「无限期/长期借用」时置灰（原有语义，取消勾选即可重新填写）。

影响与验证
----
· 存量：仅 1 张待执行审批单（id=46）受影响，其日期在库中已无任何留存，
  无法回填，需库管手工补一次；已完结单据不受影响。
· 回归：reserve_for_items 透传 9 项断言、submit_approval 端到端 5 项断言
  全部通过；库存精确还原、无残留数据。
 2026-09-17 09:26:42 +08:00
yueli
f7c49f41a8 fix(borrow): 统一归还/报废时间口径为北京时间，并修正过期注释 
时间口径（与归还流水同时引入，故随本轮一并修）
----
process_return 与 scrap_sources.deduct 原用 datetime.now() 写 return_time，
而 datetime.now() 取的是**容器本地时间**（Docker 下为 UTC）；同一行的
borrow_time 却由 beijing_time() 写入 —— 两个字段差 8 小时，台账时间线
自相矛盾，并会让新做的流转时间线出现「先借出、后归还，却显示归还更早」
的倒序假象。

统一改用 beijing_time()，并与新增的归还流水共用同一个时间戳，保证主表快照
与流水逐笔完全对齐。

（与 db_migrations/unify_approval_timezone.sql 处理的是同一类问题：aware/naive
与本地/北京时间的口径混用。）

注释修正
----
borrow_service.submit_approval 的 docstring 写着「仅存储意向，不扣库存」，
但 Phase 1 起该函数已调用 reserve_for_items() 预占库存（扣 available_quantity）。
过期注释会误导后续开发者（尤其是做转交的人以为库存没动过），已改写为实际的
预占语义与三种释放路径（驳回 / 撤回 / 扫码执行）。
 2026-09-17 09:18:02 +08:00
yueli
cccd6f6081 feat(borrow): 转交接口、身份ID锚点与流转时间线后端 
责任链收口
----
· execute_dispatch：强制 borrower_id，姓名一律由 sys_user 反查，**不回退**到
  申请单姓名 —— 申请单上的姓名是「申请意向」，与扫码时实际来领的人本就可能
  不同（库管代建场景尤甚），回退会让 current_holder 从第一刻就记错人。
  同时落库 dispatch_operator，补齐「谁经手发货」。
· process_return：新增 returner_id，记录有 current_holder_id 时强校验二者相等，
  不符即整单回滚（原实现只要持有 op_return:operation 即可归还任何人借出的
  物品，函数内从不读取 borrower_name，归还环节责任链是断的）；
  每次归还写 trans_borrow_return 流水；全量归还清空 current_holder
  （borrower_id 保留作历史）。
· transfer_borrow（新）：整单全量转交，写转交流水 + 推进主表 current_holder。

为什么一期只允许整单全量转交
----
trans_borrow 是单行模型，只能存一个 current_holder_id。部分转交（借 10 转 5）
会让这一行同时表示两个人，语义直接撕裂，且归还时无法判定该由谁还。
若未来需支持，必须改为按数量**拆行**（新建一条承接转出量、原行扣减），
而不是在单行上加字段打补丁。

为什么转交绝不触碰库存
----
借出期间 available 已冻结、stock 仍含借出未还量（deduct_stock=False）。
转交若动库存，会同时破坏两个既有假设：「归还只加 available」会算多，
「借库转报废在确认损失时扣 stock」（scrap_sources.BorrowScrapAdapter）
会重复扣减。

接口
----
· POST /borrow/<id>/transfer      转交（borrow_transfer 权限 + 防抖锁 + 行锁）
· GET  /borrow/<id>/history       单品流转历史（供精确追溯）
· GET  /borrow/slip/<no>/history  整单时间线（实测单号最多 21 条明细，
                                  逐条调用会产生 21 个请求，故聚合返回）
· GET  /borrow/users              人员名单（借出/转交/归还共用，公司隔离）

一个隐蔽缺陷（本轮发现并修复）
----
整单时间线初版按展示用的时间字符串排序，而该字符串截断到**秒** —— 同一秒内的
连续动作（如「转交 A→B 紧接着转交 B→C」）会退化为并列，顺序取决于数据库返回
顺序，时间线随机错乱。已改为按真实 datetime 排序，并加回归用例锁定。
 2026-09-17 09:17:57 +08:00
yueli
58fa42bff3 feat(scrap): 报废全链路收口到审批流 
系统自陈的规则是「报废一律需审批」（SCRAP_ALWAYS_REQUIRES_APPROVAL = True），
但实际有 4 条写 TransScrap 的路径，其中 3 条绕过审批。本提交把三条旁路
全部收口，只保留「申请 → 审批 → 执行」一条写入路径。

【删除】直接报废 POST /api/v1/scrap
  同时移除 ScrapService.process_scrap()。该路径的一个连带影响是
  「维修件报废」能力随之消失 —— process_scrap 的 trans_repair 分支是
  repair_status='报废转出' 的唯一写入点。实测该能力零使用（报废转出 0 条、
  trans_scrap 来源 0 条），且早已半死：审批流的扫码校验会拒绝 trans_*
  来源。repair_service.py 的误导文案（原文指引操作员「前往报废管理进行
  扫码操作」，而那条路根本不通）已改为「维修件报废暂未开放」。
  权限元素 scrap_create:operation 保留不删 —— add_scrap_perm.sql 以它为
  scrap_apply/scrap_execute 的授权来源。

【改造】借库转报废 POST /borrow/scrap → POST /borrow/scrap-request
  TransService.scrap_borrow() 删除，逻辑迁入 BorrowScrapAdapter。
  沿用 op_return:operation 权限（零授权变更）。已归还/已报废的记录改为
  **直接报错**，不再静默 continue 返回 count=0（原缺陷：用户以为成功）。

【改造】不良品报废 POST /defective/<id>/scrap → POST /defective/<id>/scrap-request
  申请时**不预占** remaining_qty（与报废模块「仅锁定意向，不扣库存」的
  既有哲学一致）。副作用：同一批坏件可重复提交多张申请单，执行期由适配器
  按 Fail-Closed 拒绝超额的那几张。已在该接口注释与前端提示中写明。

【服务层】ScrapApprovalService 接入来源适配层
  - submit_approval 改由 get_adapter() 分派，并新增整单 scrap_mode 一致性
    校验（混合「需扫码/免扫码」两类来源直接拒绝，让 execute 分流保持简单）
  - _build_scanned_index 的来源校验改为 is_scan_source()：语义上是**收窄**
    而非放宽，扫码通道永远不接纳 trans_* 来源
  - execute 按模式分流：scan 项走原有扫码匹配（索引只由 scan 项构建），
    auto 项按批准量执行。签名与调用契约不变。
  - _match_key 加入来源表：不良品 SKU 是从原库存行复制的，不带来源时
    同一张单里的两者会**必然串键**，扫码量算到错误对象上。纯库存单两侧
    同源、键仍匹配，对既有流程零行为变更。

【修复】approve() 的 fail-open
  原实现 `if user_entries and str(operator_id) not in user_entries` ——
  allowed_approvers 为空时条件短路为假，**任何登录用户都能审批**。
  这与「报废一律需审批」直接矛盾，留这扇门等于没有审批。改为无名单即拒绝。
  已实测存量「无审批人」的在途单为 0 张，不会卡死历史数据。

【扫码通道】scrap/scan 的 trans_repair 分支改为 trans_defective_goods
  在管不良品按 SKU 匹配，在管量回填到既有字段形状，前端无需按来源分支。

【清理】scrap_approval_service 的 _stock_models 与 TransScrap 导入已移除
  （来源差异全部收敛到适配层）；trans_service / inventory_reservation 中
  指向已删方法的注释已更新指向 BorrowScrapAdapter。
 2026-09-16 17:14:17 +08:00
yueli
e4d2b2ec68 feat(scrap): 报废来源适配层（纯新增，零行为变更） 
把「报废来源差异」从审批服务里抽出来，为后续把借出未还、在管不良品
接入审批流铺路。

背景
----
报废审批流原先只认三张库存表（ScrapApprovalService._stock_models 硬编码），
导致另外两类来源只能各走直报接口绕过审批 —— 与系统自陈的
「报废一律需审批」（SCRAP_ALWAYS_REQUIRES_APPROVAL）冲突，构成职责分离
漏洞：同一个库管可自行宣告实物销毁而无人复核。

三类来源的语义差异
------------------
  维度        库存行            在管不良品        借出未还
  执行模式    scan              scan              auto（免扫码）
  可报废量    available_qty     remaining_qty     quantity-returned
  扣减        available 与      只动在管台账，    只扣 stock_quantity
              stock 同扣       不碰任何库存表    （可用量已在借出时冻结）
  成本        沿用现口径        defective_unit_cost  0/0

★ 为什么在管不良品保留扫码、借出未还免扫码：
  坏件实物就在仓库里、有 SKU，扫码是有效的「申请报 A、实际毁 B」防护；
  借出物在借用人手上，物理上不可能扫到，且执行只改台账与总库存、
  不产生任何可被挪用的可用库存，风险等级不同量级。

其他要点
--------
- defective_unit_cost() 从 api/v1/inbound/stock.py 迁入本模块：服务层不得
  反向 import API 层。复用 inventory_reservation.stock_model_map()，
  避免第四份库存表字典。
- 提交期新增 submit_guard 钩子，用于修复「提交只校验 available、执行却校验
  both」的校验不对称（会出现申请通过、执行必失败的单据）。
- is_scan_source() 对未知来源返回 False（Fail-Closed）：扫码通道只接纳明确
  声明为 scan 的来源，杜绝 trans_repair 那类「扫得到、执行却拒绝」的错配。

本步不触碰任何现有路由，现网仍走老路径，可独立评审与验证。
 2026-09-16 17:14:05 +08:00
yueli
fbc9296056 feat(stock): status 硬隔离与出库通道封堵 
激活库存表长期「只写不读」的 status 列，使其成为分配准入的硬门槛。

- inventory_reservation: 新增状态语义单一事实来源（STOCK_STATUS_*/
  allocatable_filter/is_allocatable）；verify_scanned 增加状态准入校验
  （覆盖出库与借库两条提交路径）
- outbound: _allocate_bom_requirements 过滤条件加 allocatable_filter，
  非「在库」一律不进入候选集；扫码路由把 ValueError 转为 400
- outbound_service: create_outbound_batch 强制 request_id 必填。原先无单
  时会跳到所谓「散单」分支，而该分支的扣减逻辑从未落地（注释点名的
  _apply_reservation_override 全仓不存在），实测只写台账不扣库存，
  同一批货可被反复出库；get_stock_by_barcode 接入扫码准入；维修单扫码
  补排除「报废转出」；预占再平衡块补 rollback 兜底
- fill_missing_stock_status.sql: 把存量行刷回「在库」。该过滤是
  Fail-Closed 的，不先洗刷会让全库无法出库

破坏性变更：不传 request_id 的出库请求现在会被拒绝。
 2026-09-16 15:45:02 +08:00
yueli
97ff63523c fix(export): 公司隔离移出 if filters 判定，确保无条件执行 
export_excel 的行级公司隔离原本嵌套在 `if filters:` 内部：
只要调用方不传或传空筛选条件，整段隔离会被跳过且不抛错 —— 静默失效。
（实测: 修复前 export_excel({}, None) 会导出跨公司全部 1816 行。）

现把 get_current_company_filter() 及其 filter_conditions.append 提到
if filters: 之前，无论有无筛选条件都绝对执行。

同时清理路由里 filters 字典的 'company' 死键 —— export_excel 从不消费它，
真正生效的是 get_current_company_filter() 直接读 request.args 上的公司标识。

注意：前端 handleExport 的 company 参数必须保留（已在代码中加注说明）。
实测 WAREHOUSE_MGR 带 ?company=IRIS 导出 1126 行仅 IRIS，不带则 1816 行
涵盖 IRIS+LICA —— 跨域角色按公司收窄范围完全依赖这个 query 参数。

实测(修复后):
  SALES/IRIS          filters={}          → 1126 行, 仅 IRIS
  SALES/IRIS          filters={keyword:''}→ 1126 行, 仅 IRIS
  WAREHOUSE_MGR       ?company=IRIS       → 1126 行, 仅 IRIS
  WAREHOUSE_MGR       (无参数)            → 1816 行, IRIS+LICA
 2026-09-11 12:41:27 +08:00
yueli
d69a77cec1 fix(export): 补上 export_excel 缺失的表头定义 
GET /api/v1/inbound/base/export（物料页「导出库存统计」）在
base_service.py 里执行 ws.append(headers)，而 headers 全文件从未赋值，
每次调用必抛 NameError，导出功能 100% 不可用。

按 _write_stock_rows 实际写入的 22 列顺序补齐表头，命名对齐同仓库
inbound_summary_service 与 stock.py 的既有报表。

实测: 容器内导出成功 203282 字节，1817 行（含表头），表头与数据行
均为 22 列，未出现串列。
 2026-09-11 11:44:35 +08:00
yueli
06cb5f1cac fix(reservation): 实扫来源不可识别时整单失败，避免预占永久锁死 
出库与借库两条执行路径原先写作：

    _scanned = [i for i in items if i.get('source_table') != 'trans_repair']
    if _scanned:
        verify_scanned(...); restore_then_deduct(...)

`if _scanned:` 为假时校验与释放被整体跳过，而下方仍无条件把单据置为
status=3（已完成）。此时申请阶段 reserve_for_items() 扣掉的 available_quantity
无人归还，且 status=3 之后 /close（要求 status==1）与 /withdraw（要求
status∈(0,1)）都拒绝再释放 —— 预占就此永久锁死，成为谁也领不走的幽灵库存，
且没有流水可供追溯。

改为 Fail-Closed：实扫明细的来源必须全部落在 model_map 内，否则整单失败。
事务回滚后单据保持 status=1、预占原样保留，库管可重试执行，或走驳回/撤回 ——
任一路径都能正常归还预占。

- outbound_service.create_outbound_batch：以 model_map 白名单过滤，
  并要求 _scanned 非空
- trans_service.execute_dispatch：先显式校验来源合法性并列出非法值，
  再要求 _scanned 非空
 2026-09-11 10:34:55 +08:00
yueli
a8a3c82331 fix(stock): 补行级防穿仓与入库改量下限，杜绝可用数变负 
available_quantity 一旦为负，预占/释放/盘点的全部算术都会失真。此前有两处
缺口，本次一并堵上，使 available_quantity >= 0 成为不变量。

1) 执行阶段逐行扣减无下限校验（inventory_reservation.restore_then_deduct）

   物料级校验只保证「Σ实扫 ≤ Σ可用」这一总量关系，拦不住「总量守恒但单行
   穿仓」：同物料下 A 批可用 2、B 批可用 8，工人把 5 件全压在 A 批上，总量
   5 ≤ 10 通过，A 批却被扣成 -3。借库走 deduct_stock=False，连实物数校验都
   跳过，是裸扣。

   已实测复现：借库与出库路径均可把单行扣成 -3。

   校验放在 release_reserved() 之后，故不会误拒合法的换批次（物理覆盖）：
   释放后每行 available 已含本单预占，扫自己预占过的批次时 raw >= 0 保证
   必然放行；改扫其它批次时，该批次实时可用量就是它自己的上限。

2) 下调入库数量可把可用数压成负（buy/product/semi 三处 update_inbound）

   按 diff 同步增减 stock/available，但无任何下限检查。该批次若已有部分被
   预占/出库/借出，向下调整即产生负可用数。现在下调前校验可用数是否够扣。
   正常数据下 stock >= available 恒成立，故守住 available 同时守住 stock。

配套：三个 update_* 端点此前只捕获 Exception → 500，没有 ValueError 分支
（同文件的 delete_* 早就有）。补上 400 分支，使业务校验失败不再被记成
服务端故障。

验证（事务内执行并回滚，未落库）：跨批次穿仓被拦、合法换批次放行、全额执行
本单预占批次放行、下调击穿被拦（API 返回 400，三个端点一致）、上调不受影响、
真实借库单 52 行全额执行正常、全库无负可用数。
 2026-09-11 10:34:15 +08:00
yueli
cbcedecba2 fix(outbound): 扫码/备选库位回加本单预占，修正可用数重复计数 
出库选单提交申请时 reserve_for_items() 会立即扣减 available_quantity（预占，
防超卖），但扫码页拿到的仍是这个已被本单扣过的值，并当作「本单能扫多少」的
上限。对本单而言它自己锁掉的货当然该能扫，于是同一批货被算了两次：

  · 某行被本单占满时 available=0，工人直接扫不进去，提示「库存不足或已出库」
  · /alternatives 按 available_quantity > 0 过滤，被本单占满的行从列表消失
  · 草稿恢复时刷新实时库存，误报「实际库存已少于你扫的数量」

改法：扫码阶段的可用量 = 实时可用量 + 本单在该行的预占量。别人单子的预占
不回加，防超卖能力不丢。该值与后端 restore_then_deduct() 释放预占后用于校验
的数字精确相等，是同一口径而非近似。

后端：
- inventory_reservation.py 新增 reserved_index()/reserved_qty() 纯读工具
- outbound.py 新增 _own_reserved_index()，改造 /scan 与 /alternatives
- outbound_service.py 的 _format_scan_result 返回归一化可用量

两道门禁：
- biz_type 区分出库/借库两张审批单（独立表、ID 空间独立，而两个端点被
  出库页与借库页共用），否则借库单 ID 会命中另一张出库单
- 单据状态仅放行 status ∈ {0,1}。set_items() 只在创建时调用，执行/驳回后
  items_json 里的 reserved=True 仍原样保留而库存早已归还，门禁一松就会
  二次回加 → 真超卖（现有 3 张已完成单据即属此形态）

不满足门禁时静默降级为不回加（fail-closed），并回传 reservation_applied。
 2026-09-11 10:34:00 +08:00
yueli
f702a70fe5 fix(borrow): 借出只冻结可用数，不再扣减实物库存 
问题
----
上一轮库存预占改造（b57c21a）把借库执行改用了 restore_then_deduct()，
而该函数是按**出库语义**设计的（物品永久离开仓库），会同时扣减
available_quantity 与 stock_quantity。借库是可逆的，于是产生两个缺陷：

1) 借出再归还后，实物库存永久少一份
     初始   (stock=20, avail=20)
     借出5  (stock=15, avail=15)
     归还5  (stock=15, avail=20)   ← 实物没回来，丢了 5

2) 借出后转报废会重复扣减
   scrap_borrow 的注释明确写着「扣减总库存（该物品确认损失）；
   可用库存已在借出时冻结，无需重复扣」—— 它假设借出**没动实物**。
   借出已扣 stock 后，转报废再扣一次：
     借出5  stock=15 → 转报废 stock=10（正确应为 15）

修复
----
restore_then_deduct 增加 deduct_stock 参数：
  出库 deduct_stock=True （默认）—— 可用数、实物数同时扣
  借库 deduct_stock=False          —— 只冻结可用数，实物数不动

★ 这是**恢复原有设计**，不是新设计。git 历史显示从最初的
  04ee938 借库逻辑实现 起，历经 7ef22a3 / 83b3db6 / b79b0f9 /
  2556b77 / 1527d55 六次提交，一直是：
      stock.available_quantity = float(stock.available_quantity) - qty
  （只减可用，不动实物）。b57c21a 把它替换掉了。

  盘点的差异计算也印证了该口径的正确性：
      adjusted_stock_qty = stock_quantity - 借出未还
      diff_qty = 实盘数 - adjusted_stock_qty
  这段逻辑要求 stock_quantity **包含**借出未还的实物，否则会重复扣减。

最终语义
--------
  stock_quantity     = 账面实物总数（含借出未还）
  available_quantity = 实际可取用数

  出库申请(预占)  —    available ↓
  出库执行        stock ↓  available ↓
  借库申请(预占)  —      available ↓
  借库执行        —      available ↓
  借库归还        —      available ↑
  借库转报废      stock ↓  —

实测（stock, available）
------------------------
  借还循环：初始(20,20) → 借出5(20,15) → 归还5(20,20)  完全可逆
  出库：    预占4(20,16) → 执行(16,16)  实物确实减
  转报废：  借出3(20,17) → 转报废(17,17)  实物减一次，不重复
 2026-09-11 09:39:20 +08:00
yueli
33acdc758c fix(scan-draft): 撤回申请单时清理其扫码草稿 
问题
----
草稿按 (user_id, biz_type, request_id) 存储，而撤回逻辑原先只做两件事：
释放预占、把状态置为 4。没有任何草稿清理 —— 撤回后草稿成为孤儿数据：

  · 单据状态变为 4，不再出现在扫码页的下拉里（那里只拉 status=1），
    草稿从此永远读不到；
  · 若不清理会持续累积，每行是一个整单 JSON 快照。

实测（撤回前 2 份草稿）：撤回后该单草稿数归 0。

★ 清的是**所有用户**在这张单上的草稿，而非仅撤回者自己的 ——
  可能有多人扫过同一张单，只清自己的会留下他人的孤儿数据。

出库 outbound_service._release_and_close
借库 borrow_service._release_and_close
两处共用底层，一并补上。
 2026-09-11 09:06:43 +08:00
yueli
e93107458a feat(purchase): 采购列表支持关键词搜索与日期范围 
背景
----
采购管理此前只有状态筛选，无法按单号/物料/申请人检索，也无法按采购
日期收窄范围。现对齐出库/报废记录的搜索语义，便于用户迁移使用习惯。

后端
----
PurchaseService.get_purchase_list 新增参数：
  keyword / search_type / start_date / end_date

search_type 取值（与出库、报废一致）：
  all          单号 | 物料名称 | 规格型号 | 备注 | 申请人
  no           单号
  name         物料名称
  spec_model   规格型号
  requester    申请人

实现要点
--------
· 申请人姓名存在 SysUser.username，格式「姓名/账号」（如 韩善龙/hanshanlong），
  ilike 直接匹配整串即可命中；
· 该类字段只在 SysUser 上，故**按需 join** —— 单号/名称/规格分支不联表，
  避免无谓开销；
· 公司隔离分支也需 join SysUser，与关键词分支可能重复 join 同一目标，
  会产生笛卡尔积导致结果翻倍，故按需补 join 并用 distinct 兜底；
· 日期范围按 purchase_date 过滤（该列是 Date，无需补时分秒）。

实测：名称'充电器'→1 单，申请人'韩善龙'→21 单，日期 05-13→2 单，
      关键词不存在→0 单，状态+搜索组合→14 单。
 2026-09-10 17:41:22 +08:00
yueli
077fd2f2cf feat(borrow,scrap): 补齐申请人撤回端点，与出库对齐 
背景
----
出库已有独立的申请人撤回端点（仅 @jwt_required + 服务层归属断言），
但借库/报废没有：

  · 借库撤回复用 close 端点，权限是 op_borrow_approval（管理路径），
    普通员工调用返回 403；
  · 报废撤回带 @permission_required('scrap_apply')，同样挡住普通申请人
    （scrap_apply 只授予 INBOUND/OUTBOUND/SUPERVISOR/SUPER_ADMIN）。

结果是「我的申请单」页面里，借库/报废的撤回按钮对普通员工点了报错。

借库
----
服务层拆成与管理路径并列的两条入口（与出库同构）：

  mark_completed     —— 管理路径，需 op_borrow_approval，仅 status==1
  withdraw_request   —— 申请人路径，仅校验单据归属，status 0 或 1

两者共用 _release_and_close()，释放逻辑只有一份实现。
新增 POST /transactions/borrow/request/<id>/withdraw（仅 @jwt_required）。

报废
----
withdraw() 增加 require_owner 参数区分两条路径：
  require_owner=True （默认，申请人路径）→ 断言 applicant_id == operator_id
  require_owner=False（管理路径）        → 由调用方权限装饰器鉴权
WITHDRAWABLE_STATUS 从 (1,) 放宽到 (0, 1)，与出库/借库对齐。
移除端点上的 @permission_required('scrap_apply')，改走归属校验。

安全实测
--------
  借库 B 撤 A 的单 → 403，库存仍是 27（未被释放）
  借库 A 撤自己的单 → 200，30 完全释放
  报废 B 撤 A 的单 → 403
  报废 A 撤自己的单 → 200
  主管代撤员工的单（特权路径）→ 200
 2026-09-10 15:46:55 +08:00
yueli
bcbee8a194 feat(outbound): 申请人撤回自己的申请单 + 我的申请单端点 
背景
----
出库审批页是管理视角（需 outbound_approval 权限），普通申请人提交后
**没有任何入口看回自己的单据**，更谈不上撤回。

服务层：抽出共用释放逻辑
------------------------
新增 OutboundApprovalService.withdraw_request()，与既有的 close_request()
（管理路径）形成两条独立入口：

  close_request     —— 管理路径，需 outbound_approval 等权限，仅 status==1
  withdraw_request  —— 申请人路径，仅校验「单据归属」，status 0 或 1 均可

两者各自完成权限与状态校验后，调用**同一个** _release_and_close()。
释放逻辑只有一份实现，不会因修改其中一处而漏掉另一处。

为什么单独开一条路径，而不是在 close_request 里加 if 分支：
  权限模型不同（管理角色 vs 单据归属）。混在一个函数里，后续修改容易
  互相影响 —— 这正是需要避免的访问控制风险。

API
---
POST /outbound/request/<id>/withdraw   申请人撤回（仅 @jwt_required）
  · 归属断言：非本人且非特权 → 403「无权撤回他人的申请单」
  · 状态守卫：仅 0/1 可撤回；执行成功后 status 会被置 3，故该判断
    本身即执行守卫，已执行或已撤回的单都进不来

GET  /outbound/my-requests             我的申请（仅 @jwt_required）
  · applicant_id 硬编码为当前登录用户，不接受任何入参覆盖

两者都**不做模块权限校验** —— 普通申请人无需持有 outbound_approval
（那是管理权限）。与「给审批端点加 if 降级放行」是两条路：后者把管理
逻辑与用户逻辑混在一个端点里，一旦 is_privileged_viewer() 判定出错
即越权；本端点从设计上就没有「看别人」的分支。

安全实测
--------
  普通员工查我的申请（此前 403）        → 200
  B 查列表看不到 A 的单                → 39 单中无 A 的单
  B 撤回 A 的单                        → 403，且库存未被释放
  A 撤回自己的单                       → 200，库存 17→20 完全释放
  主管代撤他人工单                     → 200（特权路径）
  待审批(status=0) 撤回                → 200，库存释放
  重复撤回                             → 400「当前状态不可撤回」
 2026-09-10 15:36:59 +08:00
yueli
9925bf2b99 fix(inventory): 撤回/作废单据时释放预占库存，消除库存泄漏 
问题
----
系统原本已有「完结」功能（出库/借库），但它只改状态、不释放预占：

    approval.status = 4   # 已完结
    db.session.commit()   # ← 库存没还回去

申请阶段 reserve_for_items() 扣掉的 available_quantity 就此永久泄漏 ——
货被一张永不执行的作废单锁死，谁也领不走。

核查存量 23 张 status=4 的单，所幸均为预占改造前提交（items_json 无
stock_id），尚未造成实际损失。但缺陷本身是真实的。

改动（三个模块统一）
--------------------
出库 outbound_service.close_request
借库 borrow_service.mark_completed
  · 调用 release_reserved(approval.get_items()) 按 items_json 原样归还；
  · 明确「仅 status==1（已通过待执行）可撤回」—— 执行成功后
    create_outbound_batch / execute_dispatch 会把 status 置为 3，
    故该状态判断本身即执行守卫，已执行或已撤回的单都进不来；
  · 返回消息带上释放条数，便于操作者确认。

报废 scrap_approval_service.withdraw（新增能力）
  · 报废原先只有 approve/reject，没有撤回入口，补齐；
  · 复用同一个 release_reserved()：报废当前尚未接入预占，调用它会安全
    跳过（无 reserved 标记），但将来报废接入预占时该段代码自动生效；
  · 新增端点 POST /api/v1/scrap/request/<id>/withdraw（权限 scrap_apply）。

未采用按流水表二次校验：request_no(APR-OUT-…) 与 outbound_no(OUT-…)
格式不同、无关联字段，按单号比对是无效的，状态判断已足够。

实测
----
决定性用例（证明释放真实生效，非账面功夫）：
  A单预占5 → available=1
  B单要5   → 400 拒绝（被A占住）
  撤回A    → available=6
  B单再要5 → 200 成功，available=1     ★ 释放的库存真的可被复用

三模块：
  出库 撤回后 4→10 完全恢复，stock 未变（货没动）
  借库 撤回后 6→10 完全恢复
  报废 撤回成功，重复撤回被正确拒绝

状态码说明：报废复用出库/借库已有的 4=已完结 作为「已撤回」，
而非引入 -1，避免同一系统出现两套编号（其 2 已被「已驳回」占用）。
 2026-09-10 15:08:32 +08:00
yueli
b57c21a4cd feat(inventory): 库存预占生命周期，消除出库/借库超卖 
问题：库存超卖
--------------
改造前出库/借库申请只记录「要什么、要多少」，不绑定具体库存行，
真正的 available_quantity 扣减发生在执行阶段。于是多张申请可以同时
claim 同一批货，等到工人拿扫码枪时才发现货已被别人领走。

生命周期（三阶段）
------------------
  提交申请（预占）  reserve_for_items()
     用分配器把需求落到具体库存行，立即扣减 available_quantity，
     并把 (stock_id, source_table, allocated_qty, reserved) 写回 items_json。

  驳回（释放）      release_reserved()
     遍历 items_json 把预占量还回池子，避免货被永不执行的单永久占住。

  扫码执行（覆盖）  verify_scanned() + restore_then_deduct()
     校验实扫身份/数量未超批准范围 → 释放全部预占 → 对实扫批次
     同时扣减 available_quantity 与 stock_quantity。

身份键：base_id 主键 + SKU 兜底（重要设计决策）
-----------------------------------------------
本系统中 SKU 是**批次级**编号：同一 base_id 下每个入库批次各有不同的
SKU（实测 stock_buy 有 183 个物料是多批次的，如 base_id=2405 下有
0000001685 与 0000001974 两个 SKU）。

若以 SKU 作为身份主键，「申请时锁定 A 批、工人现场改扫 B 批」会被判为
身份不符而拒绝 —— 恰好否定了「物理覆盖」这个核心能力。
故改用 base_id（物料级、跨批次稳定，spec_model 由其唯一确定），
历史数据无 base_id 时降级为 (name, spec_model)。

可用量校验按物料汇总，而非按单批次
----------------------------------
开发中修正的一处缺陷：若逐行要求「该批次可用量 >= 该批次扫码量」，
工人改扫小批次时会被误拒。例如本单预占 A 批 5 件，改扫 B 批 2 件 +
C 批 3 件，B 批自身只有 2 件可用，逐行校验即失败。实际这 5 件都是本单
锁定的货，理应允许。现按物料汇总校验可用量，按行校验实物库存。

改动文件
--------
· 新增 app/services/inventory_reservation.py（通用服务层）
· outbound_service.create_request     —— Phase 1 预占
· outbound_service.approve(reject)    —— Phase 2 释放
· outbound_service.create_outbound_batch —— Phase 3 覆盖（移除原逐行扣减）
· borrow_service.submit_approval      —— Phase 1
· borrow_service.approve(reject)      —— Phase 2
· trans_service.execute_dispatch      —— Phase 3，并用统一身份键替换
                                         原有的 (name, spec_model) 字符串匹配

实测（真实 HTTP 全链路）
------------------------
初始 available=10
  ① 提交申请(需5)   → 200，available 10→5    预占生效
  ② 审批通过        → available 仍为 5        预占保留
  ③ 扫码执行(改扫另一批次 4 件) → 200
     原批次恢复满额、实扫批次扣减(0,0)，available=6, stock=6

单场景验证：预占 A 批改扫 B 批放行；驳回后可用量完全恢复；
           扫其他物料被拒；批准 6 扫 8 被拒。
 2026-09-10 14:59:10 +08:00
yueli
fd0bfd3d9c feat(records): 借还记录接入高级筛选 
复用 app/utils/advanced_filter.py 的解析与谓词逻辑：
  · 父级字段（单号 borrow_no、借用人 borrower_name）走标准 SQL 谓词
  · 子级字段（SKU、物料名称）经单号子查询过滤，否定操作符走 NOT IN 整单排除
  · 物料名经三表联查（buy/semi/product JOIN material_base）

借还的单号维度查询基于 order_subq 子查询分页，故此处把过滤条件施加在
order_subq.c.borrow_no 上，与既有的状态/日期/公司隔离过滤保持同一层次。

前端 records.vue 新增「高级筛选」el-popover（字段/操作符/值 + 添加条件/
应用筛选/重置），序列化为 advancedFilters JSON 字符串随查询下发。

验证：sku ne 0000000002 → 52 单（库中无单含该 SKU，正确不减）；
      sku contains 0000 → 52 单（52 单的 SKU 全部含 0000，数据巧合）。
 2026-09-10 13:06:03 +08:00
yueli
e437b3cece feat(records): 高级筛选引擎 + 出库记录接入 
一、新增共享工具 app/utils/advanced_filter.py
  系统内已有该模式（material/list.vue、stock/inbound/buy.vue），
  沿用其既有约定：参数名 advancedFilters、值为 JSON 字符串、
  操作符 eq/ne/contains/not_contains/ge/le。

  · parse_advanced_filters() 解析并规整，坏输入退化为空列表不影响主查询
  · build_predicate() 单条件 → SQLAlchemy 谓词，未登记字段返回 None 杜绝列注入
  · build_material_name_select() 物料名三表联查（buy/semi/product JOIN material_base）

二、★ 父子关系处理（本次核心）
  记录接口返回的是**按单号分组的订单**，而用户筛选字段多落在**明细行**上。
  若直接 .filter(TransOutbound.sku.ilike(...))，会在 GROUP BY 前收窄明细范围，
  展开行里的兄弟明细会凭空消失。正确做法是先求「含匹配明细的单号集合」
  再让主查询按单号 IN 过滤。

  实测对照（单 OUT-20260811-1519-0003，21 条明细）：
    按其中一条 SKU 筛选 → 子查询法保住全部 21 条；直接 filter 只剩 1 条。

三、★ 否定操作符语义（NOT IN）
  子级字段的 ne / not_contains 不能直接用 SQL != / NOT LIKE —— 那表达的是
  「本单存在某条不等于 X 的明细」，多明细单几乎必然成立，等于筛选失效。
  用户意图是**整单排除**，故 apply_child_condition() 统一：
    肯定 → order_no     IN (含匹配明细的单号)
    否定 → order_no NOT IN (含匹配明细的单号)
  两者子查询完全一致（都用肯定形式谓词），仅外层取反。
  父级字段（单号/操作人）仍走标准 SQL 谓词，语义无歧义。

四、出库记录接入（前端弹窗 + 后端接线）

验证：
  eq 0000000002 → 1 单；material_name contains 白板 → 16 单
  sku ne 0000000002 → 394 = 395-1，含该 SKU 的单被整体排除
  material_name not_contains 白板 → 379 = 395-16
 2026-09-10 13:05:59 +08:00
yueli
c35ec9a659 feat(records): 出库/借还记录统一高级搜索版式 
三个记录页（出库/借还/报废）此前搜索区形态各异：出库用裸 div + 分散样式，
借还缺日期范围，报废只有 SKU 输入框。现统一为 el-form :inline="true" +
.filter-form 版式，并补齐缺失的过滤维度。

借还记录（新增日期范围能力）：
  · 后端 get_records 增加 start_date/end_date 参数，按「借出时间」过滤；
  · 边界补全时分秒（YYYY-MM-DD → 当日 00:00:00 / 23:59:59），
    与出库记录同口径，解决零点截断导致当天记录漏查的问题；
  · API 层透传两个新参数。

出库记录：
  · 版式统一为 inline 表单，日期选择器加 label；
  · 新增「重置」按钮；
  · 搜索类型切换由 500ms 防抖改为立即查询。

借还记录：
  · 新增「重置」按钮；搜索类型/状态切换改为立即查询（取消防抖）。

实测（SUPER_ADMIN）：
  报废 全部/单号/SKU/操作人/物料名/日期 六类过滤均 200 且命中正确；
  借还 无过滤 52 单 / 本月 18 单 / 空区间 0 单（日期过滤生效）；
  出库 无过滤 395 单 / SKU 277 / 姓名 7 / 物料名 16 / 单号 OUT-2026 命中 395。
 2026-09-10 12:06:08 +08:00
yueli
e152f16ebc feat(scrap): 报废一律需审批，不再按物料标记区分 
业务规则变更：所有报废申请都必须由指定审批人审批通过后才能执行。

原逻辑走 resolve_approval_control 判定是否需审批，而 material_base 表中
仅 1/3012 个物料标记了 is_approval_required，意味着 99.97% 的报废申请会
走免审批分支——status 直接置 1、actual_approver_id 被赋为申请人自己、
审批人参数被静默丢弃。前端即便做了必填也只是摆设。

改动（规则收敛到单一来源）：
  · 新增 SCRAP_ALWAYS_REQUIRES_APPROVAL = True，作为唯一开关；
  · submit_approval() 无审批人一律拒绝；恒置 status=0（待审批）；
    删除免审批自动通过分支；
  · resolve_approval_control 仍调用，但仅用于生成提示文案，
    不再参与是否审批的判定；
  · /request/check-approval 返回 need_approval=SCRAP_ALWAYS_REQUIRES_APPROVAL，
    否则该接口会继续返回 false，导致前端预检结果失真。

实测：不传审批人 → 拒绝；传审批人 → status=0 且 actual_approver_id 为空。
⚠ 注意：此前自动通过的单据今后一律进入审批队列。
 2026-09-10 11:32:51 +08:00
yueli
ed351f96ec refactor(scrap): 按单执行校验改用 SKU 主键匹配 
架构要求以 SKU 为唯一校验键，原实现按 (source_table, stock_id) 匹配。

已核验数据前提：SKU 在同一库存表内唯一（0 重复），且不存在跨表重名
（stock_buy / stock_semi / stock_product 交叉 0 冲突），故 SKU 可安全
作为跨来源标识。

改动：
  · 新增 _match_key()：SKU 非空时以 'sku:<SKU>' 为键；个别历史库存行
    SKU 为空，回退 'row:<table>#<id>'，前缀区分确保绝不串键；
  · _build_approved_index() 按 SKU 聚合，累加批准量并保留各行的
    source_table + stock_id（rows 列表）；
  · 校验拆为两步并给出明确文案：SKU 是否在批准明细内、同 SKU 累计量
    是否超批准量；
  · ★ 扣减改为按批准单配对的 source_table + stock_id 定位库存行加锁，
    不再信任前端传来的 stock_id —— 实测前端传伪造 stock_id=99999 时，
    仍从批准单指定的库存行扣减，台账同样记录批准单的 stock_id；
  · 同一 SKU 在批准单占多行时，按批准顺序依次分配扣减量。

实测 7 项校验用例 + 多行分配 / 批准行已删除 / 可用不足 均符合预期。
 2026-09-10 10:21:50 +08:00
yueli
7719943779 feat(scrap): 报废执行改为按单扫码校验，废弃盲执行 
execute() 原先只吃 request_id，按申请单快照全量扣减，用户反馈「扫码与报废脱节」。
现改为接收实扫明细 scanned_items：

  · 强制按单：未提交实扫明细一律拒绝执行；
  · 键为 (source_table, stock_id)，与申请单 items_json 同口径，
    同一物品多次扫码自动累加，兼容「逐件扫」与「输数量」两种操作；
  · 校验实扫项必须落在批准明细内，且累计量不得超批准量，否则整单拒绝；
  · 允许合法子集（少扫 = 本次不报废该行）；
  · 扣减以实扫量为准，同时扣 available_quantity 与 stock_quantity
    （报废即实物销毁，上一版只扣可用库存会让总库存虚挂）。

接口 POST /scrap/request/<id>/execute 由无 body 改为接收 {items:[...]}。
 2026-09-10 10:14:40 +08:00
yueli
b4b79c68a9 fix(borrow): 借库转报废实物不足时报错回滚，不再夹断到 0 
原逻辑在 stock_quantity 减为负数时直接置 0。但借出时已扣减过
available_quantity，夹断会使 available_quantity > stock_quantity，
凭空多出可用库存，后续出库/借库可继续占用这批并不存在的实物。

改为不足即抛 ValueError，与同一事务内其余校验一致，整单回滚。
 2026-09-10 10:14:36 +08:00
yueli
8755837fe8 fix(timezone): 审批单据时间统一为 naive 北京时间，消除 8 小时偏差 
成因：approved_at / executed_at 列是 timestamp without time zone，而赋值用了
带时区的 datetime.now(timezone(timedelta(hours=8)))。psycopg2 对 naive 列不会
剥掉 tzinfo，而是转成 naive UTC 再写入，结果比同为北京时间的 created_at 早 8 小时。
（代码里并无 datetime.utcnow()，真实成因是 aware 值被驱动的隐式 UTC 转换。）

改动：
  · outbound_service / borrow_service 的审批分支
    datetime.now(beijing_tz).replace(tzinfo=None) → beijing_time()
    （免审批分支已在上一轮改为 beijing_time，此处补齐审批分支）；
  · purchase_service 审批/完结分支同源缺陷一并修复；
  · scrap_approval / scrap_approval_service 的 _beijing()、_beijing_now() 由
    tz-aware 改为 naive —— 配合上述迁移把列类型改为 naive，
    若仍返回 aware 值，timestamptz→timestamp 后会反向早 8 小时。

实测四表（scrap/outbound/borrow/purchase）created_at 与 approved_at 差值
均在同一秒内（-1ms ~ -12ms）。
 2026-09-10 10:14:31 +08:00
yueli
8b61cdb67d fix(approval): 需审批判定改为 base_id → SKU → 名称+规格 三级降级 
原判定仅有 base_id 与「名称+规格字符串」两级，出库申请明细只有 name/spec、
无 base_id，只能走脆弱的字符串匹配，同名或同规格不同料极易误判。

新增 SKU 优先级：material_base 表本身没有 sku 列，SKU 只存在于
stock_buy / stock_semi / stock_product，故经明细自带 source_table 反查
sku → base_id 再回查物料，查不到才依次降级其余两张库存表。
查到物料即定论，不再往下走字符串兜底，杜绝误杀。
 2026-09-10 10:14:17 +08:00
yueli
1dbf74b7bc feat(borrow): 借库审批补「完结」能力（对齐出库 status=4） 
- mark_completed 改为 1→4 已完结（真正扫码借出完成仍为 status=3）
- 前端审批页新增「已完结」筛选项与状态映射；审批信息列对 3/4 显示审批人
 2026-09-10 09:47:07 +08:00
yueli
ffbb2199f0 feat(scrap): 报废申请审批流 + 按单报废（后端） 
- ScrapApproval 模型 + ScrapApprovalService：提交/列表/审批/执行(锁库存扣 available_quantity 写 TransScrap)
- 新路由 POST /scrap/request、/request/check-approval、GET /request、PATCH /request/<id>/approve、POST /request/<id>/execute；权限码 scrap_apply/scrap_approval/scrap_execute（无角色硬编码）
- 旧 /scrap 直接报废入口保持不变
- /inbound/stock/list 每项返回 source_table，供按单流程精准选库存
 2026-09-10 09:46:57 +08:00
yueli
044e6dbd98 feat(borrow,outbound): 库管(WAREHOUSE_MGR)代建申请强制审批 
- submit/create 新增 force_approval：库管建单无视物料是否需审批，一律走审批
- 路由按当前角色为 WAREHOUSE_MGR 传 true；未选审批人返回明确业务错误
 2026-09-09 16:19:38 +08:00
yueli
2a9e2e4560 fix(bom): BOM 三态互斥 + active_only排除归档 + 详情主备注 
- get_bom_list active_only 补 is_archived==False，出库/借库“按BOM套餐”不再泄漏归档版本
- get_bom_detail 返回顶层 remark，详情弹窗主备注可回显
- 状态互斥：update_enabled 切启/停即清归档；update_archived 归档→废弃(enabled=False)、取消归档→启用；停用视图排除归档
 2026-09-09 13:00:41 +08:00
yueli
eff9b62224 fix(borrow,outbound): 普通用户记录只看本人——按领用人/借用人姓名(不含账号前缀)匹配 
- 出库记录/借还记录：非管理者视角时按 领用人(consumer_name)/借用人(borrower_name) 过滤
- 匹配取登录名 username.split(/)[0] 的姓名；兼容库里存“姓名/xiaolongxia”全名(姓名+/前缀)
- 修复：管理员替员工创建、领用人=员工 的单，员工登录可见
 2026-09-09 11:19:15 +08:00
yueli
aa9322bcbc feat(borrow): 借库申请后端必填校验——申请原因、预计归还日期(长期借用除外) 
- submit_approval 校验：申请原因非空；未勾长期借用时必须有 expected_return_time，否则 ValueError 拦截
 2026-09-09 10:53:12 +08:00
yueli
d06ce45a72 feat(borrow,outbound): 需审批判定收敛——ID优先 + 名称精确AND核心规格(斜杠前段) 
- approval_control 重写：带 base_id 按主键绝对判定；无 id 才名称100%一致 AND 核心规格(_code_of)一致兜底，杜绝同名不同规误杀
- 借/出库服务命中需审批但未选审批人时，报错列出需审批物料名/规格
 2026-09-09 10:47:24 +08:00
yueli
4cd3eefdf4 feat(borrow,outbound): 默认免审批改造——命中物料需审批才走原流程 
- models/base.py 加 is_approval_required 列及 isApprovalRequired 序列化；field_permissions 登记
- 新增 POST /inbound/base/batch-approval（批量设需审批，仿批量质检）
- borrow_service.submit_approval / outbound_service.create_request：明细含需审批物料→须选审批人走原审批；否则创建即 status=1(待库管执行)、不发审批邮件
- 判定按 (name,spec_model) 反查启用物料
 2026-09-09 09:31:18 +08:00
yueli
2b0e335790 fix(inbound/buy): 批号自增改为按物料精准取最近一条 
- 新增 get_latest_batch_record_by_base_id：SQL 直接 filter(base_id)+order by in_date/id desc first()，O(1) 不分页
- 新增 GET /inbound/buy/latest-record
- 修复原“拉全表前1000条再前端过滤”导致的历史被截断→批号退回000001/重复入库被拦（如 CCAB0029）
 2026-09-08 18:16:04 +08:00
yueli
66b3e4897f fix(bom): get_bom_summary 关键词与 list 对齐 + 状态更新方法健壮化 
- get_bom_summary 关键词过滤改为与 get_bom_list 同款子查询（同时匹配 bom_no、父件名/规格、子件名/规格），任意关键词下 summary 计数与 list 明细严格一致，消除“标题有数、表格为空”
- update_enabled/update_archived 对 bom_no/version 做 strip 规范化，并细化“BOM不存在”报错（带上实际参数便于排查）
 2026-09-08 13:58:43 +08:00
yueli
02f74278df feat(bom): 归档业务闭环——状态筛选+归档/取消归档入口 
- get_bom_list/get_bom_summary 状态过滤支持 archived，enabled 语义改为“启用且未归档”
- get_bom_list 输出补 is_archived；新增 update_archived 与 POST /bom/archive（整组切换归档、清缓存、审计）
- “未指定版本自动取最新”硬化为仅认启用且未归档（get_bom_detail / get_bom_no_by_parent）
- 前端：状态按钮组加“归档”；列表状态列区分归档；操作列加“归档/取消归档”按钮
 2026-09-08 11:13:38 +08:00
yueli
91fb6c1a03 feat(bom): 自制件子件选版本落库/强校验 + 独立启停 + 状态筛选 
- save_bom 落库 child_bom_no/child_bom_version；自制件必选且须属于启用未归档配方集，外购件置空；跨版本查重纳入引用版本
- get_bom_detail 改为读存储列，空则回退最新启用配方；候选/校验/回退读取均排除 is_archived
- 新增 GET /bom/self-bom-versions（子件候选版本）；新增 POST /bom/status 独立启停（update_enabled 清缓存）
- 草稿链路 save_draft/get_draft_detail/publish 持久化引用版本
- get_bom_list/get_bom_summary 支持 status(enabled/disabled) 过滤
 2026-09-08 10:14:44 +08:00
yueli
3dd8458de0 feat: BOM 子件展示自制件 BOM 版本号——子件列表与出库/借库 BOM 清单打印均显示 2026-09-07 18:01:16 +08:00
yueli
478b90fe50 feat: 出库类型贯穿申请→扫码出库——申请单加 outbound_type，申请时选类型、扫码出库自动带出 2026-09-07 14:01:13 +08:00
yueli
73510d3a71 feat: 借还记录默认排序重构——有限期单按预计归还时间升序靠前，无限期单按借出时间升序靠后（优先关注快到期/逾期） 2026-09-04 16:17:42 +08:00
yueli
0daf50ac21 fix: 成品/半成品/维修列表第二层跨域判断补认 crossDomain（解决库管配跨域仍看不到双边） 2026-09-04 13:01:44 +08:00
yueli
1527d552d4 feat: 出库/借库记录记录并展示库位快照（DB加列+后端写入+记录页展示） 2026-09-04 11:42:44 +08:00
yueli
e5c49c5177 fix: 入库 search-base 物料选择加公司隔离，恢复半成品批号按本公司历史自动递增 2026-09-04 09:42:49 +08:00
yueli
1b760f351e fix: 出库/借库扫码查库存与 BOM 子件物料选择加行级公司隔离（超管/跨域不受限） 2026-09-04 09:40:00 +08:00
yueli
c68ffdca0f fix: 入库成品/半成品/采购编辑其它字段时不再误清空图片——仅显式携带图片字段才更新 2026-09-03 14:14:24 +08:00
yueli
7fe861b4a7 fix: 基础信息修改其它字段时不再误清空 product_image（图片消失）——仅显式携带 generalImage 才更新图片 2026-09-03 14:12:15 +08:00
yueli
bf7b2cc6d3 feat: BOM 库存接口支持按版本查询，修复同一编号多版本下拉回显错乱 2026-09-02 18:39:17 +08:00
yueli
ee22927660 fix: 解耦 Webhook 身份证与库存序列号,恢复批号入库纯净 
- 前端:新增临时字段 form.track_id 存 16位身份证,Batch 时 form.serial_number 清空
- 前端:submitForm 不再把身份证补进 payload.serial_number,改为透传 payload.track_id
- 后端:StockSemi 仅存 serial_number(Batch 为空),notify_track 优先用 track_id
 2026-09-01 16:44:48 +08:00