# Phase 18 Completion Report

## Status
✅ Completed

## Implemented

### P18-T01 ~ P18-T08: 申诉核心
- [x] V013 迁移：`appeals` 表（含 status/escalation 约束）
- [x] `Appeal` 实体 + `AppealMapper`（5个查询方法）
- [x] `AppealService` — 账号状态检查 / 提交申诉 / 处理申诉 / 统计
- [x] `AppealController` — 用户端3个端点（含FeatureFlag检查）
- [x] `AppealOperatorController` — 管理端5个端点
- [x] Constants 新增：APPEAL_STATUS_* 5种 / RISK_ACTION_STATUS_* 3种
- [x] FeatureFlagConfig 已有 `appealEnabled = false`

### Miniapp 页面
- [x] U48 账号受限页 — 显示限制状态/原因/是否可申诉
- [x] 申诉提交页 — 原因+证据+联系方式+提交成功态

### Admin Web
- [x] A18 申诉管理页 — 统计卡片 + 待处理列表 + 详情抽屉（3种处置决策）
- [x] 路由注册：/appeals

## Core Invariants 已保护
- ✅ **FeatureFlag 控制开关** — appealEnabled 默认 false，上线前需配置开启
- ✅ **仅 ban/suspend 可申诉** — warning/feature_limit 不支持申诉
- ✅ **申诉幂等** — 同一用户对同一 action 只能有一个 pending/reviewing 申诉
- ✅ **申诉通过 → 解除处置** — approve 后自动将 risk_action 标记为 resolved
- ✅ **申诉被拒 → 维持原处置** — reject 不变更 risk_action
- ✅ **升级人工 → 通知风控员** — escalate 触发 system 通知
- ✅ **处置已失效不可申诉** — 检查 risk_action.status == 'active'

## API 端点（8个）
GET    /appeals/account-status（账号状态+是否可申诉）
POST   /appeals（提交申诉）
GET    /appeals/my（我的申诉）
GET    /operator/appeals/pending（待处理列表）
GET    /operator/appeals/{id}（详情）
POST   /operator/appeals/{id}/process（处理：approve/reject/escalate）
GET    /operator/appeals/stats（统计）
GET    /operator/appeals/users/{userId}（用户申诉记录）

## Migration
V013__add_appeals_table.sql

## Tests
- `AppealServiceTest`: 9 个不变量用例（含 Mockito 注入）

## Project Stats
- Java files: 184 (+8 from Phase 17)
- Test classes: 30 (+1)
- Migration SQL: 13
- Miniapp pages: 30 (+2)

## Next Phase
Phase 19: 后台完善（用户管理/机构管理/Operator角色管理/敏感访问审计日志查询）