# Schema 与空库初始化（文档）

本轮**不执行**真实建库或历史数据导入，仅提供步骤与表清单。

## 1. 目标

为客户实例准备独立 PostgreSQL + 独立 Parse App，与现网 `msqvoc` 完全隔离。

## 2. 初始化步骤

1. 创建 PostgreSQL 数据库（示例名 `target_voc`）。
2. 创建数据库用户并授权。
3. 填写 `backend/config.json`：
   - `parse.appId` = 客户独立 AppId
   - `parse.masterKey` = 客户独立 Master Key
   - `parse.databaseURI` = 客户连接串
   - `parse.serverURL` = `https://TARGET_HOST/parse`
4. 用 fmode-server 启动后端，让 Parse 自动建表。
5. 按需补索引（见下）。
6. 导入平台 / Marketplace / 类目配置 / AI Prompt（空或最小集）。
7. 创建管理员账号。
8. 在 `Shop` 配置客户 Amazon 店铺。
9. 执行首次同步。

## 3. 核心业务表（重点）

| 表 | 用途 |
| --- | --- |
| Shop | 店铺与授权信息 |
| Product | 商品主数据 |
| ProductDetail | 商品详情 / 类目扩展 |
| AsinSkuMapping | ASIN-SKU 映射 |
| Listing | Listing 快照 |
| Order | 订单 |
| SorftimeReviews | 评论缓存 |
| ReturnRecord | 退货 |
| Reports | 报表 |
| TaskExecutionLog | 任务执行日志 |

> 完整字段以 Parse Schema / 源系统为准；复制实例后可用 parse-dashboard 导出 schema 再固化。

## 4. 索引建议（空库后按查询补）

- `Product.asin`
- `ProductDetail.asin` / `nodeId`
- `Order.amazonOrderId` / `purchaseDate`
- `SorftimeReviews.asin` / `reviewDate`
- `TaskExecutionLog.taskName` / `createdAt`
- `Shop.sellerId`

## 5. 权限边界

- 第一阶段**不需要**跨客户 `tenantId`（一客户一库）。
- 管理员可看本实例全量；普通用户按店铺/产品授权。
- 敏感类（Shop 凭证、Token）CLP 禁止匿名读。
- 前端 `runtime-config` 不得含 Master Key。

## 6. Dashboard 连接模板（脱敏）

```bash
parse-dashboard \
  --appId TARGET_PARSE_APP_ID \
  --masterKey "TARGET_PARSE_MASTER_KEY" \
  --serverURL https://TARGET_HOST/parse \
  --appName TARGET-VOC
```

数据库连接串模板：

```text
postgresql://TARGET_DB_USER:TARGET_DB_PASSWORD@TARGET_DB_HOST:5432/TARGET_DB_NAME
```

## 7. 明确不做

- 不默认复制现网服装/泳装/订单/评论数据
- 不在本目录提交真实密码或导出快照