Implement compression quota refunds and admin manual subscription

docs/confirm.md

@@ -0,0 +1,46 @@
+# 开工前确认清单 - ImageForge
+
+目的：把“产品口径/计费口径/关键体验”一次性定稿，避免边做边改导致返工。
+
+---
+
+## 1. 已确认（按你的要求已写入各文档）
+
+- 支付：Stripe
+- 超额策略：硬配额（超出返回 `402 QUOTA_EXCEEDED`）
+- 订阅周期：按 Stripe 订阅周期（`current_period_start` ~ `current_period_end`），不是自然月
+- 匿名试用：支持；每日 10 次（以成功压缩文件数计）
+- Free 套餐：不开放对外 API（仅 Pro/Business 可创建 API Key）
+- 邮件：注册邮箱验证 + 密码重置（SMTP）
+- 默认语言：中文
+
+---
+
+## 2. 需要你确认的默认口径（我已在文档里按“建议默认值”写死）
+
+1) **Free 配额周期**
+- 当前写法：Free（未订阅）按自然月（UTC+8）重置；Pro/Business 按订阅周期。
+
+2) **匿名试用的“日界”与识别**
+- 当前写法：匿名试用按自然日（UTC+8）00:00 重置；采用 Cookie + IP 双限制。
+
+3) **批量任务遇到额度不足时的行为**
+- 当前写法：`POST /compress/batch` 若本周期剩余单位不足以覆盖上传文件数，直接返回 `402`，不创建任务。
+
+4) **默认套餐参数（可改）**
+- Free：500 / 月，5MB 单文件，10/批量，保留 24h
+- Pro：10,000 / 订阅周期，20MB 单文件，50/批量，保留 7 天
+- Business：100,000+ / 订阅周期，50MB 单文件，200/批量，保留 30 天
+
+5) **邮箱未验证是否禁止压缩**
+- 当前文档口径：注册用户未验证邮箱时，调用压缩接口返回 `EMAIL_NOT_VERIFIED`（匿名试用不受影响）。
+
+---
+
+## 3. 你只需要回复我 5 个点（同意/修改）
+
+- Free 配额周期：按自然月（UTC+8）是否 OK？
+- 匿名试用：按自然日（UTC+8）是否 OK？是否要“仅 Cookie”还是“Cookie + IP 双限制”？
+- 批量额度不足：是否坚持“直接 402 不建任务”，还是允许“部分成功/部分失败”？
+- 套餐默认值：Free/Pro/Business 的配额、大小、保留期是否调整？
+- 邮箱验证：是否必须验证后才能压缩？