danyang-match/docs/善缘丹阳 V1.1 WorkBuddy 开发执行计划修订版.md

“善缘丹阳”公益婚恋服务平台

V1.1 WorkBuddy 开发执行计划修订版

版本：V1.1
修订基础：V1.0 WorkBuddy 总执行计划 + 最新项目计划书 + V1.1 首页/页面/API/数据库增量设计
执行原则：保留原 Phase 01～26 主结构，进行增量修订，不推翻已确认核心架构

---

第一章 修订目标

本次修订的目的不是重新拆一套开发计划，而是让 WorkBuddy 后续执行时：

1. 不再按旧首页开发；
2. 不再忽略固定服务站；
3. 不再把婚恋咨询和婚前辅导当“以后再说”；
4. 不再把所有活动都当相亲活动；
5. 不再把活动双向互选直接转换成聊天；
6. 正式加入本地资格核验；
7. 正式加入 Banner；
8. 正式加入内容中心与反诈；
9. 正式加入公益服务统计；
10. 继续坚持 V1.0 已确认的匹配、聊天、红娘、风控和权限规则。

---

第二章 V1.1 新增正式范围

以下内容从本版开始正式属于 V1.1：

善缘丹阳品牌
Banner
首页8个核心入口
善缘服务站
服务预约
婚恋咨询
婚前辅导
婚恋课堂
婚恋反诈
婚俗新风内容
本地资格核验
多类型公益活动
专项公益服务项目
多组织活动协同
公益服务统计

这些不再属于：

“可选优化”。

---

第三章 V1.1 继续不做

仍然禁止：

直播
短视频
动态Feed
朋友圈
群聊
语音房
视频相亲
积分
排行榜
VIP
支付
付费聊天
付费联系方式
AI代聊
AI婚姻预测
颜值评分
财富评分
开放社区
在线心理治疗IM
财务系统
政府OA

---

第四章 V1.1 首页正式锁定

首页结构必须改为：

顶部品牌
↓
用户状态
↓
Banner
↓
8个核心入口
↓
今日推荐
↓
善缘公益服务
↓
近期公益活动
↓
善缘服务站
↓
婚恋课堂
↓
安全提醒

旧首页不得继续实现。

---

第五章 8个核心入口锁定

第一排：

找对象
公益红娘
公益活动
婚恋咨询

第二排：

婚恋课堂
婚前辅导
婚恋反诈
善缘服务站

顺序固定。

---

第六章 Phase 总体修订策略

原：

Phase 01～26

继续保留。

新增一个正式阶段：

Phase 13A 公益咨询与婚前辅导

因此实际执行顺序变为：

Phase 01
...
Phase 13
Phase 13A
Phase 14
...
Phase 26

---

第七章 Phase 01 修订

原任务

项目基础骨架。

V1.1 新增要求

在项目治理文档中直接加入：

V1.1首页结构
Banner
本地资格
公益咨询
服务站
内容中心
活动双重确认规则

---

第八章 Phase 01 AGENTS.md 必须新增

首页Banner与8入口已确认
服务站属于V1.1正式范围
婚恋咨询属于V1.1正式范围
婚前辅导属于V1.1正式范围
婚恋反诈属于V1.1正式范围
活动Mutual Interest不能直接创建Chat
本地资格与实名认证必须分离

---

第九章 Phase 02 保持

认证、Operator、Organization、RBAC 基本不变。

新增预留权限域：

banner.*
counseling.*
content.*
service_location.*
service_appointment.*
service_program.*
local_eligibility.*

---

第十章 Phase 03 实名认证修订

实名认证继续完成：

身份验证
年龄判断
身份证加密
Hash

但不得把：

丹阳本地资格

塞进实名认证模块。

两者独立。

---

第十一章 人脸核验处理

WorkBuddy 只需要：

预留 verification_level / liveness_status。

不主动开发：

人脸数据库
Face Embedding
自研识别

具体 Provider 仍是待确认项。

---

第十二章 Phase 04 正式扩展

原：

Profile + Preference + Privacy

现在增加：

Local Eligibility 基础能力。

---

第十三章 Phase 04 新增任务

