67 lines
1.8 KiB
Markdown
67 lines
1.8 KiB
Markdown
# 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管理 + 内容管理 + 服务站管理 + 专项项目）*
|