Files
danyang-match/docs/V1_0_TO_V1_1_GAP_ANALYSIS.md
Codex 60eeb8aef5 docs(brand): 全仓库 Codex 署名统一为 WorkBuddy + 5 个文件重命名
## 背景
用户指令:「先将 codex 的任务一并改为 workbuddy 的任务」。
Codex 已不再运行,当前由 WorkBuddy 承担开发执行,文档署名需同步。

## 判定规则(用大小写精确区分)
| 类别 | 写法 | 处置 |
|---|---|---|
| 工具署名 | 大写 Codex | → WorkBuddy |
| 分支名 | codex/ui-v11-fidelity | → workbuddy-ui-v11-fidelity(去斜杠,规避本仓库 ref 清理) |
| 已删除文件的历史路径 | 小写 2026-09-11-codex-baseline-cleanup* | 保持原样(记录真实曾存在的文件名,改了即失真) |

结果:26 个文件、126 处署名替换。残留小写 codex 仅 8 处,全部是历史路径。

## 文件重命名(git mv,保留历史)
- Codex开发执行总指令、项目规则与任务拆解.md → WorkBuddy 同名
- Codex首轮启动提示词 + Phase 01~Phase 26 Jira级任务清单 + 每阶段验收条件.md → WorkBuddy 同名
- docs/善缘丹阳 V1.1 Codex 开发执行计划修订版.md → docs/善缘丹阳 V1.1 WorkBuddy 开发执行计划修订版.md
- docs/善缘丹阳 V1.1 Codex-Jira 最终开发任务增量清单.md → docs/善缘丹阳 V1.1 WorkBuddy-Jira 最终开发任务增量清单.md
- docs/善缘丹阳 V1.1 Codex最终主启动提示词(整合版).md → docs/善缘丹阳 V1.1 WorkBuddy最终主启动提示词(整合版).md

引用已同步:AGENTS.md 6 处、AGENTS_SUMMARY.md、以及 4 份计划/规格文档。

## AGENTS.md 两处特别处理
- 「git config user.name = Codex」一句改为不点名工具的表述
- 「feature/ fix/ codex/ ui/ 前缀」示例去掉 codex/

## 有意未改动
- ui-tests/ui-document-baseline-contracts.mjs 的废弃清单仍列 codex-baseline-cleanup*
  那是「必须不存在」的断言目标,改了会让哨兵失去意义
- 仓库 git config user.name 仍是 Codex —— 未擅自改动环境身份。
  如需彻底交接:git config user.name WorkBuddy && git config user.email workbuddy@local

验证:UI 契约门禁 13/13;AGENTS.md 零 Codex 残留;5 个新文件名与全部引用一致
2026-09-16 14:37:44 +08:00

9.2 KiB
Raw Permalink Blame History

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 | WorkBuddy 首轮执行期间生成