需求矩阵
梦名扬平台 · 全量历史需求矩阵
覆盖 8 大模块 58 项需求；当前 51 项已完成（88%）。本页仅反映真实实现与验证状态，不夸大；外部凭据类仅做适配，未真实开通。
1. 高级品牌官网真实 Logo/素材、沉浸式轮播、全站文案版面与移动端
| 需求项 | 实现情况 | 状态 | 验证 |
|---|
| 真实 Logo / 品牌素材 | 资料库 Logo 经白名单 /api/assets 全站展示；资质/联系渠道素材受控 | 已完成 | T2/T3 走查 |
| 北上广深 + 目的地沉浸式轮播 | 首页 10 图全宽轮播（北京/上海/广州/深圳 + 云南/泰国/四川/日本/西安/重庆），自动+手动切换、移动端适配、每图关联真实路线或目的地入口 | 已完成 | T3 16/16 |
| 全站中文文案 / 版面 / 交互 | eyebrow 中文化、空态/错误态齐全、导航与页脚完整（真实见证/全球连接/合伙人） | 已完成 | walk-sitewide 57/57 |
| 移动端 | 三档断点（1120/1024/860/560）+ 汉堡导航 + 响应式表格 | 已完成 | T2/T3 移动端 |
| 杜绝占位/单一蓝底 | 首屏已替换为真实图片轮播；无英文占位残留 | 已完成 | T2 首页断言 |
2. 审核路线 / 详情 / 完整行程 PDF资料审核 → 展示 → 完整行程 PDF → 后台状态 → AI 跳转
| 需求项 | 实现情况 | 状态 | 验证 |
|---|
| 路线资料审核（去重可审核索引） | SHA-256 去重、素材台账逐条审核、驳回联动前台回退占位、重新导入保留审核结果 | 已完成 | 资料审核页 |
| 商城地区/分类/关键词筛选 | 地区+分类互斥 + 关键词搜索 + 目的地入口 | 已完成 | T2 搜索断言 |
| 路线详情 + 行程图册 | 亮点/参考日程/包含不含/购物自费/来源 SHA-256 + 多图册 | 已完成 | T2 详情页 |
| 完整行程 PDF 查看/下载 | 31/31 已生成（data/pdf + manifest），白名单路由 /api/itinerary-pdf 防穿越，详情页查看/下载，缺失时明确提示 | 已完成 | T4 13/13（31 条逐条抽查） |
| 后台 PDF 状态与来源 | 产品管理「行程 PDF」列（已生成/大小/来源/查看下载）+ 资料审核页生成状态汇总 | 已完成 | T4 后台断言 |
| AI 推荐跳转完整行程 | AI 回答带 /products/<id> 与 /preview 链接，前台渲染为可点击 | 已完成 | T3/T4 AI 链接 |
3. AI 专属旅游顾问需求收集 → 建议 → 敏感/实时事项转人工工单 → 前台/后台闭环
| 需求项 | 实现情况 | 状态 | 验证 |
|---|
| 需求收集（跨轮次） | 目的地/日期/人数/预算/偏好/特殊需求累计采集，进度徽章 | 已完成 | ai-qa 19/19 |
| 路线初筛与方案比较 | 多候选并列 + 会员专属价条件（按已审核规则） | 已完成 | ai-qa + 手动 |
| 高风险 100% 转人工 | 价格/库存/支付/合同/退款/签证/特殊人群/收益/旧话术 → 自动建工单 | 已完成 | ai-qa 19/19 + verify4 |
| 工单跟进与时间线 | 报价全生命周期写时间线，客户「我的订单」可见报价状态与金额 | 已完成 | T1 时间线断言 |
| 会员上下文适配 | 识别会员等级/激活态，按已审核规则说明权益（不承诺未定稿） | 已完成 | 会话上下文实测 |
4. 会员 / 手机号 / 实名 / 权益国际手机号主登录 + 密码邮箱兜底 + 唯一编号 + 实名审核 + 多档权益
| 需求项 | 实现情况 | 状态 | 验证 |
|---|
| 对外认证路径（邮箱 + 密码） | 公开注册/登录仅邮箱+密码；历史手机号账号保留数据并可由人工协助绑定邮箱；短信未启用 | 已完成 | verify4 V1-V3 |
| 密码/邮箱备用登录 | 邮箱或手机号+密码，10 分钟 5 次失败锁定 | 已完成 | 追加实测 |
| 购买 → 唯一会员编号 | 游客/登录购买、模拟支付验签幂等、激活生成唯一 MMY 编号 | 已完成 | verify3/verify4 |
| 实名审核/驳回补件 | 加密存储、驳回原因必填、重新提交次数留痕、游客归属校验 | 已完成 | verify3/verify4 |
| 多档权益/订单/有效期 | 逐档展示与实名、权益台账幂等发放、有效期与剩余天数 | 已完成 | verify4 + 多档实测 |
| 换绑/隐私同意/账号安全 | 换绑双验证码+旧号解绑+会话失效；登录建档隐私同意；密码锁定 | 已完成 | verify4 V6 + 追加实测 |
| 后台会员管理 | 搜索/筛选/档案详情/权益台账/审计 | 已完成 | walk-sitewide |
5. 通知 / 收据 / 适配注册/实名/订单/咨询通知与邮件收据，后台追踪；无凭据仅本地模拟
| 需求项 | 实现情况 | 状态 | 验证 |
|---|
| 通知模板与可审计落库 | welcome/phone_bound/会员费收据/团费收据/退款通知/实名/转人工 全落库 | 已完成 | 通知记录页 |
| 邮件失败状态与重发 | PROVIDER_ERROR 落库可筛选 + 后台重发 + 失败注入 | 已完成 | 实测重发 |
| 短信发送/核验失败留痕 | send_failed/verify_failed 全量记录，后台可查 | 已完成 | 手机验证记录页 |
| 本地模拟不假称真实 | 无凭据强制 mock，页面/收件箱明确标注「未真实外发」 | 已完成 | 页面标注 |
| 收据视图（会员端） | 「我的订单」可展开收据卡（订单号/金额/收款主体/退款/人工入口） | 已完成 | T2 |
6. 合伙人体系统一身份登录、角色分流、独立申请/审核、独立工作台、严格隔离；严禁佣金/多层分销
| 需求项 | 实现情况 | 状态 | 验证 |
|---|
| 统一身份登录 + 角色分流 | 同一账号体系；合伙人角色不进入官方后台（已从 ADMIN_ROLES 移除），前台 header 显示「工作台」 | 已完成 | T5 权限断言 |
| 独立申请（资料/渠道/区域/协议） | /partner 申请页：姓名/机构/擅长渠道/服务区域/行业资源/合规协议同意 | 已完成 | T5 |
| 后台审核（通过/驳回/禁用） | /admin/partners 审核队列，备注留痕+审计；通过即启用工作台权限 | 已完成 | T5 |
| 独立工作台（严格隔离） | /partner/dashboard：仅本人档案、授权路线素材（无成本/供应商/内部备注）、客户交接工单、官方公告；不展示其它伙伴/客户隐私/官方后台 | 已完成 | T5 |
| 公告管理 | 超管发布公告，合伙人工作台可见 | 已完成 | T5 |
| 严禁佣金/推荐奖励/多层分销 | 全流程无佣金/返利/多级字段；申请页与工作台明确合规声明 | 已完成 | 代码审查 |
7. 官方后台路线资料 PDF 审核、会员实名权益、订单咨询、合伙人审核权限、通知审计
| 需求项 | 实现情况 | 状态 | 验证 |
|---|
| 路线/资料/PDF 状态 | 路线管理（版本审核/发布校验+搜索筛选）、资料审核台账、行程 PDF 状态列 | 已完成 | T4/T6 |
| 会员实名权益 | 实名审核队列、驳回补件、权益台账（新增客户/类型筛选）、档案详情 | 已完成 | verify4/T6 |
| 订单/咨询 | 会员订单详情+回调+退款、旅行订单（新增搜索筛选+客户支付页）、人工工单+报价+转确认单 | 已完成 | T1/T6 |
| 合伙人审核权限 | /admin/partners 申请审核/禁用+公告；仅超管/会员运营 | 已完成 | T5 |
| 通知审计 | 通知记录（状态/重发）、手机验证记录、审计日志（筛选+全文搜索） | 已完成 | walk-sitewide/T6 |
| 搜索/筛选/空态/异常 | 各列表搜索筛选齐全：知识库/路线/旅行订单/权益台账/审计全文搜索；空态与错误提示完整 | 已完成 | T6 8/8 |
8. 外部凭据适配（不真实开通）短信/邮件/支付/域名/AI 密钥仅安全适配与配置模板
| 需求项 | 实现情况 | 状态 | 验证 |
|---|
| 短信/邮件适配层 | mock/aliyun/twilio/smtp/generic 骨架；无凭据强制本地模拟，绝不实发 | 已完成 | 健康检查/设置页 |
| 支付适配层 | 六渠道验签/归一化/幂等/对账；未配置商户时明确「通道待接入」 | 已完成 | payment-adapter 8/8 |
| AI 服务端密钥适配 | 仅服务端读 Key，未配置降级规则模式，探活不泄密 | 已完成 | ai-connectivity |
| 部署/域名/Secret 模板 | .env.example/Docker/健康检查/备份恢复；无真实凭据不发布 | 已完成 | 健康检查 |
| 未获授权不真实开通 | 全程未真实扣款/发送/注册/建密钥/发布域名 | 已完成 | 审计报告 |
9. 旅游 Token 权益闭环（单层推荐 / 退回公司申请 / 人工审核）单层推荐按后台已批准规则产生 Token；会员可退回公司主体提交奖励兑换申请；后台人工审核记录结算，本机不自动打款/提现/返佣；Token 不可转让
| 需求项 | 实现情况 | 状态 | 验证 |
|---|
| 单层推荐成功 → 按已批准规则产生 Token | 推荐归因已支付后可触发奖励发放；规则表 token_reward_rules 已建（仅「已启用」规则发放，未定稿/草稿绝不虚构赠送额度） | 半成品 | Token 规则任务 |
| Token 账户 / 余额 / 流水（含来源） | 激活会员自动开通账户（0 余额不虚构）；balance/frozen/total_earned/total_spent + ledger 流水（account_open/transfer_in/out/demo_grant/reward/redeem） | 已完成 | T44/T49 浏览器 |
| 退回公司主体（奖励兑换申请） | token_redeem_requests 已建：会员提交申请冻结 Token；后台人工审核通过记录结算状态与奖励金额（settle_amount_cents 仅记录，本机不自动打款/提现） | 半成品 | Token 规则任务 |
| 后台审核：通过/驳回/结算状态/审计 | 审核通过写销毁/冻结流水 + 结算记录 + 审计；驳回解冻 | 半成品 | Token 规则任务 |
| Token 不可转让边界 | 不提供会员间流转入口；历史转赠开关已停用，任何转赠请求均受控拒绝并保留接口边界。 | 已完成 | Token 规则任务 |
| 合规边界 | 不提现、不兑法币、不返佣、无多级分销、不涉链上转账；演示发放强制带「受控演示」标记 | 已完成 | 代码审查 |
10. 长期商城架构（多卖家 · 已登记，暂不大规模实现）未来允许经公司审核的合伙人和会员上架各国商品；当前仅登记需求与缺口清单，不做大规模实现；真实支付/跨境结算/商家 KYC/税务物流/外部商品来源只列缺口，不假装完成
| 需求项 | 实现情况 | 状态 | 验证 |
|---|
| 商品发布者归属（合伙人 / 会员卖家） | 本地已记录发布者账号与卖家类型；已批准合伙人可提交，激活会员须经运营批准卖家资格，普通会员不可提交 | 已完成 | 本地权限测试 |
| 商品字段：国家地区 / 品类 / 库存 / 价格状态 / Token 兑换价 | 国家或地区、品类、库存与价格状态、Token 兑换价、图片与详情 | 缺口 | 待实施 |
| 上架申请 → 平台审核 → 发布/下架 | 本地已实现：卖家提交草稿，运营审核卖家资格与路线版本；仅发布且版本审核通过后公开，下架与审核均留审计 | 已完成 | seller-policy 测试 + 本地生产访问 |
| 订单与履约状态 | 商城订单与履约状态跟踪 | 缺口 | 待实施 |
| Token 用于商城兑换与公司回收 | Token 仅用于商城商品兑换与公司回收申请，不作为现金或多级返佣 | 缺口 | 待实施 |
| 外部缺口清单（不假装完成） | 真实支付、跨境结算、商家 KYC、税务/物流、外部商品来源 —— 仅登记为缺口，未实现 | 缺口 | 缺口清单 |
| 卖家申请与审核入口 | 会员中心、合伙人工作台、卖家工作台与运营审核队列均已接通；这是本地可验证功能，不代表支付、KYC 或线上商家结算已接入 | 已完成 | seller-policy 测试 + /seller 访问 |
