jianhen-voc/schema/README.md

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 连接模板（脱敏）

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

数据库连接串模板：

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

7. 明确不做

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