9.1 KiB
9.1 KiB
SOUL派对成员运营模块｜需求文档
模块边界：本模块属于工作手机项目，但独立于微信模块；只处理SOUL派对房的成员登记、欢迎内容任务、互动回执、数据统计和房主关系。微信账号、微信联系人、微信消息、微信朋友圈均不在本需求范围。
| 项目 | 内容 |
|---|---|
| 版本 | V1.0 |
| 状态 | 待开发 |
| 产品负责人 | 水泉 |
| 开发主责 | 火炬 |
| 目标规模 | 每月1～2万人进房成员的登记、去重、分析与转化统计 |
| 需求来源 | 2026-07-26业务口述 + 本机SOUL材料与安装包调研 |
1. 业务目标
房主无法靠人工记住每月进入派对房的1～2万人。本模块把每一次进房转成可查询的成员档案和可复盘的运营数据：
成员进房 → 前台登记 → AI标签 → 欢迎内容任务 → 投递/回复回执 → 房间复访与关系统计 → 运营复盘
最终回答四个问题：
- 谁进过哪个房间、进过几次、什么时候进入？
- 这个人可见的名称、公开资料、瞬间内容、发言和兴趣标签是什么？
- 欢迎内容是否发出、是否送达、是否回复、是否再次进入？
- 某房主通过哪些房间、哪些分享链接连接到了哪些成员，哪些成员质量更高？
2. 角色与权限
| 角色 | 能力 |
|---|---|
| 房主 | 查看自己房间成员、内容模板、数据看板和关系图谱 |
| 运营人员 | 配置房间、审核标签、创建欢迎内容任务、处理异常 |
| 火炬开发/运维 | 配置事件接入、任务执行、回执、监控和数据修复 |
| 管理员 | 跨房间查看、模板治理、频次规则、审计与导出 |
3. 功能一：派对成员前台登记（P0）
3.1 触发与登记
当成员进入派对房时创建“进房事件”；同一成员重复进入只新增事件，不重复创建成员档案。
| 字段组 | 记录内容 |
|---|---|
| 成员身份 | 平台成员ID、展示名称、头像引用、账号状态、首次/最近出现时间 |
| 房间上下文 | 房间ID、房间名称、房主ID/名称、来源分享标识、进入/离开时间 |
| 行为记录 | 进房次数、停留时长、发言/互动次数、最近互动时间、再次进入次数 |
| 可见资料快照 | 公开简介、公开标签、公开瞬间摘要、可见兴趣/城市等字段及采集时间 |
| 数据来源 | 事件来源、字段来源、采集成功/缺失/过期状态 |
3.2 AI成员卡片
AI只基于可见资料和房间行为生成可解释标签，每条标签必须有来源和置信度。
- 标签：新成员、复访成员、活跃互动、内容兴趣、问题类型、潜在协作、待人工确认。
- 分析摘要：
可见事实、行为摘要、标签建议、推荐下一步四段。 - 不确定信息标为“待确认”，不作为成员事实写入。
- 支持运营人员修正、删除标签；所有变更进入审计记录。
3.3 前台登记台
- 房间实时成员流：进房、离房、首进、复进、异常事件。
- 成员360卡：成员资料、进房轨迹、互动、欢迎内容、回复和标签。
- 去重提示：同一成员在多房间出现时显示统一成员主档和房主关系。
- 查询：按房间、房主、日期、标签、复访、是否回复、任务状态筛选。
4. 功能二：欢迎内容与派对邀请（P0）
4.1 业务规则
成员进房后可触发一条欢迎内容任务。内容由“文字 + 图片/活动卡片 + 房间名称 + 邀请链接”组成，支持按房间配置模板。
模板示例（可编辑）：
感谢你来到「{房间名称}」。这里有今天的主题和后续派对入口：{邀请链接}。回复“资料”可领取本场内容卡。
4.2 任务状态机
待触发 → 预检 → 待执行 → 已提交 → 已送达 / 失败 / 限制 → 已回复 → 已转人工 / 已结束
| 环节 | 规则 |
|---|---|
| 预检 | 检查成员去重、模板有效、素材存在、账号状态、频次额度 |
| 去重 | 同成员、同房间、同模板、同周期只保留一条有效任务 |
| 内容 | 文字、图片/卡片、房间名、邀请链接可版本化；记录模板版本 |
| 回执 | 记录提交、送达、失败、回复时间和失败原因 |
| 人工接管 | 高价值成员、敏感回复、连续失败进入待处理队列 |
4.3 频次与质量策略（P1）
- 默认一名成员在同一房间每个运营周期最多触发一次欢迎任务。
- 复访成员优先改用“欢迎回来”模板，避免重复打扰。
- 依据房间规则、账号状态、任务成功率、成员互动质量动态分配执行额度。
- 任务只通过平台已支持的消息能力执行；不可执行时保留为待人工处理任务并记录原因。
5. 功能三：数据统计与房主关系图谱（P0）
5.1 核心漏斗
| 指标 | 公式 |
|---|---|
| 进房人数 | 去重成员数 |
| 新成员率 | 首次进房成员 ÷ 进房人数 |
| 复访率 | 有再次进房成员 ÷ 进房人数 |
| 欢迎任务触发率 | 已创建任务 ÷ 可触达成员 |
| 送达率 | 已送达 ÷ 已提交 |
| 回复率 | 有回复成员 ÷ 已送达 |
| 回流率 | 收到欢迎内容后再次进房成员 ÷ 已送达 |
| 高质量成员率 | 高质量标签成员 ÷ 去重成员 |
5.2 看板
- 日/周/月房间看板：进房、停留、复访、触达、送达、回复、回流。
- 成员价值分层：活跃度、复访、回复、互动深度、人工确认结果。
- 内容效果：不同模板、图片/卡片、房间链接的送达和回复表现。
- 房主关系图谱：房主 → 房间 → 成员；成员在多个房主/房间间的交集、来源和复访。
- 异常看板：任务限制、失败原因、无回执、数据缺失、积压人工任务。
6. 功能四：平台限制与最优成员策略（P1）
| 目标 | 需求 |
|---|---|
| 执行额度 | 按账号、房间、时间窗口记录可用额度和实际消耗 |
| 风险感知 | 任务失败、限制提示、异常波动、重复触达自动进入异常队列 |
| 最优成员 | 以复访、停留、互动、回复、人工确认等可解释指标评分，分为高/中/低优先级 |
| 策略建议 | AI输出“建议跟进/建议暂停/建议换内容/建议人工接管”，展示依据和置信度 |
| 运营复盘 | 每周输出房间、模板、成员分层、异常和下周动作清单 |
7. 数据模型
| 实体 | 主键 | 核心字段 |
|---|---|---|
soul_member |
member_id | 名称、资料快照、首次/最近出现、AI标签、人工确认 |
soul_room |
room_id | 房间名、房主、邀请链接、状态 |
soul_room_visit |
visit_id | member_id、room_id、进入/离开、停留、互动 |
soul_message_task |
task_id | 成员、房间、模板版本、状态、回执、失败原因 |
soul_member_relation |
relation_id | 房主、房间、成员、来源、首次/最近关联时间 |
soul_ai_profile |
profile_id | 成员、事实摘要、标签、依据、置信度、人工修订 |
soul_daily_metric |
date+room_id | 漏斗指标、额度、异常指标 |
8. 接口与事件边界
room.member.entered：成员进入房间。room.member.left：成员离开房间。room.member.interacted：发言、互动或可统计行为。member.profile.available：可见资料更新。message.task.created/message.task.receipt：欢迎内容任务与回执。room.invite.opened：邀请链接打开或回流事件（可用时接入）。
所有事件写入SOUL独立命名空间；不得调用、修改或依赖微信事件、微信表或微信消息队列。
9. 火炬开发拆解与验收
| 阶段 | 火炬交付 | 验收 |
|---|---|---|
| S0 调研验证 | 真实房间事件字段、成员资料字段、消息回执字段清单 | 输出字段样本、缺失项、验收截图/日志 |
| S1 登记台 | 成员、房间、进房事件、去重和成员360卡 | 同成员多次进房只1主档、多条事件 |
| S2 内容任务 | 模板、素材、预检、去重、任务状态机和人工队列 | 任意任务可查模板版本、状态和失败原因 |
| S3 数据看板 | 漏斗、房间、成员、内容、关系图谱 | 指标可追溯到成员与事件 |
| S4 策略治理 | 额度、异常、优先级、AI建议、周报 | 规则可配置、建议可解释、人工可修订 |
10. 验收标准
- 进房成员100%生成或关联成员主档，重复进房不重复建人。
- 成员卡可追溯房间、房主、进房次数、互动、资料采集时间和标签来源。
- 欢迎内容任务全程有状态、模板版本、回执和失败原因。
- 日/周/月看板能显示进房、复访、送达、回复、回流和高质量成员率。
- 房主关系图谱可查看“房主—房间—成员”的关联和交集。
- SOUL数据与微信模块数据表、接口、任务队列完全隔离。
- 火炬完成真实环境S0字段验收后，才能进入写类任务联调。
11. 非目标
- 不替代现有SOUL内容生产、视频切片、素材分发和文章发布工作流。
- 不将成员资料同步到微信模块。
- 不以未经验证的推断替代成员事实。