From 92572bcf6bc49c11737f036711e8425081451cb3 Mon Sep 17 00:00:00 2001
From: yumoqing <yumoqing@gmail.com>
Date: Fri, 17 Jul 2026 18:06:14 +0800
Subject: [PATCH] docs: correct org hierarchy from supplychain, not
 organization.parentid

---
 README.md | 30 +++++++++++++++++++++++-------
 1 file changed, 23 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 7827b3f..4a9b65b 100644
--- a/README.md
+++ b/README.md
@@ -4,12 +4,26 @@
 
 ## 数据来源
 
-| 数据源 | 表 | 说明 |
-|--------|-----|------|
-| 模型调用记录 | `llmusage` | 每次 API 调用的详细日志 |
-| 模型定义 | `llm` | 模型名称、目录类型、供应商、owner |
-| 组织架构 | `organization` | 分销商→供应商→客户层级关系 |
-| 定价 | `pricing_program_timing` | 各模型供应商定价数据 |
+| 数据源 | 模块 | 表 | 说明 |
+|--------|------|-----|------|
+| 模型调用记录 | llmage | `llmusage` | 每次 API 调用详细日志 |
+| 模型定义 | llmage | `llm` | 模型名、catelog、供应商、owner |
+| 定价 | pricing | `pricing_program_timing` | 各模型供应商定价数据 |
+| 供应链关系 | supplychain | `distribution_agreements` | 分销商(reseller) → 二级分销商(sub_reseller) |
+| 供应链关系 | supplychain | `product_org_auth` | 产品授权 org 关联链 |
+| 组织架构 | rbac | `organization` | org 基础信息（名称、类型、parentid） |
+
+### 维度层级（从供应链模块获取）
+
+```
+分销商(distributor, org_type='reseller')
+  └─ 供应商/二级分销商(sub_reseller, org_type='sub_reseller')
+       └─ 客户(customer, org_type='customer')
+```
+
+- 分销商与二级分销商关系：`distribution_agreements`(reseller_id → sub_reseller_id)
+- 二级分销商与客户关系：`organization.parentid` 或 `product_org_auth` 授权链
+- **注意**: 不能用 `organization.parentid` 递归到顶来获取分销商，因为 parentid 是组织管理层级，不代表供应链业务关系。分销商归属必须从 `supplychain` 模块获取。
 
 ## 集市表
 
@@ -41,7 +55,9 @@
 - **TTFT × 单价**：综合性价比排序
 
 ### 多维度
-- **分销商(owner)** → **供应商(reseller)** → **销售(sale)** → **客户(customer)**
+
+- **分销商(reseller)** → **二级分销商(sub_reseller)** → **客户(customer)**
+- 层级关系来自 `supplychain` 模块：`distribution_agreements` + `product_org_auth`
 - 每层独立统计：用量、模型分布、性能、费用
 
 ## Dashboard 看板