Skip to content

Latest commit

 

History

History
52 lines (39 loc) · 2.95 KB

user-stories.md

File metadata and controls

52 lines (39 loc) · 2.95 KB

AITokenPool 产品能力

简明版:角色、核心流程、能力清单(详细的访谈式用户故事已收敛,历史见 git)。

1. 角色

角色 说明 关键能力
访客 / 新用户 未注册 浏览市场 / 模型列表 / 登录注册
普通用户 注册并邮箱验证 自助注册、每日赠送、调用模型、钱包 / 交易记录
分享者 普通用户的行为角色 上架闲置 key 赚点数(分成 90/10)
管理员 部署者 / 企业 IT 成员管理、充值、用量报表、模型管理、部门
运营者 平台运营 运行时状态、点数流水、用户列表、成员充值(独立运营视图)

2. 核心流程

注册 → 首次消费

  1. 登录页自助注册(邮箱验证码激活,未验证不可登录;验证码可重发,SMTP 失败重试 2 次、最多共 3 次尝试)
  2. 首次登录获得每日赠送点数(注册起 10 天 × 1 点/天,当日有效)
  3. 选择模型 → 网关调用(余额预检 → 路由选 key → 计费)
  4. 交易记录查看明细:模型 / Key 列 + 输入(非缓存) / 缓存 / 输出 / 总 Token 四列

上架 → 分享收益

  1. 共享管理页上架 key(provider / plan / model + 额度 + 可用时段 + 备注)
  2. 他人消费该 key → 分享者得 90% 点数(永久),写 earn 交易
  3. 已上架的 key 可改上架设置(留空 key 即保留原密钥),也可暂停 / 下线;状态、额度、用量实时可见

企业管控

  1. 管理员配置 key 池(同上架机制)+ 部门 / 成员管理
  2. 员工消费按点数计费;部门用量报表一目了然
  3. 成员可提交加额申请,管理员审批

3. 能力清单(对照 README 特性)

  • 多协议网关:OpenAI Chat / Responses / Anthropic Messages + SSE 流式互转
  • 透明计费:输入 / 缓存命中 / 输出 token 明细;各厂商价目按原币记(人民币 / 美元);高峰时段计价、按单次请求输入长度分档计价
  • 点数体系:每日赠送、分享分成、管理员充值、自助注册 + 邮箱验证、找回密码
  • 企业管控:部门、成员点数、用量报表、运营者视图、模型管理 CRUD
  • 安全:上游 key AES-256-GCM 加密、argon2 哈希、角色隔离、主密钥机制
  • 中英双语前端:仪表盘 / 模型市场 / 共享管理 / 钱包 / 交易记录 / 管理视图 / 运营视图 / 设置,全页面

4. UI 约定

  • 尽量少用弹窗:操作反馈用 toast,复杂表单用内联区域
  • 交易记录表支持列筛选、排序、分页与 CSV 导出;键盘导航(↑/↓ 选行、Enter 主操作、Esc 清除)对任意数据表生效
  • 登录态绝不 fallback 到 mock 数据——加载失败显示空态 + 重试

5. 规划(未实现)

  • chat-modal 流式接入网关、SSE 续传、key 缓存
  • 公共版共享市场深化(撮合 / 信誉体系)
  • 多节点部署 / PostgreSQL / Redis(当前单机 SQLite)