P04-V11-T01 user_local_eligibilities
P04-V11-T02 本地资格声明API
P04-V11-T03 本地资格页面U62
P04-V11-T04 本地资格状态进入/me/status
P04-V11-T05 Evidence接口预留
P04-V11-T06 LocalEligibilityCapability

---

第十四章 本地资格准入规则

首轮用户只需声明：

丹阳户籍
丹阳工作
丹阳居住
其他符合

不是默认所有人都上传材料。

---

第十五章 Phase 05 审核模块修订

原 ReviewTask 继续复用。

新增：

review_type = local_eligibility

不新建第二套审核引擎。

---

第十六章 Phase 05 新增任务

P05-V11-T01 local eligibility review queue
P05-V11-T02 need evidence
P05-V11-T03 approve/reject
P05-V11-T04 evidence file permission
P05-V11-T05 audit

---

第十七章 Phase 06 Match Engine 修订

继续保持：

双向Required
双向评分
Ranking
Reasons

新增 Eligibility 条件：

local_eligibility capability

是否作为所有推荐硬门槛由业务规则配置。

---

第十八章 Phase 07 首页开发重大修订

旧版首页任务全部替换为 V1.1 首页。

新增：

P07-V11-T01 HomeAggregateService
P07-V11-T02 GET /api/v1/home
P07-V11-T03 Banner section
P07-V11-T04 8 Quick Entries
P07-V11-T05 user state header
P07-V11-T06 recommendation section
P07-V11-T07 service recommendation section
P07-V11-T08 upcoming activities
P07-V11-T09 service station card
P07-V11-T10 content section
P07-V11-T11 safety notice

---

第十九章 Banner 后端可以在 Phase 07 完成基础读取

Phase 07 最少完成：

home_banners
GET /home/banners
HomeAggregate

完整后台管理可以到 Phase 19。

---

第二十章 Phase 07 验收修订

必须验证：

首页顺序固定
Banner能展示
8入口固定
未审核用户不返回候选
Paused无推荐
Successful无新对象推荐
服务站可展示
公益内容可展示

---

第二十一章 Phase 08 保持

Like、Pass、Block、Match 不做业务扩展。

但必须保留：

Match Episode。

因为活动后未来可能重新建立关系。

---

第二十二章 Phase 09～10 保持

聊天核心设计不变。

仍然：

Mutual后Chat
REST Send
WS Receive
Block实时

---

第二十三章 Phase 11 通知模块扩展

新增通知类型：

service_appointment
counseling
premarital
local_eligibility
service_station

---

第二十四章 Phase 11 新任务

P11-V11-T01 appointment notifications
P11-V11-T02 counseling notifications
P11-V11-T03 local eligibility notifications
P11-V11-T04 privacy-safe external copy

---

第二十五章 Phase 12 关系状态保持

不因为新增婚前辅导继续扩复杂 RelationshipStatus。

婚前辅导作为：

独立 Service。

---

第二十六章 Phase 13 红娘修订

红娘核心不变。

新增：

转介婚恋咨询
转介活动
转介服务站

---

第二十七章 Phase 13 新任务

P13-V11-T01 counseling referral
P13-V11-T02 activity referral
P13-V11-T03 service-location referral
P13-V11-T04 referral source tracking

---

第二十八章 新增 Phase 13A

Phase 13A：公益咨询与婚前辅导

Epic：

EPIC-P13A 公益婚恋咨询与婚前辅导

---

第二十九章 Phase 13A 数据任务

P13A-T01 counseling_services
P13A-T02 counseling_followups
P13A-T03 counseling type
P13A-T04 service mode
P13A-T05 counseling consent

---

第三十章 Phase 13A 用户端

P13A-T06 U55婚恋咨询介绍
P13A-T07 U56咨询申请
P13A-T08 U57我的咨询
P13A-T09 U58婚前辅导介绍
P13A-T10 U59婚前辅导申请

---

第三十一章 Phase 13A 后台

P13A-T11 counseling queue
P13A-T12 counseling detail
P13A-T13 assign counselor
P13A-T14 schedule
P13A-T15 start
P13A-T16 follow-up
P13A-T17 complete
P13A-T18 close

---

第三十二章 Phase 13A 权限

