SFTP 账号
上游数据源账号（可写 upload/）与下游客户账号（只读 files/、可写 receipt/），真实 SFTP 协议可直连，端口 —
📂账号清单—
up=上游数据源（绑供应商）· down=下游客户（绑客户，门户可见）；密码仅创建/重置时显示一次
| ID | 账号 | 角色 | 归属 | 目录占用 | 状态 | 最近登录 | 操作 |
|---|
上游账号必须先挂到「供应商档案」里的供应商名下
供应商档案
上游数据提供方（采购关系，与客户分开管理）。只记三类：基本面、价格、我们用了哪些接口/数据
🏭供应商清单—
停用后不能新增/改绑该供应商的账号，已有账号照常传输
| ID | 供应商 | 基本面 | 价格 | 用到的接口 / 数据 | 账号 | 状态 | 操作 |
|---|
分发规则
配置哪个上游 → 下发到哪些下游；文件到达上游 upload/ 静默 5 秒后自动分发并归档
🔔分发通知
企业微信机器人 webhook（可选），文件分发后推送通知
🔀路由矩阵—
勾选每个上游对应下发的下游账号
传输日志
文件分发记录 + SFTP 登录审计；服务与 Web 分进程运行，白名单为空时只监听本机
🔐接入白名单
白名单为空 = 只监听本机、外网不可达；一行一个 IP 或 CIDR（如 203.0.113.7 / 203.0.113.0/24）
封禁中：
同 IP 10 分钟内失败 20 次自动封禁 1 小时；客户已在「客户与应用 · IP 白名单」维护的出口 IP 可直接抄过来
🗂️审计流水—
最近 200 条
| 时间 | 类型 | 账号 | 对端 | 文件 | 大小 | 详情 | 次数 |
|---|
仪表盘
平台运行概览
时间
业务类型
接口域
—
📈调用趋势
—
🧩计费分类占比
🏅客户排行
TOP 8 · 条形颜色=计费分类
💰收入与成本
测试客户：收入 0，成本照算
🔻销售漏斗
—
🔄续约与增购
30 天内到期 · 金额待 CRM 接入
🕒最近调用
最新 10 条实时流水 · 仅「查得」计费
| 时间 | 客户 | 接口 | 状态 | 业务码 | 耗时 | 入参 |
|---|---|---|---|---|---|---|
| 加载中… | ||||||
数据源
接入的上游数据提供方 · 成本价支持「单价模式 / 包年包量模式」，用于毛利核算
🔌数据源清单—
成本价支持单价模式 / 包年包量模式
| ID | 名称 | 地址 | 认证 | 成本价 | 月预算 | 状态 | 备注 | 操作 |
|---|
接口管理
对外可售接口 · 「售价」面向客户，「成本价」与上游结算；未单独设置时自动跟随所属数据源
📡接口清单—
售价面向客户 · 成本价与上游结算，未单独设置则跟随数据源
| ID | 接口名称 | 对外路径 | 默认单价 | 成本价 | 成功计费码 | 缓存 | 数据源 | 状态 | 操作 |
|---|
客户
下游调用方 · 每个客户独立密钥与接口授权，可维护联系人与合同号用于账单抬头
🏢客户清单—
每个客户独立密钥与接口授权，可维护联系人与合同号
| ID | 客户名称 | 计费模式 | 有效期 | 合同号 | 联系人 | 状态 | Key 数 | App 数 | 已授权接口 | 操作 |
|---|
账单对账
按客户 × 周期统计「查得」次数 × 单价 = 应付金额，可导出 Excel 账单
🧾账单明细—
「查得」次数 × 单价 = 应付金额
📑按接口明细
| 接口名称 | 接口路径 | 总调用 | 查得次数 | 单价(元/次) | 金额(元) | 成本/毛利(内部) | 额度用量(已用/上限) |
|---|---|---|---|---|---|---|---|
| 选择客户与周期后查询 | |||||||
💡 计费口径：仅「查得」（业务成功返回 10000000）计费/计额度；查无数据、参数错误、鉴权失败、限流不计。包量客户的金额列按单价折算仅供参考，实际结算以合同包量固定价为准。
调用日志
每次调用的计量明细 · 计费依据与问题排查基础
📜调用流水—
每次调用计量记录 · 计费与排查依据
| ID | 时间 / Trace ID | 客户 / App | 接口 | 状态 | 业务码 | 耗时 | 入参 |
|---|
📚 接口文档中心
统一网关接入 · 按次计费 · 点击任意接口查看完整对接文档，可直接发给客户开发
—
接口总数
—
功能模块
🚀接入说明
四步完成对接
① 接口地址：http(s)://<平台域名>/api/v1/...，全部接口均为 POST，Content-Type: application/json
② 鉴权：请求头携带 X-App-Key 与 X-App-Secret（由平台商务签发）
③ 计费：仅「查得」（业务返回成功码）计费；查无数据、参数错误、鉴权失败、限流不计费不计额度。批量查询工坊与 API 测试工具产生的调用同此口径，同样计入客户额度与账单
④ 限流：按合同约定的 QPS 配置；超限返回 HTTP 429
成本分析
成本与毛利分析 · 成本价可设单价模式或包年包量模式（合约总价 ÷ 包量总额折算），接口级优先于数据源级
📊成本与毛利
成本价 × 查得次数 = 成本 · 收入 − 成本 = 毛利
🗄️按数据源汇总
| 数据源 | 成本单价(元/次) | 查得次数 | 收入(元) | 成本(元) | 毛利(元) | 毛利率 |
|---|---|---|---|---|---|---|
| 查询周期后展示 | ||||||
📡按接口明细
接口可覆盖数据源成本 · 「成本来源」列标注实际生效层级
| 接口 | 数据源 | 查得次数 | 售价(元/次) | 成本单价(元/次) | 成本来源 | 收入(元) | 成本(元) | 毛利(元) |
|---|---|---|---|---|---|---|---|---|
| 查询周期后展示 | ||||||||
预警中心
用量/费用阈值预警：达到阈值自动记录并推送 Webhook
🚨预警规则—
达到阈值自动记录并推送 Webhook
| ID | 客户 | 指标 | 阈值 | 统计周期 | 静默期 | 状态 | 操作 |
|---|
📣触发记录—
按触发时间倒序
| ID | 时间 | 客户 | 指标 | 当前值 | 阈值 | 渠道 |
|---|
Webhook 告警
预警触发时自动 POST 推送到钉钉/企业微信/飞书或自建接收端
🔔推送通道—
钉钉 / 企业微信 / 飞书 / 自建接收端
| ID | 名称 | 地址 | 订阅事件 | 状态 | 操作 |
|---|
💡 推送报文：POST application/json，字段含 event/title/message/customer/metric/value/threshold/ts。测试按钮可验证连通性。
IP 白名单
按客户限制调用来源 IP（支持单 IP 与 CIDR 网段；未配置 = 不限制）
🛡️白名单规则—
支持单 IP 与 CIDR 网段 · 未配置 = 不限制
| ID | 客户 | IP / 网段 | 备注 | 状态 | 操作 |
|---|
账号管理
后台管理员账号；密码须满足复杂度策略（至少 8 位，含大小写字母与数字）
👤平台账号—
按角色分配模块权限
| ID | 用户名 | 角色 | 最近登录 | 状态 | 创建时间 | 操作 |
|---|
🔐角色权限矩阵
平台内部岗位角色（点表头可看模块全称）
读＝可查看（GET）；读写＝可新增与修改（POST/PATCH）；全权＝额外可删除（DELETE）；—＝无权限（侧栏隐藏 + 后端拒绝）。「账号与安全」的开号、改角色、调权限、删除始终仅超级管理员可执行，其他账号最多被授予只读，防止自我提权。
🏢客户侧角色权限
客户人员登录客户门户，只能看到本公司数据
客户侧账号在「客户与应用 → 门户账号」中开通：一个客户可开多个账号（1 个客户管理员 + 若干只读）。客户侧账号进不了管理后台，也看不到其他客户。
待办中心
跨模块行动项 · 预算、授权到期、文档漂移、账号审批统一收敛；预警是事实流水，这里是要办的事
📋
—
待处理
🆕
—
本周新增
✅
—
已解决
🔴
—
紧急任务
📋任务流
点击「解决」将任务标记完成
预算与策略
数据源月度成本预算与阶梯式自动控制 · 从通知、警告、切换备用源到熔断逐级升级
📅本月预算执行
—
| 数据源 | 月预算 | 已用 / 进度 | 查得次数 | 备用源 | 状态 | 操作 |
|---|
🎚️5 档自动控制
阈值 / 动作对照
0%启动期 · 记录基线数据
50%正常 · 绿灯，不触发任何动作
70%通知 · Webhook「预算预警」+ 待办中心 🟢 任务
85%警告 · 短信 + 备用源并行试用 + 待办中心 🟡 任务
95%限流 · 自动切换备用源为主流量 + 待办中心 🔴 任务
100%熔断 · 暂停原源 + 全部走备用源 + 最高级 Webhook
与现有「预警中心」共享触发逻辑 · 同样会写 AlertRecord 与触发 Webhook
应用与门户
客户应用与自助门户 · App 独立密钥与限额，门户账号可自助查询本公司的用量与账单
📱客户应用（App）—
生产 / 沙箱 / 测试环境，各自独立密钥与限额
| 客户 | App 名称 | 环境 | X-App-Key | QPS | 授权数 | 生效/到期 | 状态 | 操作 |
|---|
每个 App 开通后自动签发 X-App-Key 与 X-App-Secret（仅创建时显示一次）。删除 App 时其下 key 与 App 级授权会自动停用
🪪客户门户账号—
门户地址：/portal/ · 客户仅能看到自己公司的数据
| ID | 客户 | 用户名 | 客户侧角色 | 最近登录 | 状态 | 开通时间 | 操作 |
|---|---|---|---|---|---|---|---|
| 加载中… | |||||||
客户侧账号只能看本公司数据，进不了管理后台，也看不到其他客户。客户管理员可管密钥与 SFTP 传输；客户只读仅看接口目录、用量与账单。每个客户至少保留 1 个客户管理员。
链路追踪
每次调用生成 Trace ID，串联客户 → 网关 → 上游 → 网关 → 客户的全链路耗时
🔗链路列表—
点击查看 客户 → 网关 → 上游 的全链路耗时
| Trace ID | 调用次数 | 累计耗时 | 最后出现 | 操作 |
|---|