简明版:角色、核心流程、能力清单(详细的访谈式用户故事已收敛,历史见 git)。
| 角色 | 说明 | 关键能力 |
|---|---|---|
| 访客 / 新用户 | 未注册 | 浏览市场 / 模型列表 / 登录注册 |
| 普通用户 | 注册并邮箱验证 | 自助注册、每日赠送、调用模型、钱包 / 交易记录 |
| 分享者 | 普通用户的行为角色 | 上架闲置 key 赚点数(分成 90/10) |
| 管理员 | 部署者 / 企业 IT | 成员管理、充值、用量报表、模型管理、部门 |
| 运营者 | 平台运营 | 运行时状态、点数流水、用户列表、成员充值(独立运营视图) |
- 登录页自助注册(邮箱验证码激活,未验证不可登录;验证码可重发,SMTP 失败重试 2 次、最多共 3 次尝试)
- 首次登录获得每日赠送点数(注册起 10 天 × 1 点/天,当日有效)
- 选择模型 → 网关调用(余额预检 → 路由选 key → 计费)
- 交易记录查看明细:模型 / Key 列 + 输入(非缓存) / 缓存 / 输出 / 总 Token 四列
- 共享管理页上架 key(provider / plan / model + 额度 + 可用时段 + 备注)
- 他人消费该 key → 分享者得 90% 点数(永久),写 earn 交易
- 已上架的 key 可改上架设置(留空 key 即保留原密钥),也可暂停 / 下线;状态、额度、用量实时可见
- 管理员配置 key 池(同上架机制)+ 部门 / 成员管理
- 员工消费按点数计费;部门用量报表一目了然
- 成员可提交加额申请,管理员审批
- 多协议网关:OpenAI Chat / Responses / Anthropic Messages + SSE 流式互转
- 透明计费:输入 / 缓存命中 / 输出 token 明细;各厂商价目按原币记(人民币 / 美元);高峰时段计价、按单次请求输入长度分档计价
- 点数体系:每日赠送、分享分成、管理员充值、自助注册 + 邮箱验证、找回密码
- 企业管控:部门、成员点数、用量报表、运营者视图、模型管理 CRUD
- 安全:上游 key AES-256-GCM 加密、argon2 哈希、角色隔离、主密钥机制
- 中英双语前端:仪表盘 / 模型市场 / 共享管理 / 钱包 / 交易记录 / 管理视图 / 运营视图 / 设置,全页面
- 尽量少用弹窗:操作反馈用 toast,复杂表单用内联区域
- 交易记录表支持列筛选、排序、分页与 CSV 导出;键盘导航(↑/↓ 选行、Enter 主操作、Esc 清除)对任意数据表生效
- 登录态绝不 fallback 到 mock 数据——加载失败显示空态 + 重试
- chat-modal 流式接入网关、SSE 续传、key 缓存
- 公共版共享市场深化(撮合 / 信誉体系)
- 多节点部署 / PostgreSQL / Redis(当前单机 SQLite)