Shopify库存导入复核包

适用场景与前置条件

库存审计结果需要交给店铺负责人确认，尤其是 On hand current/new、变体范围和导入失败后的重新导出步骤。

前置条件：Python 3.10 或更高版本；买家有权导出的 Shopify Inventory CSV；输入已删除店铺名称、客户信息、域名、账号和凭据。

输入与输出

输入：python scripts/buildimportreviewpacket.py --snapshot examples/normalizedinventory.json --audit examples/inventoryaudit.json --case examples/case.json --output examples/importreview_packet.json

输出：importreviewpacket.json，包含计划变更、阻断项、人工步骤、回滚说明、PENDING 决策和 NOTFORAUTO_IMPORT 标志。

安装与执行

无需第三方依赖。按 README 中的命令运行；脚本只读输入并写入新的 JSON 文件。

错误恢复

补齐上游快照或审计文件后重跑；出现 BLOCK 时保持 HOLDFORHUMAN_REVIEW，不执行 Shopify Import。

权限与隐私边界

只处理买家有权使用且已脱敏的本地文件，不登录 Shopify、不读取 Cookie 或令牌、不调用 Admin API、不修改商品或库存、不提交导入。

验收

使用 examples 中的脱敏文件运行，确认输出可解析、状态与输入事实一致、原始 CSV 未被改写，并人工复核异常行。