# Mimoon 产品逻辑方案：完善计划与模型交接

## 1. 当前工作的唯一范围

本仓库用于讨论和完善 **APP 产品逻辑方案**。当前不进入软件开发：不选择技术栈，不搭工程、不写产品代码，不接外部服务，不部署。原系统架构、SDK、账本和上线门槛仅表达产品最终需要的能力与验证，不是本轮开发任务。

## 2. 阅读顺序与规则优先级

1. `Mimoon_完整方案_清晰版.md`；2. `docs/02_语义复核清单.md`与`docs/05_家族PK代表关系确认.md`；3. 来源映射与分章快照；4. 本文件。

优先级：用户最新确认 → 未覆盖的原已确认规则 → 建议／测试参数。不能用编辑建议替用户决定，也不能因成本或合规风险擅自取消已确认玩法。

## 3. 已经确认，不要重复询问

- PELLO为核心；免费排位零金币可玩，正常完成双方获排位币，胜者更多。
- 排位积分只用于排名和段位；排位币用于消费，其正常礼物为收礼者结算金豆。
- 金币赛与排位无关；支持2／3／5／8／12人及三种入口；10%手续费、90%奖池。
- 未获赛事奖励者的积分1:1转本期赛事币，商店关闭后清零。
- 普通用户可多族；族长单族。家族PK一次代表一族、随时改，前后记录各归对应家族。
- 每族每日一次免费宝箱，另有独立付费箱且档位更高；开箱者固定金币＋随机派对礼物，家族资源，族长金豆。
- 族长激励规则公开，私人金额和钱包明细保密。
- 1美元＝10,000金币；10,000金豆＝1美元；普通礼物50%；提现最低10美元。
- PELLO已确认6球、首次停稳按球心锁分、球体保留和持续3球加时；仅局时、卡球、停稳阈值、超时及月赛同分边界继续测试。家族PK的75／25等参数仍测试；地区、渠道和每期奖品待评审。

## 4. 尚未闭合的产品逻辑

| 编号 | 产品问题 | 影响 |
|---|---|---|
| L01 | PK切换代表时，已经开始但未结束的一局归旧族还是新族 | 战绩归属、提示、纠纷 |
| L02 | 排位币礼物与金币礼物的商品对应和价值映射 | 金豆数、商城展示 |
| L03 | 两种宝箱各等级金币、礼物概率、家族资源、族长金豆、价格和付费次数 | 宝箱完整规则 |
| L04 | 族长本人开箱是否同时拿开箱者和族长奖励 | 身份重叠结算 |
| L05 | PELLO局时目标、卡球、停稳判定阈值和超时；月赛是否沿用同一加时规则 | 剩余玩法边界 |
| L06 | 排位奖励、段位算法、匹配扩圈、赛季重置 | 排位成长 |
| L07 | 金币赛门票档、分奖、并列、取整 | 付费规则与结果 |
| L08 | 日常归属切换、PK次数、规模、权重、参照值和奖励 | 家族PK结算 |
| L09 | 关卡里程碑、挑战奖励／时区／重试／上限／预算 | 休闲奖励 |
| L10 | 月赛资格、轮次、积分、同分、缺席、补赛、申诉、领奖、转换时点 | 月赛流程 |
| L11 | 赛事商店关闭、提醒、异常补领、商品 | 到期体验 |
| L12 | 金币来源使用限制与混合来源返奖继承 | 钱包告知 |
| L13 | 首发国家、语言、年龄、渠道、KYC、税费和物流 | 发行范围 |

## 5. 一次性完善产品逻辑的工作顺序

### 阶段A：核心玩法闭环
PELLO主竞技的6球、停稳锁分、球体保留、球心判分和持续3球加时已确认，不再追问。仅在必要时补L05剩余边界，再锁定L06、L02。产物是教学→免费排位→结果→重玩／回放／邀请→排位币消费的页面状态。验收：零金币可玩、免费不转收费、积分与币分开、正常失败有奖、Bot明确标识。

### 阶段B：金币比赛闭环
锁定L07；完整定义报名、冻结、满员、准备、比赛、校验、结算、退款、申诉和三入口。验收：返奖＋费＝门票，费只扣一次，返奖与净变化分开，无效局全退，重试不重复扣发。

### 阶段C：内容与月赛
锁定L09—L11。产物是关卡、挑战、赛事报名、积分榜、复核、发奖、赛事币商店和到期页面。验收：奖励不重复，消费不减排名，只清本期赛事币，不删历史成绩和常驻资产。

### 阶段D：派对与家族
明确派对角色和房内游戏；锁定L01、L08、L03、L04。产物是派对、多家族、代表切换、PK、捐赠、两种宝箱和隐私流程。验收：记录唯一归属、历史不搬迁、被踢不抹权益、每族免费资格独立、规则公开而私账保密。

### 阶段E：资产、后台逻辑与发行边界
锁定L12；核验金币、排位币、金豆、赛事币和各积分的来源／用途／到期／可见性；完成规则快照、审批审计、预算熔断、退款申诉；L13归档发行评审，不虚构结论。

### 阶段F：全文收口
用四场景贯穿页面和状态；更新L01—L13；复核A01—A19、公式、参数状态、异常和术语；再更新阅读版。仍然不进入软件开发。

## 6. 每轮讨论的文档纪律

每确认一项，同步用户原话与编号、正文、未决状态、页面／状态／异常／验收及来源映射。不能只改摘要；不能只改正常流程；不能把演算当正式规则。

## 7. 文档核验

```bash
python3 scripts/extract_blueprint.py
python3 scripts/verify_blueprint.py
git diff --check
```

只验证文档，不表示APP已开发或获准发行。

## 8. 给下一模型的指令

> 当前只完善Mimoon APP产品逻辑，不选技术栈、不写代码、不部署。先读README、完整清晰版、用户确认和本文件。不要重复询问第3节已确认规则。按A—F处理L01—L13：当前步骤真正依赖时才问；得到答案后同时更新正文、确认、未决状态、页面／异常／验收和来源映射。保留原HTML，不把建议／示例升级定案，不把成本或合规风险当作取消已确认玩法的授权。每轮运行文档核验并检查diff。