3.3 KiB
3.3 KiB
项目愿景
一、核心目标
cmhub 要解决：cmbot 的 AI 生成能力（标题、图片）目前锁在单机桌面工具里，无法被其他项目复用，也没有计费和用量管控。
让其他业务项目能够通过 HTTP API 调用 AI 生成标题和图片，并获得按点数计费、用量可控、调用可追溯的能力。
它面向两类使用者：终端用户在自助用户端注册、扫码充值、管理自己的 API Key；其他业务项目/程序用这些 API Key 调用生成接口。本服务是自助用户端 + 计费型 AI 能力网关 + 运营后台三合一。用户端不做面向消费者的「内容生成产品页」，只做账户自助（注册/充值/Key 管理/记录），生成结果仍只经 API 输出。
二、目标用户
- 注册用户（终端用户）：在用户端自助注册登录、扫码充值、查看自己的充值记录/充值总额/剩余点数/消费记录、自助生成与删除 API Key。点数余额挂在用户账户上。
- 接入方（用户的程序 / 其他项目）：拿用户名下的 API Key 调用生成接口，关心稳定、点数够不够、报错清晰；扣的是所属用户的点数。
- 运营人员：在 django-admin 管理注册用户、点数余额、计费规则，查看充值和调用记录，处理点数不足/异常。
三、产品原则
遇到取舍时，以这些原则为准：
- 核心流程优先：先把「鉴权 → 计费 → 生成 → 扣点 → 记录」这条主链路做顺。
- 真实数据优先：点数、金额、扣费、充值不造假；不用演示逻辑冒充计费逻辑。
- 账目必须对得上：每一笔点数变动都有流水、可追溯到充值订单或调用记录。
- 试用额度可控：新用户注册送 10 点试用点数降低首次接入门槛，但必须按账本发放、可追溯、可防重复。
- 小步交付：每一步都能运行、能验证、能回退。
- 少即是稳：MVP 不追求完整，只追求最小闭环可靠；先同步、先单机、先后台手工开通。
- 可维护：复用
cmbot现有 AI 调用代码，不另起一套。
四、核心价值主张
| 价值点 | 说明 |
|---|---|
| 能力复用 | 把 cmbot 的标题/图片生成开放给任意项目，无需各自重复对接上游 |
| 按量计费 | 不同操作/模型消耗不同点数，用量与成本可控 |
| 充值即点数 | 外部支付系统付款后自动转点数，扣费与上游解耦、低延迟 |
| 可观测可运营 | django-admin 一处管理账号、点数、计费规则、充值与调用记录 |
五、不做什么（非目标）
- 不做自建支付/收银台，付款在外部支付系统完成，本服务发起扫码下单并接收回调，不碰资金清算。
- 不做异步任务队列（第一版图片生成走同步等待）。
- 不做面向终端消费者的「内容生成产品页」；用户端只做账户自助（注册/充值/API Key 管理/记录查询）。
- 不做复杂活动赠点、邀请奖励或历史用户自动补发；当前只做新用户注册一次性 10 点试用额度，且必须配套防刷、幂等和流水留痕。
- 不做多币种、分账、自动退款对账等容易膨胀、不属于 MVP 的能力。
MVP 的具体功能范围与验收标准，见 需求。