# V1.0 → V1.1 Gap Analysis

> 分析当前 V1.0-RC.2 与 V1.1 需求的差距，明确每个模块的处理方式。

> **2026-09-09 证据校正：** 本文件原有“✅ 已实现”记录来自早期开发自报，只表示代码或文件曾被创建，不代表当前可构建、可运行或已通过权限验收。实际执行状态以 `docs/善缘丹阳 V1.1 客户需求基线增量开发与修复计划.md` 和最新 Phase Completion Report 为准；分类仍可复用，完成标记必须重新举证。

---

## 分析方法

使用 KEEP / EXTEND / REFACTOR / REPLACE / ADD 五类标记。

---

## 模块级 Gap 分析

### Auth / Operator / RBAC

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 微信登录 | ✅ 已实现 | 保持 | KEEP |
| 手机号绑定 | ✅ 已实现 | 保持 | KEEP |
| 实名认证 | ✅ 已实现 | 增加人脸核验预留 | EXTEND |
| Operator 角色（9个） | ✅ 已实现 | 新增4个角色 | EXTEND |
| Permission 体系 | ✅ 已实现 | 新增7个权限域 | EXTEND |
| DataScope | ✅ 已实现 | 扩展至新模块 | EXTEND |

### 实名认证（Phase 03）

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 身份证加密/hash | ✅ 已实现 | 保持 | KEEP |
| 未成年拦截 | ✅ 已实现 | 保持 | KEEP |
| 人脸核验 | ❌ 未实现 | 仅预留接口/状态 | EXTEND（预留） |
| VerificationLevel | ❌ 未实现 | 预留字段 | EXTEND |

### Profile + 本地资格（Phase 04）

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 用户资料/偏好/兴趣 | ✅ 已实现 | 保持 | KEEP |
| 本地资格声明 | ❌ 未实现 | user_local_eligibilities + evidence | ADD |
| 本地资格佐证上传 | ❌ 未实现 | local_eligibility_evidences | ADD |
| /me/status 扩展 | ✅ 已实现 | 增加 localEligibilityStatus | EXTEND |
| CapabilityService | ⚠️ 部分实现 | 接入本地资格 | EXTEND |

### 审核（Phase 05）

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 资料审核流程 | ✅ 已实现 | 保持 | KEEP |
| ReviewTask 复用 | ✅ 已实现 | 新增 review_type=local_eligibility | EXTEND |
| 本地资格审核队列 | ❌ 未实现 | 复用现有审核引擎 | ADD |

### Match Engine（Phase 06）

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 双向Required | ✅ 已实现 | 保持 | KEEP |
| 双向评分 | ✅ 已实现 | 保持 | KEEP |
| 本地资格作为 Eligibility 条件 | ❌ 未实现 | 新增 | EXTEND |
| 推荐数量/阈值/冷却 | 配置化 | 保持配置化 | KEEP |

### 首页（Phase 07）— 重大变更

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 旧首页（仅推荐） | ✅ 已实现 | 废弃 | REPLACE |
| HomeAggregate API | ❌ 未实现 | GET /api/v1/home | ADD |
| Banner轮播 | ❌ 未实现 | home_banners 表 + 接口 | ADD |
| 8核心入口 | ❌ 未实现 | 前端固定结构 | ADD |
| 用户状态适配 | 基础 | 按5种状态差异化 | EXTEND |
| 善缘公益服务区 | ❌ 未实现 | 状态相关服务建议 | ADD |
| 近期活动预览 | 基础 | 扩展展示 | EXTEND |
| 服务站卡片 | ❌ 未实现 | ServiceLocationCard | ADD |
| 婚恋课堂区 | ❌ 未实现 | ArticleSection | ADD |
| 安全提醒 | ❌ 未实现 | SafetyNoticeCard | ADD |
| 各用户状态首页 | 基础 | 详细差异化 | EXTEND |

### Like / Match / Block（Phase 08）

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| Like/Pass | ✅ 已实现 | 保持 | KEEP |
| Mutual Match | ✅ 已实现 | 保持 | KEEP |
| Block | ✅ 已实现 | 保持 | KEEP |
| Match Episode 兼容活动 | ❌ 未实现 | 活动来源 Match Episode | EXTEND |

### 聊天（Phase 09）

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| REST Send + WS Receive | ✅ 已实现 | 保持 | KEEP |
| 图片/Emoji | ✅ 已实现 | 保持 | KEEP |
| 幂等发送 | ✅ 已实现 | 保持 | KEEP |
| Activity Match Chat 兼容 | ❌ 未实现 | 支持活动来源 Match | EXTEND |

### 通知（Phase 11）

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 基础通知 | ✅ 已实现 | 保持 | KEEP |
| 预约/咨询/本地资格通知 | ❌ 未实现 | 新增10+通知类型 | ADD |
| 隐私安全文案 | ❌ 未实现 | 锁屏不泄露敏感信息 | ADD |

### 红娘（Phase 13）

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 红娘服务 | ✅ 已实现 | 保持 | KEEP |
| 转介婚恋咨询 | ❌ 未实现 | 新增 | ADD |
| 转介公益活动 | ❌ 未实现 | 新增 | ADD |
| 转介服务站 | ❌ 未实现 | 新增 | ADD |
| 转介来源追溯 | ❌ 未实现 | source tracking | ADD |

