供应商画像

总览

交互以原型 供应商画像-V1.1.html 为准。所有接口在运营后台服务（admin）下，需登录 token。

通用约定

• 全部 POST + JSON，返回 { "code": 0, "msg": "success", "data": … }；code != 0 时 msg 直接 toast。
• 数据截至：所有统计截至 昨天（今天的场次不算），用出参 statDate 展示「数据截至 2026.10.25」。
• 统计窗口：近 N 天 = [statDate-N+1, statDate]；上 N 天 = 紧挨着的前 N 天，不重叠。按 场次日期统计。
• 统计数据后端按天缓存，当天内重复打开数字不变（标签、处罚明细不缓存）。
• 金额单位 元；比率字段单位为 %，后端保留 2 位，前端展示 1 位；扎数为整数（JSON 数字）。
• 时间格式 yyyy-MM-dd HH:mm:ss，日期 yyyy-MM-dd。
• 分页出参统一为 { index, size, total, records }；入参用 pageNum，pageSize 固定 10（可不传）。

加载时序

点「画像」 → 并发 ① base + ② metrics + ④ category → 7/30 天切换：纯前端切 ② 的 "7"/ "30"，默认近 7 天

「处罚次数 · 查看明细」 → ③ period = 当前履约卡片选中的 7/30

「品类数据 · 查看明细」 → ⑤ viewType = 当前分段（main/prefer/quality） → 「在售主力花材 · 查看明细」 → ⑤ viewType=active

「编辑标签」 → ⑥ 拉标签库（过滤 type=2） → 前端维护草稿 → 「保存标签」调 ⑦

枚举

标签分类 tagCategory（按分类显示不同颜色徽标）

合作状态 cooperateStatus

直接展示 cooperateStatusName 即可：0 未认证 / 1 待审核 / 2 正常 / 3 审核不通过 / 4 已清退 / 5 已冻结 / -100 已删除。

品类视图 viewType

main 主营品类 · prefer 优选 · quality 品质优选 · active 在售主力花材

等级 rankNum

1~6 对应 A/B/C/D/E/O，可拼在商品名后（如「红玫瑰 A级」）。

接口

POST/supplier/profile/base基础信息与标签

入参

{ "supplierId": 10002 }

出参 data

{
  "statDate": "2026-10-25", "supplierId": 10002, "supplierName": "云岭花卉合作社",
  "loginTel": "18756300314", "cooperateStatus": 2, "cooperateStatusName": "正常",
  "enterTime": "2024-03-18 10:00:00", "lastSellTime": "2026-10-25 14:26:00",
  "tagList": [ { "supplierId": 10002, "tagId": 1, "tagName": "玫瑰主供", "tagCategory": "profile" } ]
}

POST/supplier/profile/metrics经营概览 + 履约与售后

入参

{ "supplierId": 10002 }

出参结构

business、service 都是以 "7"、"30"（字符串）为 key 的对象。带环比的指标统一为 指标对象：

business["7" | "30"]（经营概览）

service["7" | "30"]（履约与售后）

顶层

statDate 数据截至日；totalPunishCount 历史累计处罚次数（不随 7/30 变化）。

{
  "statDate": "2026-10-25",
  "business": {
    "7":  { "sellDays": { "current": 6, "previous": 5, "delta": 20.0 },
            "sellNum":  { "current": 9200, "previous": 8100, "delta": 13.6 },
            "sellAmount": { "current": 138000.00, "previous": 123000.00, "delta": 12.2 } },
    "30": { ... }
  },
  "service": {
    "7":  { "afterSaleAmount": { "current": 4680.00, "previous": 4440.00, "delta": 5.4 },
            "afterSaleRate":   { "current": 2.70, "previous": 2.90, "delta": -0.2 },
            "afterSaleNum": 320, "afterSaleCount": 19,
            "lackRate":      { "current": 0.90, "previous": 1.20, "delta": -0.3 },
            "lowerRankRate": { "current": 0.60, "previous": 0.80, "delta": -0.2 },
            "punishCount": 4 },
    "30": { ... }
  },
  "totalPunishCount": 27
}

POST/supplier/profile/punishPage处罚明细

入参

records[]（按处罚时间倒序）

{ "index": 1, "size": 10, "total": 16, "records": [
  { "id": 1, "punishType": 1, "punishTypeName": "缺货处罚", "punishTime": "2026-10-18 09:32:00",
    "punishPrice": 800.00, "roundNo": "2026-10-18", "orderSn": "...", "remark": "..." } ] }

total 与指标里的 punishCount（同周期）一致；弹窗副标题「共 N 条 · 每页 10 条」用 total。

POST/supplier/profile/category品类看板

入参

{ "supplierId": 10002 }

