FranklinWH API Portal
MVP 原型 (2026-05-08) — 移除个人开发者注册，所有角色共用通用工作台
🚀 角色工作台入口
演示入口选择角色快速进入对应的工作台页面，体验不同用户视角
📄 原型页面列表
29 个页面| # | 页面名称 | 需求来源 | 描述 | 操作 |
|---|---|---|---|---|
| 🌐 登录前页面 (公开访问) | ||||
| 1 | 开发者落地页 | US-003 | 官网开发者入口，展示 API 核心能力 | 查看 |
| 2 | API 文档 | US-001 | 登录前可见的 API 文档页面 | 查看 |
| 3 | 快速入门 新增 | US-021 | 5分钟完成首次 API 调用，多语言代码示例 | 查看 |
| 4 | Swagger UI | US-002 | 在线 API 调试工具 | 查看 |
| 5 | 定价方案 新增 | 竞品对标 | 套餐对比、功能矩阵、FAQ | 查看 |
| 6 | 更新日志 新增 | 竞品对标 | 版本变更、新功能、废弃通知、迁移指南 | 查看 |
| 7 | 系统状态 新增 | 竞品对标 | 服务可用性、响应时间、历史事件 | 查看 |
| 8 | 登录页面 | US-010, US-011 | FleetView SSO + 无感验证 | 查看 |
| 10 | 套餐开通引导 | US-PA | FleetView 用户首次登录后的套餐选择引导 | 查看 |
| 11 | 账号状态 | US-PA | 套餐待开通、申请审核中状态展示 | 查看 |
| 🔐 登录后页面 (按角色区分) | ||||
| 13 | 开发者工作台（通用） | 免费版 | API 调用统计、密钥管理、套餐管理（所有角色共用） | 查看 |
| ↳ developer/api-keys.html | API Keys 管理 | 查看 | ||
| ↳ developer/logs.html | 调用日志 | 查看 | ||
| ↳ developer/plan.html | 套餐管理 | 查看 | ||
| ↳ developer/settings.html | 账号设置 | 查看 | ||
| ↳ developer/swagger.html | API 调试 (登录后) | 查看 | ||
| ⚙️ 管理后台 | ||||
| 22 | 管理后台 | US-090~092 | 账号审批、调用监控、限流管理 | 查看 |
| ↳ 账号列表 | 用户账号管理、搜索、筛选 | 查看 | ||
| ↳ 企业管理 | 企业账号、配额、合同管理 | 查看 | ||
| ↳ 调用统计 | 全平台 API 调用量监控与分析 | 查看 | ||
| ↳ 异常检测 | 异常调用模式和安全威胁检测 | 查看 | ||
| ↳ 全局调用日志 | 所有账号历史调用日志明细，支持筛选和导出 | 查看 | ||
| ↳ 系统健康 | 各服务运行状态监控 | 查看 | ||
| ↳ 限流配置 | 各套餐 API 调用限制配置 | 查看 | ||
| ↳ 套餐申请 新增 | 套餐申请审批、SLA 监控 | 查看 | ||
| ↳ 定价套餐配置 新增 | 套餐管理、计费模式配置、阶梯定价 | 查看 | ||
| ↳ API 版本 | API 版本生命周期管理 | 查看 | ||
| ↳ 权限模板 | 角色-Scope 授权矩阵和权限模板 | 查看 | ||
💡 使用说明
这是一个纯静态 HTML 原型，可直接在浏览器中打开查看。所有数据均为模拟数据，用于验证 UI 设计和用户流程。
🧭 导航栏设计逻辑
登录前页面（公开访问）
导航：首页 | 文档 | 快速入门 | API 调试 | 定价
右侧：[登录] [开始使用] 按钮
适用：landing, docs, quickstart, swagger, pricing, changelog, status, login
登录后页面（需要认证）
导航：文档 | API 调试 | 工作台
右侧：用户邮箱 + 头像
适用：dashboard-*, api-keys, telemetry, alerts, oauth, admin
📊 竞品对标改进
基于 Enphase、Tesla、Sigenergy、Stripe、RapidAPI 等优秀 API 平台的分析，本次原型新增以下关键功能：
✅ 开发者体验 (DX)
- • 快速入门引导 (5分钟首次调用)
- • 多语言 SDK 代码示例
- • 一键复制代码片段
- • Postman Collection 导出
✅ 商业化准备
- • 分层定价方案 (免费/Pro/Business/Partner)
- • 功能对比矩阵
- • 配额使用可视化
- • 超额预警机制
✅ 透明度与信任
- • 系统状态页面 (可用性监控)
- • API 响应时间展示
- • 历史事件记录
- • 状态订阅通知
✅ 版本管理
- • 详细更新日志
- • 破坏性变更预警
- • 废弃通知与迁移指南
- • 邮件/RSS 订阅