# 字段映射表汇总

本文档汇总「商品上传模板导出」中所有按性别/类目生效的字段映射表。
来源：`graph/template_export.py`（内置默认）+ `config.yaml`（可覆盖/新增，优先）。
密钥约定：`→` 左为 db（数据库中）值，右为模板下拉框精确选项。

---

## 1. 成分映射 component_map

| 作用范围 | db 值 | 模板值 |
|---|---|---|
| 女装 `female` | 棉 | 棉Cotton |
| 女装 `female` | 聚酯纤维 / 涤纶 / 再生聚酯纤维 / 聚酯纤维(涤纶） | 聚酯纤维(涤纶)Polyester |
| 女装 `female` | 氨纶 | 氨纶Elastane |
| 女装 `female` | 锦纶 | 锦纶(尼龙)Polyamide |

- 映射键：`component_1 / component_2 / component_3` 三个字段
- config 段：`component_map.female`
- 男装/童装/无成分：保留 db 原值（不查此表；完整配置以 `config.yaml` 为准）

---

## 2. 季节映射 season_map

| 作用范围 | db 值 | 模板值 |
|---|---|---|
| 女装 `female` | 四季 | ALL/全球/所有 |

- 映射键：`season` 字段
- config 段：`season_map.female`
- 男装保留 db 原值

---

## 3. 印花图案映射 pattern_map

| 作用范围 | db 值 | 模板值 |
|---|---|---|
| 女装 `female` | 印花 | 卡通 |
| 女童 `girl_kids` | 印花 | 卡通 |

- 映射键：`pattern` 字段
- config 段：`pattern_map.female`、`pattern_map.girl_kids`
- 男装 / **男童** 保留 db 原值（男童不映射）

---

## 4. 适用人群映射 target_audience_map

| 作用范围 | db 值 | 模板值 |
|---|---|---|
| 女童 `girl_kids` | 男童 | 女童 |
| 男童 `boy_kids` | 女童 | 男童 |

- 童装模板专用：女童模板遇到「男童」→「女童」；男童模板遇到「女童」→「男童」
- config 段：`target_audience_map.kids.girl_kids`、`target_audience_map.kids.boy_kids`
- 成人男/女装保留 db 原值（不查此表）

---

## 5. 类型映射（SPU商品属性-类型）kids_type_map

| 作用范围 | db 值 | 模板值 |
|---|---|---|
| 女童 `girl_kids` | 上衣 | 针织上衣 |

- 映射键：`kids_type` → `SPU商品属性-类型`
- config 段：`kids_type_map.girl_kids`
- **只有女童**需要映射结果；男童保留 db 原值

---

## 6. 适用年龄段（童装）

- 映射：`kids_age` → `适用年龄段`（仅童装模板填，原样透传，不走映射表）

---

## 配置覆盖说明

所有映射表均遵循同一加载逻辑：**config.yaml 有对应段则「合并覆盖」内置默认，缺失/留空则回退内置默认**。
内置默认常量（`_COMPONENT_FEMALE_MAP` / `_SEASON_FEMALE_MAP` / `_PATTERN_FEMALE_MAP` /
`_PATTERN_KIDS_MAP` / `_TARGET_AUDIENCE_KIDS_MAP` / `_KIDS_TYPE_GIRL_MAP`）位于
`graph/template_export.py`。