# 京东首批商品导入

## 当前状态

- 京东商品、SKU、库存接口已经在同一授权进程中验证成功。
- `getProduct` 已修复：URL path 中的 `productId` 必须加入 MD5 待签名字段，不能重复放入 query。
- 当前授权店铺商品总数会随店铺实时变化；2026-08-21 最近一次复测为 824 条。
- `https://server.fmode.cn/backend/vO3T8gAdwB/data` 是挂载前缀，直接 GET 返回 404；正确 class 资源为 `{base}/classes/<ClassName>`。
- 已通过 `{base}/classes/ProductDetail` 完成读取和正式幂等写入。详细证据见 `JD-PRODUCT-DETAIL-PARSE-VERIFICATION-2026-08-21.md`。
- Listing AI 新同步器已完成 824 个动态目录商品的全量源快照同步和评分验收；结果见 `LISTING-AI-IMPLEMENTATION-REPORT-2026-08-21.md`。本页旧 `import:jd-products` 命令仅保留兼容/小批诊断用途。

## 导入内容

默认导入前 10 个商品，并写入：

- `ProductDetail`：商品主档、类目、品牌、价格、原始详情响应；
- `Product`：现有系统商品主表兼容字段；
- `AsinSkuMapping`：京东商品与 SKU 关系；
- `JdStockSnapshot`：库存、预占库存、仓库和采集时间。

订单、销量、GMV、流量、退款、评价不会由商品接口伪造填充。

## 运行方式

先设置环境变量，不把密钥写进脚本或前端：

```powershell
$env:JD_SOURCE_PARSE_URL = "https://server.fmode.cn/parse"
$env:JD_SOURCE_PARSE_APP_ID = "主 Parse 应用 ID"
$env:JD_SOURCE_PARSE_MASTER_KEY = "主 Parse Master Key"
$env:JD_TARGET_PARSE_URL = "https://server.fmode.cn/backend/vO3T8gAdwB/data"
$env:JD_TARGET_PARSE_APP_ID = "目标 Parse Application ID"
$env:JD_TARGET_PARSE_MASTER_KEY = "目标应用 Master Key"
$env:JD_APP_KEY = "京东 AppKey"
$env:JD_APP_SECRET = "京东 AppSecret"

npm run import:jd-products -- --dry-run --limit 10
npm run import:jd-products -- --limit 10
```

`--dry-run` 只读取京东并输出数量和商品 ID；正式导入使用业务键更新，重复运行不会重复创建同一商品、SKU 或当天库存快照。

不要用目标 Parse 挂载前缀的根 GET 作为健康检查，也不要依赖当前环境的 `count=1` 结果判断是否有数据。现阶段 readiness 应请求：

```text
{JD_TARGET_PARSE_URL}/classes/ProductDetail?limit=1
```

并校验 HTTP 200、JSON body 和 `results` 数组。上游存在间歇性 HTTP 403 / Parse code 119；仅对此精确错误做有限退避重试。