P13A-T19 counselor role
P13A-T20 counseling manager role
P13A-T21 assigned data scope
P13A-T22 sensitive note access

---

第三十三章 Phase 13A 风控联动

P13A-T23 counseling risk referral
P13A-T24 source=counseling

咨询人员：

不直接Ban。

---

第三十四章 Phase 13A 验收

必须：

用户能申请
工作人员能分配
咨询人员只能看Assigned服务
婚前辅导复用同一Service
咨询记录不保存逐字谈话
红娘不能看咨询正文
普通管理员默认不能看正文
风险可以转交

---

第三十五章 Phase 14 活动重大升级

Activity 从：

相亲活动

升级：

公益活动体系。

---

第三十六章 Phase 14 新增字段

activity_type
registration_policy
target_group
industry_scope

---

第三十七章 ActivityType 正式支持

matchmaking
interest_social
relationship_education
premarital_guidance
marriage_custom_culture
anti_fraud

---

第三十八章 Phase 14 新增组织关联

新增：

activity_organizations

支持：

host
organizer
co_organizer
partner
venue_partner

---

第三十九章 活动资格规则不能统一写死

例如：

相亲联谊：

实名认证
本地资格
资料审核

反诈课堂：

可更开放。

通过：

registration_policy

控制。

---

第四十章 Capacity 修订

停止默认：

male_limit
female_limit

改成：

total_capacity
+
activity_capacity_groups

只有具体活动需要性别分组才配置。

---

第四十一章 Phase 15 签到保持

签到核心不变。

新增：

非Matchmaking活动同样可以签到。

---

第四十二章 Phase 16 必须替换旧规则

旧规则：

Activity Mutual
→ Match
→ Chat

正式废弃。

---

第四十三章 Phase 16 新规则

Activity Interest
↓
Mutual Interest
↓
Mutual Connection Consent
↓
双方分别确认
↓
Match Episode
↓
Conversation

---

第四十四章 Phase 16 新增数据模型

activity_mutual_connection_consents

---

第四十五章 Phase 16 新任务

P16-V11-T01 mutual result
P16-V11-T02 connection consent
P16-V11-T03 user A confirm
P16-V11-T04 user B confirm
P16-V11-T05 both-confirm transaction
P16-V11-T06 active Match reuse
P16-V11-T07 prior unmatch new episode
P16-V11-T08 decline/timeout

---

第四十六章 Phase 16 验收

单向意向不泄露
双方互选不立即Chat
一方确认不创建Match
双方确认只创建1个Match
已有active Match不重复
旧unmatch后创建新Episode

---

第四十七章 Phase 17 风控扩展

Risk source 增加：

service_station
counseling
content

主要新增：

线下服务场景风险转交。

---

第四十八章 不开发公开违规黑名单

虽然项目计划书提到公示违规信息，本产品实现中不直接建设公开用户黑名单。

内部：

RiskAction
Ban
Audit

即可。

---

第四十九章 Phase 18 申诉保持

不变。

---

第五十章 Phase 19 后台重大扩展

新增5组后台模块：

Banner
公益咨询
内容管理
善缘服务站
专项公益服务

---

第五十一章 Phase 19 Banner

任务：

P19-V11-T01 Banner list
P19-V11-T02 Banner edit
P19-V11-T03 publish
P19-V11-T04 schedule
P19-V11-T05 reorder
P19-V11-T06 audience scope

---

第五十二章 Phase 19 内容中心

新增：

content_categories
content_articles

后台：

文章列表
新建
编辑
发布
下架

---

第五十三章 内容分类

至少：

婚恋课堂
婚前辅导
婚俗新风
婚恋反诈

---

第五十四章 Phase 19 服务站

新增：

service_locations
service_appointments

后台支持：

服务站维护
预约列表
确认
改期
完成
取消

---

第五十五章 Phase 19 专项服务项目

新增：

service_programs
service_program_members

用于：

• 职工关爱
• 青年服务
• 异地务工群体服务
• 其他专项公益项目

---

第五十六章 Phase 19 组织协同扩展

新增：

organization_relationships

但：

Organization relationship 不能替代 RBAC。

---

第五十七章 Phase 19 新角色

service_station_operator
counselor
counseling_manager
content_editor

实际可以多角色合并。

