77 lines
2.2 KiB
Markdown
77 lines
2.2 KiB
Markdown
# 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专项测试）*
|