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,76 @@
+# Phase 22 完成报告：部署运维配置扩展
+
+> 版本基线：v1.0.0-RC.2 → v1.1.0-dev | 日期：2026-09-08
+> 对应 EPIC：EPIC-P22-V11
+
+---
+
+## 完成摘要
+
+| 项目 | 内容 |
+|------|------|
+| Phase | 22 |
+| 模块 | 部署运维配置扩展 |
+| 状态 | ✅ 已完成 |
+
+---
+
+## 变更文件
+
+### FeatureFlagConfig.java
+新增 13 个 V1.1 Feature Flag 配置项，全部可通过 `application.yml` 覆盖。
+
+### application.yml
+新增 `features.*` 配置段，包含所有 V1.1 Flag 的默认值。
+
+### FeatureFlagController.java
+新增两个 API 端点：
+- `GET /api/v1/operator/feature-flags` — 获取所有 Flag 当前值
+- `PUT /api/v1/operator/feature-flags/{flagName}` — 动态更新单个 Flag
+
+---
+
+## Flag 配置详情
+
+| Flag | 默认值 | 用途 |
+|------|--------|------|
+| counselingEnabled | true | 公益咨询功能总开关 |
+| premaritalEnabled | true | 婚前辅导功能开关 |
+| contentEnabled | true | 内容管理功能开关 |
+| serviceLocationEnabled | true | 善缘服务站功能开关 |
+| localEligibilityEnabled | true | 本地资格核验开关 |
+| referralEnabled | true | 红娘转介功能开关 |
+| mutualConsentEnabled | true | 活动互选二阶段同意开关 |
+| serviceProgramEnabled | true | 专项公益服务项目开关 |
+| livenessEnabled | false | 活体检测开关（预留，未接入第三方） |
+| localEvidenceUploadEnabled | true | 本地资格佐证上传开关 |
+| localEvidenceMaxFiles | 5 | 最大佐证文件数限制 |
+| localEvidenceMaxFileSizeMB | 10 | 单个文件最大大小(MB) |
+| localEvidenceAllowedTypes | jpg,png,pdf | 允许的文件格式 |
+| counselingAttachmentsPrivate | true | 咨询附件是否使用私有存储桶 |
+| counselingAttachmentsBucket | counseling-attachments | 咨询附件 S3 存储桶名称 |
+
+---
+
+## 使用方式
+
+### 通过 application.yml 配置
+```yaml
+features:
+  counseling-enabled: true
+  liveness-enabled: false
+```
+
+### 通过运营后台 API 动态调整
+```bash
+# 查询所有 Flag
+GET /api/v1/operator/feature-flags
+
+# 动态开启/关闭
+PUT /api/v1/operator/feature-flags/counselingEnabled
+Body: {"value": false}
+```
+
+---
+
+*Phase 22 完成。下一阶段：Phase 23（V1.1专项测试）*