---

第五十八章 Phase 19 首页后台

必须完成：

Banner管理。

8核心入口：

不做运营动态排序。

---

第五十九章 Phase 20 Analytics 重大扩展

新增：

服务站访问
服务预约
婚恋咨询
婚前辅导
公益课堂
婚恋反诈
专项服务
用户来源

---

第六十章 Phase 20 新指标

SERVICE_APPOINTMENTS
SERVICE_APPOINTMENTS_COMPLETED
COUNSELING_REQUESTS
COUNSELING_COMPLETED
PREMARITAL_GUIDANCE_COMPLETED
SERVICE_STATION_USERS
CONTENT_VIEWS
SERVICE_PROGRAM_USERS
LOCAL_ELIGIBILITY_VERIFIED_USERS

---

第六十一章 服务人数/人次区分

正式必须支持：

Unique Service Users
Service Occurrences

---

第六十二章 “有效交友匹配”

建议建立技术指标：

EFFECTIVE_CONNECTION

建议定义：

Mutual Match
+
Two-Way Chat

但最终政府报送口径仍需要产品/运营确认。

---

第六十三章 Phase 21 生命周期修订

账号注销时新增处理：

service_appointments
counseling_services
service_program_members
local_eligibility

---

第六十四章 注销后

必须：

取消未来预约
停止未完成咨询或进入人工处理
停止专项服务
本地资格停止作为有效状态

历史必要服务记录按Retention Policy处理。

---

第六十五章 Phase 22 部署保持

基础架构不变。

仍然：

Docker Compose
Nginx
PostgreSQL
Redis
Private Object Storage

---

第六十六章 Phase 22 新增配置

counseling.enabled
premarital.enabled
content.enabled
serviceLocation.enabled
localEligibility.enabled

---

第六十七章 Phase 22 上传安全扩展

对象存储现在还包括：

local eligibility evidence
content cover
service location cover

资格佐证必须 Private。

---

第六十八章 Phase 23 测试扩展

新增E2E：

Local Eligibility E2E
Home V1.1 E2E
Banner E2E
Counseling E2E
Service Appointment E2E
Content E2E
Activity Mutual Consent E2E

---

第六十九章 Phase 23 新权限测试

红娘不能看咨询记录
服务站人员不能看身份证
内容编辑不能看用户资料
Counselor只能看Assigned咨询
普通管理员不能直接读本地资格佐证

---

第七十章 首页E2E

必须验证：

Banner
8入口
今日推荐
活动
服务站
内容
安全提醒

并根据：

未实名
审核中
Searching
Paused
Successful

验证不同首页。

---

第七十一章 Phase 24 UAT 扩展

新增真实角色：

婚恋咨询工作人员
服务站运营人员
内容运营人员

---

第七十二章 服务站UAT

必须完成：

群众扫码
↓
进入小程序
↓
预约服务
↓
工作人员后台确认
↓
到场
↓
完成服务

---

第七十三章 咨询UAT

必须：

用户申请
↓
后台分配
↓
咨询人员查看
↓
服务
↓
完成

且不需要：

Excel/私人微信记录核心业务。

---

第七十四章 Phase 25 RC 新增检查

必须检查：

Banner正式内容
服务站地址
服务时间
客服电话
文章内容
婚恋反诈内容
咨询服务介绍
婚前辅导介绍

不能用开发占位文案上线。

---

第七十五章 Phase 26 Production 修订

生产上线增加：

Banner初始化
内容分类Seed
善缘服务站初始化
咨询服务配置
本地资格Config

---

第七十六章 Production Seed 修订

可以Seed：

Roles
Permissions
Content Categories
Service Types
Activity Types

不能Seed：

假用户/假Match。

---

第七十七章 新版Phase完整顺序

最终正式执行：

