38 lines
1.4 KiB
Markdown
38 lines
1.4 KiB
Markdown
# 杜康好客 · 城市 / 仓库 / 日志架构
|
|
|
|
> **2026-07-12** P1 多合伙 + P2 仓库 ✅ · 合伙人管仓日志 ⏳ Wave 3
|
|
|
|
## 数据模型（摘要）
|
|
|
|
```
|
|
CommonCity → PartnerAccount(主) → Store(partnerAccountId, settlementRate)
|
|
→ CityWarehouse(HQ|PARTNER 管仓)
|
|
→ CatalogProduct
|
|
PartnerAccount → 子账号(parentAccountId, permissions JSON)
|
|
```
|
|
|
|
迁移：城市绑定/购酒分佣合并至 `partner_account`；订单快照 `partnerAccountIdAtPay` + `orderCommissionRateAtPay`。
|
|
|
|
## 日志职责
|
|
|
|
| 主体 | 表 | 入口 |
|
|
|------|-----|------|
|
|
| HQ 写操作 | `common_event` HQ_OPERATION | `@HqOperation` → `/logs/hq` |
|
|
| 合伙人 | `log_partner_analytics` | `/logs/partners` |
|
|
| 门店 | `log_store_analytics` | `/logs/stores` |
|
|
| C 端 | `log_user_analytics` | `/logs/users` |
|
|
| 权益/订单 | `common_event` BENEFIT_LEDGER / ORDER_STATUS | 领域查询 |
|
|
|
|
## HQ action（新业务）
|
|
|
|
`CITY_*` · `WAREHOUSE_*` · `PARTNER_*` · `PARTNER_ACCOUNT_*` · `HQ_ACCOUNT_*` · `HQ_PERMISSION_*`
|
|
常量：`hq-operation.constants.ts` · 筛选项：`apps/admin-web/src/lib/hq-log.ts`
|
|
|
|
## 合伙人子账号 eventName
|
|
|
|
`partner_staff_create|update|permission_update|delete` ✅ · `partner_warehouse_*` ⏳
|
|
|
|
## DoD
|
|
|
|
HQ 写接口有 `@HqOperation`；合伙人写走 `trackPartnerOneSafe`；extraJson 脱敏；不跨模块直写他人日志表。
|