01 产品目标与决策记录
已确认的方向
| 编号 | 用户明确的内容 | 产品影响 |
|---|---|---|
| C01 | 目标用户为进群用户；当前群里缺人，需要拉人进来 | 拉新和进群后的参与都属于首期核心目标 |
| C02 | 第一期重点是签到、答题和更好的内容分发 | 内容与任务应关联，不能只有签到领奖 |
| C03 | 长期培养为原创内容产出平台和用户中心 | 保留投稿、贡献记录及未来账号关联空间 |
| C04 | 首期总预算每周60U | 四类奖励的金额分配尚未确认；60U暂按奖励预算记录，开发、服务器和手续费是否包含仍待定 |
| C05 | 用户提出支持中文和英文 | 双语为设计范围；默认语言、翻译与切换规则尚属建议 |
讨论中的关键调整
| 顺序 | 讨论与纠正 | 当前结论 |
|---|---|---|
| 1 | 原始需求从“机器人配置”拆成拉新、任务、积分、触达及运营功能 | 技术选型不能代替业务需求 |
| 2 | 明确内容分发与长期原创内容方向 | 补入内容管理、内容关联题目和贡献记录 |
| 3 | 曾建议首期弱化拉新，用户指出群里没人 | 该建议已撤回，拉新必须保留 |
| 4 | 原奖池30/20/10覆盖活跃、周榜、贡献，缺少拉新预算 | 新的20/20/10/10分配仅为备选方案 |
| 5 | 讨论邀请机会跨周、答题、投票与内容配置 | 累计、消耗、重复中奖等规则尚待业务确认 |
| 6 | 讨论身份、界面、语言、角色、数据流与App | 提出机器人＋运营后台方案，尚未完成技术评估与最终选择 |
首期范围建议
首期目标路径：种子用户进入 → 邀请新成员 → 入群验证 → 内容触达 → 签到、答题、投票 → 积分及周度奖励 → 再次参与 → 优质内容贡献。
建议首期包含：一个目标群、一套按周活动、邀请归属与验证、任务、双语内容、个人查询、人工审核开奖发奖、基础复盘。暂不包含：强制App注册、自动转账、多群独立结算、复杂账号反作弊、完整创作者平台。以上范围除用户明确目标外均需评审确认。
首期成功指标不预填虚构目标值：活动启动人数、有效邀请人数、首次任务参与率、7天留存、次周任务参与率、内容关联答题人数、优质投稿人数、奖励实付及运营工时。数量目标由营销在试运行前设定。
02 产品形态与模块
入口与身份方案（建议）
Telegram群负责公共内容、讨论、公告；机器人私聊负责邀请入口、签到答题、个人记录及语言切换；网页运营后台负责配置、发布、审核和结算。当前PRD网页只用于阅读，不是运行中的业务后台。
用户启动机器人后用Telegram用户ID建立内部活动用户，不额外要求密码、手机号或App绑定。分享邀请链接不能证明对方收到或阅读；启动入口、加入群、满足有效邀请条件是不同事件。首次符合规则的邀请来源锁定，不能被后续链接覆盖。昵称不作为唯一身份，也不据此合并账号。
机器人需要必要的群管理权限及成员变化订阅。入群时记录、退群时更新；24小时后复核。只在结束时查询“仍在群内”不足以证明连续留群，期间记录不完整时转待审核。存量群成员和部署前历史不可假设全部可自动追溯。
业务模块与用户功能
| 编号 | 模块 | 用户入口及功能 | 运营对应功能 |
|---|---|---|---|
| M01 | 用户入口与个人中心 | 开始参与、规则、积分、活跃天数、语言、联系客服 | 用户查询、参与状态、语言、操作记录 |
| M02 | 邀请拉新 | 专属链接、有效人数、待验证人数、余额、机会、无效原因 | 来源渠道、邀请关系、验证、异常审核 |
| M03 | 内容分发 | 今日内容、往期内容、关联任务 | 双语内容、媒体或链接、发布计划、撤下与版本 |
| M04 | 签到、答题与投票 | 今日任务、提交、反馈、解析、完成状态 | 题库、投票、时间窗口、计分和任务排期 |
| M05 | 积分与奖励 | 积分流水、周榜、抽奖机会、中奖与领奖状态 | 积分调整、奖池、名单冻结、开奖、发奖登记 |
| M06 | 消息与活动节奏 | 公告、资格提醒、结果通知 | 中英模板、排期、发布状态与失败重试 |
| M07 | 运营管理与复盘 | 申诉、投稿入口 | 审核、权限、配置、导出、贡献评选、指标 |
模块由原来的6个扩充为7个，主要因为将内容分发单独列出；不代表必须开发7套独立系统。
页面与按钮建议
机器人主菜单：今日任务／精选内容／邀请好友／我的奖励／个人中心。个人中心含Language／语言及联系客服。群内置顶欢迎说明和活动入口，公共消息使用双语短摘要。
运营后台导航：工作台、内容管理、任务管理、邀请与用户、活动与奖励、审核与申诉、数据复盘、系统与权限。复杂内容浏览和投稿成熟后再考虑Mini App。
双语与App边界（建议）
2026-09-11已确认：新用户首次启动自选语言（双语欢迎消息＋按钮），选定后记住，不依赖客户端语言推断；个人中心可随时切换，后台默认中文。公共群消息不能按每个人的偏好分别显示；题目和内容的双语版本共享同一编号，切换语言不新增计分机会。关键活动规则和计分任务发布前必须检查双语齐全，普通内容缺译时可提示后显示已有版本。
第一期不强制接入App。建立内部用户ID关联Telegram ID，预留App用户ID，后续通过双方身份验证绑定。不得凭相同昵称或钱包地址自动合并；账号关联不自动合并积分。是否复用已有后台、账号和内容服务，待检查现有App后确定。
03 角色与权限
| 角色 | 功能权限 | 配置与使用位置 | 限制 |
|---|---|---|---|
| 普通用户 | 邀请、签到、答题、投票、查看个人数据、领奖、投稿申诉 | 群与机器人 | 只能看自己的详细记录及公开榜单 |
| 内容运营 | 创建双语内容、题目、投票、预览排期；处理投稿及问题 | 后台内容与任务管理 | 默认不能配置总预算、分配管理员或登记发奖 |
| 活动审核与发奖人员 | 异常审核、积分调整、贡献评选、冻结名单、开奖及发奖登记 | 后台审核、活动与奖励 | 每次调整保存理由；收款资料限制访问 |
| 超级管理员 | 账号角色、目标群、时区、活动规则与预算、系统设置 | 后台系统与权限 | 高影响变更保留审计记录 |
首期可一人兼任多角色，但权限仍分别定义。邀请人与被邀请人是普通用户的业务关系。Telegram群管理员不自动拥有后台权限。后台登录认证方式待技术评估；服务端校验权限，不能只隐藏按钮。
04 业务流程
本节是建议流程。点击步骤查看执行者、数据结果及异常分支；具体奖励规则以待定项确认后为准。
查看全部流程明细表（打印时完整展开）
本节流程均为建议落地流程；其中3人、24小时、8分、3天等来自原材料，跨周消耗等来自讨论建议，最终以待定清单确认后的活动规则为准。流程中的“异常”是分支，不应默认全部自动通过。
F01 种子用户与邀请拉新
| 步骤 | 执行者 | 动作 | 数据或结果 | 异常与分支 |
|---|---|---|---|---|
| 1 | 运营 | 配置活动与初始引流渠道 | 来源渠道、活动规则及入口 | 没有种子用户需先开展渠道引流 |
| 2 | 邀请人 | 启动机器人并分享专属入口 | 邀请码关联用户 | 分享不等于收到，不直接计奖励 |
| 3 | 新用户 | 通过链接启动机器人 | 内部用户与首次邀请关系 | 自邀、已有归属或非新用户不重复归属 |
| 4 | 新用户 | 加入目标群 | 入群时间，状态待验证 | 直接入群无来源的用户不猜测邀请人 |
| 5 | 系统 | 观察24小时成员变化 | 记录进退群事件 | 验证期内退出即作废且永不重算（2026-09-11确认） |
| 6 | 系统或审核员 | 复核有效性 | 有效邀请增加1或转待审 | 记录缺失、异常账号不自动认定 |
| 7 | 系统 | 每满3人生成一次机会 | 邀请余额与机会流水 | 余额跨周累计已确认；防重复生成 |
| 8 | 系统 | 分配至符合截止规则的期次 | 当期可用机会，通知邀请人 | 机会生成后自动进入当期抽奖（已确认） |
F02 每日签到
| 步骤 | 执行者 | 动作 | 数据或结果 | 异常与分支 |
|---|---|---|---|---|
| 1 | 运营 | 设置签到日历与积分 | 日期、时区、时间窗口 | 按期配置，默认周一至五（已确认） |
| 2 | 系统 | 发布今日任务入口 | 可参与签到任务 | 发布失败告警及人工补发 |
| 3 | 用户 | 点击签到 | 签到请求关联用户 | 未启动或不满足群成员条件先提示 |
| 4 | 系统 | 校验当天资格与重复提交 | 首次有效签到 | 已签到返回原结果，不重复计分 |
| 5 | 系统 | 记录积分和活跃日 | 建议1分，当天活跃最多计1天 | 以活动时区切日，不以手机时区切日 |
| 6 | 用户 | 查看签到结果及后续任务 | 本周积分、天数、关联内容 | 失败可重试但不能多记账 |
F03 内容关联单选答题
| 步骤 | 执行者 | 动作 | 数据或结果 | 异常与分支 |
|---|---|---|---|---|
| 1 | 内容运营 | 创建内容和关联题目 | 中英题干、选项、答案、解析 | 缺答案或缺计分任务翻译禁止发布 |
| 2 | 内容运营 | 预览并排期 | 每周3题（2026-09-11确认） | 频率按期可调 |
| 3 | 系统 | 发布内容摘要及答题入口 | 内容与任务编号关联 | 消息发送失败进入重试或人工处理 |
| 4 | 用户 | 阅读内容并选择答案 | 当前题目及所选选项 | 内容入口点击不等于完整阅读 |
| 5 | 用户与系统 | 确认提交并校验首次作答 | 保存最终答案和提交时间 | 超时拒绝；重复提交返回原结果 |
| 6 | 系统 | 判分并记录 | 答对建议3分，答错0分 | 答错也算活跃日（有效提交即算，已确认） |
| 7 | 系统 | 展示解析及个人进度 | 解析、积分流水、活跃天数 | 切换语言不能重答；提交后即时解析（已确认） |
| 8 | 内容运营 | 查看正确率并处理错题 | 题目效果与更正记录 | 已有人作答后不静默改答案，需补偿方案 |
F04 官方投票
| 步骤 | 执行者 | 动作 | 数据或结果 | 异常与分支 |
|---|---|---|---|---|
| 1 | 内容运营 | 明确调研目的 | 选题偏好、功能需求或活动时间 | 没有调研需要不强行凑投票 |
| 2 | 内容运营 | 配置双语问题与选项 | 单多选、起止时间、积分、结果公开规则 | 首期建议单选，修改及撤回政策待定 |
| 3 | 系统 | 发布投票入口 | 建议每周最多2次计分投票 | 已确认采用机器人按钮投票，可识别投票者 |
| 4 | 用户 | 提交选择 | 用户、投票编号、选项 | 匿名票不能可靠用于个人积分 |
| 5 | 系统 | 保存并计分 | 首次有效参与建议1分 | 改投不重复加分，撤回按配置处理 |
| 6 | 系统 | 到期关闭并汇总 | 各选项票数与参与人数 | 到期后拒绝新提交 |
| 7 | 内容运营 | 发布结果并调整内容计划 | 例如下周增加产品教程 | 公布汇总，不默认公开个人选择 |
F05 内容运营与分发
| 步骤 | 执行者 | 动作 | 数据或结果 | 异常与分支 |
|---|---|---|---|---|
| 1 | 内容运营 | 编制当周内容计划 | 新人引导、产品知识、互动、用户贡献 | 选题围绕业务目标与上期反馈 |
| 2 | 内容运营 | 编辑内容双语版本 | 标题、摘要、正文或链接、媒体、分类 | 检查链接有效性与内容使用许可 |
| 3 | 内容运营 | 关联答题或投票 | 一个内容关联相应任务 | 内容可以独立发布，不强制每篇有题 |
| 4 | 内容运营 | 检查双语预览和排期 | 草稿转待发布 | 未完成检查不进入发布队列 |
| 5 | 系统 | 发布群消息与机器人内容入口 | 消息标识、发布时间、版本 | 失败重试避免重复发同一内容 |
| 6 | 用户 | 查看并参与关联任务 | 内容入口访问及任务参与 | 只记录实际可观测事件，不声称已阅读 |
| 7 | 内容运营 | 复盘与维护历史内容 | 内容参与效果、归档或撤下 | 撤下保留历史积分和审计记录 |
F06 周度运营与结算
| 步骤 | 执行者 | 动作 | 数据或结果 | 异常与分支 |
|---|---|---|---|---|
| 1 | 管理员与运营 | 配置当期规则与60U预算 | 规则版本、期次、奖池 | 各奖池合计超预算不得发布 |
| 2 | 内容运营 | 配置内容和任务日历 | 签到、答题、投票排期 | 时区、起止时间及双语检查 |
| 3 | 系统与运营 | 发布公告并开展活动 | 用户看到资格、奖品及截止时间 | 已开始后不随意改当期奖励承诺 |
| 4 | 运营 | 监控参与及处理异常 | 邀请审核、申诉、内容贡献 | 人工调整必须附理由 |
| 5 | 系统 | 到期计算候选名单 | 活跃资格、邀请机会、积分榜 | 只纳入当期满足截止规则的数据 |
| 6 | 审核员 | 审核并冻结最终名单 | 名单版本及排除原因 | 未决争议延期或按公告规则处理 |
| 7 | 发奖人员 | 执行开奖与发奖流程 | 中奖结果与发放记录 | 开奖未完成不能消耗机会 |
| 8 | 运营 | 发布汇总并复盘下期 | 新增、留存、参与、支出、工时 | 规则调整默认从下一期生效 |
F07 抽奖、领奖与发奖
| 步骤 | 执行者 | 动作 | 数据或结果 | 异常与分支 |
|---|---|---|---|---|
| 1 | 审核员 | 冻结各奖池资格及抽奖机会 | 独立机会编号与名单版本 | 可用、待审核、已使用分开 |
| 2 | 发奖人员 | 按公告方式公开抽取 | 中奖人、奖项、抽取记录 | 同人同池最多中N次，N可配置、默认无上限（已确认）；跨池待定 |
| 3 | 系统或运营 | 确认本期开奖完成 | 保存结果，机会转已使用 | 失败不消耗；重复导入不重开奖 |
| 4 | 系统 | 通知中奖用户 | 金额、领奖入口与期限 | 私聊无法送达时用不暴露资料的群公告 |
| 5 | 中奖用户 | 私下提交领奖资料 | 币种、网络、地址或其他信息 | 不在群公开收集；不索取私钥或助记词 |
| 6 | 发奖人员 | 人工检查并发放 | 发奖状态、交易凭据与实付 | 地址错误、失败、过期进入异常处理 |
| 7 | 运营 | 公布结果与结案 | 公开获奖摘要，私下保存敏感资料 | 领奖线下人工处理，运营提醒并公示（已确认） |
F08 投稿与特别贡献
| 步骤 | 执行者 | 动作 | 数据或结果 | 异常与分支 |
|---|---|---|---|---|
| 1 | 用户 | 提交原创内容、提问或答疑 | 投稿原文、作者、时间 | 首期允许人工接收，不要求完整编辑器 |
| 2 | 内容运营 | 审核质量与发布授权 | 待审、采纳或退回 | 非原创或重复投稿说明原因 |
| 3 | 审核员 | 按当期标准评选贡献奖 | 奖项与评选理由 | 已确认：人工加分与入围资格审核并行，贡献奖经线下抽奖产生 |
| 4 | 内容运营 | 发布精选并署名 | 内容关联作者与原始投稿 | 未获发布许可则不公开 |
| 5 | 发奖人员 | 纳入发奖及贡献记录 | 奖励状态、作者贡献历史 | 未评选出合格内容时预算处理待定 |
F09 申诉与人工修正
| 步骤 | 执行者 | 动作 | 数据或结果 | 异常与分支 |
|---|---|---|---|---|
| 1 | 用户 | 提交邀请或积分问题 | 事项、任务编号、说明 | 不需要在群公开个人资料 |
| 2 | 运营 | 查询任务与邀请流水 | 受理记录与证据 | 无证据不能凭昵称直接加分 |
| 3 | 审核员 | 决定维持或更正 | 理由、操作者、调整流水 | 保留原记录，不直接抹除历史 |
| 4 | 系统 | 重算未冻结资格并通知 | 新进度及处理结果 | 已冻结需新版本；已开奖需单独补偿决策 |
05 运营功能与核心配置
以下字段为建议需求，示例值不是已批准默认值。所有后台保存功能需有必填、格式、权限与时间校验。
| 配置位置 | 核心字段 | 示例或建议 | 校验及生效规则 |
|---|---|---|---|
| 系统与权限／基础设置 | 目标群、活动时区、运营联系方式、后台账号角色 | 一个目标群；时区待确认 | 修改时区不能重算已结算历史；后台身份必须认证 |
| 活动与奖励／期次 | 活动编号、起止、结算、开奖、领奖截止、规则版本 | 周日结算、周一开奖来自原文 | 开始早于截止，开奖晚于审核冻结 |
| 活动与奖励／预算 | 总额、各奖池金额、币种、网络、费用承担 | 每周60U纯奖池、手续费另算；金额按期配置、上线前定稿 | 总分配不超60U，单奖合计与奖池一致 |
| 活动与奖励／奖项 | 类型、人数、单人金额、同池与跨池重复获奖、无人达标策略 | 拉新、活跃、周榜、贡献 | 并列平分、余奖滚下期；领奖线下处理（均已确认） |
| 邀请与用户／邀请规则 | 新人定义、留群时长、每次机会人数、跨周余额、退群重入、期次归属 | 原文24小时、3人一次 | 首次入群为准；重入不算新人；验证期内退出作废且永不重算 |
| 活动与奖励／机会规则 | 自动参抽、消费时点、有效期、上限、延期、重复中奖 | 开奖成功后消耗（已确认）；同人同池N次可配、默认无上限 | 机会编号唯一；延期不误扣 |
| 任务管理／签到 | 开放日期、日内窗口、积分、群成员要求 | 原文1分；按期配置、默认周一至五 | 同用户同活动日只能一次 |
| 任务管理／题库 | 双语题干选项、正确答案、解析、关联内容、积分 | 单选，每周3题（可按期调整）、答对3分 | 正确答案必须存在；双语选项语义一致 |
| 任务管理／答题排期 | 发布与截止、提交次数、解析时机、答错活跃口径 | 一次最终提交；即时解析；答错计活跃日（均已确认） | 发布后涉及评分的修改需版本和补偿说明 |
| 任务管理／投票 | 双语问题选项、单多选、时间、积分、改投撤回、结果公开 | 原文参与1分、每周最多2次 | 机器人按钮投票（已确认）；改投不重复计分 |
| 内容管理／内容 | 标题、摘要、正文或链接、媒体、分类、作者、双语、关联任务 | 新人指南、教程、互动、精选投稿 | 草稿预览后排期；发布保存版本与消息标识 |
| 消息管理／模板 | 欢迎、任务、资格、开奖、领奖、错误提示的双语版本 | 中文／English切换 | 缺翻译提示；失败可重试，不无限重复推送 |
| 活动与奖励／活跃及榜单 | 分数门槛、活跃天数、计日行为、同分规则、人工分上限 | 原文8分且3天 | 有效提交即算活跃日；同分并列平分、余奖滚入下期 |
| 审核／人工调整 | 用户、原因、证据、分值变化、操作者、期次 | 错误补偿或优质内容加分 | 不能覆盖原流水；审核操作可追溯 |
| 审核／贡献奖 | 评选标准、名额、金额、叠加规则、发布授权 | 人工加分＋5与入围审核并行；贡献奖线下抽奖产生 | 不能将奖励建议默认为固定发放承诺 |
| 数据复盘／报表 | 期次、来源、语言、用户分组、指标口径 | 对比渠道的入群与后续任务参与 | 排除测试账号，导出权限受控 |
运营的每周操作清单
开期前：确定奖池和规则 → 准备双语内容及题目 → 配置投票 → 预览用户入口 → 检查群权限和消息 → 发布公告。
活动中：检查消息发送 → 查看新增与任务完成 → 审核异常邀请 → 处理申诉 → 筛选贡献内容 → 记录人工调整。
结算时：检查截止口径 → 审核候选名单 → 冻结并导出 → 开奖 → 私下收集领奖资料 → 人工发奖 → 记录凭据 → 公告与复盘。
06 数据流与实际例子
主要数据对象
| 对象 | 保存内容 | 关联关系 |
|---|---|---|
| 活动用户 | 内部用户ID、Telegram ID、语言、参与状态、可选App ID | 同一人所有任务和邀请记录关联内部ID |
| 活动期次与规则 | 时间、时区、规则版本、预算和奖池 | 结算引用当期版本，不引用随时变化的最新规则 |
| 邀请关系与成员事件 | 邀请人、被邀请人、来源、入退群时间、审核状态 | 一个被邀请用户只贡献一次有效归属，具体新人定义待定 |
| 抽奖机会 | 唯一编号、来源邀请、所属期次、状态 | 一次机会只消费一次，和邀请余额分开 |
| 内容与任务 | 内容版本、双语题目或投票、发布时间、截止时间 | 双语共享同一业务编号 |
| 参与记录与积分流水 | 用户、任务、答案或选项、时间、加减分原因 | 可追溯每笔积分，重复请求不重复记账 |
| 资格与获奖发放 | 冻结名单版本、奖项、中奖结果、发奖状态及凭据 | 开奖绑定冻结名单；敏感领奖资料限制访问 |
| 投稿、申诉与审计 | 原始材料、处理记录、操作人、时间、理由 | 更正不删除原始证据 |
一个贯穿示例（基于建议规则）
小王第一周有效邀请1人，余额为1，无机会。第二周又有效邀请2人，生成机会T001，余额归零，自动进入第二周抽奖。第二周实际开奖成功后T001变为已使用，即使未中奖也不跨周保留。若开奖延期，T001保持待使用。若累计有效邀请10人，则共生成3次机会，余1人；此前已经使用的机会不重复参加。
小李通过小王链接启动机器人，创建用户U102，入群满24小时且事件核验通过后，小王增加1名有效邀请。小李签到＋1分、答对题Q03＋3分，当天4分但只算1个活跃日。切换英文打开Q03不会再次计分。周末若9分、活跃3天且审核通过，进入活跃抽奖名单；中奖后提交领奖信息，运营人工发放并记录凭据。
数据与指标边界
首次任务参与率＝观察窗口内完成至少一次有效任务的新活动用户／同一批新活动用户。7天留存需对已满7天的入群批次观察；次周参与率需对上一周参与用户观察。有效邀请属于结算口径，后续留存和内容参与属于效果口径，不能混为一个指标。具体观察窗口、退出再入和“在群”或“任务活跃”的留存定义上线前确定。
消息发布成功不等于用户看到；入口点击不等于阅读完成；答对不等于真实理解。只报告可观测事件。所有记录由服务端校验身份、时间和权限，用户按钮或页面显示不能决定奖励结果。
07 冲突、待定与上线决策
“待定”必须在对应功能上线或活动公告前确认。2026-09-11五轮讨论已确认其中19项（见各行“2026-09-11已确认”标注）；D15、D17挂起。当前网页不会因为浏览或点击而改变决策状态。
| 编号 | 冲突或待定项 | 当前证据与建议 | 确认人／时点 |
|---|---|---|---|
| D01 | 拉新奖池缺失 | 原文30活跃＋20周榜＋10贡献已满60；备选20拉新＋20活跃＋10周榜＋10贡献未获确认。2026-09-11已确认：奖池金额为按期配置项，后期可改，上线前定稿，池构成默认值随之定稿 | 用户／2026-09-11，公告前定稿 |
| D02 | 固定或动态奖池 | 用户希望考虑拉新人多的情况；建议按期预公告或有上限的阶梯奖池，合计不超60。2026-09-11已确认：按期配置化解固定／动态之争 | 用户／2026-09-11 |
| D03 | 60U预算覆盖范围 | U暂按USDT理解；手续费、开发与服务器是否另计未确认。2026-09-11已确认：60U为纯奖池，手续费、服务器、开发成本另算 | 用户／2026-09-11 |
| D04 | 新用户定义及初始名单 | 从未入群、活动后首次入群或首次启动机器人不能混用；历史识别能力需验证。2026-09-11已确认：以首次入群为准；退出再进入不算新人；不可被重复邀请，首次归属唯一锁定 | 用户／2026-09-11 |
| D05 | 24小时与退群重入 | 原文需留群24小时；通过后退出是否撤销、重入是否重算待定。2026-09-11已确认：验证期内退群作废且永不重算；通过验证后退群不撤销已计邀请 | 用户／2026-09-11 |
| D06 | 机会跨周与消费 | 余额跨周、自动参抽、开奖成功后消耗为建议；有效期、总上限未定。2026-09-11已确认：余额跨周累计；满3人自动生成机会并自动进入当期抽奖；开奖成功即消耗、不跨周保留 | 用户／2026-09-11 |
| D07 | 多机会与重复中奖 | 建议多机会增加概率、同人同池最多中一次；跨池叠加未定。2026-09-11已确认：同人同池最多中N次，N为配置项、默认无上限（推翻此前“最多中一次”建议）；跨池叠加未涉及、仍待定 | 用户／2026-09-11 |
| D08 | 邀请跨期截止 | 建议以满足24小时的时刻归属期次，而非点击或入群时刻。2026-09-11已确认（随机会规则）：机会生成后自动进入当期抽奖，期次以验证通过、机会生成时刻为准 | 用户／2026-09-11 |
| D09 | 签到与题量 | 原文周一至周五签到，任务写每日签到；建议3天各1题，具体5天或7天签到待定。2026-09-11已确认：签到按期配置、默认周一至五；答题每周3题、频率可按期调整 | 用户／2026-09-11 |
| D10 | 答错及活跃日 | 答错0分是否算活跃，人工加分是否算活跃日未定；建议有效提交算参与日。2026-09-11已确认：有效提交即算活跃日，答错与人工加分均计入 | 用户／2026-09-11 |
| D11 | 答案解析与题目错误 | 一次提交、即时解析为建议；错题作废或补偿需规则。2026-09-11已确认：提交后即时显示对错与解析；错题更正补偿细则上线前补充 | 用户／2026-09-11 |
| D12 | 投票实现与撤回 | 原生非匿名投票或机器人按钮未选；改投、撤回积分与活跃日处理待定。2026-09-11已确认：采用机器人按钮投票（可识别投票者、可靠计分）；改投、撤回细则随实现细化，默认改投不重复加分 | 用户／2026-09-11 |
| D13 | 人工5分与贡献奖 | 原文允许优质内容＋5，曾建议贡献奖单列；是否叠加、上限与评审标准待定。2026-09-11已确认新模型：优质内容由人工审核加积分＋5，同时人工审核是否入围特别贡献奖抽奖；特别贡献奖经线下抽奖产生，不再是运营直接指定 | 用户／2026-09-11 |
| D14 | 周榜同分与名额 | 原文前三名；新的10U备选如何分配，同分、人数不足未定。2026-09-11已确认：同分并列平分；不足3人只发实际达标名次，余奖滚入下期 | 用户／2026-09-11 |
| D15 | 时区与具体截止 | 周日结算、下周一开奖来自原文，但时区和具体时刻未定。2026-09-11决定：挂起，待目标社群构成明确后再定 | 用户／2026-09-11，待社群构成 |
| D16 | 领奖与剩余预算 | 币种网络、截止期限、地址修改、无人达标或未领奖的金额处理未定。2026-09-11已确认：领奖线下人工处理，运营负责提醒并公示，系统仅记录状态、不设系统强制期限 | 用户／2026-09-11 |
| D17 | 产品形态和App | 机器人＋网页后台、不强制App为建议；Mini App、后台复用需评估。2026-09-11决定：用户明确暂不讨论技术形态，挂起 | 用户／2026-09-11，待重启讨论 |
| D18 | 双语默认及翻译 | 英文兜底、简体中文、人工检查为建议；翻译负责人未定。2026-09-11已确认：语言首次启动自选（双语欢迎消息＋按钮），选定后记住；翻译负责人未涉及 | 用户／2026-09-11 |
| D19 | 种子用户与目标值 | 拉新重要已确认；第一批人从哪里来、渠道负责人和数量目标待定。2026-09-11已确认：种子用户由自有渠道导入；数量目标仍由营销在试运行前设定 | 用户／2026-09-11 |
| D20 | 运营权限与数据保存 | 角色兼任、审核责任、隐私告知、保存期限、删除及导出范围待定。2026-09-11部分确认：首期一人兼任多角色，权限按角色分开定义并留审计；数据保存、隐私细则仍待定 | 用户／2026-09-11，隐私细则上线前 |
| D21 | 故障和已开奖修正 | 缺失成员事件、任务停机、重开奖与补偿未定；建议人工审核、公开说明，不静默改历史。2026-09-11已确认按此原则执行 | 用户／2026-09-11 |
08 验收与交付边界
验收用例基于建议方案；2026-09-11已按当日十九项确认决策同步更新，仍不以本稿替代最终公告规则。
| 编号 | 场景 | 预期结果 |
|---|---|---|
| A01 | 分享链接但对方未启动 | 不产生有效邀请，不声称对方已收到 |
| A02 | 用户已归属A，又点击B链接 | 不覆盖已有有效归属；自邀不获奖励 |
| A03 | 入群未满24小时或期间事件缺失 | 不自动计有效；验证期内退群作废且永不重算 |
| A04 | 第一周1人、第二周2人有效邀请 | 余额跨周累计，生成且仅生成1次机会 |
| A05 | 累计10人，重复执行生成任务 | 累计3次机会、余额1人；重复执行不增发 |
| A06 | 开奖延期或结果重复导入 | 延期不扣机会；同一期不重复消耗及发奖 |
| A07 | 同日重复签到或切换语言答同题 | 不重复得分，不重复增加活跃天数 |
| A08 | 同日签到、答题、投票均完成 | 分数按各任务累计，活跃日仅增加1 |
| A09 | 超过任务截止时间提交 | 拒绝提交并说明已截止 |
| A10 | 投票改投及撤回 | 机器人按钮投票；任何改投不重复加分 |
| A11 | 奖池合计超过60U | 阻止发布并显示超出额；不暗中压缩奖金 |
| A12 | 内容或任务缺必填／正确答案／必要翻译 | 发布前明确报错；草稿可保存 |
| A13 | 未授权人员调用积分或发奖操作 | 服务端拒绝；已授权操作保留审计 |
| A14 | 人工修正已冻结名单 | 不覆盖旧版本，保存理由；已开奖走补偿决策 |
| A15 | 消息失败、发奖失败 | 保留失败状态、原因和重试记录，避免重复发送或付款 |
| A16 | 用户无App账号 | 可完成首期Telegram流程；不会因此被拒绝参与 |
上线前验证：机器人群权限与事件接收、任务时区、双语路径、全链路小规模试运行、后台权限、数据备份与恢复方案。开奖与发奖第一期按人工操作设计，自动化程度及服务异常处理需要研发评估。网页仅是PRD说明，不含真实账号连接、发布、支付或后台数据保存功能。
09 来源与版本维护
- 原始文件：TG机器人配置.docx；2026-09-10需求梳理与旧版流程网页。
- 用户确认：本次对话中目标用户、签到答题与内容方向、拉新重要性、每周60U；奖励截图作为原文规则依据。
- 平台核对：Telegram Bot Features 官方资料 ↗ （邀请参数与入口）。
- 平台核对：Telegram Bot API 官方资料 ↗ （用户身份、语言、成员事件、成员查询及投票限制）。
- 平台核对：Telegram Mini Apps 官方资料 ↗ （未来页面身份校验）。
- 平台资料在2026-09-11讨论时核对；开发时需再次确认所用API与权限。
- 本次新增：内容独立模块、9条流程、运营配置、角色权限、数据例子、21项待定与16项验收。
- 后续确认D项时，同步更新规则、流程、配置默认值和验收；保留历史版本与变更原因。
- 2026-09-11 v0.4：同日五轮需求讨论确认19项待定（D01—D14、D16、D18—D21），D15、D17挂起；同步更新第02、04、05、07、08节相关表述；特别贡献奖改为“人工加分＋入围审核＋线下抽奖”模型。
10 开源复用评估与改造清单
评估结论与验证范围
建议采用成熟开源机器人框架及后台框架，复用部分邀请入口代码，自行实现活动规则、积分与奖励账目。该方案是技术建议，用户要求记录以供后续AI讨论，不代表技术栈或全部规则已获最终批准。
本次完成公开仓库文档、目录、许可证及部分关键源码的只读检查，未部署运行候选系统，未运行其测试，未做完整安全审计、依赖漏洞扫描或生产可用性验证。不能将“已有源码”表述为“系统已经可直接上线”，也不承诺复用比例或工期。
候选项目及授权状态
| 项目 | 已核实内容 | 采用建议 |
|---|---|---|
| alerrad/referral-bot | 已读取LICENSE，MIT；检查时GitHub显示最近推送2025-04-21；有机器人邀请入口、排名查询、排行榜小程序；README把后台和完整多语言列为待办 | 可选择性复用适用代码并保留许可及版权声明，不原样采用计奖逻辑 |
| RakinSV/Telegram-admin-app-project | 文档宣称有内容、答题、邀请、抽奖、投稿和后台；检查时最近推送2026-08-24；GitHub许可证字段为空，目录未发现许可证文件，所读pyproject也未给出授权 | 目前仅作功能参考；未确认授权前不纳入可复用代码范围。文档功能未逐一验证 |
| itsAPK/Telegram-Referral-Bot | 上轮只核对仓库文档：邀请、广播、管理命令、导出；作者提示使用较旧python-telegram-bot 13.7；未确认许可证 | 仅作运营功能参考，未进入本轮源码采用候选 |
推送时间不等于持续维护承诺。未找到许可证不等于断言仓库绝不存在其他授权，后续采用前必须重新确认。此次没有复制候选仓库业务代码到当前项目。
已核实的关键代码问题
| 编号 | 位置 | 代码事实 | 对我们业务的影响及修改 |
|---|---|---|---|
| O01 | bot/src/routers/commands.py：start_command | 带邀请参数启动机器人后调用add_invited | 这一步只代表入口参与；需改为待验证记录，入群和留群核验通过后才转有效 |
| O02 | bot/src/core/database.py：Invited及add_invited | 主键由被邀请人tg_id和invited_by组成，只检查同一对关系是否已存在 | 数据层允许同一人归属不同邀请人；需按最终新人规则建立唯一归属约束，并处理并发冲突 |
| O03 | bot/src/core/database.py：get_leaderboard | 按Invited记录数量统计排行 | 不能直接当有效邀请数；应只统计验证通过且属于对应口径的记录 |
| O04 | bot/src/core/database.py：User、Invited | 当前模型没有活动期次、进退群事件、抽奖机会和积分流水 | 需要扩展或重建业务模型，不能只加几个配置参数 |
| O05 | bot/src/routers/commands.py及词库目录 | 处理函数直接使用LEXICON_EN；词库有英文和俄文 | 需要中文词库、用户语言字段、统一语言选择与模板调用 |
| O06 | requirements.txt与leaderboard-mini-app/package.json | 机器人固定依赖aiogram 3.17.0等，小程序使用Next.js和独立前端依赖 | 正式采用前选兼容版本并检查依赖；首期可省去排行榜小程序 |
以上O01—O06为静态代码检查结论，不是实际运行复现报告。代码读取自当时main分支，未记录不可变commit SHA；后续实施必须锁定版本并重新核验，不能假设上游不会变化。
按产品模块拆分工作
“复用”仍包含接入、配置与验证。下表是工作范围估计，不是已完成的实现。
| 模块 | 复用程度 | 需要修改或新增 | 关联PRD |
|---|---|---|---|
| Telegram消息、按钮、命令 | 使用aiogram等开源框架 | 我们的菜单、路由、身份识别、错误处理 | M01、M06 |
| 专属邀请入口 | 可复用后修改 | 来源校验、无效参数、首次归属、自邀和并发处理 | F01、D04 |
| 用户档案 | 扩展开发 | 内部用户ID、Telegram ID、语言、状态、可选App关联 | M01、D17—D18 |
| 有效邀请认定 | 核心业务重做 | 入退群事件、24小时核验、存量用户、退群重入、缺失记录待审 | F01、D04—D05 |
| 抽奖机会 | 新增开发 | 每3人生成、跨周余额、期次、使用状态、延期、防重复生成 | F07、D06—D08 |
| 每日签到 | 新增业务逻辑 | 活动时区、日历、每日一次、积分及活跃日 | F02、D09—D10 |
| 单选答题 | 开源交互能力＋业务开发 | 双语题库、排期、一次提交、判分、解析、错题修正 | F03、D09—D11 |
| 官方投票 | 开源交互能力＋业务开发 | 问题选项、计分、改投撤回、截止、结果公开 | F04、D12 |
| 内容分发 | 后台基础表单＋业务开发 | 双语内容、媒体链接、关联任务、排期、失败重试与防重复发布 | F05、D18 |
| 积分与榜单 | 展示思路可参考，计算重做 | 独立积分流水、按期汇总、同分处理、人工调整审计 | M05、D10、D13—D14 |
| 奖励与结算 | 新增业务逻辑 | 60U校验、四类奖项、候选名单、冻结、开奖、发奖状态 | F06—F07、D01—D03、D16 |
| 运营后台 | 使用开源后台框架 | 注册业务模型、配置字段、权限；增加发布、审核、冻结等业务操作 | 第03、05节 |
| 中文与英文 | 修改及补充 | 语言偏好、模板、内容翻译；双语共享任务编号 | M01、D18 |
| 投稿与申诉 | 简单表单与业务流程 | 接收、审核、结果通知、贡献记录；不首期做复杂编辑器 | F08—F09 |
| 数据复盘 | 新增业务查询 | 来源、有效邀请、任务参与、留存、支出和统计口径 | 第06节、D19 |
建议架构与复用边界
用户在Telegram群或机器人操作 → aiogram接收事件 → 统一业务服务校验身份、规则与状态 → 数据库保存记录 → 机器人反馈；运营后台调用同一套业务规则，后台操作不能绕过积分、预算和冻结校验。
| 层次 | 建议 | 不包含在现成能力中的工作 |
|---|---|---|
| 机器人接入 | aiogram处理消息、按钮和事件 | 我们的业务流程、资格判定和记账 |
| 运营基础界面 | 若现有App后台不可复用，可选Django Admin | 内容任务模型、业务字段校验、流程操作与细分权限 |
| 业务和数据 | 统一活动服务与数据模型 | 邀请验证、积分、机会、结算、发奖审计均需实现 |
| 数据模型管理 | 若选Django，建议统一由其模型和迁移管理 | 不直接拼接原项目SQLAlchemy层和另一套重复模型 |
| 用户页面 | 首期以机器人文字、图片和按钮为主 | 排行榜Mini App可后置；个人数据仍需权限校验 |
| 发奖 | 首期人工发放，系统记录状态与凭据 | 不开发自动转账，不能把记录为已发放等同于已验证到账 |
Django Admin适合内部模型管理；发布、名单冻结与开奖等有步骤约束的操作需专门实现，不能让运营通过随意修改数据库字段完成。若现有App已有成熟账号、权限、内容和后台，应先评估复用现有能力，再决定是否新增Django。这一检查尚未进行。
建议实施顺序
| 阶段 | 范围 | 阶段验收 |
|---|---|---|
| 0 选型及规则收敛 | 确认关键D项，检查现有App，核对授权、依赖与版本，在隔离环境试运行 | 明确采用来源、技术栈、规则版本与待办，不用真实奖池验证 |
| 1 拉新闭环 | 用户入口、邀请归属、入群验证、24小时认定、后台查询 | 按A01—A03验证不提前计奖、不重复归属及缺失事件处理 |
| 2 活跃闭环 | 内容发布、签到、答题、投票、积分、个人进度 | 按A07—A10、A12验证时间、双语、防重复计分 |
| 3 奖励闭环 | 邀请机会、周度资格、预算、冻结名单、开奖、人工发奖记录 | 按A04—A06、A11、A13—A15验证记账、预算、权限和失败处理 |
授权、权限、数据备份和异常处理贯穿各阶段。只有最终规则明确、运行验证通过后，才能估算正式上线时间；当前不提供未经验证的复用百分比或固定开发工期。
代码与官方依据
11 给后续AI的实现交接
当前实际交付状态
当前项目是需求整理阶段。已有原始Word、讨论记录与简版PRD、离线需求网页及其生成脚本build_prd.py；没有可运行的Telegram业务机器人、真实后台、业务数据库或支付集成。网页的章节切换、模块选择与流程浏览已检查，但该检查不验证PRD中的业务功能。
Markdown是本需求网页的内容源。修改PRD后使用build_prd.py重新生成同名HTML，并检查新增章节没有遗漏。旧版2026-09-10网页备份用于追溯，不应作为最新需求。v0.2增加业务流程与待定项；v0.3增加开源源码评估、复用清单与本交接说明；v0.4落档2026-09-11五轮需求决策。
阅读与判断顺序
- 先读第01节C01—C05，确认用户目标：拉新必须保留、签到答题与内容分发为首期重点、每周60U、长期原创内容与用户中心、中文英文范围。
- 再读第07节D01—D21：其中19项已于2026-09-11经用户确认（见表内标注）；D15时区待社群构成、D17技术形态经用户明确暂缓讨论。第10节Django方案等建议仍未批准。
- 结合第04节流程、第05节字段、第06节数据对象和第08节验收分析实现；遇到冲突应注明来源并收敛，不自行把建议升级为确认。
- 阅读第10节开源评估。优先复用框架及合适的MIT代码，重新核实O01—O06，锁定commit及依赖版本；不要凭README宣称直接上线。
- 用户此前只要求讨论和记录；后续实施应以新一轮具体开发授权为准，不擅自发群消息、创建真实活动、收集领奖资料或转账。
下一轮应产出的实施材料
- 已确认规则与本轮假设表：列出涉及的D编号、当前选择、确认状态与影响，优先处理预算、邀请、新人、时区及机会消费规则。
- 系统结构及复用清单：区分现有App可复用能力、开源框架、引用源码及自研业务；列出许可证和锁定版本。
- 数据模型与状态转换：至少包含用户、期次、成员事件、邀请关系、任务、积分流水、机会、冻结名单、发奖记录与审计。
- 接口及后台操作定义：包含权限、时间校验、防重复提交和失败重试，避免机器人与后台分别计算两套结果。
- 分阶段开发任务和可执行验收：将A01—A16转换为最终规则下的测试，明确未部署与已验证的区别。
可直接交给其他AI的任务说明
请阅读本文件全部章节，基于用户已确认目标继续讨论并规划Telegram社群增长产品的实现。重点保留拉新、签到答题、内容分发和每周60U奖励约束。先区分确认项、原文规则与助手建议；第07节19项已于2026-09-11确认、D15与D17挂起，不能将挂起项默认为已确认。参考第10节开源复用评估，但它只经过部分静态源码检查，需重新核验授权、版本、部署可行性及关键逻辑。先检查现有App是否有可复用后台，再给出架构、数据模型、接口、分阶段任务及验收方案。当前HTML是PRD阅读工具，不是已实现的业务系统；不要误把它作为功能完成依据。