Phase 01  项目基础架构
Phase 02  Auth + Operator + RBAC
Phase 03  实名认证
Phase 04  Profile + Preference + 本地资格
Phase 05  审核
Phase 06  Match Engine
Phase 07  V1.1首页 + 找对象
Phase 08  Like / Match / Block
Phase 09  Text Chat
Phase 10  Image & Chat Safety
Phase 11  Notification
Phase 12  Relationship Progress
Phase 13  公益红娘
Phase 13A 公益咨询与婚前辅导
Phase 14  多类型公益活动
Phase 15  活动签到
Phase 16  活动互选 + 双方开启沟通确认
Phase 17  举报与风控
Phase 18  申诉
Phase 19  统一运营后台 + Banner + 内容 + 服务站 + 专项项目
Phase 20  Analytics
Phase 21  Account Lifecycle
Phase 22  Deployment / Ops
Phase 23  System Testing
Phase 24  UAT
Phase 25  RC
Phase 26  Production

---

第七十八章 V1.1 新增 P0/P1 优先级

P0

仍然优先：

登录
实名
资料
审核
匹配
Like
Match
Chat
Block
举报
权限
红娘基础
相亲活动基础

---

第七十九章 V1.1 新增 P1

Banner
本地资格
服务站
服务预约
婚恋咨询
婚前辅导
婚恋课堂
婚恋反诈
多类型活动
活动双重沟通确认
公益服务Analytics

这些是：

V1.1正式上线前需要完成的功能。

---

第八十章 不得以“P1”理解为可推到V2

这里P1含义：

相对于底层核心链路后开发。

不是：

可不做。

---

第八十一章 P2

仍然可以后续：

人脸核验正式启用
高级动态水印
高级统计
高级异常登录
高级咨询排班
更多专项项目能力

---

第八十二章 PENDING_DECISIONS 修订

新增：

人脸认证是否首发
人脸Provider
本地资格佐证触发策略
本地资格文件保留期限
咨询人员资质要求
服务站正式时间
咨询服务方式
咨询时段规则
专项服务项目首批类型
有效交友匹配正式统计口径

---

第八十三章 已确认项不得再 Pending

WorkBuddy不得再将以下标记为待确认：

善缘丹阳品牌
首页Banner
首页8入口
服务站
婚恋咨询
婚前辅导
婚恋课堂
婚恋反诈
多类型公益活动
活动双向开启沟通确认

---

第八十四章 首页开发禁止旧实现

如果旧代码已经实现：

Home = Recommendation only

需要：

渐进改造成 V1.1。

不能因为旧代码存在就继续保持。

---

第八十五章 Activity旧代码迁移

如果已经实现：

activity mutual → create match

必须修复为：

mutual → consent → match

并补 Migration/状态迁移方案。

---

第八十六章 Local Eligibility 不能塞进 Profile JSON

必须明确独立模型。

因为：

Profile information ≠ Service eligibility verification。

---

第八十七章 Counseling 不能塞进 Matchmaker Notes

必须独立：

CounselingService

因为：

红娘服务与专业婚恋咨询目的、人员、隐私边界不同。

---

第八十八章 Service Appointment 不能等于 Counseling

预约：

什么时候提供服务。

咨询：

一项具体公益服务案例。

两者可以关联，但不能混成一张万能表。

---

第八十九章 Content 不能做成 Feed

页面只：

列表
详情

后台：

创建
发布
下架

停止扩展。

---

第九十章 Service Programs 不做用户等级

专项项目：

表达服务计划。

不能演变为：

普通用户
重点用户
高价值用户

---

第九十一章 V1.1 Invariants 增量

除了原有Invariant，再增加：

INV-011 未授权本地资格证明不可访问
INV-012 Counselor只能看Assigned Service
INV-013 红娘不可读取Counseling正文
INV-014 Activity Mutual不能直接创建Chat
INV-015 双方开启沟通确认后才建立Activity Match
INV-016 Banner不可任意外链
INV-017 8个首页核心入口顺序固定
INV-018 Service Station Operator不可浏览全用户库

---

第九十二章 CI新增自动化测试

必须加入：

home-v11
local-eligibility
counseling-permission
activity-mutual-consent
service-appointment

---

第九十三章 V1.1文档同步要求

WorkBuddy实施前更新：

AGENTS.md
STATUS.md
PENDING_DECISIONS.md
JIRA_BACKLOG.md
DATABASE_SCHEMA.md
API_CONTRACT.md
UI_DESIGN_SYSTEM.md
ANALYTICS_METRICS.md
TEST_PLAN.md

---

第九十四章 Jira Backlog 增量

新增Epic：

