# TARGET-voc-instance

客户独立 AI-VOC 实例模板（占位名 `TARGET`）。

## 约束

- **不修改**源仓 `msq-voc-web` / `moshengqi-server` / `future-server`
- Sorftime / TikHub 经客户后端转发到公司现网中转：
  - `POST https://server.fmode.cn/api/voc-ecom/forward`
  - `ALL  https://server.fmode.cn/api/voc-social/*`
- 公司鉴权：客户后端配置 `Authorization: Bearer sk-...`
- 浏览器不再携带 TikHub/Sorftime 上游 Token

## 目录

| 目录 | 说明 |
| --- | --- |
| `frontend/` | Angular 前端副本 + `runtime-config.json` |
| `backend/` | 业务后端副本 + RelayClient |
| `schema/` | 空库初始化文档 |
| `deploy/` | Nginx 与部署说明 |
| `scripts/` | 密钥扫描等 |
| `docs/` | 修订方案与验收清单 |

## 交付前必改占位符

1. `backend/src/relay/relay-config.ts` → `sk-TARGET_RELAY_SK`
2. `backend/config.json` → Parse AppId / MasterKey / databaseURI
3. `frontend/src/assets/runtime-config.json` → 客户域名与 Parse
4. Eccang / Amazon 等业务密钥按客户实际情况填写

## 快速检查

```bash
# 密钥扫描
bash scripts/scan-secrets.sh

# 后端健康（服务启动后）
curl -s http://127.0.0.1:3000/api/sorftime/health
curl -s http://127.0.0.1:3000/api/tikhub/health
```

## 文档

- [修订落地方案](docs/客户独立实例落地方案-修订版.md)
- [验收清单](docs/验收清单.md)
- [Schema 初始化](schema/README.md)
- [部署说明](deploy/README.md)

## 本轮未做

- 真实 PostgreSQL 建库与历史数据迁移
- 目标客户类目 profile 细节（仅 `default`）
- 与公司 NewAPI 额度账套的联调（需有效 sk）