chore: establish V1.1 recovery baseline

2026-09-09 22:05:00 +08:00
commit b46b48eb33
947 changed files with 155471 additions and 0 deletions
@@ -0,0 +1,66 @@
+# 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管理 + 内容管理 + 服务站管理 + 专项项目）*