上线就绪清单

本清单用于 app.jumpcli.com 的最小可用上线。它区分可供客户试用的功能与必须继续保持 关闭的正式商业能力，避免把测试额度或未验证的集成当作收费服务发布。

当前可用

• 工作台、图库、任务状态与 SSE 事件通过 app.jumpcli.com 提供服务。
• 客户可自助注册、登录、找回密码、选择免费测试套餐并使用图片额度；运营人员仍可停用或 恢复账户。
• 账户注册、审核结果、密码变更、账户停用/恢复、免费测试套餐开通/取消均进入异步邮件 队列；SMTP 不可用时会重试并保留失败记录。
• 免费目录固定为 starter-test、creator-test、studio-test，默认分别提供 20、80、200 次当月图片额度。它们不创建支付订单或 Meteroid 正式用量。
• 1Panel/OpenResty 终止 TLS，JumpCLI 仅监听 127.0.0.1:19091；可信转发来源为 127.0.0.1/32。
• 正式 Meteroid 计费尚未启用；后续接入时必须使用固定版本的官方服务，并仅通过 Docker 内网访问。

上线前核对

1. .env 中确认 PUBLIC_ORIGIN=https://app.jumpcli.com、ALLOWED_HOSTS=app.jumpcli.com、 ACCESS_COOKIE_SECURE=true、FORCE_HTTPS=true、TRUST_PROXY_HEADERS=true 和 TRUSTED_PROXY_IPS=127.0.0.1/32。
2. 设置独立、非空的 ADMIN_EMAIL、ADMIN_PASSWORD 与 ADMIN_KEY。生产首次启动不会 记录自动生成的管理员密码。
3. 确认 SMTP 发送方、DKIM、SPF/DMARC 与一个受控收件箱的实际投递；不要在日志或文档中 放入 SMTP 密码。
4. 确认上游模型地址、密钥与允许模型，并用运营账号完成一次受控出图。
5. 确认 data/、images/、maintenance/ 属于 .env 中 PUID/PGID 指定的运行账户， 避免 SQLite 因目录不可写而重启。
6. 设置唯一的 APP_VERSION，用 production_build_release.sh 构建并保存脚本输出的不可变 APP_IMAGE，再使用 docker-compose.production.yml 以 --no-build --pull never 重建 容器，并访问 https://app.jumpcli.com/ready。

必须保持关闭

• 正式套餐、自动续费、支付订单、支付宝回调、退款和发票。
• Meteroid 正式组织、API token、产品/价格/指标映射和正式客户订阅投影。
• Casdoor OIDC 实际生产接入；当前账户体系由 JumpCLI 自身运行。
• 余额预警、出图失败提醒和运营告警渠道，它们需要独立的通知偏好、去重与告警接收方。

这些项目未完成时，客户只能使用明确标记为免费测试的套餐。任何“支付成功”或“已开通 付费权益”的页面、邮件和 API 响应都不应发布。

正式计费切换

完成第三方支付商的 API、签名校验和回调回放测试后，再在 Meteroid 中建立组织、产品、 价格、image_success 指标和每个套餐的映射。通过受控订单验证“下单、回调验证、权益开通、 账单刷新、退款/失败处理”全链路后，关闭 BILLING_TEST_MODE，再公开正式套餐。