Shopify库存CSV归一化

适用场景与前置条件

Shopify 的 all states 与 available CSV 列结构不同，变体、地点和库存状态散落在表格中，直接改表容易漏行或误覆盖。

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

输入与输出

输入：python scripts/normalizeinventory.py --csv examples/inventory.csv --output examples/normalizedinventory.json

输出：normalized_inventory.json，包含 CSV 模式、变体键、地点、库存状态、源文件哈希和缺失字段警告。

安装与执行

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

错误恢复

修正 CSV 表头、缺失 Handle、变体选项或非整数数量后重跑；不要猜测缺失地点或库存状态。

权限与隐私边界

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

验收

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