出参 data

商品对象（④ ⑤ 共用）

{
  "statDate": "2026-10-25",
  "main": [ { "productId": 1, "productName": "红玫瑰", "rankNum": 1, "sellNum": 12800, "afterSaleRate": 2.60, "preferFlag": 1, "qualityFlag": 0 } ],
  "prefer": [ ... ], "quality": [ ... ], "active": [ ... ],
  "growth": [ { "secondId": 9, "secondName": "绣球", "recentNum": 1760, "previousNum": 980, "diffNum": 780 } ],
  "mainTotal": 8, "preferTotal": 6, "qualityTotal": 6, "activeTotal": 6
}

POST/supplier/profile/categoryPage品类明细

入参

出参

{ index, size, total, records: [商品对象] }。sortBy=sales 时第 1 页前 3 条与 ④ 的 Top3 一致。

POST/purchaser/userTag/list系统标签库（已有接口）

无入参。返回全部标签 [{ id, type, tagCategory, name }]，前端过滤 type == 2（供应商标签）。

POST/supplier/profile/tagSave保存标签

入参

{
  "supplierId": 10002,
  "tagIdList": [1, 5, 9],
  "newTagList": [ { "name": "冷链配送", "tagCategory": "other" } ]
}

出参

供应商对象，取 supplierTagList[]（tagId、tagName、tagCategory）刷新抽屉头部标签。

规则

• 覆盖式保存：请求里没有的旧标签会被移除。
• 合计最多 8 个（tagIdList + 新标签，去重后）。
• 新标签保存后自动进入系统标签库，下次打开 ⑥ 就能选到。
• 新标签名与库里已有的供应商标签同名时，直接复用已有标签（分类以库里为准），不会重复建。
• 只有点「保存标签」才调接口；编辑弹窗内的增删都是前端草稿。

错误文案（直接 toast）

「每个供应商最多 8 个标签」「标签名称最多 5 个字」「标签名称不能为空」「请选择标签分类」「标签不存在或不是供应商标签:{id}」；5 秒内重复提交会报重复提交。

展示规则

• 抽屉标签：最多显示 7 个，超出显示 +N（N = 总数 − 7）；无标签显示「暂无标签」；颜色按 tagCategory。
• 编辑标签弹窗：提示「当前供应商已配置标签」「保存后生效」；草稿满 8 个时禁用标签库按钮和新增输入。
• 环比箭头：delta > 0 ↑、< 0 ↓、= 0 持平；数量/金额类显示「↑ 11.0%」，比率类显示「↑ 0.3 个百分点」；null 显示「—」。涨跌配色由前端定（售后率、缺货率、降级率上涨应用警示色）。
• 7/30 切换：经营概览、履约与售后两张卡片各自独立切换，默认 近 7 天；切换不请求接口。文案里的「近N天/上N天」随之变化（原型顶部固定写「近 30 天 对比上 30 天」的那一行请跟着切换或去掉）。
• 处罚明细弹窗：标题「近N天处罚明细」，副标题「共 total 条 · 每页 10 条」，提示「处罚记录按处罚时间倒序展示」；高度按满页 10 行固定；处罚时间、金额左对齐。
• 品类数据卡片：分段 主营品类 / 优选 / 品质优选；优选视图商品名后加「优选」徽标，品质优选视图加「品质优选」徽标，主营不加。
• 品类数据明细弹窗：标题「品类数据明细」，弹窗内同样三段切换（切换时 pageNum 重置为 1，保持当前排序）；排序按钮「按近30天销售扎数」「按售后率」；高度固定，切换不跳动。
• 在售主力花材明细：标题「在售主力花材明细」，无三段切换，viewType=active，排序按钮「按近7天销售扎数」「按售后率」。
• 数字千分位：扎数、金额前端格式化（12,800 扎、¥729,300）。

「统计口径」弹窗文案

抽屉右上角「统计口径」入口，静态文案（与后端实现一致，可直接使用）：

统计周期均以昨天为截止日，今天的场次不计入。

联调注意

• 测试环境：运营后台测试服（bulky-test/admin），接口已部署，可直接联调。
• 测试库很多供应商近 60 天没有订单，指标会全是 0、delta 为 null、品类列表为空——属正常，请用近期有下单的供应商联调；空态请按原型做好「暂无数据」。
• 统计接口当天有缓存：测试同学当天补的订单/处罚，指标次日才变化；处罚明细（③）和标签（①⑦）是实时的，所以当天新增的处罚可能出现「明细条数 > 指标次数」，次日恢复一致。
• business/ service 的 key 是字符串 "7"、"30"，不是数字下标。
• 比率字段后端 2 位小数（如 2.70），展示时 toFixed(1)。