# V1.1 变更日志 — CHANGELOG

> 记录 V1.0 → V1.1 的功能变更、新增、重构和删除。

---

## v1.1.0-dev（开发中）

### 2026-09-09 — Phase 01 恢复基线

- 将六份客户修订文档登记为共同需求基线，并明确按专业域裁决冲突。
- 将未经当前代码、测试和人工验收证明的历史完成声明降级为待复验记录。
- 新增 PowerShell 与 Bash 两套 Phase 01 检查入口，统一覆盖 Git、Backend、Admin、Miniapp 和 E2E。
- 移除交付文档及验证脚本中的默认明文账号密码；运行凭证改由本地环境变量或安全 Seed 提供。
- 当前实测结论为 `NO-GO`：5 个门禁失败，Admin 仅 production build 通过；未进入 Phase 02。

### 新增功能

#### 首页
- **Home Aggregate API** — `GET /api/v1/home` 聚合所有首页数据
- **首页 Banner** — 品牌/活动/公益服务运营位，支持时间过滤和受众范围
- **8个核心入口** — 找对象/公益红娘/公益活动/婚恋咨询/婚恋课堂/婚前辅导/婚恋反诈/善缘服务站
- **首页用户状态适配** — 未登录/未实名/审核中/Paused/Successful 各显示不同内容

#### 本地资格
- **本地资格声明** — 丹阳户籍/工作/居住/其他符合条件
- **本地资格佐证** — 按需上传佐证文件，独立于实名认证
- **本地资格审核** — 复用现有 review_tasks，新增 review_type=local_eligibility
- **权限保护** — 普通红娘/活动人员不可见原始佐证文件

#### 善缘服务站
- **服务站管理** — 万善公园婚姻登记处等固定阵地
- **服务预约** — 用户预约 → 工作人员确认 → 现场服务 → 完成留痕
- **前台展示** — 地址/开放时间/联系电话/地图导航/服务项目

#### 婚恋咨询（Phase 13A）
- **申请服务** — 择偶困惑/沟通相处/情感困惑/婚恋焦虑/关系冲突/其他
- **分配服务** — 后台管理员分配咨询师
- **服务流程** — 已分配→已排期→服务中→已完成→已关闭
- **咨询服务摘要** — 只记录必要摘要，不存逐字谈话
- **风控转交** — 发现风险时通过 RiskEvent 转交

#### 婚前辅导
- **复用 CounselingService** — 通过 service_type=premarital_guidance 区分
- **双人参加支持** — primary_user + companion_user（可选）
- **伴侣确认机制** — 不能一方擅自将对方加入辅导

#### 婚恋课堂与反诈
- **内容分类** — 婚恋课堂/婚前辅导/婚俗新风/婚恋反诈
- **文章管理** — 创建/编辑/发布/下架
- **首页展示** — 轻内容列表，非 Feed 形式
- **无互动** — 不建设评论/点赞/粉丝/热搜

#### 多类型公益活动
- **ActivityType** — matchmaking/interest_social/relationship_education/premarital_guidance/marriage_custom_culture/anti_fraud
- **RegistrationPolicy** — 不同类型活动可配置不同报名资格
- **CapacityGroups** — 替代硬编码的 male_limit/female_limit
- **多组织关联** — activity_organizations 支持主办/联合主办/运营/合作/场地合作

#### 活动互选二阶段确认（Phase 16 重构）
- **Activity Interest** → **Mutual Result** → **双方分别确认** → **Match Episode**
- 已有 active Match 则复用，已 Unmatch 则创建新 Episode
- 单向确认不创建 Conversation

#### 专项公益服务项目
- **ServiceProgram** — 职工关爱/青年公益婚恋/异地务工青年/残障人士支持
- **ProgramMembers** — 用户申请/管理员审批

#### 数据统计扩展
- 服务站访问/服务预约/咨询申请与完成/婚前辅导/内容浏览/本地资格核验
- 区分服务用户数与服务人次
- 有效交友匹配 provisional metric

### 数据库新增表（14张）

| 表名 | 用途 |
|------|------|
| home_banners | 首页 Banner 运营 |
| service_locations | 善缘服务站 |
| service_appointments | 服务预约 |
| counseling_services | 婚恋咨询 |
| counseling_followups | 咨询服务记录 |
| content_categories | 内容分类 |
| content_articles | 内容文章 |
| user_local_eligibilities | 用户本地资格 |
| local_eligibility_evidences | 本地资格佐证文件 |
| service_programs | 专项公益项目 |
| service_program_members | 项目成员 |
| organization_relationships | 组织间关系 |
| activity_organizations | 活动多组织关联 |
| activity_mutual_connection_consents | 活动互选双向确认 |

### 重构

- **首页** — 旧推荐页 → V1.1新首页结构（REPLACE）
- **活动互选流程** — mutual→match→chat → mutual→consent→match→chat（REFACTOR）
- **activities 表** — 增加 activity_type/registration_policy/target_group/industry_scope 字段

### 扩展

- **operators 角色体系** — 新增 service_station_operator/counselor/counseling_manager/content_editor
- **permissions** — 新增 banner.counseling/content/service_location/service_appointment/service_program/local_eligibility 权限域
- **ReviewTask** — 新增 review_type=local_eligibility
- **Notification** — 新增预约/咨询/本地资格通知类型
- **RiskEvent** — 新增 source=counseling/service_station
- **Analytics** — 新增公益服务指标

---

## v1.0.0-RC.2（冻结）

- 全部 26 个 Phase 完成
- 23 项核心不变量通过
- 16 项代码审查问题清零
- Demo 数据就绪

---

*最后更新: 2026-09-08*