MatchMaster/docs/CoinMadness前端开发说明.md

36 lines
2.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 黄金矿工(CoinMadness)文档入口
核对日期:2026-09-30。客户端基准:`codex/coin-madness` 的 `7e14f661`,已合入 main `44901f1e`。本次文档核对不代表线上部署或真机支付已验收。
## 阅读入口
| 内容 | 文档 | 定位 |
| --- | --- | --- |
| 客户端流程、代码位置、资源加载 | [活动实现说明](../assets/coin_madness/README.md) | 当前实际实现 |
| 环境、验证和协议差异 | [接入说明](GoldMiner接入说明.md) | 联调交接入口 |
| 后端字段和请求 | [后端接口 V1.7](../server/laf-cloud/functions/goldMiner/FRONTEND-API.md) | 仓库最新协议,不代表全部已接入 |
| 下单、查单、客服回退 | [支付约定](CoinMadness支付联调当前约定.md) | 客户端行为 |
| 需要前后端确认的事项 | [接口对齐清单](CoinMadness后端接口需求.md) | 替代早期模拟版需求 |
| 手工联调与集合下载 | [Postman 指南](黄金矿工-Postman操作指南.md) | 操作入口 |
| VIP 六档礼包 | [VIP 配置说明](../server/laf-cloud/functions/goldMiner/VIP-TIERS.md) | 后端配置,前端按返回值展示 |
## 当前状态
- 已接入真实活动查询、通关、支付、领奖和补发,不再是“模拟版待接入”。
- `assets/coin_madness` 是活动分包;Host、GoldMinerService、公共加载动画和 resources 入口图在分包外。
- 游戏测试包、活动测试面板、首页测试按钮和两个演示场景已删除。离线回归脚本与独立界面预览工具保留。
- 开发版/体验版选 testHttpip,其他版本选 httpip;当前两个地址相同,不能据版本名认定请求进入独立测试服。
- 未付费可累计进度,主线与无尽胜利使用服务端有效期 ID。任务按全期累计进度展示,已解锁且达标的未领取任务可选择领取,最终由后端授权。
- 客户端尚未完全对齐仓库 V1.7,详见接入说明;不能将协议新功能直接写成已交付。
## 历史资料
| 文件 | 用途 |
| --- | --- |
| [V1.3 协议副本](GoldMiner-FRONTEND-API-v1.3.md) | 历史字段参考,不能覆盖 V1.7 |
| [V1.5 接入记录](GoldMiner-API-v1.5-changes.md) | 补发授权、公共日程等阶段性变更 |
| [PRD V1.1](goldMiner-PRD.md)、[设计 V1.1](goldMiner-backend-design.md) | 原产品和设计记录,后续变更看当前协议与配置 |
| [原策划确认单](CoinMadness活动策划确认单.docx) | 保留原始确认记录,不作为当前规则或接口验收单 |
旧“付费后才计数、每段清零、只统计主线、必须依次领取、每 30 秒全量刷新”不适用于当前客户端。后续维护更新实现说明与接入差异,不再复制完整后端协议到 docs。