EPIC-P13A 公益咨询与婚前辅导

并修改：

EPIC-P04
EPIC-P05
EPIC-P07
EPIC-P11
EPIC-P13
EPIC-P14
EPIC-P16
EPIC-P17
EPIC-P19
EPIC-P20
EPIC-P21
EPIC-P23
EPIC-P24
EPIC-P25
EPIC-P26

---

第九十五章 WorkBuddy首次采用V1.1前必须做一次Gap Audit

如果已经开发部分旧V1：

必须检查：

旧首页
旧Activity Mutual
本地资格
Banner
咨询
服务站
内容
权限
Analytics

并输出：

V1.0 → V1.1 Gap Analysis

---

第九十六章 Gap分类

使用：

KEEP
EXTEND
REFACTOR
REPLACE
ADD

例如：

Match Engine = KEEP
Home = REPLACE
Activity = EXTEND
Activity Mutual Flow = REFACTOR
Counseling = ADD

---

第九十七章 推荐Gap示例

模块	处理
Auth	KEEP
Profile	EXTEND
Review	EXTEND
Match Engine	KEEP
Home	REPLACE
Chat	KEEP
Matchmaker	EXTEND
Activity	EXTEND
Activity Mutual	REFACTOR
Counseling	ADD
Service Station	ADD
Content	ADD
Analytics	EXTEND

---

第九十八章 V1.1 UI实施优先级

首先完成：

首页
服务站
婚恋咨询
活动分类
婚恋课堂

但仍要遵守整体Phase依赖。

---

第九十九章 V1.1后台实施优先级

首先完成：

待办型工作台
咨询
服务预约
Banner
内容

而不是先做高级Dashboard。

---

第一百章 运维复杂度控制

新增业务仍然使用：

1个Backend
1个PostgreSQL
1个Redis
1个Object Storage
1个Admin
1个Mini Program

不能因为新增咨询/内容：

拆新的服务。

---

第一百零一章 最终V1.1用户闭环

品牌信任
↓
实名与本地资格
↓
人工审核
↓
推荐/找对象
↓
Mutual
↓
Chat
↓
├─ 公益红娘
├─ 公益活动
├─ 婚恋咨询
└─ 服务站
↓
进一步了解
↓
婚前辅导
↓
成功关系
↓
婚俗新风

---

第一百零二章 最终V1.1运营闭环

官方/公益渠道触达
↓
二维码/小程序
↓
用户入库
↓
审核
↓
线上匹配
↓
人工服务
↓
线下活动/服务站
↓
服务记录
↓
风险处理
↓
数据统计
↓
项目成果报送

---

第一百零三章 V1.1最终开发原则

保留已经验证正确的底层核心。

只对新增业务做增量扩展。

首页必须真正体现“善缘丹阳”的完整公益服务。

服务站必须线上线下一体。

咨询与红娘必须保持不同业务边界。

活动从单一相亲扩展为公益活动平台，但不演变成社交社区。

单向意愿始终保密。

活动互选后仍要双方确认开启沟通。

本地资格核验提高本地服务准确性，但不能无限增加用户负担。

项目服务必须可统计、可留痕、可审计。

新增模块不得破坏最初的简单、易用、低维护原则。

---

第一百零四章 最终WorkBuddy执行指令

从本版开始，WorkBuddy的正式开发基线更新为：

善缘丹阳 V1.1。

开发前必须以：

V1.1 页面级功能清单
V1.1 数据库与API增量设计
V1.1 WorkBuddy开发执行计划修订版

为最新执行依据。

如果旧文档与上述V1.1文档冲突：

以V1.1修订内容为准。

但以下V1.0核心原则仍然继续有效：

Required不可放宽
Mutual后才能聊天
Block优先
红娘不能替用户决定
敏感信息默认拒绝
RBAC + Data Scope
PostgreSQL Source of Truth
模块化单体
不做商业化

V1.1不是重新开一个项目。

它是将已经成熟的V1.0婚恋核心，正式升级为：

线上匹配 + 人工红娘 + 公益活动 + 固定阵地 + 婚恋咨询 + 婚前辅导 + 婚恋反诈 + 婚俗新风的一体化丹阳公益婚恋服务平台。