# feehtml

**Repository Path**: shiwj/feehtml

## Basic Information

- **Project Name**: feehtml
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-05
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 数慧通管理后台 · 原型说明

> `feehtml` 静态 HTML 原型，用于需求确认与交互演示。入口：[`index.html`](index.html)。

## 目录

| 章节 | 说明 |
|------|------|
| [快速入门](#快速入门) | 如何预览、目录约定 |
| [页面索引](#页面索引) | 全部页面与脚本一览 |
| [模块说明](#模块说明) | 按侧边栏顺序展开功能点 |
| [业务架构](#业务架构) | 依赖关系、核心流程、跨模块规则 |
| [附录](#附录) | 字段与资质细则、更新记录 |

---

## 快速入门

**预览方式**：浏览器直接打开 `index.html`，或通过静态服务器访问本目录。

**技术约定**

| 项 | 说明 |
|----|------|
| 样式 | `css/common.css` |
| 脚本 | `js/<页面名>.js`，公共逻辑见 `js/common.js` |
| 数据 | 前端 Mock，无后端依赖 |
| 导航 | 各页面共用左侧菜单，顺序与下文模块说明一致 |

**目录结构（摘要）**

```
feehtml/
├── index.html          # 功能说明入口
├── css/common.css
├── js/                 # 页面交互脚本
├── *.html              # 各功能页面（见页面索引）
└── README.md
```

---

## 页面索引

共 **21** 个页面，归属 **7** 个一级模块、**17** 个二级功能。

| 一级模块 | 二级模块 | 页面 | 脚本 |
|----------|----------|------|------|
| 功能说明 | 功能架构 / 流程 / 规则 | `index.html` | — |
| 应用管理 | 应用授权 | `app-auth.html` | `js/app-auth.js` |
| 应用管理 | 流控策略 | `flow-policy.html` | `js/flow-policy.js` |
| 应用管理 | 调用日志 | `call-log.html` | `js/call-log.js` |
| 应用管理 | 客户工作台 | `portal-workbench.html` | `js/portal-workbench.js` |
| 基础数据 | 供应商管理 | `supplier-manage.html` | `js/supplier-manage.js` |
| 基础数据 | 客户管理 | `customer-manage.html` | `js/customer-manage.js` |
| 基础数据 | 接口管理 | `api-manage.html` | `js/api-manage.js` |
| 接口计费 | 计费规则管理 | `price-config.html` | `js/price-config.js` |
| 接口计费 | 计费任务管理 | `billing-generate.html` | `js/billing-generate.js` |
| 数据校验 | 检验规则管理 | `rule-manage.html` | `js/rule-manage.js` |
| 数据校验 | 计费数据查询 | `validation-log.html` | `js/validation-log.js` |
| 告警管理 | 告警配置 | `alarm-config.html` | `js/alarm-config.js` |
| 告警管理 | 告警日志 | `alarm-log.html` | `js/alarm-log.js` |
| 报表统计 | 客户调用统计（按天） | `report-daily.html` | `js/report-daily.js` |
| 报表统计 | 客户计费统计（按月） | `report-month.html` | `js/report-month.js` |
| 报表统计 | 供应商计费统计（按月） | `report-supplier-month.html` | `js/report-supplier-month.js` |
| 报表统计 | 客户月报接口明细 ↳ | `report-detail.html` | — |
| 报表统计 | 客户核减明细 ↳ | `report-deduct-detail.html` | — |
| 报表统计 | 供应商月报接口明细 ↳ | `report-supplier-detail.html` | `js/report-supplier-detail.js` |
| 报表统计 | 报表列表（辅助） | `report-list.html` | — |

> ↳ 表示下钻/辅助页。报表相关弹窗逻辑见 `js/report-billing-shared.js`、`js/report-deduct-modal.js` 等共享脚本。

---

## 模块说明

> 顺序与左侧导航一致。系统定位：**接口开放 + 调用校验 + 计费批处理 + 多维度报表**。

### 功能说明

| 页面 | 内容 |
|------|------|
| `index.html` | 六层模块拓扑与依赖；测试帐号开通、T+1 计费两条业务流程；三种计费模式与测试调用不计费规则 |

---

### 应用管理

基于客户与接口配置访问授权，产生原始调用日志。

| 二级模块 | 核心功能 |
|----------|----------|
| 应用授权 | 左客户 / 右授权列表；应用 CRUD；测试/正式帐号；穿梭框绑定 API；流控策略 + IP 白名单；有效期；AppKey/SecretKey 自动生成与刷新；启用/停用/过期 |
| 流控策略 | 策略 CRUD；按秒/分/时/日配置调用上限；供应用授权引用 |
| 调用日志 | 多条件查询；请求头/参数/响应详情；测试调用标识；导出；测试调用不参与检验与计费 |
| 客户工作台 | 企业隔离；Tab：数据概览 / 按月账单 / 按日统计 / 调用明细；展示有效调用量与有效支出 |

---

### 基础数据

维护供应商、客户、接口主数据，为授权、校验、计费、报表提供基础。

| 二级模块 | 核心功能 |
|----------|----------|
| 供应商管理 | 档案 CRUD；启用/停用；列表与详情；与接口一对多；停用后下属接口不参与新计费 |
| 客户管理 | 代理商—企业二级树；类型：代理商 / 企业（企业须归属代理商）；CRUD；企业关联系统帐号；详情含授权接口（按供应商分组） |
| 接口管理 | 左供应商 / 右接口；接口 CRUD（名称、路径、请求方式、发布状态）；维护供应商归属 |

字段与资质细则见 [附录 A](#附录-a-基础数据字段与资质)。

---

### 接口计费

按企业配置计价规则，定时/手动批处理生成计费数据。

| 二级模块 | 核心功能 |
|----------|----------|
| 计费规则管理 | 按企业配置；统一单价 / 阶梯单价 / 分接口单价；规则 CRUD + 历史版本；保存后立即生效 |
| 计费任务管理 | 自动 T+1 批处理；手动补跑；可选企业/接口/规则范围；计费规则快照；覆盖/追加写入；执行记录 |

计费模式说明见 [附录 B](#附录-b-计费模式)。

---

### 数据校验

对调用返回做有效性判定，有效数据进入计费链路。

| 二级模块 | 核心功能 |
|----------|----------|
| 检验规则管理 | 规则 CRUD；JSON 节点 / 正则；JSONPath + 表达式 + 预期值；关联接口；优先级；启用/停用 |
| 计费数据查询 | 检验后数据查询；有效/无效筛选；总量/有效量/无效量/有效率统计；校验详情 |

---

### 告警管理

配置短信告警，监控系统异常并处理告警记录。

| 二级模块 | 核心功能 |
|----------|----------|
| 告警配置 | 规则 CRUD；触发类型：调用失败率、计费任务失败、流控超限、接口超时；短信、静默时长、级别；适用范围与阈值 |
| 告警日志 | 记录查询；级别/状态/类型/时间筛选；待处理标记已处理或忽略 |

---

### 报表统计

由计费任务产出日报/月报，支持核减与多维度汇总。

| 二级模块 | 核心功能 |
|----------|----------|
| 客户调用统计（按天） | 维度：代理商 + 客户 + 供应商 + 接口 + 日期；调用量、成功率、计费类型/规则、支出；阶梯模式日支出显示 — |
| 客户计费统计（按月） | 维度：代理商 + 客户 + 自然月；原/核减/有效调用量与支出；操作栏核减；下钻接口明细（阶梯分档表） |
| 供应商计费统计（按月） | 维度：供应商 + 自然月；原/核减/有效调用量与支出；按接口核减；下钻明细 |

---

## 业务架构

### 业务主线

| 主线 | 链路 |
|------|------|
| 测试帐号开通 | 客户联调 → 调用日志 → 跳过检验与计价 |
| 正式接口计费 | 源调用 → T+1（检验 → 计价 → 日报）→ 月报聚合 → 核减调整 |

### 模块依赖

```
基础数据（供应商 → 接口、代理商 → 企业 → 系统帐号）
    ↓
应用管理（流控策略 → 应用授权 → 调用日志 → 工作台）
    ↓
数据校验（检验规则 → 计费数据查询）
    ↓
接口计费（计费规则 → 计费任务）
    ↓
报表统计（日统计 → 客户/供应商月报 + 核减）
    ↑
告警管理（监控调用 / 任务 / 流控 / 超时）
```

### 核心流程

**测试帐号开通**

```
客户管理 → 应用授权（测试帐号）
    → 绑定 API + 限流策略 + IP 白名单（可选）
    → AppKey/SecretKey → 调用日志
    → 跳过检验与计价，不计入计费报表
```

**接口计费（T+1）**

```
源调用数据 → 每日 T+1 批处理
    → 检验规则 → 有效数据 → 计费规则 → 日报
    → 月报聚合 → 核减调整（可选）→ 有效调用量/支出
```

### 跨模块规则

| 规则 | 说明 |
|------|------|
| 测试帐号隔离 | 写日志，跳过检验与计价，不计入计费报表 |
| T+1 批处理 | 每日处理前一自然日：检验 → 计价 → 日报 |
| 月报来源 | 客户/供应商月报由日报按自然月聚合 |
| 核减生效 | 作用于月报，保存后有效量/支出即时更新 |
| 阶梯计价 | 周期累计分档；核减与下钻按阶梯重算 |
| 主数据联动 | 停用客户暂停授权；停用供应商接口不参与新计费 |
| 代理商与企业 | 企业须归属代理商；报表按代理商筛选；计费/授权以企业为粒度 |
| 日统计支出 | 统一/分接口：日支出 = 单价 × 调用量；阶梯：日支出显示 — |
| 月报计费公式 | 统一/分接口：支出 = 单价 × 有效次数；阶梯：按累计量分档 |

---

## 附录

### 附录 A · 基础数据字段与资质

#### 基本信息

| 模块 | 必填 | 选填 |
|------|------|------|
| 供应商管理 | 名称、编码、联系人、联系电话 | 状态、备注 |
| 客户管理 | 类型、名称、编码、联系人、联系电话；企业另须所属代理商、关联系统帐号（新增时） | 状态、备注 |

#### 资质上传

格式：JPG / PNG / PDF，单文件 ≤ 5MB；提交校验必传项；详情页图片/PDF 预览。

| 模块 | 必传 | 选填 |
|------|------|------|
| 供应商管理 | 营业执照、增值业务许可证、数据安全合规问卷、信息安全承诺函 | 法人身份证正反面、信息安全资质、合规内控制度 |
| 客户管理 | 营业执照、金融许可证、用户授权协议、信息安全承诺函 | 法人身份证正反面、信息安全资质、合规内控制度 |

### 附录 B · 计费模式

| 模式 | 计价方式 |
|------|----------|
| 统一单价 | 企业下所有授权接口共用同一单价（元/次） |
| 阶梯单价 | 按周期累计有效调用量分档；日报展示规则摘要，日支出 —，月报展示分档结果 |
| 分接口单价 | 对企业有权限的接口逐条设价 |

### 附录 C · 侧边栏导航

```
功能说明
├── 应用管理（应用授权 · 流控策略 · 调用日志 · 工作台）
├── 基础数据（供应商管理 · 客户管理 · 接口管理）
├── 接口计费（计费规则管理 · 计费任务管理）
├── 数据校验（检验规则管理 · 计费数据查询）
├── 告警管理（告警配置 · 告警日志）
└── 报表统计（客户日统计 · 客户月报 · 供应商月报）
```

### 附录 D · 更新记录

| 日期 | 变更 |
|------|------|
| 2026-06-15 | 客户/供应商资质上传；代理商—企业客户体系 |
| 近期 | 法人身份证正反面改选填；联系人/联系电话改必填；README 结构优化 |