# 质检物料库 · 编辑弹窗数量修正 Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. **Goal:** 允许在质检物料库编辑弹窗修正入库数量与剩余数量,同步物资汇总库存与入库流水,账实不符时写入 adjust 流水,不改历史出库记录。 **Architecture:** 后端 `update_batch` 增加数量修正分支(`_sum_batch_out_total` + 校验 + 入库流水同步 + 可选 adjust 流水);新增 GET 批次详情返回 `outTotal`;前端编辑弹窗联动两数量字段;变动记录 Tab 支持 adjust 筛选与展示。 **Tech Stack:** FastAPI · SQLAlchemy · Vue 3 · Element Plus · DecimalInput **Spec:** `docs/superpowers/specs/2026-07-07-qc-material-batch-qty-edit-design.md` --- ### Task 1: 后端 CRUD — out_total 与 update_batch 数量修正 **Files:** - Modify: `backend/app/crud/qc_material_stock_batch.py` - [ ] 新增 `_sum_batch_out_total(db, batch_id, tenant_no) -> Tuple[Decimal, int]` - [ ] 新增 `get_batch_detail(db, batch_id, tenant_no) -> Dict`(含 outTotal、outCount) - [ ] `update_batch` 增加 `in_qty` / `remaining_qty` 参数与事务内数量修正逻辑 - [ ] 批次查询改用 `with_for_update()` 锁定 ### Task 2: 后端 API **Files:** - Modify: `backend/app/api/qc.py` - [ ] `QcMaterialBatchUpdateBody` 增加 `inQty`、`remainingQty` - [ ] 新增 `GET /qc-material-batches/{batch_id}` ### Task 3: 变动记录 adjust 筛选 **Files:** - Modify: `backend/app/crud/qc_material_usage.py` - [ ] `_list_usages_query` 增加 `change_type == adjust` 分支 ### Task 4: 前端 API 与编辑弹窗 **Files:** - Modify: `web-admin/src/api/qc-material.ts` - Modify: `web-admin/src/views/quality-inspection/qc-material/index.vue` - [ ] 类型与 `fetchQcMaterialBatchDetail` - [ ] 编辑弹窗可编辑数量、只读已出库/理论剩余、联动与校验、提交 payload ### Task 5: 变动记录 Tab **Files:** - Modify: `web-admin/src/views/quality-inspection/qc-material/QcMaterialUsageTab.vue` - [ ] 筛选项「库存调整」、Tag 与来源文案 ### Task 6: 验证 - [ ] 后端 Python 语法检查 - [ ] 前端 lint 相关文件