# 每日变动 2026-10-26

## 13:50 — 签到 / 补签 / 能量查询

### 概要

- 公开 OpenAPI 与服务端补齐签到月历、当日签到、补签资格/执行、能量余额与明细。
- 客户端（SparkApk / wyPOPandroid）将 `SparkUnavailable` 换成 `/v1/sign*`、`/v1/energy*`，避免失败后 `initData` 白屏。

### 变更范围

| 类型 | 说明 |
|------|------|
| 功能 | `energy` 模块 + HTTP `/v1/sign`、`/v1/energy` |
| 文档 | `openapi.yaml` 增加 sign / energy 标签与路径 |
| 客户端 | SignInManager / PayManager / SignInActivity 适配 |

### 主要文件

- `migrations/0034_sign_energy.sql` — 钱包 / 流水 / 签到表
- `internal/module/energy/**` — entity / model / logic
- `internal/transport/http/handler/energy/handler.go`、`router.go`、`server.go`、`bootstrap/app.go`
- `internal/transport/http/docs/openapi.yaml`
- `SparkApk` / `wyPOPandroid`：`SignInManager.kt`、`PayManager.kt`、`SignInActivity.kt`

### 验证

- `go test ./internal/module/energy/logic` pass
- 全量 `make test` / 部署：见任务简报

### 风险

- 补签激励视频闸门未启用（`need_watch_video_count=0`）；抽奖仍 unavailable。
- 需 migrate `0034` 后能量接口才有持久化。