调整字段顺序、名称

2026-04-22 17:12:37 +08:00
parent 86f120bc18
commit 7b45d04a6b
6 changed files with 56 additions and 50 deletions
@@ -118,23 +118,23 @@ PRIMARY_FIELD_NAME = "货品编码"
 PRIMARY_FIELD_SOURCE = "统一规格编码"
 ```

-当前字段映射：
+当前字段映射和展示顺序：

 | 飞书字段名 | SQL 来源字段 | 飞书字段类型 | 显示格式 |
 | --- | --- | --- | --- |
 | 货品编码 | 统一规格编码 | 文本主字段 | 文本 |
-| 品牌 | 品牌名称 | 文本 | 文本 |
-| 分类 | 一级分类 | 文本 | 文本 |
-| 产品类别 | 货品简称 | 文本 | 文本 |
 | 货品名称 | 商品名称 | 文本 | 文本 |
+| 分类 | 一级分类 | 文本 | 文本 |
 | 条形码 | 条形码 | 文本 | 文本 |
 | 零售价 | 零售价 | 数字 | 保留 2 位小数 |
 | 店铺名称 | 店铺名称 | 文本 | 文本 |
 | 店铺可用库存 | 店铺挂单量 | 数字 | 不保留小数 |
 | 总库存 | 总库存 | 数字 | 不保留小数 |
-| 本月销售数量 | 本月销售数量 | 数字 | 不保留小数 |
-| 上月销售数量 | 上月销售数量 | 数字 | 不保留小数 |
-| 上上月销售数量 | 上上月销售数量 | 数字 | 不保留小数 |
+| 当前月份销售数量，例如 202604销售数量 | 本月销售数量 | 数字 | 不保留小数 |
+| 上一月份销售数量，例如 202603销售数量 | 上月销售数量 | 数字 | 不保留小数 |
+| 上上月份销售数量，例如 202602销售数量 | 上上月销售数量 | 数字 | 不保留小数 |
+| 品牌 | 品牌名称 | 文本 | 文本 |
+| 产品类别 | 货品简称 | 文本 | 文本 |

 ### 3.5 SQL 模块

@@ -151,7 +151,7 @@ PRIMARY_FIELD_SOURCE = "统一规格编码"
 - 取每个统一规格编码、仓库的最新库存快照。
 - 汇总统一规格编码维度的总库存。
 - 取每个统一规格编码、店铺的最新挂单量快照。
- 汇总本月、上月、上上月销售数量。
+- 按店铺和统一规格编码汇总本月、上月、上上月销售数量。
 - 关联商品维表和店铺维表。
 - 输出用于飞书同步的明细结果。

@@ -176,7 +176,7 @@ PRIMARY_FIELD_SOURCE = "统一规格编码"
 - 解析飞书 Base 地址和 `app_token`。
 - 查询飞书 Base 下的表列表。
 - 查询、创建、更新飞书字段。
- 根据字段映射创建或修正目标表字段。
+- 根据字段映射重建受管字段，保证字段类型和展示顺序一致。
 - 分页读取记录。
 - 批量删除记录。
 - 批量创建记录。
@@ -304,7 +304,7 @@ python3 -m inventory_sync.cli --action sync-brand

 ### 8.2 使用全量覆盖同步

-当前采用删除旧记录后重新插入的方式，优点是逻辑简单、结果确定，不需要处理复杂的增量比对。
+当前采用删除旧记录后重新插入的方式，优点是逻辑简单、结果确定，不需要处理复杂的增量比对。为了稳定控制飞书表头顺序，同步前也会重建受管字段。

 需要注意的是，如果目标飞书表中存在人工维护的额外行，全量覆盖会删除这些记录。后续如需保留人工数据，应改为基于主键“货品编码 + 店铺名称”做 upsert。