danyang-match/docs/Phase-18-V11-Completion-Report.md

Phase 18 完成报告：申诉保持

版本基线：v1.0.0-RC.2 → v1.1.0-dev | 日期：2026-09-08 对应 EPIC：EPIC-P18-V11

---

完成摘要

项目	内容
Phase	18
模块	申诉保持
状态	✅ 已验证（V1.0基础保持不变）

---

不变量保持验证

不变量	实现	验证方式
仅 ban/suspend 可申诉	AppealService.checkCanAppeal()	源码确认
同一用户对同一action只允许一次pending申诉	AppealService.submitAppeal() 幂等检查	源码确认
申诉通过 → 解除risk_action	AppealService.processAppeal() approve分支	源码确认
申诉被拒 → 维持原处置	AppealService.processAppeal() reject分支	源码确认
FeatureFlag 控制申诉开关	appealEnabled flag	源码确认

---

现有代码结构（无需修改）

backend/
  appeal/
    controller/
      AppealController.java         — 用户端: account-status/submit/my
      AppealOperatorController.java — 后台端: pending/detail/process/stats/users
    service/
      AppealService.java            — 核心逻辑
    entity/
      Appeal.java                   — 申诉实体
    mapper/
      AppealMapper.java
    dto/
      AppealSubmitDTO.java
      AppealProcessDTO.java
      AppealItemDTO.java

miniapp/pages/appeal/              — 申诉页面（已注册在app.json）

---

V1.1 兼容性确认

方面	结论
appeals 表结构	无变化，V1.0 保持兼容
AppealController API	无变化
AppealOperatorController API	无变化
Miniapp 申诉页面	无变化
FeatureFlag 开关	保持不变（默认关闭）

---

Phase 18 完成。下一阶段：Phase 19（统一运营后台 + Banner管理 + 内容管理 + 服务站管理 + 专项项目）