3.0 KiB
3.0 KiB
Use bot API for draw and points data
Goal
将当前 nonebot 抽卡与积分运行时数据读写接入 xapi /bot API,避免继续写本地抽卡和积分 SQLite,并保持现有命令层行为不变。
What I already know
- 用户指定的 API 文档位于
C:\Users\14244\source\repos\Danding_Webs\xapi_new_web\docs\bot-api.md和nonebot-migration-guide.md。 danding_points当前已经通过aiohttp调用/bot/points/*,未发现database.py或本地 points SQLite 写入。onmyoji_gacha/data_manager.py当前已经通过aiohttp调用/bot/gacha/*,核心抽卡概率仍保留在 nonebot 本地。- 抽卡签到当前流程为先调用
/bot/points/add发积分,再调用/bot/gacha/sign-in记录签到;若 xapi 返回重复签到,会造成重复发积分。 tests/test_danding_points_http_api.py和tests/test_onmyoji_gacha_http_api.py已覆盖主要 HTTP 鉴权和 no-SQLite 约束。
Requirements
- 积分账户、积分流水读写继续严格通过
/bot/pointsAPI。 - 抽卡结果、三连抽、式神基础数据、用户统计、每日统计、排行榜、每日记录、成就查询与成就 claim 继续严格通过
/bot/gachaAPI。 - 抽卡概率、SSR/SP viptime 奖励、成就奖励编排继续保留在 nonebot 本地。
- 抽卡签到必须避免重复发积分:只有 xapi 成功记录本日签到后,才允许调用
/bot/points/add发放签到积分。 - 不实现历史 SQLite 到 xapi 的数据迁移,不生成回滚快照。
Acceptance Criteria
danding_points不写本地积分 SQLite,HTTP 请求的鉴权位置符合文档。onmyoji_gacha不写本地抽卡 SQLite,抽卡写入走/bot/gacha/draw和/bot/gacha/draw/triple。- 重复签到时不会调用
/bot/points/add发放积分。 - API 失败时保持当前命令层可恢复失败语义,不空 catch。
- 相关单元测试通过。
Definition of Done
- 代码改动局限在抽卡/积分 API 数据流。
- 更新或补充能覆盖本次行为的测试。
- 运行相关测试,必要时运行 lint/type-check。
- 若发现文档外接口缺口,停止并向用户说明具体阻塞点。
Technical Approach
沿用现有 PointsAPI 与 DataManager HTTP 适配层,不新增依赖。最小修改抽卡签到编排顺序:先调用 /bot/gacha/sign-in 以 xapi 的幂等/唯一约束判断是否首次签到,成功后再调用 /bot/points/add 发放积分。若积分发放失败,只记录错误,不补写本地库,不自行发起额外兜底。
Out of Scope
- 本地历史 SQLite 数据迁移。
- admin-ui 改造。
- 赛马数据改造。
- 旧
onmyoji_gacha/handlers/模块清理。
Technical Notes
- xapi 响应统一为
{code,message,data},成功code=200。 - GET 鉴权参数放 query,POST/PUT 鉴权参数放 JSON body。
/bot/gacha/sign-in只记录签到,积分仍由 nonebot 调/bot/points/add。/bot/gacha/draw与/bot/gacha/draw/triple由 xapi 写抽卡结果和成就进度,nonebot 传入本地抽取的式神结果。