@whyshu/argent-engine 0.0.0-stage → 0.6.0

package/engine/verticals/mercadolibre/config.json

@@ -0,0 +1,709 @@
+{
+  "_doc": "配置目录 · 美客多业务线（业务线级）。与 `configs/*.json` 同一套声明格式与同一套读取器（core/lib/config-catalog.mjs）：业务线新增可配项**只加本文件**，不改读取器、不改页面。分类固定两类：「美客多·只读」（采集/展示用，不写对方系统）与「美客多·操作」（会写表/开门户/发货，风险更高）。",
+  "domain": "mercadolibre",
+  "vertical": "mercadolibre",
+  "order": 50,
+  "items": [
+    {
+      "key": "ml.api.stores_file",
+      "label": "官方 API 店铺凭据文件",
+      "category": "美客多·只读",
+      "type": "path",
+      "source": "env",
+      "secret": false,
+      "required": false,
+      "capability": "daily-report",
+      "editable": false,
+      "help": "OAuth 店铺凭据文件位置；默认取数据目录下的约定文件名。",
+      "binding": {
+        "kind": "env",
+        "env": "ML_API_STORES_JSON"
+      }
+    },
+    {
+      "key": "ml.api.app_id",
+      "label": "官方应用 App ID",
+      "category": "美客多·只读",
+      "type": "string",
+      "source": "envfile",
+      "secret": false,
+      "required": false,
+      "capability": "daily-report",
+      "editable": false,
+      "help": "OAuth 刷新令牌用的应用 ID（部署文件维护）。",
+      "binding": {
+        "kind": "envfile",
+        "file": "daily-report.env",
+        "env": "ML_APP_ID",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "ml.api.app_secret",
+      "label": "官方应用 App Secret",
+      "category": "美客多·只读",
+      "type": "string",
+      "source": "envfile",
+      "secret": true,
+      "required": false,
+      "capability": "daily-report",
+      "editable": false,
+      "help": "OAuth 刷新令牌用的应用密钥；只显示已配置/未配置。",
+      "binding": {
+        "kind": "envfile",
+        "file": "daily-report.env",
+        "env": "ML_APP_SECRET",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "ml.daily.hour",
+      "label": "日报推送时刻",
+      "category": "美客多·只读",
+      "type": "string",
+      "source": "json",
+      "secret": false,
+      "required": false,
+      "validation": {
+        "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
+      },
+      "capability": "daily-report",
+      "editable": true,
+      "help": "按各店站点本地时间计算；错过或失败会在 +5 小时窗口内逐小时补试（幂等防重）。",
+      "binding": {
+        "kind": "json",
+        "file": "config.json",
+        "field": "mlDailyTime"
+      },
+      "default": "08:00",
+      "todayChain": [
+        "json",
+        "env",
+        "default"
+      ]
+    },
+    {
+      "key": "ml.daily.top_n",
+      "label": "畅销榜条数",
+      "category": "美客多·只读",
+      "type": "int",
+      "source": "json",
+      "secret": false,
+      "required": false,
+      "validation": {
+        "min": 1,
+        "max": 20
+      },
+      "capability": "daily-report",
+      "editable": true,
+      "help": "日报畅销榜展示多少条（1–20）。",
+      "binding": {
+        "kind": "json",
+        "file": "config.json",
+        "field": "mlDailyTopN"
+      },
+      "default": 5,
+      "todayChain": [
+        "json",
+        "env",
+        "default"
+      ]
+    },
+    {
+      "key": "ml.daily.restock_lead_days",
+      "label": "补货提前天数",
+      "category": "美客多·只读",
+      "type": "int",
+      "source": "json",
+      "secret": false,
+      "required": false,
+      "validation": {
+        "min": 0,
+        "max": 90
+      },
+      "capability": "daily-report",
+      "editable": true,
+      "help": "按可售天数提前多少天进补货预警。",
+      "binding": {
+        "kind": "json",
+        "file": "config.json",
+        "field": "mlRestockLeadDays"
+      },
+      "default": 15,
+      "todayChain": [
+        "json",
+        "env",
+        "default"
+      ]
+    },
+    {
+      "key": "ml.daily.restock_buffer_days",
+      "label": "补货缓冲天数",
+      "category": "美客多·只读",
+      "type": "int",
+      "source": "json",
+      "secret": false,
+      "required": false,
+      "validation": {
+        "min": 0,
+        "max": 90
+      },
+      "capability": "daily-report",
+      "editable": true,
+      "help": "在提前天数之上再留的安全库存天数。",
+      "binding": {
+        "kind": "json",
+        "file": "config.json",
+        "field": "mlRestockBufferDays"
+      },
+      "default": 7,
+      "todayChain": [
+        "json",
+        "env",
+        "default"
+      ]
+    },
+    {
+      "key": "ml.daily.store_count",
+      "label": "已授权店铺数",
+      "category": "美客多·只读",
+      "type": "int",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "daily-report",
+      "editable": false,
+      "help": "只读事实：店铺凭据文件里已授权的店铺条数。",
+      "binding": {
+        "kind": "machine",
+        "file": "ml-api-stores.json",
+        "field": "stores",
+        "transform": "length"
+      }
+    },
+    {
+      "key": "ml.product.dict_file",
+      "label": "品名/报关词典文件",
+      "category": "美客多·只读",
+      "type": "path",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "editable": false,
+      "help": "中文品名 → 英文品名/编码的本地词典（只读事实：文件在不在）。",
+      "binding": {
+        "kind": "machine",
+        "file": "lip-product-dict.json",
+        "presence": true
+      }
+    },
+    {
+      "key": "ml.full.base_token",
+      "label": "货件表 Base Token",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "envfile",
+      "secret": true,
+      "required": true,
+      "validation": {
+        "minLength": 8
+      },
+      "capability": "full",
+      "editable": false,
+      "help": "货件流程读写的那张表；改错 ⇒ 认领不到票（表标识按密钥处理）。",
+      "binding": {
+        "kind": "envfile",
+        "file": "fulfillment.env",
+        "env": "FULL_BASE_TOKEN",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "ml.full.table_id",
+      "label": "货件表 Table ID",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "envfile",
+      "secret": false,
+      "required": true,
+      "validation": {
+        "pattern": "^tbl[A-Za-z0-9]+$"
+      },
+      "capability": "full",
+      "editable": false,
+      "help": "货件表的数据表 id；改错 ⇒ 认领不到票。",
+      "binding": {
+        "kind": "envfile",
+        "file": "fulfillment.env",
+        "env": "FULL_TABLE_ID",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "ml.full.table_mode",
+      "label": "单表/双轨模式",
+      "category": "美客多·操作",
+      "type": "enum",
+      "source": "envfile",
+      "secret": false,
+      "required": false,
+      "validation": {
+        "enum": [
+          "lip",
+          "legacy"
+        ]
+      },
+      "capability": "full",
+      "editable": false,
+      "help": "显式指定表模式；不写则按 Base Token 推断。",
+      "binding": {
+        "kind": "envfile",
+        "file": "fulfillment.env",
+        "env": "FULL_TABLE_MODE",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "ml.store.id",
+      "label": "本机店铺标识",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "envfile",
+      "secret": false,
+      "required": false,
+      "capability": "full",
+      "editable": false,
+      "help": "本机流程归属的店铺；决定店铺级并发与窗口复用。",
+      "binding": {
+        "kind": "envfile",
+        "file": "fulfillment.env",
+        "env": "ML_STORE_ID",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "ml.store.name",
+      "label": "本机店铺名",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "envfile",
+      "secret": false,
+      "required": false,
+      "capability": "full",
+      "editable": false,
+      "help": "人读的店铺名（台账/日志里用它指代店铺）。",
+      "binding": {
+        "kind": "envfile",
+        "file": "fulfillment.env",
+        "env": "ML_STORE_NAME",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "ml.ziniao.mode",
+      "label": "店铺浏览器档位",
+      "category": "美客多·操作",
+      "type": "enum",
+      "source": "envfile",
+      "secret": false,
+      "required": false,
+      "validation": {
+        "enum": [
+          "bridge",
+          "webdriver",
+          "selenium"
+        ]
+      },
+      "capability": "full",
+      "editable": false,
+      "help": "用哪种方式驱动店铺浏览器；不写 = bridge。",
+      "binding": {
+        "kind": "envfile",
+        "file": "fulfillment.env",
+        "env": "ZINIAO_MODE",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "ml.ziniao.data_dir",
+      "label": "店铺浏览器数据目录",
+      "category": "美客多·操作",
+      "type": "path",
+      "source": "envfile",
+      "secret": false,
+      "required": false,
+      "capability": "full",
+      "editable": false,
+      "help": "店铺浏览器登录态的本地数据目录。",
+      "binding": {
+        "kind": "envfile",
+        "file": "fulfillment.env",
+        "env": "ZINIAO_DL",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "ml.invoice.fallback_base_token",
+      "label": "发票兜底表 Base Token",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "envfile",
+      "secret": true,
+      "required": false,
+      "capability": "invoice",
+      "editable": false,
+      "help": "未显式配货件表时的兜底表（表标识按密钥处理）。",
+      "binding": {
+        "kind": "envfile",
+        "file": "fulfillment.env",
+        "env": "FEISHU_BASE_TOKEN",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "ml.invoice.fallback_table_id",
+      "label": "发票兜底 Table ID",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "envfile",
+      "secret": false,
+      "required": false,
+      "validation": {
+        "pattern": "^tbl[A-Za-z0-9]+$"
+      },
+      "capability": "invoice",
+      "editable": false,
+      "help": "未显式配货件表时的兜底数据表 id。",
+      "binding": {
+        "kind": "envfile",
+        "file": "fulfillment.env",
+        "env": "FEISHU_TABLE_ID",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "ml.invoice.mapping_file",
+      "label": "发票部署配置",
+      "category": "美客多·操作",
+      "type": "path",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "editable": false,
+      "help": "模板路径/默认值/输出目录的部署配置（只读事实：文件在不在）。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "presence": true
+      }
+    },
+    {
+      "key": "ml.product.sku_dict_file",
+      "label": "SKU 词典文件",
+      "category": "美客多·只读",
+      "type": "path",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "vertical": "mercadolibre",
+      "editable": false,
+      "help": "中文 SKU → 英文/编码的本地词典（只读事实：文件在不在）。",
+      "binding": {
+        "kind": "machine",
+        "file": "lip-sku-dict.json",
+        "presence": true
+      }
+    },
+    {
+      "key": "ml.invoice.default.service_type",
+      "label": "服务类型",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "vertical": "mercadolibre",
+      "editable": false,
+      "help": "报关/发票**默认口径**（每客户一份，人工维护）：本批只读呈现，改动须用户确认。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "defaults.服务类型"
+      }
+    },
+    {
+      "key": "ml.invoice.default.customs_mode",
+      "label": "报关方式",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "vertical": "mercadolibre",
+      "editable": false,
+      "help": "报关/发票**默认口径**（每客户一份，人工维护）：本批只读呈现，改动须用户确认。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "defaults.报关方式"
+      }
+    },
+    {
+      "key": "ml.invoice.default.has_battery",
+      "label": "带电",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "vertical": "mercadolibre",
+      "editable": false,
+      "help": "报关/发票**默认口径**（每客户一份，人工维护）：本批只读呈现，改动须用户确认。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "defaults.带电"
+      }
+    },
+    {
+      "key": "ml.invoice.default.has_magnet",
+      "label": "带磁",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "vertical": "mercadolibre",
+      "editable": false,
+      "help": "报关/发票**默认口径**（每客户一份，人工维护）：本批只读呈现，改动须用户确认。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "defaults.带磁"
+      }
+    },
+    {
+      "key": "ml.invoice.default.currency",
+      "label": "申报币种",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "vertical": "mercadolibre",
+      "editable": false,
+      "help": "报关/发票**默认口径**（每客户一份，人工维护）：本批只读呈现，改动须用户确认。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "defaults.申报币种"
+      }
+    },
+    {
+      "key": "ml.invoice.default.warehouse",
+      "label": "国内收货仓库",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "vertical": "mercadolibre",
+      "editable": false,
+      "help": "报关/发票**默认口径**（每客户一份，人工维护）：本批只读呈现，改动须用户确认。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "defaults.国内收货仓库"
+      }
+    },
+    {
+      "key": "ml.invoice.default.address_library",
+      "label": "收件人地址库",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "vertical": "mercadolibre",
+      "editable": false,
+      "help": "报关/发票**默认口径**（每客户一份，人工维护）：本批只读呈现，改动须用户确认。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "defaults.收件人地址库"
+      }
+    },
+    {
+      "key": "ml.invoice.default.purpose",
+      "label": "用途",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "vertical": "mercadolibre",
+      "editable": false,
+      "help": "报关/发票**默认口径**（每客户一份，人工维护）：本批只读呈现，改动须用户确认。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "defaults.用途"
+      }
+    },
+    {
+      "key": "ml.invoice.default.declared_value_usd",
+      "label": "申报价值（USD）",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "vertical": "mercadolibre",
+      "editable": false,
+      "help": "报关/发票**默认口径**（每客户一份，人工维护）：本批只读呈现，改动须用户确认。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "defaults.申报价值USD"
+      }
+    },
+    {
+      "key": "ml.invoice.default.brand",
+      "label": "品牌申报",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "vertical": "mercadolibre",
+      "editable": false,
+      "help": "报关/发票**默认口径**（每客户一份，人工维护）：本批只读呈现，改动须用户确认。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "defaults.brand"
+      }
+    },
+    {
+      "key": "ml.invoice.default.model",
+      "label": "型号申报",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "vertical": "mercadolibre",
+      "editable": false,
+      "help": "报关/发票**默认口径**（每客户一份，人工维护）：本批只读呈现，改动须用户确认。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "defaults.model"
+      }
+    },
+    {
+      "key": "ml.invoice.default_carrier",
+      "label": "默认货代",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "editable": false,
+      "help": "发票流程默认走哪家货代（决定模板与门户）。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "defaults.货代"
+      }
+    },
+    {
+      "key": "ml.invoice.sync_max_count",
+      "label": "每次同步建单上限",
+      "category": "美客多·操作",
+      "type": "int",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "validation": {
+        "min": 0,
+        "max": 50
+      },
+      "capability": "invoice",
+      "editable": false,
+      "help": "每次同步最多取最近 N 条已完成货件建发票任务（历史货件不自动开票）。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "sync.maxCount"
+      }
+    },
+    {
+      "key": "ml.invoice.output_dir",
+      "label": "发票产物目录",
+      "category": "美客多·操作",
+      "type": "path",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "editable": false,
+      "help": "生成的发票文件落地目录。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "output.invoice"
+      }
+    },
+    {
+      "key": "ml.invoice.labels_dir",
+      "label": "标签产物目录",
+      "category": "美客多·操作",
+      "type": "path",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "editable": false,
+      "help": "下载的大货标签落地目录。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "output.labels"
+      }
+    },
+    {
+      "key": "ml.invoice.source_table_id",
+      "label": "发票源表 Table ID",
+      "category": "美客多·操作",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "editable": false,
+      "help": "发票任务的源表 id（未配则用注册表声明的表）。",
+      "binding": {
+        "kind": "machine",
+        "file": "invoice-mapping.json",
+        "field": "fullSource.table"
+      }
+    }
+  ],
+  "entries": []
+}