### 婚恋咨询（Phase 13A）— 全新

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| counseling_services | ❌ 不存在 | 完整CRUD | ADD |
| counseling_followups | ❌ 不存在 | 服务记录 | ADD |
| 申请/分配/排期/完成流程 | ❌ 不存在 | 全链路 | ADD |
| Counselor 角色+权限 | ❌ 不存在 | assigned DataScope | ADD |
| 风控转交 | ❌ 不存在 | risk_referral | ADD |
| 咨询隐私保护 | ❌ 不存在 | 敏感访问审计 | ADD |

### 多类型活动（Phase 14）— 重构

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| Activity 基础 | ✅ 已实现 | 保持 | KEEP |
| activity_type | ❌ 不存在 | matchmaking/interest_social/... | ADD |
| registration_policy | ❌ 不存在 | 按类型配置报名规则 | ADD |
| activity_organizations | ❌ 不存在 | 多组织协同 | ADD |
| capacity_groups | ❌ 不存在 | 替代male_limit/female_limit | ADD |
| 前端活动分类Tabs | ❌ 不存在 | 类型化展示 | ADD |
| 后台类型化表单 | ❌ 不存在 | 动态字段 | ADD |

### 活动签到（Phase 15）

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 签到核心 | ✅ 已实现 | 保持 | KEEP |
| 非Matchmaking活动签到 | ❌ 未测试 | 新增测试 | EXTEND |

### 活动互选（Phase 16）— 必须重构

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 旧逻辑：mutual→Match→Chat | ✅ 已实现 | 废弃 | REFACTOR |
| activity_mutual_connection_consents | ❌ 不存在 | 新增 | ADD |
| 双方确认开启沟通 | ❌ 不存在 | 二阶段同意 | ADD |
| 已有active Match则复用 | ❌ 不存在 | 逻辑 | ADD |
| 已Unmatch则新建Episode | ❌ 不存在 | 逻辑 | ADD |
| 前端互选结果页 | ❌ 不存在 | 新页面 | ADD |

### 举报与风控（Phase 17）

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 基础风控 | ✅ 已实现 | 保持 | KEEP |
| source=counseling | ❌ 不存在 | 咨询转交风险 | ADD |
| source=service_station | ❌ 不存在 | 线下转交风险 | ADD |
| 风控来源UI | ❌ 不存在 | 新字段 | ADD |

### 申诉（Phase 18）— 保持

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 申诉基础 | ✅ 已实现 | Feature Flag 控制首发 | KEEP |

### 运营后台（Phase 19）— 重大扩展

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 基础后台 | ✅ 已实现 | 保持 | KEEP |
| Banner管理 | ❌ 不存在 | 完整CRUD+调度 | ADD |
| 咨询服务管理 | ❌ 不存在 | 工作台+详情 | ADD |
| 内容管理(CMS) | ❌ 不存在 | 分类+文章CRUD | ADD |
| 服务站管理 | ❌ 不存在 | 位置+预约处理 | ADD |
| 专项项目管理 | ❌ 不存在 | Program CRUD | ADD |
| 组织关系管理 | ❌ 不存在 | organization_relationships | ADD |
| 新角色工作台 | ❌ 不存在 | 4个新角色入口 | ADD |

### 数据分析（Phase 20）

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 基础统计 | ✅ 已实现 | 保持 | KEEP |
| 服务站/咨询/内容/专项指标 | ❌ 不存在 | 新增 | ADD |
| 服务用户数vs服务人次 | ❌ 不存在 | 必须区分 | ADD |
| EFFECTIVE_CONNECTION 指标 | ❌ 不存在 | provisional | ADD |
| 统计口径版本化 | ❌ 不存在 | 可配置 | ADD |

### 账户生命周期（Phase 21）

| 项 | V1.0 状态 | V1.1 需求 | 处理 |
|----|-----------|-----------|------|
| 基础注销 | ✅ 已实现 | 保持 | KEEP |
| 注销联动预约/咨询/项目 | ❌ 未实现 | 新增联动 | EXTEND |
| 本地资格失效 | ❌ 未实现 | 状态更新 | EXTEND |
| 服务历史脱敏 | ❌ 未实现 | 保留期限策略 | EXTEND |

---

## 文档冲突处理顺序

```
用户最新明确指令 > V1.1最终主启动提示词 > V1.1专项修订文件 > V1.0未被修改的核心设计 > 旧代码
```

---

## 已知必须替换的旧逻辑

| 旧实现 | 新规则 | 处理 |
|--------|--------|------|
| Home = Recommendation only | V1.1 新首页结构 | REPLACE |
| Activity mutual → Match → Chat | Activity mutual → Consent → Match | REFACTOR |
| users.organization_id = 唯一组织归属 | 多组织关系 via organization_relationships | REFACTOR |
| activity.male_limit/female_limit | activity.total_capacity + capacity_groups | REFACTOR |

---

*生成时间: 2026-09-08 | Codex 首轮执行期间生成*