# 合伙股东前后端接口约定（两代理必须遵守）

## profile `GET user.user/profile` 增补字段

```json
{
  "identity_text": "品酒师",
  "identities": ["taster"],
  "is_partner": false,
  "maker_level_name": "",
  "madow": "0.00000000",
  "madow_rate": "0.00000075",
  "madow_value": "0.00",
  "voucher_available": "0.00",
  "active_30d": true
}
```

identities 取值：`taster` | `maker` | `venue` | `county`
is_partner = 含 maker 或 venue 或 county
identity_text 例：`品酒师` / `合伙股东 · 创客V5 · 酒道馆`

## agent `GET commission.agent` 在原 agent 上增补

```json
{
  "is_venue": 0,
  "is_county": 0,
  "county_code": "",
  "direct_order_seq": 0,
  "madow": "0.00000000",
  "madow_rate": "0.00000075",
  "madow_value": "0.00",
  "voucher_total": "0.00",
  "voucher_released": "0.00",
  "voucher_used": "0.00",
  "voucher_available": "0.00",
  "active_30d": true,
  "last_self_order_time": 0,
  "identities": ["taster"],
  "identity_text": "品酒师",
  "is_partner": false,
  "maker_level_name": ""
}
```

team 列表里每个 user.agent 同样带 is_venue / is_county / level_info

## 新接口前缀 `/addons/shopro/partner.index`

| 方法 | 路径 | 说明 |
|---|---|---|
| GET | partner.index | overview |
| GET | partner.index/rewards | 分页流水 tab=all\|push3\|maker\|venue\|county\|share |
| GET | partner.index/madow | 马豆+汇率+日流水 |
| GET | partner.index/voucher | 券账户+计划列表 |

overview:

```json
{
  "month_income": "0.00",
  "skip_count": 0,
  "active_30d": true
}
```

rewards 列表项:

```json
{
  "id": 1,
  "reward_type": "push3",
  "reward_type_text": "推三返一",
  "amount": "398.00",
  "madow": "0.00000000",
  "status": 1,
  "status_text": "已入账",
  "skip_reason": "",
  "skip_reason_text": "",
  "buyer_nickname": "",
  "order_id": 1,
  "createtime": "2026-09-16 10:00:00",
  "formula": ""
}
```

madow:

```json
{
  "madow": "0.00000000",
  "madow_rate": "0.00000075",
  "madow_value": "0.00",
  "list": []
}
```

voucher:

```json
{
  "voucher_total": "0.00",
  "voucher_released": "0.00",
  "voucher_used": "0.00",
  "voucher_available": "0.00",
  "plans": []
}
```