完成70%
This commit is contained in:
@@ -0,0 +1,221 @@
|
||||
# Apifox 逐页业务接口与页面展示核对台账
|
||||
|
||||
> 权威取证顺序：用户已打开的 Apifox 桌面端文档页 → 同一部署的脱敏只读响应（仅在获准时）→ 导出文档交叉核验。不得以导出文档缺项否定 Apifox 中已存在的 operation，也不得以 operation 存在推定页面已经完成。
|
||||
>
|
||||
> 记录规则：每一页必须同时给出业务动作、请求合同、响应字段、页面展示字段和完成状态。`已发布`是 Apifox 文档状态，不是客户端完成状态；`DECLARED_UNVERIFIED` 不得写成完成。
|
||||
|
||||
## F 家族内容
|
||||
|
||||
### F01 家族动态列表
|
||||
|
||||
| 核对项 | Apifox 桌面端实读 | 当前页面实情 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| 读取列表 | `GET /genealogy/app/genealogies/{genealogyId}/feeds`；鉴权 `Authorization`；路径 `genealogyId:int64` 必填；Header `clientid:string` 必填 | 页面已删除 `listFamilyFeedFixtures`，不再调用缺 DTO 的列表响应来填充动态卡片 | 读取 owner 存在但展示未接线，等待可消费条目 DTO |
|
||||
| 响应字段 | `200 ListResult` 仅实读到通用 `code`、`msg`、`data[]`，`data` 元素未声明动态 DTO 字段 | 页面不再展示 `id/tag/time/title/content/author` 等本地字段；只提示缺失的字段合同 | 不能建立真实字段映射；不得猜测字段名 |
|
||||
| 页面状态 | 进入发布页与跨模块入口均保留 | 有效家谱下明确显示“动态列表待后端字段合同” | **未完成 / DECLARED_UNVERIFIED**：待 Apifox 补充动态条目 DTO，或在获准的登录只读窗口取得脱敏真实响应后再恢复列表与详情入口 |
|
||||
|
||||
### F02 发布家族动态
|
||||
|
||||
| 核对项 | Apifox 桌面端实读 | 当前页面实情 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| 发布动作 | `POST /genealogy/app/genealogies/{genealogyId}/feeds`；鉴权 `Authorization`；路径 `genealogyId:int64`、Header `clientid:string` 均必填 | `appApi.createFeed` 使用严格请求和离页取消；页面不再生成本地预览 | 已接线，等待真实写入响应核验 |
|
||||
| 请求体 | `application/json`：`feedContent:string` 必填且不能为空；`feedType:string` 可选，未传默认 `text`；`mediaOssIds:string` 可选，多个 OSS ID 用英文逗号分隔；`sortOrder:int64` 可选，未传默认 `0`；`status:string` 可选，未传默认正常状态 `0` | 表单只采集并发送 `feedContent`；可选的媒体、排序、状态没有可用输入/owner，故不发送 | 页面只消费可明确映射的文本动态请求子集 |
|
||||
| 响应字段 | `200 ObjectResult` 只声明通用 `code`、`msg`、`data:object`，未声明新动态 DTO | 仅在严格成功信封后显示“已提交服务端”；不会在 F01 生成本地列表项 | **未完成 / DECLARED_UNVERIFIED**：接线不等于已验证；真实写入保留人工可观察窗口 |
|
||||
|
||||
### F03 动态详情与评论
|
||||
|
||||
| 核对项 | Apifox 桌面端实读 | 当前页面实情 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| 动态详情 | `GET /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}`；鉴权 `Authorization`；`genealogyId:int64`、`feedId:int64`、`clientid:string` 必填 | 页面已删除 `findFamilyFeedFixture`；因详情响应仍未声明动态本体 DTO，不读取并展示猜测字段 | 正文展示仍未接线，等待可消费响应字段 |
|
||||
| 详情响应 | `200 ObjectResult` 只有通用 `code`、`msg`、`data:object`，没有动态本体 DTO | 页面不展示 `tag/time/title/content/author` 等正文 fixture 字段，只显示字段合同缺口 | 动态本体字段仍不能映射，不能猜测 |
|
||||
| 一级评论读取 | `GET /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/comments`；同样要求鉴权、两个路径 ID 和 `clientid`。接口说明：仅返回正常展示的一级评论，`replyCount` 为直属回复数 | `appApi.getFeedComments` 真实读取；无远端配置或响应不合同时显示错误，不回退 fixture | 已接线，等待真实响应核验 |
|
||||
| 评论响应字段 | `data: FamilyFeedCommentView[]`：`commentId`、`genealogyId`、`feedId`、`parentCommentId`、`appUserId`、`appUserNickName`、`appUserAvatar`、`parentAppUserId`、`parentAppUserNickName`、`commentContent`、`userDeleted`、`replyCount`、`commentLevel`、`status`、`createTime` | 展示 `id ← commentId`、`author ← appUserNickName`、`time ← createTime`、`content ← commentContent`、`replyCount ← replyCount`；归属 ID 与重复 ID 在 API 边界校验 | 已接线，等待真实响应字段核验 |
|
||||
| 发表评论 | `POST /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/comments`；请求体 `parentCommentId:int64|null` 可选（不传或 `null` 为一级评论）、`commentContent:string` 必填，最大 1000 字符 | 提交 `commentContent`，限制 1000 字；仅在服务端请求成功并刷新评论列表后提示提交成功 | **未完成 / DECLARED_UNVERIFIED**：接口调用已接线，但未在无人值守时发起写入，也没有真实成功响应证据；动态本体仍缺 DTO |
|
||||
|
||||
### F04—F06 谱文列表、详情与编辑
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读 | 当前页面展示或输入 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| F04 列表 | `GET /genealogy/app/genealogies/{genealogyId}/articles`；鉴权、`genealogyId:int64`、`clientid:string` 必填；`200 ListResult` 仅通用 `code/msg/data[]`，条目未声明 DTO | 已删除 fixture、分类和本地搜索；页面明确提示缺失文章 ID、分类、标题、摘要、作者和更新时间投影 | **未完成 / DECLARED_UNVERIFIED**：没有可审计的条目字段映射，不能接线或把本地筛选误称服务端能力 |
|
||||
| F05 详情 | `GET /genealogy/app/genealogies/{genealogyId}/articles/{articleId}`；鉴权、`genealogyId:int64`、`articleId:int64`、`clientid:string` 必填；`200 ObjectResult` 仅通用对象 DTO | 已删除 fixture 正文与编辑跳转；只显示正文 DTO 缺口 | **未完成 / DECLARED_UNVERIFIED**：正文、作者、时间投影均未由详情响应声明 |
|
||||
| F06 新建 | `POST /genealogy/app/genealogies/{genealogyId}/articles`；鉴权、`genealogyId:int64`、`clientid:string` 必填 | `appApi.createArticle` 严格提交 `articleTitle/articleContent`；成功仅表示服务端成功信封，不生成本地文章 | 已接线，等待真实写入响应核验 |
|
||||
| F06 修改 | `PUT /genealogy/app/genealogies/{genealogyId}/articles/{articleId}`；鉴权、两个路径 ID、`clientid:string` 必填 | 已移除 fixture 编辑预填；没有可靠详情 DTO 和文章 ID 列表来源时，编辑入口关闭 | **未完成 / DECLARED_UNVERIFIED** |
|
||||
| 新建/修改请求体 | `categoryId:int64` 可选；`articleTitle:string` 必填；`articleSummary:string` 可选；`coverOssId:int64` 可选；`articleContent:string` 必填；`authorName:string`、`sortOrder:int64`、`status:string` 均可选。返回均为通用 `ObjectResult` | 新建页只收集并发送 `articleTitle/articleContent`；`categoryId`、摘要、封面、作者、排序、状态没有来源，故不发送 | 已实现请求字段的安全子集；编辑仍需可靠 articleId/详情 owner，所有写入待人工真实响应核验 |
|
||||
|
||||
### F07—F09 相册、照片墙与上传
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读 | 当前页面展示或输入 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| F07 相册列表 | `GET /genealogy/app/genealogies/{genealogyId}/albums`；鉴权、`genealogyId:int64`、`clientid:string` 必填；`200 ListResult` 仅通用数组 DTO | 已删除 fixture 相册卡片和本地预览，页面明确提示缺失相册 ID、封面、名称、照片数、描述和更新时间字段 | **未完成 / DECLARED_UNVERIFIED**：相册条目、封面 URL、照片数和更新时间没有响应字段来源 |
|
||||
| F07 新建相册 | `POST /genealogy/app/genealogies/{genealogyId}/albums`；请求体 `albumName:string` 必填，`albumDesc:string`、`coverOssId:int64`、`sortOrder:int64`、`status:string` 可选；返回通用 `ObjectResult` | `appApi.createAlbum` 严格提交 `albumName`；成功仅表示服务端成功信封，不生成本地相册卡片 | 已接线，等待真实写入响应核验；描述、封面、排序、状态无输入来源，故不发送 |
|
||||
| F08 照片墙读取 | `GET /genealogy/app/genealogies/{genealogyId}/albums/{albumId}/photos`；鉴权、`genealogyId:int64`、`albumId:int64`、`clientid:string` 必填；`200 ListResult` 仅通用数组 DTO | 已删除 fixture 相册和照片墙，只显示缺失照片展示字段的状态 | **未完成 / DECLARED_UNVERIFIED**：缺相册与照片展示 DTO，不能猜 OSS URL、标题或说明字段 |
|
||||
| F09 写入照片记录 | `POST /genealogy/app/genealogies/{genealogyId}/albums/{albumId}/photos`；路径两个 ID、鉴权、`clientid` 必填；`ossId:int64` 必填，`photoTitle/photoDesc/photographer/shootTime/sortOrder/status` 可选 | 已删除 mock 图片库、说明表单和本地预览 | **未完成 / BLOCKED_BY_MEDIA_OWNER**：接口接受的是既有 `ossId`，当前页面没有已核实的文件上传 owner 和真实 OSS 回执，不能把本地图片冒充上传成功 |
|
||||
|
||||
### F10 短视频
|
||||
|
||||
| 核对项 | Apifox 桌面端实读 | 当前页面/结论 |
|
||||
| --- | --- | --- |
|
||||
| 目录检索 | 以 `video` 检索，APP 目录仅返回“删除视频”；未返回视频列表、详情、发布、修改、播放地址、评论、点赞或分享 operation | F10 所需浏览和互动链路没有业务 owner，不能以参考项目或相册接口补造 |
|
||||
| 唯一命中动作 | `DELETE /genealogy/app/genealogies/{genealogyId}/videos/{videoId}`；接口说明为逻辑删除并释放视频文件和封面文件引用；鉴权、`genealogyId:int64`、`videoId:int64`、`clientid:string` 必填，`200 VoidResult` | 单一删除动作不能证明视频页面能读取、播放或发布；**F10 未完成 / MISSING_OPERATION**。不发起删除请求 |
|
||||
|
||||
## G 家谱工作区
|
||||
|
||||
### G01、G03、G05—G11
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读 | 当前页面状态与结论 |
|
||||
| --- | --- | --- |
|
||||
| G01 我的家谱 | `GET /genealogy/app/genealogies/mine`；鉴权、`clientid:string` 必填；`200 ListResult` 仅通用 `code/msg/data[]` | 页面要展示当前家谱、可切换家谱、角色与快捷入口；当前 DTO 没有这些字段。**未完成 / DECLARED_UNVERIFIED** |
|
||||
| G03 创建家谱 | `POST /genealogy/app/genealogies`；`genealogyName`、`surname`、`regionCode` 必填；`ancestralHall/originPlace/addressDetail/coverOssId/intro/visibility/joinMode` 可选。`visibility`：`0` 私密、`1` 公开、`2` 成员可见；`joinMode`：`0` 关闭、`1` 审核、`2` 邀请码 | 已删除本地家谱/首位人物预览。创建后必须从真实响应取得 `genealogyId` 再创建首位人物；当前没有可恢复查询 owner，不能从泛型 mine 列表按名称猜 ID | **未完成 / MISSING_OPERATION**：两阶段创建结果恢复链未闭合，且封面 `coverOssId` 仍缺上传 owner |
|
||||
| G05 家谱概览 | `GET /genealogy/app/genealogies/{genealogyId}/overview`；鉴权、`genealogyId:int64`、`clientid` 必填；`200 ObjectResult` 通用对象 | 页面需要家谱资料、成员/人物等概览显示；响应无 DTO。**未完成 / DECLARED_UNVERIFIED** |
|
||||
| G06 搜索公开家谱 | `GET /genealogy/app/genealogies/public` 已在 Apifox 目录确认；读取结果仍为通用 `ListResult` | 已删除本地搜索结果和申请跳转；名称、籍贯、简介、可加入状态、稳定 genealogyId 均未获声明。**未完成 / DECLARED_UNVERIFIED** |
|
||||
| G08 申请加入 | `POST /genealogy/app/genealogies/{genealogyId}/join-applies`；路径 `genealogyId:int64`、鉴权、`clientid` 必填；body `applicantName/phone/relationDesc/applyReason:string`、`inviterUserId:int64` 均可选 | 已删除本地填写预览；没有公开家谱详情、可申请权限或稳定 ID 投影时，不凭“可选”字段虚构申请上下文。**未完成 / DECLARED_UNVERIFIED**，不发送申请 |
|
||||
| G09 我的申请 | `GET /genealogy/app/genealogies/join-applies/mine`；鉴权、`clientid` 必填；`200 ListResult` 通用数组 DTO | 已删除 fixture 申请列表；申请名称、状态、原因、时间等展示字段无映射。**未完成 / DECLARED_UNVERIFIED** |
|
||||
| G10 审核申请 | `PUT /genealogy/app/genealogies/{genealogyId}/join-applies/{applyId}/audit`；路径两个 ID、鉴权、`clientid` 必填；`status:string` 必填，`auditRemark:string` 可选，返回 `VoidResult` | 已删除本地审核流程；待审核列表 DTO 和稳定 applyId 未声明。**未完成 / DECLARED_UNVERIFIED**，不执行审核写入 |
|
||||
| G11 家谱设置 | `PUT /genealogy/app/genealogies/{genealogyId}`；同一组字段为 `genealogyName/surname/ancestralHall/originPlace/regionCode/addressDetail/coverOssId/intro/visibility/joinMode`，文档均列可选 | 已删除 fixture 预填和本地预览；概览 DTO 不能安全预填，封面仍受上传 owner 阻塞。**未完成 / DECLARED_UNVERIFIED** |
|
||||
|
||||
### G12 字辈谱
|
||||
|
||||
| 核对项 | Apifox 桌面端实读 | 当前页面实情 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| 正常字辈读取 | `GET /genealogy/app/genealogies/{genealogyId}/generation-poems`；鉴权 `Authorization`、路径 `genealogyId:int64`、Header `clientid:string` 均必填。说明为仅返回正常状态字辈，供世系人物录入和展示使用 | 页面通过 `appApi.getGenerationPoems` 真实读取，展示 `generationNo/generationText/status`；响应归属、重复 poemId 和重复世代在 API 边界校验 | 已接线，等待真实响应核验；响应没有“当前世代”字段，页面已删除固定当前世代推断 |
|
||||
| 维护列表读取 | `GET /genealogy/app/genealogies/{genealogyId}/generation-poems/management`；同一鉴权、路径和 `clientid` 要求。说明为家谱内容编辑者访问，返回正常与停用字辈，供恢复、纠错和排序调整 | 点击维护先真实请求 `appApi.getGenerationPoemManagement`，成功才进入编辑；不再用 fixture 或角色推断权限 | 已接线，等待真实响应/权限核验；维护读取失败不伪造“无权限”或本地编辑状态 |
|
||||
| 单条新增/修改/停用恢复 | `POST /genealogy/app/genealogies/{genealogyId}/generation-poems`；`PUT /genealogy/app/genealogies/{genealogyId}/generation-poems/{poemId}`。后者路径另有 `poemId:int64` 必填；两者 body 均为：`generationNo:int64` 必填、`generationText:string` 必填且最大 50 字、`description:string` 可选且最大 500 字、`sortOrder:int64` 可选、`status:string` 可选（`0` 正常、`1` 停用） | 当前编辑器以一段本地文本拆分生成字辈行；没有单条 request mapper 或服务端返回处理 | 单条合同已明确，当前页面交互是批量维护模型；不能把本地状态切换写成停用/恢复成功，**未完成 / DECLARED_UNVERIFIED** |
|
||||
| 批量预览 | `POST /genealogy/app/genealogies/{genealogyId}/generation-poems/batch/preview`；body `poemText:string` 必填、最大 26000 字，最多 500 世，可用空格、逗号、分号、顿号、斜杠或换行分隔；`disableMissing:boolean` 可选 | `appApi.previewGenerationPoemBatch` 只提交 `poemText/disableMissing`；页面展示服务端 `createCount/updateCount/keepCount/disableCount`，草稿或策略变化即使旧预览失效 | 响应 `GenerationPoemBatchPreviewView` 的计数字段和家谱归属已校验，等待真实响应核验；不再使用本地差异作为保存依据 |
|
||||
| 批量保存 | `POST /genealogy/app/genealogies/{genealogyId}/generation-poems/batch/save`；请求体与批量预览相同；接口说明为按当前数据生成差异，停用不删除历史字辈记录；返回 `VoidResult` | 保存仅在当前草稿已有同签名服务端预览时调用，严格成功后读取维护列表；本地不再更新或宣称保存成功 | **未完成 / DECLARED_UNVERIFIED**：写入已接线，但无人值守未触发真实保存；需人工可观察结果和真实回读才能升级状态 |
|
||||
|
||||
## T 世系树与成员
|
||||
|
||||
### T01 世系树与人物操作面板
|
||||
|
||||
| 核对项 | Apifox 桌面端实读 | 当前页面实情 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| 世系树读取 | `GET /genealogy/app/genealogies/{genealogyId}/lineage/tree`；鉴权 `Authorization`、路径 `genealogyId:int64`、Header `clientid:string` 均必填；`200 LineagePersonTreeResult` | `pages/tree/t01-tree-overview.vue` 已调用 `appApi.getTree`，但尚未作真实响应验证 | 不是“无接口”，但不能因代码存在而宣称页面已完成 |
|
||||
| 树节点响应字段 | `data: LineagePersonTreeView[]`：`personId/genealogyId/genealogyName/genealogyNo/appUserId/appUserNickName/personNo/name/aliasName/sex/generation/generationName/fatherId/fatherName/motherId/motherName/spouseNames/avatarOssId/birthDate/birthLunar/birthPlace/deathDate/deathLunar/deathPlace/burialPlace/personStatus/biography/sortOrder/status/remark/relationType/relationName/spouses[]/children[]`；`spouses` 为配偶节点、`children` 为递归子女节点 | 当前 mapper 只投影树布局所需 `id/parentId/name/relation/generation/branch/years/sex/personStatus`；人物卡和操作面板头像固定使用本地占位图，未消费 `avatarOssId`；父母、配偶、子女等可用响应关系也未完整展示 | **未完成 / DECLARED_UNVERIFIED**：必须补头像文件取址与字段投影，并在真实只读响应下核验树形关系，才能满足人物卡要求 |
|
||||
| 点击人物后的动作 | 页面已有“查看资料、添加父亲/母亲/配偶/兄弟姐妹/儿子/女儿、调整排行、编辑信息”动作入口，分别路由 T03/T04/T06/T05 | 父母、子女的 HTTP 动作实际分别共享 `/parents`、`/children`，页面未发送 `sex` 或 `relationName`，因此不能区分“父亲/母亲”“儿子/女儿”；邀请绑定在页面中明确标作不可用 | **未完成**：操作面板存在不等于每个业务动作闭环；性别语义和邀请绑定仍缺合同闭环 |
|
||||
| 邀请绑定 | 在 Apifox APP 目录分别以 `invite`、`bind` 全文检索，均未命中任何邀请签发、受邀人查询、人物绑定、绑定结果查询 operation | 页面也未伪造该流程 | **MISSING_OPERATION**：不以入谱申请或普通人物修改替代“邀请绑定” |
|
||||
|
||||
### T03 成员资料
|
||||
|
||||
| 核对项 | Apifox 桌面端实读 | 当前页面实情 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| 读取详情 | `GET /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}`；鉴权、`genealogyId:int64`、`personId:int64`、`clientid` 均必填；`200 LineagePersonResult` | 页面调用 `appApi.getPerson` | 读取路径存在，但不是完成依据 |
|
||||
| 详情响应字段 | `data: LineagePersonView`：`personId/genealogyId/genealogyName/genealogyNo/appUserId/appUserNickName/personNo/name/aliasName/sex/generation/generationName/fatherId/fatherName/motherId/motherName/spouseNames/avatarOssId/birthDate/birthLunar/birthPlace/deathDate/deathLunar/deathPlace/burialPlace/personStatus/biography/sortOrder/status/remark` | 已把别名、性别字典值、人物状态字典值、出生/逝世农历、出生/逝世地点、安葬地、配偶名、生平和备注纳入 T03 mapper 与展示；仍未展示头像（缺 `avatarOssId` 取址）、`appUserNickName`、排序/状态原值，亲属仍只可由父母 ID 跳转。 | **未完成 / DECLARED_UNVERIFIED**：T03 仍是半成品，不能计入完成；字段已接线但未用真实只读响应核验，头像、完整亲属投影和字典语义仍未闭环。 |
|
||||
|
||||
### T04 添加亲属、T05 编辑、T06 排行
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读 | 当前页面实情与结论 |
|
||||
| --- | --- | --- |
|
||||
| T04 首位成员/新增人物 | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons`；鉴权、路径 `genealogyId`、`clientid` 必填；body 只有 `name:string` 必填。可选字段为 `appUserId/personNo/aliasName/sex/generation/generationName/fatherId/motherId/avatarOssId/birthDate/birthLunar/birthPlace/deathDate/deathLunar/deathPlace/burialPlace/personStatus/biography/sortOrder/remark/relationName`；其中 `personNo` 由服务端生成，`avatarOssId` 须来自文件上传组件 | 页面只提交 `name/birthDate/biography`。请求字段是合法子集，但没有性别、世代、父母、头像、状态、排行等来源；真实写入未验证。**未完成 / DECLARED_UNVERIFIED** |
|
||||
| T04 添加父母、子女、兄弟姐妹、配偶 | 分别为 `POST .../lineage/persons/{personId}/parents`、`.../children`、`.../siblings`、`.../spouses`；路径 `genealogyId/personId`、鉴权、`clientid` 均必填，均返回 `LineagePersonResult`，body 与新增人物同合同。实读 `sex:string` 仅写“建议使用系统字典值”，示例为 `"0"`；以“字典/dict/性别”检索 APP/PC 目录均未找到该字典读取 owner 或男/女码值映射。 | 页面现会提交所选亲属的 `relationName`，不再把路由意图丢掉；父亲/母亲共用 `/parents`，儿子/女儿共用 `/children` 仍不能仅凭该显示名获得可靠性别语义。头像仍缺文件上传回执。**未完成 / DECLARED_UNVERIFIED**，不得拿参考项目的旧 `0/1` 码值猜填，也不能执行无人值守写入。 |
|
||||
| T05 修改人物 | `PUT /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}`；两个路径 ID、鉴权、`clientid` 必填，body 与新增人物同合同，返回 `LineagePersonResult` | 已读写 `name/aliasName/generationName/birthDate/birthLunar/birthPlace/deathDate/deathLunar/deathPlace/burialPlace/biography/remark`；静态校验确认表单字段与请求白名单一致。头像仍缺上传回执；性别、人物状态、排行因字典或原子 owner 缺失未写入。 | **未完成 / DECLARED_UNVERIFIED**：已扩展为已声明的安全字段子集，但没有真实保存后的响应/回读，不能称完整人物编辑。 |
|
||||
| T06 调整排行 | Apifox 只有单人物 `PUT .../persons/{personId}` 中的可选 `sortOrder:int64`，没有同辈排行列表、批量重排、原子提交或冲突回显 operation | 页面已明确显示“服务暂未开放”，不逐人写入 | **未完成 / MISSING_OPERATION**：不能以单人 `sortOrder` 伪造同辈原子排行调整 |
|
||||
|
||||
### T07 成员目录、T08 成员状态
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读 | 当前页面实情与结论 |
|
||||
| --- | --- | --- |
|
||||
| T07 成员目录分页与搜索 | `GET /genealogy/app/genealogies/{genealogyId}/lineage/persons/page`；query 可选 `pageNum`（默认 1）、`pageSize`（默认 10）、`keyword`（姓名/别名/人物编号）、`generation:int64`、`personStatus:string`；响应 `LineagePersonPageResult` 为 `rows: LineagePersonView[]` 与 `total`。另有 `GET .../lineage/persons/options?keyword=` 供人物选项读取 | 已移除 `listTreeMemberPresentationFixtures`；页面使用实际 `pageNum/pageSize/keyword` 请求、消费 `rows/total`，支持服务端搜索与继续加载；本地预览明确报真实读取不可用，不伪造目录数据。 | **未完成 / DECLARED_UNVERIFIED**：读取合同已接线并经静态检查，尚未用登录态获得一次真实 `rows/total` 响应；世代/人物状态筛选尚未增加页面控件。 |
|
||||
| T08 成员状态说明 | 人物详情、列表和分页都提供 `personStatus`、`status`；停用人物为 `DELETE /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}`，接口说明为逻辑停用且在正常子女时拒绝停用，返回 `VoidResult` | 已移除 `findTreeMemberPresentationFixture` 和 `privacy/deceased/forbidden` 推断；页面读取人物详情并原样展示 `personStatus`，明确说明当前没有状态字典 owner，也不提供停用写入。 | **未完成 / DECLARED_UNVERIFIED**：读取已接线并经静态检查，仍未用真实只读响应核验；没有字典映射时不得生成隐私/受限/纪念文案。 |
|
||||
|
||||
## R 记录模块
|
||||
|
||||
### R01 人物录、R02 人物档案
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读 | 当前页面展示或输入 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| R01 人物录列表、搜索 | 正确读取 owner 是 `GET /genealogy/app/genealogies/{genealogyId}/lineage/persons/page`；query 为 `pageNum/pageSize/keyword/generation/personStatus`，响应为 `rows: LineagePersonView[]/total`。人物选项另有 `GET .../lineage/persons/options?keyword=` | 已移除 `listTreeMemberPresentationFixtures` 和本地“新增预览”；页面用 `pageNum/pageSize/keyword` 请求、消费 `rows/total`，支持服务端搜索和继续加载。新增人物保持从 T01 亲属关系入口进入。 | **未完成 / DECLARED_UNVERIFIED**：读取合同已接线并经静态检查，尚未用登录态获得一次真实响应；世代/人物状态筛选尚未增加页面控件。 |
|
||||
| R02 人物档案读取 | `GET /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}` 返回已在 T03 实读的 `LineagePersonView`，含 `name/generation/generationName/biography/remark`，以及头像、性别、别名、亲属名、地点、生卒、状态等 | 已移除 `findTreeMemberPresentationFixture`、本地预览/编辑；页面读取详情并展示已声明的资料字段，编辑入口改为跳转 T03 的成员档案，再由 T05 完成可写字段维护。成长日志仍跳 R08，人生事仍为待开放。 | **未完成 / DECLARED_UNVERIFIED**：读取已接线并经静态检查，尚未取得真实详情响应；头像取址、性别/状态字典和完整亲属投影仍未闭环。 |
|
||||
| R02 新建/编辑人物 | `POST /lineage/persons`、`PUT /lineage/persons/{personId}` 的完整人物请求合同已在 T04/T05 实读，`name` 必填，其余有世代、头像、亲属、状态、排序、传记、备注等字段 | 表单只收 `name/generationName/generation/biography/remark`，保存仅变成本地预览 | **未完成 / DECLARED_UNVERIFIED**：是可辨认的字段子集但没有远端读写闭环；不得把“生成本地预览”说成新建或修改成功 |
|
||||
|
||||
### R03 贺礼簿、R04 往来详情与编辑
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读 | 当前页面展示或输入 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| R03 列表、R04 详情 | `GET /genealogy/app/genealogies/{genealogyId}/relative-records`、`GET .../relative-records/{relativeId}`；均需鉴权、`genealogyId`、`clientid`，分别返回通用 `ListResult`、`ObjectResult`，未声明条目 DTO | 已删除 R03/R04 fixture 列表、详情和本地编辑预填；页面明确说明缺记录 ID、关系、事项、时间、金额和备注的响应映射 | **未完成 / DECLARED_UNVERIFIED**：接口并非缺失，但响应没有声明 `relativeId` 等展示字段，不能猜字段映射 |
|
||||
| R04 新增/修改 | `POST /genealogy/app/genealogies/{genealogyId}/relative-records`、`PUT .../relative-records/{relativeId}`；body 为 `relativeName:string` 必填，`relationName/eventName/eventTime/giftAmount:number/recordContent/mediaOssIds/sortOrder/status` 可选，返回通用 `ObjectResult` | 创建页通过 `appApi.createRelativeRecord` 提交 `relativeName/relationName/eventName/eventTime/giftAmount/recordContent`；媒体字段没有上传 owner，故不发送。详情/修改入口因无记录 DTO/ID 来源关闭 | 创建已接线，等待真实写入响应核验；修改仍 **DECLARED_UNVERIFIED** |
|
||||
| R04 删除 | `DELETE .../relative-records/{relativeId}` 已在 Apifox 同一资源目录确认 | 页面明确显示“删除暂未开放” | **未完成 / DECLARED_UNVERIFIED**：不执行删除；存在删除 operation 也不改变其他读写未接线的事实 |
|
||||
|
||||
### R05—R07 礼仪活动与献礼
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读 | 当前页面展示或输入 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| R05 礼仪活动列表、R07 新建 | 在 APP 目录以 `ceremony` 实读到该资源共六个动作：详情、修改、活动献礼列表、新增献礼、删除活动、删除献礼；没有活动列表或新建活动 operation | 已删除 `listCeremonyFixtures`、新建和编辑预览；R05/R07 显示缺 operation 状态并保留返回路径 | **未完成 / MISSING_OPERATION**：不得用详情或修改接口冒充活动列表/新建；R05、R07 的主业务 owner 缺失 |
|
||||
| R06 礼仪详情 | `GET /genealogy/app/genealogies/{genealogyId}/ceremonies/{ceremonyId}`；需鉴权、路径 `genealogyId/ceremonyId`、`clientid`，返回通用 `ObjectResult`；未声明活动 DTO | 已删除 fixture、受邀人拼装和编辑入口，只提示详情字段缺口 | **未完成 / DECLARED_UNVERIFIED**：详情 operation 存在，但这些展示字段、受邀人及其关系没有响应字段依据 |
|
||||
| R07 修改礼仪 | `PUT .../ceremonies/{ceremonyId}`；body `ceremonyType:string`、`ceremonyTitle:string` 必填，`ceremonyDesc/ceremonyTime/location/coverOssId/sortOrder/status` 可选，返回通用 `ObjectResult` | 无可靠详情 DTO 和活动 ID 来源时关闭修改，且封面另缺上传 owner | 表单字段虽可对应，但没有远端读取、写入和回读；**未完成 / DECLARED_UNVERIFIED** |
|
||||
| R06 献礼 | `GET .../ceremonies/{ceremonyId}/gifts` 返回通用 `ListResult`；`POST .../gifts` 的 body 为 `giverName:string` 可选、`giftAmount:number` 必填、`giftMessage:string` 可选，返回通用对象 | 页面有受邀人展示，不是献礼条目展示或写入 | **未完成 / DECLARED_UNVERIFIED**：献礼接口不能替代受邀信息，且没有条目 DTO 可映射 |
|
||||
|
||||
### R08 成长日志、R09 人生事
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读 | 当前页面展示或输入 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| R08 列表与详情 | `GET /genealogy/app/genealogies/{genealogyId}/growth-records`、`GET .../growth-records/{recordId}`；同一 APP 资源另有新增、修改、删除，共五个动作。列表为通用 `ListResult`、详情为通用 `ObjectResult`，均未声明记录 DTO | 已删除 `listGrowthRecordFixtures` 和本地列表预览；页面只保留创建表单 | **未完成 / DECLARED_UNVERIFIED**：`recordId`、标题、日期、内容没有响应字段声明，不能恢复列表或详情 |
|
||||
| R08 新增/修改 | `POST .../growth-records`、`PUT .../growth-records/{recordId}`；新增 body 已实读：`lineagePersonId/recordType/recordContent/recordDate/remindTime/mediaOssIds/sortOrder/status` 可选，`recordTitle:string` 必填 | `appApi.createGrowthRecord` 提交 `recordTitle/recordDate/recordContent`；人员绑定、类型、提醒、媒体、状态无来源，故不发送；修改没有记录 ID 来源而关闭 | 创建已接线，等待真实写入响应核验；修改 **DECLARED_UNVERIFIED** |
|
||||
| R09 人生事 | 分别以 `life` 与“人生”在 APP 接口目录检索，均未命中独立人生事件资源；当前文档中不能用成长、备忘或人物资料替代 | 页面已明确提示接口未开放且不展示/提交数据 | **未完成 / MISSING_OPERATION**：保持关闭是正确的，不虚构读写链路 |
|
||||
|
||||
### R10 家族备忘、R11 功德记录
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读 | 当前页面展示或输入 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| R10 备忘列表与详情 | `GET /genealogy/app/genealogies/{genealogyId}/memos`、`GET .../memos/{memoId}`；同一资源另有新增、修改、删除，共五个动作。列表 `ListResult`、详情 `ObjectResult` 都只声明通用包装字段 | 已删除 fixture 列表和本地预览，只保留创建表单 | **未完成 / DECLARED_UNVERIFIED**：不能从泛型响应推导 `memoId` 或 `completedLabel`，状态文案也没有字典依据 |
|
||||
| R10 新增/修改 | `POST .../memos`、`PUT .../memos/{memoId}`；body `memoTitle:string` 必填，`memoContent/remindTime/completed/mediaOssIds/sortOrder/status` 可选 | `appApi.createMemo` 提交 `memoTitle/remindTime/memoContent`；完成状态与媒体无可靠来源，故不发送；修改缺 ID 来源关闭 | 创建已接线，等待真实写入响应核验；修改 **DECLARED_UNVERIFIED** |
|
||||
| R11 功德列表 | `GET /genealogy/app/genealogies/{genealogyId}/merit-records`；同资源仅另有新增、删除，共三个动作；列表返回通用 `ListResult`，未声明条目 DTO | 已删除 fixture 列表和本地预览，只保留创建表单 | **未完成 / DECLARED_UNVERIFIED**：列表字段没有合同映射，页面不猜条目字段 |
|
||||
| R11 新增/修改 | `POST .../merit-records`；body `donorName:string`、`meritTitle:string` 必填，`meritType/meritContent/amount:number/meritTime/sortOrder/status` 可选；当前 APP 目录未见修改 operation | `appApi.createMeritRecord` 提交捐赠人、标题、类型、金额、时间和内容；排序/状态无来源，故不发送 | 新增已接线，等待真实写入响应核验；编辑 **MISSING_OPERATION** |
|
||||
|
||||
## N 消息通知
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读 | 当前页面展示或输入 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| N01 消息中心列表 | `GET /genealogy/app/notifications`；鉴权 `Authorization`、Header `clientid:string` 必填；`200 ListResult` 只声明通用 `code/msg/data[]`，条目仍为泛型对象 | 已删除 `listNotificationFixtures`、未读计数和本地业务跳转，只显示缺失通知字段合同 | **未完成 / DECLARED_UNVERIFIED**：没有消息 ID、已读、标题、时间、正文、目标类型和目标参数的响应字段合同；不能把 fixture 的跳转当作通知接口返回能力 |
|
||||
| N02 消息详情 | 在 APP 消息通知目录实读到的仅有列表、单条标已读、全部标已读三个 operation；没有详情读取 operation | 已删除详情 fixture，只显示缺详情 owner 状态 | **未完成 / MISSING_OPERATION**：不能以列表泛型或本地 fixture 冒充单条详情；详情所需正文、来源和跳转字段均无接口 owner |
|
||||
| N01/N02 单条标已读 | `POST /genealogy/app/notifications/{notificationId}/read`；鉴权、`notificationId:int64`、`clientid` 必填，返回 `VoidResult` | 无可消费通知 ID 时页面不显示单条标已读，已删除本地 `unread` 修改 | 正确写入 owner 存在但没有可回读 item/ID，**未完成 / DECLARED_UNVERIFIED** |
|
||||
| N01 全部标已读 | `POST /genealogy/app/notifications/read-all`；鉴权、`clientid` 必填，返回 `VoidResult` | 已删除“全部已读”本地 fixture 修改 | **未完成 / DECLARED_UNVERIFIED**：无列表回读时不把本地状态改动当服务端写入成功 |
|
||||
|
||||
## M 个人中心与账号
|
||||
|
||||
### M01 个人中心、M02 个人资料
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读 | 当前页面展示或输入 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| M01 当前用户资料 | `GET /genealogy/app/auth/profile`；鉴权、`clientid` 必填，返回通用 `ObjectResult`，`data` 未声明用户 DTO | 已删除 `currentUser.name/role/phone` 和 fixture 未读数展示，保留各模块入口 | **未完成 / DECLARED_UNVERIFIED**：用户名、角色、手机号及其脱敏规则没有响应字段合同；不可把 mock 当前用户当作已登录资料 |
|
||||
| M02 读取与修改资料 | 读取为同一 `GET /auth/profile`；修改为 `PUT /genealogy/app/auth/profile`。修改 body 已实读：`nickName/avatarOssId/sex/birthday/provinceCode/cityCode/districtCode/addressDetail` 均可选，返回通用 `ObjectResult` | 已删除 mock 预填和本地保存；当前 UI 的真实姓名/邮箱与更新合同不相交，页面明确关闭编辑 | `nickName` 可对应，但 `realName/email` 不在修改合同；后端的头像、性别、生日、地区、地址未有页面输入或 mapper。**未完成 / DECLARED_UNVERIFIED**；头像另受上传 owner 阻塞 |
|
||||
|
||||
### M03—M05 安全设置、改密、换绑手机
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读 | 当前页面展示或输入 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| M03 账号与安全概览 | 资料读取、改密、换绑均有各自 APP operation，未见独立“安全概览/设备/登录记录”读取 operation | 已删除本地账号摘要，保留改密与换绑入口 | **未完成 / DECLARED_UNVERIFIED**：入口可以保留，但安全状态、设备、会话等没有 owner，不能凭本地提示宣称已核验 |
|
||||
| M04 修改密码 | `PUT /genealogy/app/auth/password`；鉴权、`clientid` 必填；body `oldPassword:string`、`newPassword:string` 均必填且均为 32 位 MD5；返回 `VoidResult` | 页面将当前/新密码 MD5 后以 `oldPasswordHash/newPasswordHash` 传给 api 层，最终字段名映射为 `oldPassword/newPassword` | 请求字段、摘要格式和页面动作可对齐；但尚未在真实账号下接受响应验证，且不得无人值守改密。**未完成 / DECLARED_UNVERIFIED** |
|
||||
| M05 换绑手机号 | `PUT /genealogy/app/auth/phone`；鉴权、`clientid` 必填；body `clientId:string`、`phone:string`、`smsCode:string` 均必填，验证码模式为 4 位；响应为 `ObjectResult`（含 400/200） | 已删除 mock 当前手机号、输入和本地校验，页面明确提示需人工 TAC/短信与资料 DTO | 号码和四位码输入可对应，但缺实际滑动验证、短信发送、`clientId` 来源、写入与回读。**未完成 / DECLARED_UNVERIFIED**；不代用户发验证码或换绑 |
|
||||
|
||||
### M06 帮助、M07 反馈、M08 推广、M09 VIP、M10 关于
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读 | 当前页面展示或输入 | 结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| M06 帮助中心 | `GET /genealogy/app/help-articles`、`GET /genealogy/app/help-articles/{articleId}`；列表为通用 `ListResult`、详情为通用对象，未声明文章 DTO | 页面本地内置分类、问题、答案和搜索 | **未完成 / DECLARED_UNVERIFIED**：帮助读取 owner 存在，但不能从泛型响应推导问题、答案、分类或文章 ID；当前本地说明不是服务端帮助 |
|
||||
| M07 提交反馈 | `POST /genealogy/app/feedback`；鉴权、`clientid` 必填；body `feedbackType:string` 可选、`feedbackContent:string` 必填、`contactInfo:string` 可选，返回通用 `ObjectResult` | 表单与 api 层正好提交这三字段，页面包含成功、失败、结果不确定的提示 | 请求合同已对应；未经真实接受响应验证，不能把 UI 成功态视为后端成功。**未完成 / DECLARED_UNVERIFIED**，不代用户提交反馈 |
|
||||
| M08 应用推广/邀请 | `GET /genealogy/app/promotions` 已存在，但仅为“应用推广列表”，返回通用 `ListResult`；全文检索未发现邀请码签发、归因、奖励、受邀绑定或分享回执 operation | M08 正确保持“推广能力未开放”，没有伪造邀请 | **未完成 / MISSING_OPERATION**：普通推广内容列表不能替代邀请推广业务闭环 |
|
||||
| M09 VIP 与订单 | APP 目录有 `GET /genealogy/app/vip/packages`、`GET /genealogy/app/vip/orders`、`POST /genealogy/app/vip/orders`；前两者列表响应为泛型。创建订单 body 为 `packageId:int64` 必填，`genealogyId:int64`、`payType:string` 可选，返回通用对象 | 页面当前不读取、不会创建订单或扣费 | **未完成 / DECLARED_UNVERIFIED**：套餐与订单 owner 存在但 DTO 未声明、页面未接线；支付调起、支付结果、取消/退款等动作在当前 APP 目录未形成可审计合同，故继续禁用付费流程 |
|
||||
| M10 关于与退出 | 协议、版本为本地静态内容；退出为 `DELETE /genealogy/app/auth/logout`，鉴权、`clientid` 必填，返回 `VoidResult` | M10 调用 api 层退出并且无论远端结果如何都会清本机会话 | 登出路径与合同一致，但未在真实请求下验证；协议/版本没有远端 owner 的需求。退出动作仍标 **DECLARED_UNVERIFIED**，不在无人值守状态触发 |
|
||||
|
||||
## A 认证
|
||||
|
||||
| 页面/动作 | Apifox 桌面端实读：业务接口、请求/响应字段 | 当前页面展示或输入字段 | 完成状态 |
|
||||
| --- | --- | --- | --- |
|
||||
| A01 登录：验证前置与发送短信 | `GET /captcha/require`：查询 `tenantId/clientId/sceneCode/subject`，其中 `sceneCode` 必填；响应 `VerificationRequireResult` 已声明 `required/providerCode/captchaType/sceneCode/ttlSeconds`。`POST /genealogy/app/auth/sms/code`：Header `clientid` 必填；Body `clientId/grantType/tenantId/sceneCode/phone/validToken` 均必填，`sceneCode` 含 `APP_SMS_LOGIN`；响应 `VoidResult`。 | `a01-entry.vue` 以手机号、密码或四位短信码登录；取码先查验证要求，再由内嵌验证组件提交 `validToken`。滑动验证采用服务商组件本身，不增加页面自定义样式。 | **未完成 / DECLARED_UNVERIFIED**：前置响应字段与发送短信字段已逐项对上，但未发送短信；`required=false` 时如何签发可消费票据也未由 Apifox 合同说明，不能把页面本地倒计时当发送成功。 |
|
||||
| A01 账号密码登录 | `POST /genealogy/app/auth/login`：Header `clientid` 必填；Body `clientId/grantType/tenantId/phone/password` 均必填，`grantType=password`，`password` 为 32 位 MD5；响应组件为 `LoginResult`。 | 页面将手机号和 MD5 密码传至 API 层；当前 API 层读取响应 `access_token` 保存会话。登录接口请求体没有 `validToken` 字段，页面仅把滑动验证作为前端完成条件。 | **未完成 / DECLARED_UNVERIFIED**：请求字段对齐；Apifox 当前只标出 `LoginResult` 组件，未在该 operation 展开可核的会话字段，且尚未以测试账号获得一次被接受的响应，不能声明登录已完成。 |
|
||||
| A01 短信登录 | `POST /genealogy/app/auth/login/sms`：Header `clientid` 必填；Body `clientId/grantType/tenantId/phone/smsCode` 均必填，`grantType=sms`，`smsCode` 为四位短信码；响应组件为 `LoginResult`。 | 页面字段为手机号、四位验证码；API 层同样依赖返回的 `access_token` 建立会话。 | **未完成 / DECLARED_UNVERIFIED**：请求合同对齐，但该动作依赖真人收到短信；未发送、未登录，不把页面登录成功提示当成远端成功。 |
|
||||
| A04 注册 | 短信链路同上但 `sceneCode=APP_REGISTER`。`POST /genealogy/app/auth/register`：Header `clientid` 必填；Body 已实读 `clientId/grantType/tenantId/phone/password/smsCode`，`grantType=password`、密码为 32 位 MD5、验证码为四位；响应 `LoginResult`。 | 页面输入手机号、验证码、密码、确认密码和协议勾选；提交时传手机号、MD5 密码、验证码。 | **未完成 / DECLARED_UNVERIFIED**：字段链路可对照，但注册会创建真实账号，按约定不在无人值守时触发；`LoginResult` 的完整展示字段仍待接受响应核实。 |
|
||||
| A05 找回密码 | 短信链路同上但 `sceneCode=APP_FORGOT_PASSWORD`。`PUT /genealogy/app/auth/password/reset`：Header `clientid` 必填；Body `clientId/grantType/tenantId/phone/newPassword/smsCode` 均必填，`grantType=password`、`newPassword` 为 32 位 MD5、验证码为四位；响应 `VoidResult`。 | 页面输入手机号、验证码、新密码、确认密码；提交参数为手机号、MD5 新密码、验证码。 | **未完成 / DECLARED_UNVERIFIED**：请求字段对齐；找回会真实改密，未触发，不能以本地“修改成功”状态当接口完成。 |
|
||||
| A06 账号状态/恢复 | 在 APP 认证目录按 `status`、`frozen`、`disabled`、`risk`、`appeal`、`recovery` 检索，未找到账号状态读取、限制原因、申诉或恢复的独立 operation。 | 页面只读路由参数 `status`，并用本地 `frozen/disabled/risk` 文案展示限制原因和恢复说明；“查看恢复方式”仅打开本地弹层；该文件也未注册进 `pages.json` 的 52 条路由。 | **未完成 / MISSING_OPERATION**：没有后端 owner 提供状态、原因、可恢复路径或申诉结果，不能把静态文案当真实账号状态；未注册时也不能由正常路由到达。 |
|
||||
|
||||
## 本轮累计
|
||||
|
||||
| 范围 | 已逐页实读 | 可实施映射 | 未完成原因 |
|
||||
| --- | ---: | --- | --- |
|
||||
| F01—F10 | 10/10 | F02 发布、F03 评论读取/提交、F06 谱文创建、F07 相册创建已按声明字段接线；F01/F04/F05/F08/F09 已关闭无 DTO 或上传 owner 的 fixture 展示 | F02/F03/F06/F07 等待真实响应核验；动态、谱文和相册展示仍缺 DTO；F09 缺文件上传 owner，F10 缺读取/发布 owner；写入不得在无人值守时触发 |
|
||||
| G01、G03、G05—G12 | 9/9 | G12 正常列表、维护列表、批量预览/保存已按声明字段接线；G03/G06/G08—G11 已删除 fixture 或本地预览 | G12 待真实读取/写入响应核验，当前世代字段仍未声明；G03 两阶段结果恢复链、G06/G08—G11 的 DTO/ID/权限缺口仍未闭环 |
|
||||
| T01、T03—T08 | 7/7 | 树、详情、人物分页/选项、人物与亲属写入合同均已逐项实读；T03、T05、T07、T08 的已声明读取/字段子集已接线 | T03 明确为未完成；T01 头像与邀请绑定未闭环；T04 关系性别语义不完整；T06 缺原子排行 operation；T07/T08 均待真实读取响应核验 |
|
||||
| R01—R11 | 11/11 | R03/R04、R08、R10、R11 创建已按声明字段接线；R05—R07/R09 已删除本地流程 | 所有 R 列表/详情仍缺 DTO；创建待真实响应核验；R05/R07、R09 另有明确 `MISSING_OPERATION` |
|
||||
| N01—N02 | 2/2 | 消息列表、单条标已读、全部标已读 owner 已实读；页面已删除 fixture 消息和本地已读 | 列表条目 DTO 未声明、消息详情 operation 明确缺失，无稳定 ID 时不发送已读 mutation |
|
||||
| M01—M10 | 10/10 | M01—M03/M05 已删除 mock 资料和本地资料流程；改密、反馈、退出已有独立接线 | M02 字段与合同不一致；读取 DTO 多为泛型；M08 缺邀请业务 owner；VIP 还缺可审计支付闭环；敏感写入均未实测 |
|
||||
| A01、A04—A06 | 4/4 | 验证要求、短信发送、密码/短信登录、注册、找回密码的请求合同已逐项实读 | 无人值守不发送短信、不注册、不找回、不真实登录；`LoginResult` 仅见响应组件名，完整会话字段待接受响应；A06 明确缺状态/恢复 owner |
|
||||
@@ -0,0 +1,751 @@
|
||||
# 产品参考页面功能映射表
|
||||
|
||||
> 规划日期：2026-07-23（北京时间）
|
||||
> 状态：需求已收口，作为《今晚全量联调与明早测试执行计划》的权威附件，三人交叉评审与用户确认均已完成；用户已明确开始执行，`T_due=2026-07-24 08:00`，55 个候选 PA 本轮维持 `approvedCandidateActions=0`。
|
||||
> 冻结规则：用户确认本附件仍不代表开始实现；只有用户明确说“开始执行”后才允许修改业务代码、接口接线、样式和测试，或运行测试、构建与 MuMu。
|
||||
|
||||
## 一、范围、优先级与计数
|
||||
|
||||
本附件只做产品甄别，不复制参考代码。优先级固定为：
|
||||
|
||||
1. 用户对当前 `jiapuapp` 的明确需求；
|
||||
2. 当前真实后端合同、线上文档和可复现响应；
|
||||
3. 当前项目的路由、架构、安全、国风视觉和无障碍基线；
|
||||
4. `C:\Users\Rain\Desktop\job\app设计`；
|
||||
5. `C:\Users\Rain\Desktop\job\Jiapu-App`。
|
||||
|
||||
基线计数：
|
||||
|
||||
| 对象 | 分母 | 本附件覆盖 |
|
||||
| --- | ---: | ---: |
|
||||
| 当前 `jiapuapp` 活动路由 | 52 | 52，沿用 `docs/接口与页面映射总表.md` 的 A/G/T/F/R/N/M 稳定编号 |
|
||||
| 设计参考文件 | 60＝59 PNG＋1 单页 PDF | 60，`D001`—`D060` |
|
||||
| 完成项目活动路由 | 78 | 78，`J001`—`J078` |
|
||||
| 完成项目注释路由声明 | 1 | 1，`JX001` |
|
||||
| 完成项目未注册页面文件 | 7 | 7，`JU01`—`JU07` |
|
||||
| 完成项目媒体资产 | 531 | 531 个进入资产候选池；实际采用前另建逐文件 `RAxxx` |
|
||||
| 本轮规划确认前批准的新增当前路由 | 0 | 0；候选先复用现有 owner 或保持关闭/待确认 |
|
||||
|
||||
完成项目 `pages.json` 共有 79 个 `path` 文本，其中 `pages/index/vertical-swiper/vertical-swiper` 整段被注释，因此活动路由分母是 78，不是 79；`pages/render/render` 已计入 78。
|
||||
|
||||
## 二、稳定 ID 与逐动作规则
|
||||
|
||||
- 设计证据的完整格式是 `Dxxx-Pxx-Sxx-Axx`：文件、页面/PDF 页、页面状态、来源证据基记录。当前每张单页 PNG 都作为独立 `S01` 状态证据，表内 `Dxxx-P01-Axx` 是省略 `S01` 的短写，不表示不同文件可以合并。
|
||||
- 完成项目的完整格式是 `Jxxx-Sxx-Axx`。同一路由上的正常、空、管理、编辑、权限等状态先区分，再对查看、创建、删除、邀请、支付等来源证据基记录编号；表内省略默认 `S01`。注释路由用 `JX001`，未注册文件用 `JUxx`。
|
||||
- 通常一个 `Axx` 对应一个独立动作。若旧截图或旧代码分支把多个控件不可分地记在同一物理证据中，基记录后必须追加稳定语义后缀，例如 `J073-A02@comment`、`@reaction`、`@share`；每个后缀分别绑定合同键、六类结论和 PA。341 只统计物理基记录，语义后缀不重复增加来源文件/代码记录，但不能用同一基号合并不同产品动作。
|
||||
- 当前产品 owner：沿用 A01、G01、T01、F01、R01、N01、M01 等编号。共享 owner 使用 `S-ID`、`S-PERM`、`S-FILE`、`S-REGION`、`S-SESSION`。
|
||||
- 一行可列同一页面的多个动作，但每个动作都必须有动作 ID、合同键和结论；不同结论不得合并。
|
||||
- 文件名、画面、路由或源码相似不能单独证明“重复”。它们可能是普通态、管理态、编辑态、空态、错误态、不同角色态或主题态；只有入口、对象、动作、数据、接口、权限和返回行为全部等价后才能共用当前 owner，源状态 ID 始终保留。
|
||||
|
||||
六类甄别结论固定为：`直接采用`、`改造后采用`、`仅参考交互`、`后端缺失，暂时关闭`、`与当前产品冲突，明确舍弃`、`待用户确认`。
|
||||
|
||||
所有动作继承以下门禁：
|
||||
|
||||
1. 正常、加载、空、失败、无权限、提交中、明确失败、结果未知、返回与重进状态按动作性质覆盖。
|
||||
2. 当前 OpenAPI 没有稳定 capability 投影；写入口在权限 owner 确认前只能显示禁用原因，403 不能反推权限。
|
||||
3. 所有 `int64` ID 必须先通过十进制字符串 wire 门禁；不安全 number 解析后禁止继续使用。
|
||||
4. 参考稿的亮红导航、旧 uView 控件、旧图标、固定尺寸和旧数据层不进入视觉目标；只借鉴信息结构，视觉统一回当前国风系统。
|
||||
5. `DECLARED_UNVERIFIED` 只表示受保护 OpenAPI 有声明；收到“开始执行”并取得本轮真实证据前，没有任何动作可预先标 `LIVE_VERIFIED`。
|
||||
|
||||
## 三、当前合同键
|
||||
|
||||
本节是源页面逐动作映射使用的唯一合同索引。每个键只能有一个 `contractState`，每个当前 operation 必须写成 `METHOD + 完整 path`。快照中有 operation 但已知 schema、权限、唯一 owner、结果确认或静态门禁冲突时，状态取更严重的 `CONTRACT_CONFLICT`；门禁脚本期望、但受保护快照没有的路径只能记为“门禁目标”，不能冒充当前 operation。当前没有任何键可预先标 `LIVE_VERIFIED`。
|
||||
|
||||
### 3.1 共享合同
|
||||
|
||||
| 合同键 | 当前 operation 或唯一 owner | `contractState` | 当前阻塞和门禁 |
|
||||
| --- | --- | --- | --- |
|
||||
| `C-S-ID` | OpenAPI 中所有 `genealogyId`、`personId`、`memberId`、`appUserId`、内容 ID、文件 ID、`avatarOssId` 及关系引用；无独立 operation | `CONTRACT_CONFLICT` | 当前 `int64` JSON number 不能满足 JavaScript 安全整数门禁；严格门禁包括 `genealogy-workspace-openapi-contract.ps1`、`g03-bootstrap-openapi-contract.ps1`、`lineage-openapi-contract.ps1`。所有 ID 动作继承本键。 |
|
||||
| `C-S-CAPABILITY` | 家谱、成员、世系等读取 DTO 中的服务端 capability/角色字段；无独立 operation | `CONTRACT_CONFLICT` | 快照没有闭合 `canView/canEdit/canInvite/canAudit/canDelete` owner，不能由前端角色名或一次 403 推测。 |
|
||||
| `C-S-CONTENT-LOCK` | 无跨谱文、成长记录和重要证件的统一访问密码/内容锁 operation | `MISSING_OPERATION` | 不得复用登录密码、A05 重置密码或参考项目三套旧 wrapper；若以后批准，必须先定义独立资源、可见性、校验、重置和限流 owner。 |
|
||||
| `C-S-PLATFORM-SHARE` | 当前 UniApp/Android 系统分享 adapter；无后端 operation | `NOT_APPLICABLE` | 唯一 owner 只负责调起平台分享、取消/失败和返回状态；分享内容必须由对应业务读取 owner 提供，例如 M08 当前活动家谱票据用 `C-G-INVITE-LIST`、APP 推广用 `C-M-PROMO`、宣传视频用 `C-M-PROMO-VIDEO`、F10 家族视频用 `C-F-VIDEO-READ`。未在冻结候选真机验证前产品动作最多为 `PARTIAL`。 |
|
||||
| `C-S-PLATFORM-CLIPBOARD` | 当前 UniApp/Android 系统剪贴板 adapter；无后端 operation | `NOT_APPLICABLE` | 唯一 owner 只负责复制动作、拒绝/失败和返回状态，不拥有被复制的票据或推荐码；业务内容分别来自 `C-G-INVITE-LIST`、`C-M-REFERRAL`。未在冻结候选真机验证前不得宣称复制成功。 |
|
||||
| `C-S-SAFE-EXTERNAL-OPEN` | 当前 UniApp/Android 外部链接打开 adapter 与目标 allowlist；无后端 operation | `NOT_APPLICABLE` | 唯一 owner 只负责 HTTPS、官方域名 allowlist、取消/失败和返回状态，不拥有下载地址内容；任意参考 URL、HTTP 地址或应用市场 scheme 均不得直接迁入。 |
|
||||
| `C-S-NAV` | 当前 `pages.json`、route key、参数 validator、返回与根切换的本地导航 owner；无后端 operation | `NOT_APPLICABLE` | 只拥有导航结构，不拥有目标页数据或权限；所有跨页 PA 自动继承，参考项目菜单不能绕过当前注册路由。 |
|
||||
| `C-LOCAL` | 协议、关于、版本号等经批准的正式本地静态 owner | `NOT_APPLICABLE` | 只适用于无需远端事实的内容，不能用于邀请码、通知详情、支付结果或人物资料。 |
|
||||
|
||||
### 3.2 A 认证与账号
|
||||
|
||||
| 合同键 | 当前 operation 或唯一 owner | `contractState` | 当前阻塞和门禁 |
|
||||
| --- | --- | --- | --- |
|
||||
| `C-A-TAC-API` | `GET /captcha/require`<br>`POST /captcha/challenge`<br>`POST /captcha/verify` | `CONTRACT_CONFLICT` | `auth-tac-openapi-contract.ps1` 是已知红灯；其中“密码登录必须消费 `validToken`”与已确认的“密码登录不接收 `validToken`、TAC 为客户端强制前置”冲突，执行时必须先修订门禁口径。 |
|
||||
| `C-A-TAC-A11Y` | 复用 `GET /captcha/require`、`POST /captcha/challenge`、`POST /captcha/verify`；`VerificationPayload` 声明多种验证码载荷 | `CONTRACT_CONFLICT` | 快照并非完全缺 operation；当前冲突是无拖动替代的服务端可用性、选择/降级语义和真机证据未闭合，`auth-android-accessibility-release-gate.ps1` 仍为红灯。 |
|
||||
| `C-A-LOGIN` | `POST /genealogy/app/auth/login` | `CONTRACT_CONFLICT` | 密码 wire、TAC 口径和会话结果未闭合；关联 `auth-tac-openapi-contract.ps1`、`password-change-openapi-contract.ps1`。 |
|
||||
| `C-A-SMS-SEND` | `POST /genealogy/app/auth/sms/code` | `CONTRACT_CONFLICT` | 公共发码场景、`validToken`、四位/六位 OTP 及换绑场景归属冲突；本键是该 path 的唯一 owner，注册和重置不得重复拥有。 |
|
||||
| `C-A-SMS-LOGIN` | `POST /genealogy/app/auth/login/sms` | `CONTRACT_CONFLICT` | OTP schema 与 TAC 发码闭环未通过 `auth-tac-openapi-contract.ps1`。 |
|
||||
| `C-A-REGISTER` | `POST /genealogy/app/auth/register` | `CONTRACT_CONFLICT` | OTP 和密码唯一 wire owner 未闭合；另依赖 `C-A-SMS-SEND`。 |
|
||||
| `C-A-RESET` | `PUT /genealogy/app/auth/password/reset` | `CONTRACT_CONFLICT` | OTP、密码策略及旧 MD5 路径冲突；另依赖 `C-A-SMS-SEND`。 |
|
||||
| `C-A-WECHAT` | 无 APP 微信登录 operation | `MISSING_OPERATION` | `GET /auth/code` 是遗留接口，不是可确认的当前 APP 微信登录 owner。 |
|
||||
| `C-A-PROFILE-READ` | `GET /genealogy/app/auth/profile` | `CONTRACT_CONFLICT` | 当前响应不能满足严格资料 DTO；关联 `profile-openapi-contract.ps1`。 |
|
||||
| `C-A-PROFILE-WRITE` | `PUT /genealogy/app/auth/profile` | `CONTRACT_CONFLICT` | dirty-only merge、版本/CAS、清空语义和结果未知恢复未闭合；关联 `profile-update-openapi-contract.ps1`。 |
|
||||
| `C-A-PASSWORD-CHANGE` | `PUT /genealogy/app/auth/password` | `CONTRACT_CONFLICT` | 密码 wire、全部会话撤销和稳定错误码未闭合；关联 `password-change-openapi-contract.ps1`。 |
|
||||
| `C-A-PHONE-SEND` | 无当前受保护的换绑专用发码 operation | `MISSING_OPERATION` | 门禁目标 `POST /genealogy/app/auth/phone/sms/code` 未出现在受保护快照；公共发码不得擅自替代。 |
|
||||
| `C-A-PHONE-CHANGE` | `PUT /genealogy/app/auth/phone` | `CONTRACT_CONFLICT` | 当前密码、新号 OTP、会话撤销和结果语义未闭合；关联 `phone-change-openapi-contract.ps1`。 |
|
||||
| `C-A-DEACTIVATE` | `POST /genealogy/app/auth/account/deactivate` | `CONTRACT_CONFLICT` | `AccountDeactivateBody.smsCode` 的四位内联 schema 与 `phone-change-openapi-contract.ps1` 要求的统一短信 Secret/六位口径冲突；另依赖 `C-A-SMS-SEND`。敏感操作仅限人工窗口。 |
|
||||
| `C-A-LOGOUT` | `DELETE /genealogy/app/auth/logout` | `CONTRACT_CONFLICT` | token/client 归属、幂等和终态错误未闭合；关联 `logout-openapi-contract.ps1`。 |
|
||||
|
||||
### 3.3 G 家谱、行政区划、申请与成员
|
||||
|
||||
| 合同键 | 当前 operation 或唯一 owner | `contractState` | 当前阻塞和门禁 |
|
||||
| --- | --- | --- | --- |
|
||||
| `C-S-REGION-CHILDREN` | `GET /genealogy/region/children` | `DECLARED_UNVERIFIED` | 共享行政区划 owner；待线上字段和层级语义验真。 |
|
||||
| `C-S-REGION-PATH` | `GET /genealogy/region/path/{regionCode}` | `DECLARED_UNVERIFIED` | 待祖先路径顺序和缺失码语义验真。 |
|
||||
| `C-S-REGION-SEARCH` | `GET /genealogy/region/search` | `CONTRACT_CONFLICT` | `g03-bootstrap-openapi-contract.ps1` 错把目标写成未声明的 `GET /genealogy/app/region/search`，门禁必须按快照真实路径重订。 |
|
||||
| `C-S-REGION-DETAIL` | `GET /genealogy/region/{regionCode}` | `DECLARED_UNVERIFIED` | 待详情字段验真。 |
|
||||
| `C-G-MINE` | `GET /genealogy/app/genealogies/mine` | `CONTRACT_CONFLICT` | 通用列表响应不能提供稳定 ID、角色和 capability；关联 `genealogy-workspace-openapi-contract.ps1`、`g03-bootstrap-openapi-contract.ps1`。 |
|
||||
| `C-G-PUBLIC` | `GET /genealogy/app/genealogies/public` | `CONTRACT_CONFLICT` | 搜索游标、结果 DTO 和错误语义未满足 `join-application-openapi-contract.ps1`。 |
|
||||
| `C-G-OPTIONS` | `GET /genealogy/app/genealogies/options` | `DECLARED_UNVERIFIED` | 不能在未验真前与 public/mine 列表混用。 |
|
||||
| `C-G-DETAIL-READ` | `GET /genealogy/app/genealogies/{genealogyId}` | `CONTRACT_CONFLICT` | 通用对象响应且与 overview 形成两个单谱读取候选；关联 `genealogy-workspace-openapi-contract.ps1`。 |
|
||||
| `C-G-OVERVIEW` | `GET /genealogy/app/genealogies/{genealogyId}/overview` | `CONTRACT_CONFLICT` | 稳定 DTO、访问状态和 capability 未闭合；关联 workspace、G03、G11 门禁。 |
|
||||
| `C-G-SETTINGS` | `PUT /genealogy/app/genealogies/{genealogyId}` | `CONTRACT_CONFLICT` | dirty-only merge、版本/CAS、权限和 pending 申请保护未闭合；关联 `g11-settings-openapi-contract.ps1`。 |
|
||||
| `C-G-CREATE-GENEALOGY` | `POST /genealogy/app/genealogies` | `CONTRACT_CONFLICT` | G03 第一次写只有通用结果，不能确认稳定 `genealogyId`、幂等和结果未知状态。 |
|
||||
| `C-T-PERSON-CREATE` | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons` | `CONTRACT_CONFLICT` | G03 第二次写兼通用人物创建 owner；根人物保护、稳定 `personId`、ID wire 和权限未闭合。 |
|
||||
| `C-G-CREATE-RECOVERY` | 无可确认的幂等结果查询或创建续办 operation | `MISSING_OPERATION` | mine/overview 的存在不能证明可安全恢复第一次写；门禁目标 `GET /genealogy/app/genealogy-bootstrap-operations/{operationKey}` 未声明。现有 G03 两个门禁仍按原子 bootstrap 设计，与已确认两阶段方案冲突，执行时须先重订。 |
|
||||
| `C-G-JOIN-CREATE` | `POST /genealogy/app/genealogies/{genealogyId}/join-applies` | `CONTRACT_CONFLICT` | 幂等 receipt、稳定申请 ID 和结果语义未闭合；关联 `join-application-openapi-contract.ps1`。 |
|
||||
| `C-G-JOIN-RECOVERY` | 无当前申请提交结果查询 operation | `MISSING_OPERATION` | 门禁目标 `GET /genealogy/app/genealogies/join-apply-requests/{requestKey}` 未声明。 |
|
||||
| `C-G-JOIN-MINE` | `GET /genealogy/app/genealogies/join-applies/mine` | `CONTRACT_CONFLICT` | 游标和 typed item 未闭合。 |
|
||||
| `C-G-JOIN-WITHDRAW` | `DELETE /genealogy/app/genealogies/join-applies/{applyId}` | `CONTRACT_CONFLICT` | 权限、幂等和稳定结果未闭合。 |
|
||||
| `C-G-JOIN-PENDING` | `GET /genealogy/app/genealogies/{genealogyId}/join-applies/pending` | `CONTRACT_CONFLICT` | capability、游标和 typed item 未闭合。 |
|
||||
| `C-G-JOIN-AUDIT` | `PUT /genealogy/app/genealogies/{genealogyId}/join-applies/{applyId}/audit` | `CONTRACT_CONFLICT` | 审核权限、并发、重复审核和结果 receipt 未闭合。 |
|
||||
| `C-G-INVITE-LIST` | 无当前可邀请家谱/活动票据列表或单票据读取 operation | `MISSING_OPERATION` | M08 不得从本地列表推断邀请权限，也不得用静态票据恢复签发/撤销结果。 |
|
||||
| `C-G-INVITE-ISSUE` | 无当前家谱邀请票据签发 operation | `MISSING_OPERATION` | 门禁目标幂等签发 path 未出现在受保护快照；响应未知时只能经权威列表恢复，不得再次盲签。 |
|
||||
| `C-G-INVITE-REVOKE` | 无当前家谱邀请票据撤销 operation | `MISSING_OPERATION` | 门禁目标撤销 path 未出现在受保护快照；撤销竞态与未知结果必须经权威列表收敛。 |
|
||||
| `C-G-INVITE-RESOLVE` | 无当前邀请码解析 operation | `MISSING_OPERATION` | 不得以本地解码、旧 wrapper 或普通搜索代替。 |
|
||||
| `C-G-INVITE-REDEEM` | 无当前邀请码兑换/直接入谱 operation | `MISSING_OPERATION` | 不得借普通加入申请绕过独立邀请语义。 |
|
||||
| `C-G-INVITE-RESULT` | 无当前邀请码兑换结果查询 operation | `MISSING_OPERATION` | 结果未知时不得重复提交。 |
|
||||
| `C-G-POEM` | `GET /genealogy/app/genealogies/{genealogyId}/generation-poems`<br>`POST /genealogy/app/genealogies/{genealogyId}/generation-poems`<br>`POST /genealogy/app/genealogies/{genealogyId}/generation-poems/batch/preview`<br>`POST /genealogy/app/genealogies/{genealogyId}/generation-poems/batch/save`<br>`GET /genealogy/app/genealogies/{genealogyId}/generation-poems/management`<br>`PUT /genealogy/app/genealogies/{genealogyId}/generation-poems/{poemId}` | `CONTRACT_CONFLICT` | `g12-generation-poem-openapi-contract.ps1` 要求另一套唯一 GET/PUT、版本/CAS 和旧入口移除，门禁目标与当前六个 operation 不一致。 |
|
||||
| `C-G-MEMBER-READ` | `GET /genealogy/app/genealogies/{genealogyId}/members`<br>`GET /genealogy/app/genealogies/{genealogyId}/members/options` | `CONTRACT_CONFLICT` | 成员与世系人物身份、typed item 和 capability 未闭合。 |
|
||||
| `C-G-MEMBER-UPDATE` | `PUT /genealogy/app/genealogies/{genealogyId}/members/{memberId}` | `CONTRACT_CONFLICT` | body 中 `lineagePersonId` 同时成为邀请绑定候选，尚无唯一 mutation owner。 |
|
||||
| `C-G-MEMBER-REMOVE` | `DELETE /genealogy/app/genealogies/{genealogyId}/members/{memberId}` | `CONTRACT_CONFLICT` | 移除权限、所有者保护和结果未知处理未闭合。 |
|
||||
| `C-G-MEMBER-LEAVE` | `DELETE /genealogy/app/genealogies/{genealogyId}/members/me` | `CONTRACT_CONFLICT` | 本人退出约束、最后管理员/所有者保护及终态未闭合。 |
|
||||
| `C-G-MEMBER-TRANSFER` | `PUT /genealogy/app/genealogies/{genealogyId}/members/owner-transfer` | `CONTRACT_CONFLICT` | 高风险权限迁移、并发和结果确认未闭合。 |
|
||||
| `C-G-SORT` | 无家谱批量排序或始祖世代安全 operation | `MISSING_OPERATION` | 不能复用人物 `sortOrder` 或字辈接口。 |
|
||||
| `C-G-ADMIN` | 无管理员列表、授权和细粒度 capability operation | `MISSING_OPERATION` | members operation 不能在无明确角色/capability 合同时替代。 |
|
||||
| `C-G-DELETE` | 无当前删除家谱 operation | `MISSING_OPERATION` | 参考项目 `delGenealogy` 不是当前合同；不得借设置 PUT、成员退出或本地移除列表伪装删除。 |
|
||||
|
||||
`invite-ticket-openapi-contract.ps1` 中以下目标路径均未出现在受保护快照，只是门禁目标：`GET /genealogy/app/genealogies/{genealogyId}/invite-tickets/mine`、`POST /genealogy/app/genealogies/{genealogyId}/invite-tickets`、`DELETE /genealogy/app/genealogies/{genealogyId}/invite-tickets/{inviteTicketId}`、`POST /genealogy/app/genealogy-invite-tickets/resolve`、`POST /genealogy/app/genealogy-invite-redemptions`、`GET /genealogy/app/genealogy-invite-redemption-requests/{requestKey}`。
|
||||
|
||||
### 3.4 T 世系与邀请绑定
|
||||
|
||||
| 合同键 | 当前 operation 或唯一 owner | `contractState` | 当前阻塞和门禁 |
|
||||
| --- | --- | --- | --- |
|
||||
| `C-T-TREE` | `GET /genealogy/app/genealogies/{genealogyId}/lineage/tree` | `CONTRACT_CONFLICT` | 当前通用树不能满足头像卡、稳定图关系、窗口化、遮蔽和权限合同；`lineage-openapi-contract.ps1` 的 v2 路径只是未声明目标。 |
|
||||
| `C-T-DETAIL` | `GET /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}` | `CONTRACT_CONFLICT` | 通用对象、ID/capability 未闭合，T03 仍是 fixture 半成品；关联 `t03-member-remote-contract.ps1`。 |
|
||||
| `C-T-LIST` | `GET /genealogy/app/genealogies/{genealogyId}/lineage/persons`<br>`GET /genealogy/app/genealogies/{genealogyId}/lineage/persons/page`<br>`GET /genealogy/app/genealogies/{genealogyId}/lineage/persons/options` | `CONTRACT_CONFLICT` | 三个读取 owner 的边界、typed item、ID 和 capability 未闭合。 |
|
||||
| `C-T-PARENT` | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/parents` | `CONTRACT_CONFLICT` | 父/母意图、`sex` enum、重复关系、图版本和权限未闭合。 |
|
||||
| `C-T-SPOUSE` | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/spouses` | `CONTRACT_CONFLICT` | 关系方向、重复/冲突、图版本和权限未闭合。 |
|
||||
| `C-T-SIBLING` | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/siblings` | `CONTRACT_CONFLICT` | 性别、共同父母、排行和关系原子性未闭合。 |
|
||||
| `C-T-CHILD` | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/children` | `CONTRACT_CONFLICT` | 儿/女 `sex` enum、另一父母、排行和关系原子性未闭合。 |
|
||||
| `C-T-EDIT` | `PUT /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}` | `CONTRACT_CONFLICT` | 宽 body、字段白名单、并发、头像链及 `appUserId` 绑定混入同一 PUT。 |
|
||||
| `C-T-RANK` | 候选但非独立 owner：`PUT /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}` | `CONTRACT_CONFLICT` | 只有单人物 `sortOrder`，没有同辈原子重排、冲突版本或完整结果；正式 PUT owner 仍是 `C-T-EDIT`。 |
|
||||
| `C-T-BIND-INVITE` | 无当前人物邀请签发、送达和接受 operation | `MISSING_OPERATION` | 家谱票据目标也未声明，且不能证明等于“绑定某一人物”。 |
|
||||
| `C-T-BIND-IDENTITY` | 无受邀账号身份查找或安全匹配 operation | `MISSING_OPERATION` | 不得按手机号、昵称或参考本地数据猜 `appUserId/memberId`。 |
|
||||
| `C-T-BIND-MUTATION` | 冲突候选：`PUT /genealogy/app/genealogies/{genealogyId}/members/{memberId}`<br>冲突候选：`PUT /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}` | `CONTRACT_CONFLICT` | 一个写 `lineagePersonId`，一个写 `appUserId`；快照没有指定唯一 owner、原子性或禁止双写规则。 |
|
||||
| `C-T-BIND-RESULT` | 无当前人物绑定结果查询 operation | `MISSING_OPERATION` | 结果未知时不得重试或双写。 |
|
||||
| `C-T-DELETE` | `DELETE /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}` | `CONTRACT_CONFLICT` | 当前语义更接近停用；根人物、被引用人物、权限及图版本未闭合。 |
|
||||
|
||||
### 3.5 文件链
|
||||
|
||||
| 合同键 | 当前 operation 或唯一 owner | `contractState` | 当前阻塞和门禁 |
|
||||
| --- | --- | --- | --- |
|
||||
| `C-S-FILE-BINARY-WRITE` | `POST /genealogy/app/files/upload`<br>`POST /genealogy/app/files/resumable/init`<br>`POST /genealogy/app/files/resumable/chunk`<br>`POST /genealogy/app/files/resumable/complete` | `CONTRACT_CONFLICT` | 上传成功结果、`ossId` 安全 wire、断点续传幂等及完成后可访问事实未闭合。 |
|
||||
| `C-S-FILE-REFERENCE-WRITE` | `POST /genealogy/app/files/reference`<br>`DELETE /genealogy/app/files/reference` | `CONTRACT_CONFLICT` | 引用对象身份、重复引用、删除引用与删除二进制边界未闭合。 |
|
||||
| `C-S-FILE-READ` | 无按 `ossId`/文件 ID 恢复可访问 URL 或授权读取的 GET operation | `MISSING_OPERATION` | 上传返回值或历史 URL 不能替代冷启动读取 owner。 |
|
||||
|
||||
### 3.6 F 家族内容
|
||||
|
||||
| 合同键 | 当前 operation 或唯一 owner | `contractState` | 当前阻塞和门禁 |
|
||||
| --- | --- | --- | --- |
|
||||
| `C-F-FEED-READ` | `GET /genealogy/app/genealogies/{genealogyId}/feeds`<br>`GET /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}` | `CONTRACT_CONFLICT` | 读 DTO、游标、作者投影和媒体策略未闭合；关联 `family-feed-read-openapi-contract.ps1`。 |
|
||||
| `C-F-FEED-PAGE-LEGACY` | `GET /genealogy/app/genealogies/{genealogyId}/feeds/page` | `CONTRACT_CONFLICT` | 门禁识别为应移除的重复读取 owner。 |
|
||||
| `C-F-FEED-WRITE` | `POST /genealogy/app/genealogies/{genealogyId}/feeds`<br>`PUT /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}`<br>`DELETE /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}`<br>`POST /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/likes`<br>`DELETE /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/likes` | `DECLARED_UNVERIFIED` | 媒体另依赖文件链，所有 ID 另依赖 `C-S-ID`。 |
|
||||
| `C-F-FEED-MODERATION` | 无动态置顶或加精 operation | `MISSING_OPERATION` | 不能用 `sortOrder/status` 猜测管理语义，也不能只改本地列表。 |
|
||||
| `C-F-COMMENT-READ` | `GET /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/comments`<br>`GET /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/comments/{commentId}/replies` | `CONTRACT_CONFLICT` | 根评论/回复投影、删除占位和游标语义未闭合。 |
|
||||
| `C-F-COMMENT-PAGE` | `GET /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/comments/page`<br>`GET /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/comments/{commentId}/replies/page` | `CONTRACT_CONFLICT` | `/comments/page` 是重复 owner 候选，回复分页也须与 canonical 读取统一。 |
|
||||
| `C-F-COMMENT-WRITE` | `POST /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/comments`<br>`DELETE /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/comments/{commentId}` | `DECLARED_UNVERIFIED` | 回复创建只在 `parentCommentId` 真实语义确认后复用 POST。 |
|
||||
| `C-F-ARTICLE` | `GET /genealogy/app/genealogies/{genealogyId}/article-categories`<br>`GET /genealogy/app/genealogies/{genealogyId}/articles`<br>`POST /genealogy/app/genealogies/{genealogyId}/articles`<br>`GET /genealogy/app/genealogies/{genealogyId}/articles/{articleId}`<br>`PUT /genealogy/app/genealogies/{genealogyId}/articles/{articleId}`<br>`DELETE /genealogy/app/genealogies/{genealogyId}/articles/{articleId}` | `DECLARED_UNVERIFIED` | 分类只有读取；文章字段、富文本和媒体白名单待验真。 |
|
||||
| `C-F-ARTICLE-CATEGORY-WRITE` | 无谱文分类新增、编辑或删除 operation | `MISSING_OPERATION` | 分类读取不能反推分类管理能力，不得借文章 POST/PUT 代替。 |
|
||||
| `C-F-ALBUM` | `GET /genealogy/app/genealogies/{genealogyId}/albums`<br>`POST /genealogy/app/genealogies/{genealogyId}/albums`<br>`PUT /genealogy/app/genealogies/{genealogyId}/albums/{albumId}`<br>`DELETE /genealogy/app/genealogies/{genealogyId}/albums/{albumId}` | `DECLARED_UNVERIFIED` | 封面媒体和删除语义另受文件与权限门禁约束。 |
|
||||
| `C-F-PHOTO-READ` | `GET /genealogy/app/genealogies/{genealogyId}/albums/{albumId}/photos` | `DECLARED_UNVERIFIED` | 照片访问 URL 仍依赖 `C-S-FILE-READ`。 |
|
||||
| `C-F-PHOTO-WRITE` | `POST /genealogy/app/genealogies/{genealogyId}/albums/{albumId}/photos`<br>`DELETE /genealogy/app/genealogies/{genealogyId}/albums/{albumId}/photos/{photoId}` | `DECLARED_UNVERIFIED` | 新增照片是“文件写＋照片记录写”两段动作。 |
|
||||
| `C-F-PHOTO-EDIT` | 无照片元数据编辑 operation | `MISSING_OPERATION` | 不得借相册 PUT 或本地数组修改。 |
|
||||
| `C-F-VIDEO-DELETE` | `DELETE /genealogy/app/genealogies/{genealogyId}/videos/{videoId}` | `DECLARED_UNVERIFIED` | 孤立删除没有读取对象来源时不得启用。 |
|
||||
| `C-F-VIDEO-READ` | 无视频列表、详情或播放资源读取 operation | `MISSING_OPERATION` | 不使用参考项目 URL 或全局 store 代替。 |
|
||||
| `C-F-VIDEO-WRITE` | 无视频发布或编辑 operation | `MISSING_OPERATION` | 文件上传不等于视频实体发布。 |
|
||||
| `C-F-VIDEO-COMMENT` | 无家族视频评论读取、发表、回复或删除 operation | `MISSING_OPERATION` | 动态评论 `C-F-COMMENT-*` 只拥有 feed 资源，不能跨资源复用为视频评论。 |
|
||||
| `C-F-VIDEO-REACTION` | 无家族视频点赞/取消点赞 operation | `MISSING_OPERATION` | 不得用本地计数、动画或参考项目裸请求冒充服务端反应状态。 |
|
||||
|
||||
### 3.7 R 族务记录
|
||||
|
||||
| 合同键 | 当前 operation 或唯一 owner | `contractState` | 当前阻塞和门禁 |
|
||||
| --- | --- | --- | --- |
|
||||
| `C-R-RELATIVE` | `GET /genealogy/app/genealogies/{genealogyId}/relative-records`<br>`POST /genealogy/app/genealogies/{genealogyId}/relative-records`<br>`GET /genealogy/app/genealogies/{genealogyId}/relative-records/{relativeId}`<br>`PUT /genealogy/app/genealogies/{genealogyId}/relative-records/{relativeId}`<br>`DELETE /genealogy/app/genealogies/{genealogyId}/relative-records/{relativeId}` | `DECLARED_UNVERIFIED` | 收/送方向、金额精度、人物关联和权限待验真。 |
|
||||
| `C-R-CEREMONY` | `GET /genealogy/app/genealogies/{genealogyId}/ceremonies`<br>`POST /genealogy/app/genealogies/{genealogyId}/ceremonies`<br>`GET /genealogy/app/genealogies/{genealogyId}/ceremonies/{ceremonyId}`<br>`PUT /genealogy/app/genealogies/{genealogyId}/ceremonies/{ceremonyId}`<br>`DELETE /genealogy/app/genealogies/{genealogyId}/ceremonies/{ceremonyId}`<br>`GET /genealogy/app/genealogies/{genealogyId}/ceremonies/{ceremonyId}/gifts`<br>`POST /genealogy/app/genealogies/{genealogyId}/ceremonies/{ceremonyId}/gifts`<br>`DELETE /genealogy/app/genealogies/{genealogyId}/ceremonies/{ceremonyId}/gifts/{giftId}` | `DECLARED_UNVERIFIED` | 祭祀献礼不能直接等同参考“贺礼邀请”。 |
|
||||
| `C-R-GROWTH` | `GET /genealogy/app/genealogies/{genealogyId}/growth-records`<br>`POST /genealogy/app/genealogies/{genealogyId}/growth-records`<br>`GET /genealogy/app/genealogies/{genealogyId}/growth-records/{recordId}`<br>`PUT /genealogy/app/genealogies/{genealogyId}/growth-records/{recordId}`<br>`DELETE /genealogy/app/genealogies/{genealogyId}/growth-records/{recordId}` | `DECLARED_UNVERIFIED` | 人物 ID、分类 enum 和媒体字段待验真。 |
|
||||
| `C-R-MEMO` | `GET /genealogy/app/genealogies/{genealogyId}/memos`<br>`POST /genealogy/app/genealogies/{genealogyId}/memos`<br>`GET /genealogy/app/genealogies/{genealogyId}/memos/{memoId}`<br>`PUT /genealogy/app/genealogies/{genealogyId}/memos/{memoId}`<br>`DELETE /genealogy/app/genealogies/{genealogyId}/memos/{memoId}` | `DECLARED_UNVERIFIED` | 日期、提醒和权限字段待验真。 |
|
||||
| `C-R-MERIT-BASE` | `GET /genealogy/app/genealogies/{genealogyId}/merit-records`<br>`POST /genealogy/app/genealogies/{genealogyId}/merit-records`<br>`DELETE /genealogy/app/genealogies/{genealogyId}/merit-records/{meritId}` | `DECLARED_UNVERIFIED` | 只支持列表、新增和单删；图片另依赖文件链。 |
|
||||
| `C-R-MERIT-DETAIL` | 无功德详情 operation | `MISSING_OPERATION` | 列表项投影不能伪装远端详情。 |
|
||||
| `C-R-MERIT-EDIT` | 无功德编辑 operation | `MISSING_OPERATION` | 不得用再次 POST 猜测新增/编辑复用语义。 |
|
||||
| `C-R-LIFE` | 无人生事件 operation | `MISSING_OPERATION` | 保持关闭。 |
|
||||
| `C-R-DOCUMENT` | 无重要证件 operation | `MISSING_OPERATION` | 隐私敏感，不能迁移参考旧接口或示例数据。 |
|
||||
| `C-R-GREETING` | 无独立“贺礼邀请”列表、详情、增改删 operation | `MISSING_OPERATION` | `relative-records` 是人情往来，`ceremonies/gifts` 是祭祀/献礼；二者都不能因名称接近而冒充本业务。 |
|
||||
|
||||
### 3.8 N 通知
|
||||
|
||||
| 合同键 | 当前 operation 或唯一 owner | `contractState` | 当前阻塞和门禁 |
|
||||
| --- | --- | --- | --- |
|
||||
| `C-N-LIST` | `GET /genealogy/app/notifications` | `CONTRACT_CONFLICT` | 当前是无稳定 item/type/target schema 的通用列表；关联 `notification-read-openapi-contract.ps1`。 |
|
||||
| `C-N-UNREAD-COUNT` | 无当前未读数 operation | `MISSING_OPERATION` | 门禁目标 `GET /genealogy/app/notifications/unread-count` 未声明。 |
|
||||
| `C-N-READ-ONE` | `POST /genealogy/app/notifications/{notificationId}/read` | `CONTRACT_CONFLICT` | 幂等、当前账号归属及稳定结果未闭合。 |
|
||||
| `C-N-READ-ALL` | `POST /genealogy/app/notifications/read-all` | `CONTRACT_CONFLICT` | 当前账号范围、幂等和结果未闭合。 |
|
||||
| `C-N-DETAIL-SAME-SESSION` | 本地 owner：N01 当前会话不可变列表项快照；来源仍是 `GET /genealogy/app/notifications` | `CONTRACT_CONFLICT` | 同会话投影可保留，但列表 item/type/target schema 不稳定；不得猜业务深链。 |
|
||||
| `C-N-DETAIL-COLD-START` | 无通知详情或按通知 ID 重取 operation | `MISSING_OPERATION` | 冷启动、进程重启、深链或快照丢失时诚实关闭。 |
|
||||
| `C-N-TYPED-REMINDER` | 候选复用 `GET /genealogy/app/notifications` | `CONTRACT_CONFLICT` | 现有列表缺稳定生日/疫苗/备忘等 type、目标 route key、参数和权限失效 schema，不能从文案猜类型。 |
|
||||
|
||||
### 3.9 M 我的
|
||||
|
||||
| 合同键 | 当前 operation 或唯一 owner | `contractState` | 当前阻塞和门禁 |
|
||||
| --- | --- | --- | --- |
|
||||
| `C-M-HELP-LIST` | `GET /genealogy/app/help-articles` | `CONTRACT_CONFLICT` | 完整列表 DTO 未满足 `help-center-openapi-contract.ps1`。当前 M06 的文章阅读必须由列表项投影承接。 |
|
||||
| `C-M-HELP-DETAIL` | `GET /genealogy/app/help-articles/{helpId}` | `CONTRACT_CONFLICT` | operation 已声明，但当前门禁指定完整列表为唯一远端 owner；规划不新增独立详情路由，先统一 owner 后才可启用本键。 |
|
||||
| `C-M-FEEDBACK` | `GET /genealogy/app/feedback`<br>`POST /genealogy/app/feedback` | `DECLARED_UNVERIFIED` | 列表范围、提交幂等和结果未知处理待验真。 |
|
||||
| `C-M-PROMO` | `GET /genealogy/app/promotions` | `DECLARED_UNVERIFIED` | 只证明推广内容读取，不代表邀请码、积分、奖励或分享变现。 |
|
||||
| `C-M-PROMO-VIDEO` | 无独立广告/宣传视频列表、详情或播放资源 operation | `MISSING_OPERATION` | `GET /genealogy/app/promotions` 未证明返回稳定可播放媒体；家族视频 `C-F-VIDEO-READ` 不能跨域替代。 |
|
||||
| `C-M-PROMO-VIDEO-COMMENT` | 无广告/宣传视频评论读取、发表、回复或删除 operation | `MISSING_OPERATION` | 不得借动态评论或家族视频评论 owner 冒充。 |
|
||||
| `C-M-PROMO-VIDEO-REACTION` | 无广告/宣传视频点赞/取消点赞 operation | `MISSING_OPERATION` | 不得用本地计数或参考控件冒充服务端状态。 |
|
||||
| `C-M-REFERRAL` | 无 APP 推广推荐码/二维码签发或读取 operation | `MISSING_OPERATION` | 推广推荐码不是家谱邀请票据，不能解析、兑换或直接入谱，也不能借 `C-G-INVITE-ISSUE` 冒充。 |
|
||||
| `C-M-REWARD` | 无邀请奖励、积分余额或奖励明细 operation | `MISSING_OPERATION` | 不得从推广文案、邀请码或本地计数推断奖励。 |
|
||||
| `C-M-VIP-READ` | `GET /genealogy/app/vip/packages`<br>`GET /genealogy/app/vip/orders` | `DECLARED_UNVERIFIED` | 待 typed item、金额单位和订单状态验真。 |
|
||||
| `C-M-VIP-ORDER` | `POST /genealogy/app/vip/orders` | `CONTRACT_CONFLICT` | 通用对象结果没有稳定订单 ID、幂等键、订单详情或结果未知恢复链。 |
|
||||
| `C-M-VIP-PAY` | 无支付、支付结果查询、取消或退款 operation | `MISSING_OPERATION` | 不得由创建订单 HTTP 200 进入成功页。 |
|
||||
| `C-M-MONEY` | 无余额、资金流水、提现提交或提现状态 operation | `MISSING_OPERATION` | 文件上传不能单独启用收款码/提现流程。 |
|
||||
|
||||
未直接出现在某一 PA 合同列的键也有明确用途，不能被误当成漏接动作：`C-S-ID/C-S-CAPABILITY/C-S-NAV` 是全部相关 PA 自动继承的共享门禁；`C-G-DETAIL-READ` 是与 overview 竞争、待退役的诊断键；`C-G-MEMBER-UPDATE` 是 `C-T-BIND-MUTATION` 的冲突候选 operation 证据；`C-F-FEED-PAGE-LEGACY/C-F-COMMENT-PAGE` 是待移除的重复读取 owner；`C-F-PHOTO-EDIT` 记录未获批准产品动作的合同缺口；`C-M-HELP-DETAIL` 记录被 list-only 决策压住的声明 operation。它们不增加 PA 分母，也不能绕过对应 canonical owner。
|
||||
|
||||
## 四、第一参考源：60 个设计文件
|
||||
|
||||
### 4.1 D001—D030
|
||||
|
||||
| 文件 ID / 文件 | 页面与逐动作 ID | 当前合同键与 owner | 甄别结论与改造边界 |
|
||||
| --- | --- | --- | --- |
|
||||
| `D001` `4、族谱网APP端-思维导图.pdf` | `D001-P01-A01` APP 功能树；`A02` 后台/网站/PC 分支 | A/G/T/F/R/N/M；其他端无当前路由 | `A01 仅参考交互`，作为反向覆盖目录；`A02 与当前产品冲突，明确舍弃`，不扩张本仓库 |
|
||||
| `D002` `编辑家族视频.png` | `D002-P01-A01` 选择并删除视频 | `C-F-VIDEO-READ/C-F-VIDEO-DELETE` → F10 | `后端缺失，暂时关闭`；不能因有孤立 DELETE 就启用管理页 |
|
||||
| `D003` `编辑相册.png` | `D003-P01-A01` 改名/描述/封面；`A02` 删除相册 | `C-F-ALBUM`、`C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` → F07/F08 | 两项均 `改造后采用`；权限、结果未知、封面文件链和删除确认必须重做 |
|
||||
| `D004` `创建家谱 .png` | `D004-P01-A01` 填姓氏/谱名/堂号/地望/祠堂/访问权限并创建 | `C-S-REGION-CHILDREN/C-S-REGION-PATH/C-S-REGION-SEARCH/C-S-REGION-DETAIL`、`C-G-CREATE-GENEALOGY`、`C-T-PERSON-CREATE`、`C-G-CREATE-RECOVERY` → G03 | `改造后采用`；自由文本地望不能代替必填 `regionCode`；固定两阶段顺序，但首写无稳定词法 ID 或结果未知时必须停止，不能从 mine 列表猜回 |
|
||||
| `D005` `登陆.png` | `D005-P01-A01` 密码登录；`A02` 忘记；`A03` 注册；`A04` 微信登录 | `C-A-TAC-API/C-A-TAC-A11Y/C-A-LOGIN/C-A-SMS-SEND/C-A-RESET/C-A-REGISTER/C-A-WECHAT` → A01/A04/A05 | A01—A03 `改造后采用`，补 TAC/协议/错误；A04 `后端缺失，暂时关闭` |
|
||||
| `D006` `调整世代.png` | `D006-P01-A01` 调整始祖世代并联动其他成员 | `C-G-SORT` → G 候选 | `后端缺失，暂时关闭`；不能借 T06 排行或 G12 字辈 |
|
||||
| `D007` `发布视频.png` | `D007-P01-A01` 标题/描述/上传并发布视频 | `C-F-VIDEO-WRITE/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` → F10 | `后端缺失，暂时关闭`；上传存在也不等于视频实体发布存在 |
|
||||
| `D008` `功德录(1).png` | `D008-P01-A01` 浏览功德记录；`A02` 进入管理 | `C-R-MERIT-BASE/C-R-MERIT-DETAIL` → R11 | A01 `改造后采用`；A02 `仅参考交互`，详情/编辑合同不足 |
|
||||
| `D009` `功德录.png` | `D009-P01-A01` 多选记录；`A02` 删除 | `C-R-MERIT-BASE` → R11 | A01 `仅参考交互`；A02 `改造后采用`，服务端仅单删且需权限/二次确认 |
|
||||
| `D010` `管理世代.png` | `D010-P01-A01` 浏览字辈代次；`A02` 编辑；`A03` 新增 | `C-G-POEM` → G12 | 三项 `改造后采用`；统一到 G12 单一 owner，不建立“世代”第二合同 |
|
||||
| `D011` `加入家谱.png` | `D011-P01-A01` 粘贴邀请码并直接加入 | `C-G-INVITE-RESOLVE/C-G-INVITE-REDEEM/C-G-INVITE-RESULT` → G06 | `后端缺失，暂时关闭`；不可借普通 `C-G-JOIN-CREATE` |
|
||||
| `D012` `家谱主页 – 1.png` | `D012-P01-A01` 家谱总览；`A02` 模块导航 | `C-G-OVERVIEW` → G05 | A01/A02 均为 `仅参考交互`；作为独立总览状态证据保留，不能因与 D043 相似就判重复；红色整页视觉不直接采纳 |
|
||||
| `D013` `家谱主页 – 22.png` | `D013-P01-A01` 贺礼邀请列表；`A02` 分类筛选；`A03` 新建 | `C-R-GREETING` → R 候选 | 三项 `待用户确认`；“贺礼邀请”既非人情簿也未证明等于祭祀献礼 |
|
||||
| `D014` `家谱主页 – 23.png` | `D014-P01-A01` 多选贺礼；`A02` 删除 | 同 D013 | A01 `仅参考交互`；A02 `待用户确认`，语义与权限未定 |
|
||||
| `D015` `家谱主页 – 24.png` | `D015-P01-A01` 贺礼详情 | 同 D013 | `待用户确认`；不能用 ceremony gift 详情猜产品语义 |
|
||||
| `D016` `家谱主页 – 25.png` | `D016-P01-A01` 创建/编辑贺礼 | 同 D013 | `待用户确认`；标题、类型、金额、受邀人和状态合同均需定义 |
|
||||
| `D017` `家谱主页 – 26.png` | `D017-P01-A01` 成长日志列表；`A02` 分类/筛选；`A03` 新建 | `C-R-GROWTH` → R08 | 三项 `改造后采用`；人物 ID 与 recordType enum 先验真 |
|
||||
| `D018` `家谱主页 – 27.png` | `D018-P01-A01` 成长日志详情 | `C-R-GROWTH` → R08 | `改造后采用` |
|
||||
| `D019` `家谱主页 – 28.png` | `D019-P01-A01` 多选成长记录；`A02` 删除 | `C-R-GROWTH` → R08 | A01 `仅参考交互`；A02 `改造后采用`，只删测试数据并二次确认 |
|
||||
| `D020` `家谱主页 – 29.png` | `D020-P01-A01` 新建成长日志 | `C-R-GROWTH` → R08 | `改造后采用`；绑定真实人物，禁止本地假插入 |
|
||||
| `D021` `家谱主页 – 30.png` | `D021-P01-A01` 人情簿列表；`A02` 新建 | `C-R-RELATIVE` → R03/R04 | 两项 `改造后采用`；收/送方向、金额精度先验真 |
|
||||
| `D022` `家谱主页 – 31.png` | `D022-P01-A01` 多选人情记录；`A02` 删除 | `C-R-RELATIVE` → R03/R04 | A01 `仅参考交互`；A02 `改造后采用` |
|
||||
| `D023` `家谱主页 – 32.png` | `D023-P01-A01` 新建/编辑人情记录 | `C-R-RELATIVE` → R04 | `改造后采用` |
|
||||
| `D024` `家谱主页 – 33.png` | `D024-P01-A01` 备忘列表；`A02` 新建 | `C-R-MEMO` → R10 | 两项 `改造后采用` |
|
||||
| `D025` `家谱主页 – 34.png` | `D025-P01-A01` 管理员列表；`A02` 添加 | `C-G-ADMIN/C-G-MEMBER-READ` → G 候选 | 两项 `待用户确认`；无 capability owner，不新增假页面 |
|
||||
| `D026` `家谱主页 – 35.png` | `D026-P01-A01` 多选管理员；`A02` 删除；`A03` 权限配置 | `C-G-ADMIN/C-G-MEMBER-READ/C-G-MEMBER-REMOVE` | A01 `仅参考交互`；A02/A03 `待用户确认`，破坏性/授权能力未闭合 |
|
||||
| `D027` `家谱主页 – 36.png` | `D027-P01-A01` 选择成员并添加管理员 | `C-G-ADMIN/C-G-MEMBER-READ` | `待用户确认` |
|
||||
| `D028` `家谱主页 – 37.png` | `D028-P01-A01` 配置管理员权限 | `C-G-ADMIN` | `待用户确认`；不能把前端勾选框当服务端 capability |
|
||||
| `D029` `家谱主页 – 38.png` | `D029-P01-A01` 发布文字/图片动态；`A02` 置顶；`A03` 加精 | `C-F-FEED-WRITE/C-F-FEED-MODERATION/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` → F02 | A01 `改造后采用`；A02/A03 `后端缺失，暂时关闭` |
|
||||
| `D030` `家谱主页 – 39.png` | `D030-P01-A01` 表格式世系浏览 | `C-T-TREE` → T01 | `仅参考交互`；可作为辅助模式候选，但头像卡树是当前必需主模式 |
|
||||
|
||||
### 4.2 D031—D060
|
||||
|
||||
| 文件 ID / 文件 | 页面与逐动作 ID | 当前合同键与 owner | 甄别结论与改造边界 |
|
||||
| --- | --- | --- | --- |
|
||||
| `D031` `家谱主页 – 40.png` | `D031-P01-A01` 搜索世系人物；`A02` 选择定位 | `C-T-LIST/C-T-TREE` → T01/T07 | 两项 `改造后采用`；搜索与树定位共享人物 ID owner |
|
||||
| `D032` `家谱主页 – 41.png` | `D032-P01-A01` 头像人物卡树；`A02` 横纵浏览 | `C-T-TREE/C-S-FILE-READ` → T01 | 两项 `改造后采用`，且是用户明确的 T01 必需能力；视觉重做为当前国风 |
|
||||
| `D033` `家谱主页 – 42.png` | `D033-P01-A01` 查看资料；`A02` 父亲；`A03` 母亲；`A04` 配偶；`A05` 兄弟姐妹；`A06` 排行；`A07` 儿子；`A08` 女儿；`A09` 邀请绑定；`A10` 编辑 | `C-T-DETAIL/C-T-PARENT/C-T-SPOUSE/C-T-SIBLING/C-T-RANK/C-T-CHILD/C-T-BIND-INVITE/C-T-BIND-IDENTITY/C-T-BIND-MUTATION/C-T-BIND-RESULT/C-T-EDIT` → T01/T03—T06/独立邀请流程 | 十项均为用户明确需求，产品取舍为 `改造后采用`；合同不足的动作执行态关闭且产品完成度 BLOCKED，不能删入口或假成功 |
|
||||
| `D034` `家谱主页 – 43.png` | `D034-P01-A01` 查看人物资料空态；`A02` 资料/亲属切换；`A03` 邀请其激活绑定；`A04` 编辑 | `C-T-DETAIL/C-T-BIND-INVITE/C-T-BIND-IDENTITY/C-T-BIND-MUTATION/C-T-BIND-RESULT/C-T-EDIT` → T03/T05/邀请流程 | A01/A02/A04 `改造后采用`；A03 产品需求已批准但当前 `后端缺失，暂时关闭` |
|
||||
| `D035` `家谱主页 – 44.png` | `D035-P01-A01` 查看人物亲属列表；`A02` 点亲属继续查看 | `C-T-DETAIL/C-T-LIST` → T03 | 两项 `改造后采用`；避免递归叠原生页，沿用单实例轨迹 |
|
||||
| `D036` `家谱主页 – 45.png` | `D036-P01-A01` 选择/绑定成长对象；`A02` 编辑头像姓名排行等人物字段；`A03` 填成长日志 | `C-T-BIND-INVITE/C-T-BIND-IDENTITY/C-T-BIND-MUTATION/C-T-BIND-RESULT/C-T-EDIT/C-T-RANK/C-R-GROWTH` → T04/T05/T06/R08 | A01 `后端缺失，暂时关闭`；A02/A03 `改造后采用`且必须按 owner 拆分，不能把排行和人物编辑合为宽表单 |
|
||||
| `D037` `家谱主页 – 46.png` | `D037-P01-A01` 阅读富文本详情 | `C-R-CEREMONY/C-M-HELP-LIST` → 取决于来源 | `仅参考交互`；通用长文阅读形态可复用，但数据 owner 必须由入口决定 |
|
||||
| `D038` `家谱主页 – 47.png` | `D038-P01-A01` 编辑人物基础资料；`A02` 微信/QQ/地址/学历/职业等扩展隐私资料 | `C-T-EDIT` → T05 | A01 `改造后采用`；A02 `与当前产品冲突，明确舍弃`，当前需求未授权且后端无隐私/可见性 owner，不采集、不存储、不上传 |
|
||||
| `D039` `家谱主页 – 48.png` | `D039-P01-A01` 帮助分类；`A02` 搜索 | `C-M-HELP-LIST` → M06 | 两项 `改造后采用` |
|
||||
| `D040` `家谱主页 – 49.png` | `D040-P01-A01` 阅读帮助文章 | `C-M-HELP-LIST` → M06 | `改造后采用`；由完整列表项投影承接，不新增独立远端 owner |
|
||||
| `D041` `家谱主页 – 50.png` | `D041-P01-A01` 分享应用；`A02` 邀请奖励/积分；`A03` 微信小程序首次登录限制 | `C-M-PROMO/C-S-PLATFORM-SHARE/C-M-REWARD/C-A-WECHAT` → 无当前路由的 M 推广候选 | A01 `仅参考交互`；A02/A03 `待用户确认`并保持关闭，禁止承诺积分或微信链，更不得覆盖 M08 家谱邀请 |
|
||||
| `D042` `家谱主页 – 51.png` | `D042-P01-A01` 填标题/描述并提交反馈 | `C-M-FEEDBACK` → M07 | `改造后采用`；真实提交失败和结果未知不得清空 |
|
||||
| `D043` `家谱主页.png` | `D043-P01-A01` 家谱总览；`A02` 模块导航 | `C-G-OVERVIEW` → G05 | A01/A02 均为 `仅参考交互`；独立保留为可能的角色、主题或业务状态，待入口/数据/权限证据证明后才决定是否与 D012 共用状态实现 |
|
||||
| `D044` `家族视频.png` | `D044-P01-A01` 视频列表；`A02` 播放；`A03` 管理；`A04` 发布 | `C-F-VIDEO-READ/C-F-VIDEO-WRITE/C-F-VIDEO-DELETE` → F10 | 四项 `后端缺失，暂时关闭`；播放 UI 可做关闭页信息参考 |
|
||||
| `D045` `家族相册.png` | `D045-P01-A01` 照片墙；`A02` 预览；`A03` 上传照片；`A04` 编辑相册 | `C-F-ALBUM/C-F-PHOTO-READ/C-F-PHOTO-WRITE/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` → F08/F09 | A01—A04 均为 `改造后采用`；A03/A04 必须在文件、权限和两段写闭环后实施 |
|
||||
| `D046` `谱文(1).png` | `D046-P01-A01` 管理谱文分类 | `C-F-ARTICLE-CATEGORY-WRITE` → F04/F06 | `仅参考交互`；当前合同只有分类读取，无分类增改删，管理动作关闭 |
|
||||
| `D047` `谱文.png` | `D047-P01-A01` 浏览谱文分类；`A02` 进入内容 | `C-F-ARTICLE` → F04 | 两项 `改造后采用` |
|
||||
| `D048` `谱文详情.png` | `D048-P01-A01` 阅读谱文；`A02` 添加/编辑 | `C-F-ARTICLE` → F05/F06 | 两项 `改造后采用`；富文本和媒体必须消毒/归一化 |
|
||||
| `D049` `设置世代.png` | `D049-P01-A01` 编辑代数/字辈；`A02` 保存；`A03` 删除 | `C-G-POEM` → G12 | A01—A03 均为 `改造后采用`；A03 只能改造成停用/恢复，不得猜测为物理删除 |
|
||||
| `D050` `首页 – 14.png` | `D050-P01-A01` 我的家谱列表；`A02` 搜索；`A03` 创建；`A04` 普通申请加入；`A05` 邀请码直入 | `C-G-MINE/C-G-PUBLIC/C-G-OPTIONS/C-G-CREATE-GENEALOGY/C-T-PERSON-CREATE/C-G-CREATE-RECOVERY/C-G-JOIN-CREATE/C-G-JOIN-RECOVERY/C-G-INVITE-RESOLVE/C-G-INVITE-REDEEM/C-G-INVITE-RESULT` → G01/G03/G06/G08 | A01—A04 `改造后采用`；A05 `后端缺失，暂时关闭` |
|
||||
| `D051` `首页 – 16.png` | `D051-P01-A01` 家族动态列表；`A02` 图片墙；`A03` 评论/回复；`A04` 发布 | `C-F-FEED-READ/C-F-FEED-WRITE/C-F-COMMENT-READ/C-F-COMMENT-WRITE/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` → F01/F02/F03 | 四项 `改造后采用`；不复制示例图片、电话号码或静态评论 |
|
||||
| `D052` `首页 – 18.png` | `D052-P01-A01` 通知列表；`A02` 全部已读；`A03` 审核加入；`A04` 打开活动通知 | `C-N-LIST/C-N-READ-ALL/C-N-DETAIL-SAME-SESSION/C-N-DETAIL-COLD-START/C-G-JOIN-AUDIT` → N01/N02/G10 | A01—A03 `改造后采用`；A03 必须深链到 G10，不能由 N01 直接审核；A04 `后端缺失，暂时关闭`，不得在无目标合同时伪造跳转 |
|
||||
| `D053` `首页 – 19.png` | `D053-P01-A01` 查看本人资料；`A02` 推广；`A03` 反馈；`A04` 安全；`A05` 帮助；`A06` 退出 | `C-A-PROFILE-READ/C-M-PROMO/C-M-FEEDBACK/C-A-PASSWORD-CHANGE/C-A-PHONE-CHANGE/C-A-LOGOUT/C-M-HELP-LIST` → M01/M03/M06/M07/M10；A02 为无当前路由候选 | A01、A03—A06 `改造后采用`；A02 同为 `改造后采用`的候选证据，但不承诺奖励且不得覆盖 M08 家谱邀请 |
|
||||
| `D054` `首页 .png` | `D054-P01-A01` 我的家谱列表；`A02` 创建；`A03` 加入 | 同 D050 | A01—A03 均为 `仅参考交互`；独立保留为可能的主题、角色或业务状态，不能只按颜色相似度与 D050 合并 |
|
||||
| `D055` `思维导图.png` | `D055-P01-A01` APP 认证/家谱/世系/内容/族务/消息/我的全功能树；`A02` 后台；`A03` 网站；`A04` PC 管理端 | A/G/T/F/R/N/M；其他端无当前路由 | A01 `仅参考交互`并作为全项目反向检查目录；A02—A04 `与当前产品冲突，明确舍弃` |
|
||||
| `D056` `添加功德人.png` | `D056-P01-A01` 姓名/内容/图片并新增功德记录 | `C-R-MERIT-BASE/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` → R11 | `改造后采用`；当前无编辑/详情 operation，图片 owner 待确认 |
|
||||
| `D057` `添加谱文.png` | `D057-P01-A01` 标题/正文/落款/图片质量/媒体并保存 | `C-F-ARTICLE/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` → F06 | `改造后采用`；只提交当前合同白名单，图片质量不是后端业务字段 |
|
||||
| `D058` `相册.png` | `D058-P01-A01` 相册列表；`A02` 新建；`A03` 打开详情 | `C-F-ALBUM` → F07/F08 | 三项 `改造后采用` |
|
||||
| `D059` `新建相册.png` | `D059-P01-A01` 名称/描述并创建相册 | `C-F-ALBUM` → F07 | `改造后采用` |
|
||||
| `D060` `字辈谱.png` | `D060-P01-A01` 浏览字辈；`A02` 管理 | `C-G-POEM` → G12 | 两项 `改造后采用` |
|
||||
|
||||
## 五、第二参考源：78 条活动路由
|
||||
|
||||
“参考 wrapper”只证明旧项目尝试过某动作，不是当前合同。未列入 wrapper 的裸 `uni.request`、全局 store 传 URL、硬编码数据和被注释调用均不得迁入。
|
||||
|
||||
### 5.1 J001—J026
|
||||
|
||||
| 路由 ID / 参考路由 | 页面与逐动作 ID | 参考 wrapper | 当前合同键与 owner | 甄别结论与边界 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| `J001` `pages/index/index` | `J001-A01` 读用户/家谱；`A02` 切谱；`A03` 模块导航；`A04` 宣传视频 | `getALLCreatGenealogyList`, `getAuthByUserGenealogy`, `getCreatGenealogy`, `getDictDataByDictCode`, `getUserInfo`, `getVideopublicize` | `C-G-MINE/C-G-OVERVIEW/C-A-PROFILE-READ/C-M-PROMO-VIDEO` → G01/G05；A04 为无当前路由候选 | A01—A03 `仅参考交互`并拆 owner；A04 `后端缺失，暂时关闭`，拒绝跨域巨型首页 |
|
||||
| `J002` `pages/login/login` | `J002-A01` 密码登录；`A02` 注册；`A03` 重置；`A04` 微信登录 | `getCaptcha`, `getDictDataByDictCodeNoToken`, `login`, `register`, `userResetPwd`, `wechatAppLogin` | `C-A-TAC-API/C-A-TAC-A11Y/C-A-LOGIN/C-A-SMS-SEND/C-A-REGISTER/C-A-RESET/C-A-WECHAT` → A01/A04/A05 | A01—A03 `改造后采用`；A04 `后端缺失，暂时关闭`；页面必须拆 owner |
|
||||
| `J003` `pages/render/render` | `J003-A01` 阳历/农历日期时间选择演示 | 无 | `C-LOCAL` → 共享控件候选 | `与当前产品冲突，明确舍弃`活动路由；需要日期选择时只参考控件行为 |
|
||||
| `J004` `pages/index/addGenealogy` | `J004-A01` 输入邀请信息直接入谱 | `inviteCreatGenealogy` | `C-G-INVITE-RESOLVE/C-G-INVITE-REDEEM/C-G-INVITE-RESULT` → G06 | `后端缺失，暂时关闭`；与 G08 普通申请隔离 |
|
||||
| `J005` `pages/index/createGenealogy` | `J005-A01` 选字典/地区并创建家谱 | `addCreatGenealogy`, `getDictDataByDictCode` | `C-S-REGION-CHILDREN/C-S-REGION-PATH/C-S-REGION-SEARCH/C-S-REGION-DETAIL/C-G-CREATE-GENEALOGY/C-T-PERSON-CREATE/C-G-CREATE-RECOVERY` → G03 | `改造后采用`；旧一次提交改为两阶段顺序，首写结果未知时停止并人工对账 |
|
||||
| `J006` `pages/index/invite` | `J006-A01` 邀请家人空壳 | 无 | `C-G-INVITE-ISSUE` | `与当前产品冲突，明确舍弃`空壳；不冒充 T01 邀请绑定 |
|
||||
| `J007` `pages/index/genealogyList/index` | `J007-A01` 家谱列表/选择；`A02` 删除家谱；`A03` 读配置 | `delGenealogy`, `getCreatGenealogy`, `getDictDataByDictCode`, `getDictDataByDictCodeNoToken` | `C-G-MINE/C-G-DELETE` → G01 | A01/A03 `改造后采用`；A02 `待用户确认`且不执行真实删除 |
|
||||
| `J008` `pages/index/genealogyList/characterTable` | `J008-A01` 查看字辈 | `getCharacterTable` | `C-G-POEM` → G12 | `改造后采用` |
|
||||
| `J009` `pages/index/genealogyList/add` | `J009-A01` 添加/编辑字辈；`A02` 删除 | `addCharacterTable`, `deleteCharacterTable` | `C-G-POEM` → G12 | A01/A02 均为 `改造后采用`；A02 只能按停用/恢复合同改造，拒绝物理删除猜测 |
|
||||
| `J010` `pages/index/puwen/classList` | `J010-A01` 读取并选择谱文分类 | `getDictDataByDictCode` | `C-F-ARTICLE` → F04/F06 | `仅参考交互`；分类必须来自当前文章合同 |
|
||||
| `J011` `pages/index/puwen/index` | `J011-A01` 谱文列表/筛选；`A02` 访问密码；`A03` 删除 | `deleteLiterature`, `getDictDataByDictCode`, `getLiterature`, `pw_is_cehck` | `C-F-ARTICLE/C-S-CONTENT-LOCK` → F04/F05 | A01/A03 `改造后采用`；A02 `待用户确认`，当前无内容锁 owner |
|
||||
| `J012` `pages/index/puwen/genealogy` | `J012-A01` 谱文详情 | `getLiteratureDetails` | `C-F-ARTICLE` → F05 | `改造后采用`；作为独立入口/详情状态证据保留，证明等价后才与其他详情入口共用实现 |
|
||||
| `J013` `pages/index/puwen/add` | `J013-A01` 新建；`A02` 编辑；`A03` 读原详情 | `addLiterature`, `getLiteratureDetails` | `C-F-ARTICLE` → F06 | 三项 `改造后采用` |
|
||||
| `J014` `pages/index/puwen/wjmm` | `J014-A01` 重置谱文访问密码；`A02` 成长日志访问密码；`A03` 证件访问密码 | `addLiterature`, `cz_update_password`, `cz_update_password_hx`, `getLiteratureDetails`, `pw_update_password`, `pw_update_password_hx`, `zy_update_password`, `zy_update_password_hx` | `C-S-CONTENT-LOCK` | 三项 `待用户确认`；明确不映射 A05，拒绝跨 F/R/证件的复制污染 |
|
||||
| `J015` `pages/index/album/index` | `J015-A01` 相册列表 | `getPhotocategoryList` | `C-F-ALBUM` → F07 | `改造后采用` |
|
||||
| `J016` `pages/index/album/add` | `J016-A01` 新建相册 | `addPhotocategory` | `C-F-ALBUM` → F07 | `改造后采用` |
|
||||
| `J017` `pages/index/album/details` | `J017-A01` 照片列表；`A02` 上传；`A03` 删除照片 | `deletePhoto`, `getPhotoList`, `uploadPhoto` | `C-F-PHOTO-READ/C-F-PHOTO-WRITE/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` → F08/F09 | 三项 `改造后采用`；上传与记录两段确认 |
|
||||
| `J018` `pages/index/album/edit` | `J018-A01` 编辑相册 | `addPhotocategory` | `C-F-ALBUM` → F07/F08 | `改造后采用`；不复用“新增”旧 wrapper 语义 |
|
||||
| `J019` `pages/index/document/index` | `J019-A01` 证件列表；`A02` 密码校验；`A03` 删除 | `deletePhotodocument`, `getPhotodocument`, `zy_is_cehck` | `C-R-DOCUMENT/C-S-CONTENT-LOCK` | 三项 `待用户确认`；默认关闭，不迁移身份证明或真实 PII |
|
||||
| `J020` `pages/index/document/add` | `J020-A01` 新建/编辑证件；`A02` 选择类型 | `addPhotodocument`, `getDictDataByDictCode` | `C-R-DOCUMENT` | 两项 `待用户确认`且默认关闭 |
|
||||
| `J021` `pages/index/video/index` | `J021-A01` 视频列表；`A02` 播放；`A03` 删除 | `deleteVideo`, `getVideoList` | `C-F-VIDEO-READ/C-F-VIDEO-DELETE` → F10 | A01—A03 均为 `后端缺失，暂时关闭`；A03 不得因存在孤立删除 operation 就暴露入口 |
|
||||
| `J022` `pages/index/video/add` | `J022-A01` 上传；`A02` 发布/编辑视频 | `addVideo`, `uploadFile` | `C-F-VIDEO-WRITE/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` → F10 | 两项 `后端缺失，暂时关闭` |
|
||||
| `J023` `pages/index/video/xcindex` | `J023-A01` 宣传视频列表 | `getVideopublicize` | `C-M-PROMO-VIDEO` | `待用户确认`；宣传与家族视频分离 |
|
||||
| `J024` `pages/index/video/details` | `J024-A01` 从全局 store 取 URL 播放 | 无 | `C-F-VIDEO-READ` → F10 | `仅参考交互`；全局 URL 传递方式明确舍弃 |
|
||||
| `J025` `pages/index/meritsVirtues/index` | `J025-A01` 功德列表；`A02` 删除 | `deleteVirtues`, `getVirtuesList` | `C-R-MERIT-BASE` → R11 | 两项 `改造后采用` |
|
||||
| `J026` `pages/index/meritsVirtues/add` | `J026-A01` 新增；`A02` 编辑；`A03` 读取详情 | `addVirtues`, `getVirtuesDetail` | `C-R-MERIT-BASE/C-R-MERIT-EDIT/C-R-MERIT-DETAIL` → R11 | A01 `改造后采用`；A02/A03 `后端缺失，暂时关闭`，当前无详情/编辑 operation，不能假完成 |
|
||||
|
||||
### 5.2 J027—J052
|
||||
|
||||
| 路由 ID / 参考路由 | 页面与逐动作 ID | 参考 wrapper | 当前合同键与 owner | 甄别结论与边界 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| `J027` `pages/index/meritsVirtues/details` | `J027-A01` 功德详情 | `getVirtuesDetail` | `C-R-MERIT-DETAIL` → R11 | `后端缺失，暂时关闭`独立详情；可在列表使用服务端已有投影，但不能伪造详情 |
|
||||
| `J028` `pages/index/gift/index` | `J028-A01` 贺礼邀请列表；`A02` 分类；`A03` 删除 | `deleteGift`, `getDictDataByDictCode`, `getGift` | `C-R-GREETING` | 三项 `待用户确认`；先定义业务语义 |
|
||||
| `J029` `pages/index/gift/details` | `J029-A01` 贺礼详情 | `getGiftInfo` | 同 J028 | `待用户确认` |
|
||||
| `J030` `pages/index/gift/add` | `J030-A01` 新建；`A02` 编辑；`A03` 分类；`A04` 读取详情 | `addGift`, `getDictDataByDictCode`, `getGiftInfo` | 同 J028 | 四项 `待用户确认` |
|
||||
| `J031` `pages/index/log/index` | `J031-A01` 成长列表；`A02` 删除/批量；`A03` 进入详情 | `deleteDevelopmentlog`, `development`, `getDevelopmentlogList` | `C-R-GROWTH` → R08 | A01—A03 均为 `改造后采用`；A02 只按当前单条合同和权限实现；与 J070/J071 分别保留为可能的入口/筛选/角色状态 |
|
||||
| `J032` `pages/index/log/details` | `J032-A01` 成长详情 | `getDevelopmentlogDetails` | `C-R-GROWTH` → R08 | `改造后采用` |
|
||||
| `J033` `pages/index/log/add` | `J033-A01` 新增；`A02` 编辑；`A03` 分类 | `addDevelopmentlog`, `getDevelopmentlogDetails`, `getDictDataByDictCode` | `C-R-GROWTH` → R08 | 三项 `改造后采用` |
|
||||
| `J034` `pages/index/favor/index` | `J034-A01` 人情簿列表；`A02` 删除 | `deleteCashgift`, `getCashgiftList` | `C-R-RELATIVE` → R03 | 两项 `改造后采用` |
|
||||
| `J035` `pages/index/favor/details` | `J035-A01` 人情记录详情 | `getCashgiftDetails` | `C-R-RELATIVE` → R03/R04 | `改造后采用` |
|
||||
| `J036` `pages/index/favor/add` | `J036-A01` 新增；`A02` 编辑 | `addCashgift`, `getCashgiftDetails` | `C-R-RELATIVE` → R04 | 两项 `改造后采用` |
|
||||
| `J037` `pages/index/memorandum/index` | `J037-A01` 备忘列表；`A02` 删除 | `deleteMemorandum`, `getMemorandum` | `C-R-MEMO` → R10 | 两项 `改造后采用` |
|
||||
| `J038` `pages/index/memorandum/add` | `J038-A01` 新增；`A02` 编辑；`A03` 读取详情 | `addMemorandum`, `getMemorandumInfo` | `C-R-MEMO` → R10 | 三项 `改造后采用` |
|
||||
| `J039` `pages/index/memorandum/details` | `J039-A01` 备忘详情 | `getMemorandumInfo` | `C-R-MEMO` → R10 | `改造后采用` |
|
||||
| `J040` `pages/index/admin/index` | `J040-A01` 管理员列表；`A02` 移除 | `getManageUserDel`, `getManageUserList` | `C-G-ADMIN/C-G-MEMBER-READ/C-G-MEMBER-REMOVE` | 两项 `待用户确认`；移除须影响预览和再认证 |
|
||||
| `J041` `pages/index/admin/add` | `J041-A01` 静态成员勾选；`A02` 进入权限页 | 无 | `C-G-ADMIN` | A01/A02 均为 `与当前产品冲突，明确舍弃`；该半成品不迁移，不把假成员列表带入当前产品 |
|
||||
| `J042` `pages/index/admin/power` | `J042-A01` 读取权限；`A02` 提交管理员权限 | `addManageUser`, `getManagePower` | `C-G-ADMIN` | 两项 `待用户确认`，合同缺失前关闭 |
|
||||
| `J043` `pages/index/familyCircle/index` | `J043-A01` 动态列表；`A02` 评论列表；`A03` 评论；`A04` 删除动态 | `addComment`, `deleteUsernews`, `getComment`, `getUsernewsList` | `C-F-FEED-READ/C-F-FEED-WRITE/C-F-COMMENT-READ/C-F-COMMENT-WRITE` → F01/F03 | 四项 `改造后采用`；列表和评论/删除拆 owner |
|
||||
| `J044` `pages/index/familyCircle/add` | `J044-A01` 发布动态；`A02` 取公开字典 | `addUsernews`, `getDictDataByDictCodeNoToken` | `C-F-FEED-WRITE` → F02 | A01/A02 `改造后采用`；A02 仅使用当前明确字段 owner |
|
||||
| `J045` `pages/index/tree/index` | `J045-A01` 按父母展开表格式世系 | `getGenealogyUserByParentsId` | `C-T-TREE` → T01 | `仅参考交互`；不复制旧接口和递归数据形状 |
|
||||
| `J046` `pages/index/tree/tree` | `J046-A01` 树谱；`A02` 查看资料；`A03` 添加/编辑亲属；`A04` 删除人物 | `getGenealogyUser`, `userDel` | `C-T-TREE/C-T-DETAIL/C-T-PARENT/C-T-SPOUSE/C-T-SIBLING/C-T-CHILD/C-T-EDIT/C-T-DELETE` → T01/T03—T05 | A01—A03 `仅参考交互`并按当前 owner 重做；A04 `待用户确认`，停用不是物理删除 |
|
||||
| `J047` `pages/message/index` | `J047-A01` 通知/广告/文章混排；`A02` 直接审核入谱；`A03` 人物列表 | `auditInGenealogy`, `getad_list`, `getArticleList`, `getNoticeList`, `getUserList` | `C-N-LIST/C-G-JOIN-AUDIT/C-T-LIST` → N01/G10 | A01 `仅参考交互`但须拆类型；A02 `改造后采用`为跳 G10，不在 N01 写；A03 `与当前产品冲突，明确舍弃`错位数据 |
|
||||
| `J048` `pages/message/details` | `J048-A01` 通知详情 | `getNoticeDetails` | `C-N-DETAIL-SAME-SESSION/C-N-DETAIL-COLD-START` → N02 | `后端缺失，暂时关闭` LIVE 详情；仅允许列表当代内存投影 |
|
||||
| `J049` `pages/mine/index` | `J049-A01` 我的主页/资料；`A02` 宣传/广告；`A03` 删除账号 | `delUser`, `getad_list`, `getDictDataByDictCodeNoToken`, `getUserInfo`, `getVideopublicize` | `C-A-PROFILE-READ/C-M-PROMO/C-A-DEACTIVATE` → M01/M10 | A01 `改造后采用`；A02/A03 `待用户确认`，A03 为敏感注销候选且不归主页直调 |
|
||||
| `J050` `pages/mine/help` | `J050-A01` 帮助分类；`A02` 文章列表 | `getArticleList`, `getHelpClass` | `C-M-HELP-LIST` → M06 | 两项 `改造后采用` |
|
||||
| `J051` `pages/mine/setting` | `J051-A01` 设置导航；`A02` 帮助/协议内容 | `getArticleList`, `getHelpClass` | `C-M-HELP-LIST/C-LOCAL` → M03/M10 | A01/A02 均为 `仅参考交互`；设置只做导航，不另建数据 owner |
|
||||
| `J052` `pages/mine/password` | `J052-A01` 修改密码 | `userEditPWD` | `C-A-PASSWORD-CHANGE` → M04 | `改造后采用`；旧密码 wire 不能迁移为新合同 |
|
||||
|
||||
### 5.3 J053—J078 与注释路由
|
||||
|
||||
| 路由 ID / 参考路由 | 页面与逐动作 ID | 参考 wrapper | 当前合同键与 owner | 甄别结论与边界 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| `J053` `pages/mine/opinion` | `J053-A01` 提交反馈 | `addUseropinion` | `C-M-FEEDBACK` → M07 | `改造后采用` |
|
||||
| `J054` `pages/mine/share` | `J054-A01` 展示推广；`A02` 立即分享 | 无 | `C-M-PROMO/C-S-PLATFORM-SHARE` → 无当前路由的 M 推广候选 | A01 `改造后采用`候选证据；A02 `仅参考交互`，旧错误跳创建家谱明确舍弃；不得覆盖 M08 家谱邀请 |
|
||||
| `J055` `pages/mine/vip_xf` | `J055-A01` 套餐；`A02` 创建/支付 VIP | `getMemberLevel`, `getUserInfo`, `payVip` | `C-M-VIP-READ/C-M-VIP-ORDER/C-M-VIP-PAY` → M09 | A01 `改造后采用`为只读；A02 `后端缺失，暂时关闭`支付闭环 |
|
||||
| `J056` `pages/mine/vip_success` | `J056-A01` 查询购买记录/成功 | `vip_log` | `C-M-VIP-READ/C-M-VIP-PAY` → M09 | `后端缺失，暂时关闭`成功页；只能由权威订单结果进入 |
|
||||
| `J057` `pages/mine/helpDetails` | `J057-A01` 帮助详情 | `getArticleDetails` | `C-M-HELP-LIST` → M06 | `改造后采用`产品意图；当前由列表项投影承接，旧独立详情 owner 不迁入 |
|
||||
| `J058` `pages/index/relationship/index` | `J058-A01` 静态人物/亲属资料；`A02` 邀请激活 | 无 | `C-T-DETAIL/C-T-BIND-INVITE/C-T-BIND-IDENTITY/C-T-BIND-MUTATION/C-T-BIND-RESULT` → T03/邀请流程 | A01 `仅参考交互`；A02 产品需求保留但当前 `后端缺失，暂时关闭` |
|
||||
| `J059` `pages/index/tree/personalData` | `J059-A01` 人物资料 | `getUserInfoId` | `C-T-DETAIL` → T03 | `改造后采用` |
|
||||
| `J060` `pages/index/tree/add` | `J060-A01` 绑定账号；`A02` 编辑头像/姓名/排行/父亲/生卒；`A03` 确认 | 无 | `C-T-BIND-INVITE/C-T-BIND-IDENTITY/C-T-BIND-MUTATION/C-T-BIND-RESULT/C-T-EDIT/C-T-RANK/C-T-PARENT` → T04—T06 | A01—A03 均为 `与当前产品冲突，明确舍弃`；宽静态表单实现不迁移，字段须逐 owner 甄别后重做 |
|
||||
| `J061` `pages/mine/userInfo` | `J061-A01` 本人资料；`A02` 添加父母；`A03` 配偶；`A04` 兄弟姐妹；`A05` 子女；`A06` 单人；`A07` 人物编辑；`A08` 排行/层级 | `addBrotherSister`, `addChildren`, `addOneUser`, `addParents`, `addUserspouse`, `getDictDataByDictCode`, `getDictDataByDictCodeNoToken`, `getLevelList`, `getMomList`, `getUserInfoId`, `getUserSpouseInfoId`, `userEdit` | `C-A-PROFILE-READ/C-A-PROFILE-WRITE/C-T-PARENT/C-T-SPOUSE/C-T-SIBLING/C-T-CHILD/C-T-EDIT/C-T-RANK` → M02/T04—T06 | A01—A05、A07/A08 `改造后采用`产品意图，但必须拆 owner；A06 与当前产品冲突，`明确舍弃`未绑定通用人物新建；旧一页多模式和旧 wrapper 全部舍弃 |
|
||||
| `J062` `pages/index/log/selectUser` | `J062-A01` 选择成长人物；`A02` 管理员选择分支 | `getUserList` | `C-T-LIST/C-R-GROWTH/C-G-ADMIN` → R08 | A01 `改造后采用`；A02 `与当前产品冲突，明确舍弃`未完成分支 |
|
||||
| `J063` `pages/index/genealogyList/ancestorsOrder` | `J063-A01` 调整始祖世代空占位 | 无 | `C-G-SORT` | `与当前产品冲突，明确舍弃`空文件；功能候选保持后端缺失关闭 |
|
||||
| `J064` `pages/mine/helpList` | `J064-A01` 按分类读帮助文章 | `getArticleList` | `C-M-HELP-LIST` → M06 | `改造后采用` |
|
||||
| `J065` `pages/content/detail` | `J065-A01` 账号协议；`A02` 帮助/关于富文本 | `getNewsDetails` | `C-LOCAL/C-M-HELP-LIST` → A/M06/M10 共享查看器 | A01/A02 均为 `仅参考交互`；入口决定 owner，明确不是 F05 谱文 |
|
||||
| `J066` `pages/mine/fenxiang` | `J066-A01` 推广推荐码/二维码；`A02` 复制；`A03` 下载 App；`A04` 分享变现 | 无 | `C-M-REFERRAL/C-M-PROMO/C-M-MONEY/C-S-PLATFORM-CLIPBOARD/C-S-PLATFORM-SHARE/C-S-SAFE-EXTERNAL-OPEN` → 无当前路由的 M 推广候选 | A01/A02 `后端缺失，暂时关闭`，明确不是家谱票据；A03 `仅参考交互`且只能由安全外链 owner 承接；A04 `待用户确认`；四项均不得覆盖 M08 |
|
||||
| `J067` `pages/login/register` | `J067-A01` 注册；`A02` 性别/邀请码；`A03` 协议 | `getCaptcha`, `getDictDataByDictCodeNoToken`, `register` | `C-A-TAC-API/C-A-TAC-A11Y/C-A-SMS-SEND/C-A-REGISTER/C-LOCAL` → A04 | A01—A03 `改造后采用`；A02 只保留当前合同字段，旧邀请码不迁入 |
|
||||
| `J068` `pages/mine/changemobile` | `J068-A01` 当前密码＋新号换绑 | `userEditMobile` | `C-A-TAC-API/C-A-TAC-A11Y/C-A-PHONE-SEND/C-A-PHONE-CHANGE` → M05 | `改造后采用`产品目标；旧缺 TAC/OTP/会话撤销合同明确舍弃 |
|
||||
| `J069` `pages/index/sortGenealogy` | `J069-A01` 读取用户家谱；`A02` 批量排序 | `changeGenealogySort`, `getALLCreatGenealogyList` | `C-G-MINE/C-G-SORT` → G01 候选 | A01 `改造后采用`并复用 G01；A02 `后端缺失，暂时关闭`，不同于 T06/G12 |
|
||||
| `J070` `pages/index/log/list` | `J070-A01` 人物/分类成长列表；`A02` 密码校验；`A03` 删除；`A04` 新建 | `cz_is_cehck`, `deleteDevelopmentlog`, `getDevelopmentlogList`, `getDictDataByDictCode` | `C-R-GROWTH/C-S-CONTENT-LOCK` → R08 | A01/A03/A04 `改造后采用`并独立保留此筛选/入口状态；证明与 J031 等价后才共用实现；A02 `待用户确认` |
|
||||
| `J071` `pages/index/log/class` | `J071-A01` 成长分类；`A02` 进入列表；`A03` 错位删除逻辑 | `deleteDevelopmentlog`, `getDevelopmentlogList`, `getDictDataByDictCode` | `C-R-GROWTH` → R08 | A01/A02 `仅参考交互`；A03 `与当前产品冲突，明确舍弃` |
|
||||
| `J072` `pages/index/video/video2` | `J072-A01` 纵滑播放；`A02` 评论；`A03` 点赞；`A04` 分享；`A05` 裸请求旧 HTTP | 无 | `C-F-VIDEO-READ/C-F-VIDEO-COMMENT/C-F-VIDEO-REACTION/C-S-PLATFORM-SHARE` → F10 候选 | A01—A04 `仅参考交互`但分别进入浏览、评论、点赞、分享候选，不能共用读取 owner；A05 `与当前产品冲突，明确舍弃` |
|
||||
| `J073` `pages/index/video/video3` | `J073-A01` 宣传纵滑播放；`J073-A02@comment` 评论；`J073-A02@reaction` 点赞；`J073-A02@share` 分享；`J073-A03` 裸请求旧接口 | 无 | A01 → `C-M-PROMO-VIDEO`；A02@comment → `C-M-PROMO-VIDEO-COMMENT`；A02@reaction → `C-M-PROMO-VIDEO-REACTION`；A02@share → `C-M-PROMO-VIDEO/C-S-PLATFORM-SHARE` | A01 与三个 A02 语义子动作均 `仅参考交互`，不代表批准宣传业务；A03 `与当前产品冲突，明确舍弃` |
|
||||
| `J074` `pages/index/video/video4` | `J074-A01@browse` 第三套纵滑；`J074-A01@comment` 评论；`J074-A02` 旧 HTTP 与外部云接口 | 无 | A01@browse → `C-F-VIDEO-READ`；A01@comment → `C-F-VIDEO-COMMENT`；A02 无可迁移 owner | 两个 A01 语义子动作均 `仅参考交互`；A02 `与当前产品冲突，明确舍弃` |
|
||||
| `J075` `pages/message/ad_detail` | `J075-A01` 广告/宣传消息详情 | `ad_detail`, `getDictDataByDictCodeNoToken` | `C-N-DETAIL-SAME-SESSION/C-N-DETAIL-COLD-START/C-M-PROMO` → N02 | `待用户确认`；服务端消息类型/目标未闭合前关闭 |
|
||||
| `J076` `pages/mine/withdrawal` | `J076-A01` 余额；`A02` 资金流水；`A03` 进入提现 | `getUserInfo`, `money_log` | `C-M-MONEY` | 三项 `待用户确认`且关闭 |
|
||||
| `J077` `pages/mine/tixian` | `J077-A01` 提现金额；`A02` 上传收款码；`A03` 提交；`A04` 混入成长日志残留 | `add_tixian`, `addDevelopmentlog`, `getDevelopmentlogDetails`, `getDictDataByDictCode` | `C-M-MONEY/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` | A01—A03 `待用户确认`且关闭；A04 `与当前产品冲突，明确舍弃`复制污染 |
|
||||
| `J078` `pages/mine/tixian_log` | `J078-A01` 提现记录/状态/审核时间 | `tixian_log` | `C-M-MONEY` | `待用户确认`且关闭 |
|
||||
| `JX001` `pages/index/vertical-swiper/vertical-swiper`（注释） | `JX001-A01` 纵向短视频实验 | 无 | `C-F-VIDEO-READ` → F10 | `与当前产品冲突，明确舍弃`活动路由候选；只保留交互证据且不计 78 分母 |
|
||||
|
||||
## 六、7 个未注册页面文件
|
||||
|
||||
| 文件 ID / 相对路径 | 页面与逐动作 ID | 参考 wrapper | 当前 owner | 甄别结论 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| `JU01` `pages/index/genealogyList.vue` | `JU01-A01` 全功能菜单导航；`A02` 错配按钮/文案 | 无 | `C-S-NAV/C-G-OVERVIEW` → G05 与各业务域 | A01 `仅参考交互`并作为可能的角色/菜单状态保留；A02 `与当前产品冲突，明确舍弃`；未注册页面不自动新增路由 |
|
||||
| `JU02` `pages/index/tree/tree2.vue` | `JU02-A01` 树谱；`A02` 资料；`A03` 父母；`A04` 配偶；`A05` 兄弟姐妹；`A06` 儿子；`A07` 女儿；`A08` 编辑；`A09` 其他关系入口；`A10` 删除 | `getGenealogyUser`, `userDel` | `C-T-TREE/C-T-DETAIL/C-T-PARENT/C-T-SPOUSE/C-T-SIBLING/C-T-CHILD/C-T-EDIT/C-T-DELETE/C-S-NAV` → T01/T03—T06 | A01—A09 `仅参考交互`并作为另一树状态证据保留，旧代码整体舍弃；A10 `待用户确认`。其中“女儿”复用 `addSon` 是反例 |
|
||||
| `JU03` `pages/index/vertical-swiper/j-video.nvue` | `JU03-A01` 视频子项播放/暂停 | 无 | `C-F-VIDEO-READ` → F10 | `仅参考交互`；随实验页不注册 |
|
||||
| `JU04` `pages/index/vertical-swiper/vertical-swiper.nvue` | `JU04-A01` 纵向列表；`A02` 播放切换 | 无 | `C-F-VIDEO-READ` → F10 | 两项 `仅参考交互`；这是 JX001 的目标文件，不计活动路由 |
|
||||
| `JU05` `pages/index/video/douyin-scrollview/douyin-scrollview.vue` | `JU05-A01` 纵滑；`JU05-A02` 播放；`JU05-A03` 评论；`JU05-A04@reaction` 点赞；`JU05-A04@share` 分享；`JU05-A05` 裸请求旧/外部接口 | 无 | A01/A02 → `C-F-VIDEO-READ`；A03 → `C-F-VIDEO-COMMENT`；A04@reaction → `C-F-VIDEO-REACTION`；A04@share → `C-F-VIDEO-READ/C-S-PLATFORM-SHARE` | A01—A03 与两个 A04 语义子动作均 `仅参考交互`；A05 `与当前产品冲突，明确舍弃` |
|
||||
| `JU06` `pages/index/video/douyin-scrollview/douyin-scrollview.nvue` | `JU06-A01` 纵滑；`JU06-A02` 播放；`JU06-A03` 评论；`JU06-A04@reaction` 点赞；`JU06-A04@share` 分享；`JU06-A05` 裸请求旧/外部接口 | 无 | A01/A02 → `C-F-VIDEO-READ`；A03 → `C-F-VIDEO-COMMENT`；A04@reaction → `C-F-VIDEO-REACTION`；A04@share → `C-F-VIDEO-READ/C-S-PLATFORM-SHARE` | A01—A03 与两个 A04 语义子动作均 `仅参考交互`；A05 `与当前产品冲突，明确舍弃` |
|
||||
| `JU07` `pages/mine/index2.vue` | `JU07-A01` 资料；`A02` 反馈；`A03` 帮助；`A04` 设置；`A05` 退出 | `getUserInfo` | `C-A-PROFILE-READ/C-M-FEEDBACK/C-M-HELP-LIST/C-A-PASSWORD-CHANGE/C-A-PHONE-CHANGE/C-A-LOGOUT/C-S-NAV` → M01/M06/M07/M10 | 五项 `仅参考交互`；作为可能的角色/布局状态保留，未注册事实不等同于无产品价值 |
|
||||
|
||||
## 七、反向覆盖索引
|
||||
|
||||
| 当前 owner | 设计证据 | 完成项目证据 | 规划结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| A01/A04/A05 认证 | D005、D053、D055 | J002、J065、J067 | 密码/短信/注册/找回按 TAC 与当前合同改造；微信关闭 |
|
||||
| G01/G03/G05 家谱工作区 | D004、D012、D043、D050、D054、D055 | J001、J005、J007、JU01 | 列表/概览/两阶段创建采用；旧巨型首页和菜单壳不迁移 |
|
||||
| G06/G08—G10 加入与审核 | D011、D050、D052 | J004、J047 | 普通申请采用；邀请码直入关闭；通知只能回流 G10 |
|
||||
| G11/G12 设置与字辈 | D006、D010、D049、D060 | J008、J009、J063、J069 | 字辈采用；始祖世代和家谱排序缺 owner 关闭 |
|
||||
| G 管理员与破坏性成员动作 | D025—D028 | J040—J042 | 待用户确认；无 capability 前关闭 |
|
||||
| T01/T03—T08 | D030—D036、D038、D055 | J045、J046、J058—J062、JU02 | T01 十入口已批准；头像卡/面板按当前架构重做；排行/绑定按合同关闭但不删需求 |
|
||||
| F01—F03 动态 | D029、D051、D055 | J043、J044 | 动态/评论改造采用；置顶/加精关闭 |
|
||||
| F04—F06 谱文 | D046—D048、D057 | J010—J014 | 列表/详情/编辑采用；内容密码待确认 |
|
||||
| F07—F09 相册/媒体 | D003、D045、D058、D059 | J015—J018 | 相册/照片采用；共享文件链闭合前不假上传 |
|
||||
| F10 视频 | D002、D007、D044 | J021、J022、J024、J072、J074、JX001、JU03—JU06；J023/J073 为独立 M 宣传视频证据 | 家族视频完整后端链缺失，保持关闭；纵滑只作交互证据；宣传视频不得借 F10 owner |
|
||||
| R01/R02 人物录与人物资料 | D031、D034—D036、D038 | J058—J062 | R01、R02 分别作为 PA-049、PA-038/048 的独立路由状态，复用唯一列表/详情/编辑数据 owner；R02 通用新建本地预览舍弃，编辑只导航 T05 |
|
||||
| R03/R04 人情往来 | D021—D023 | J034—J036 | 改造采用 |
|
||||
| R05—R07 礼仪/贺礼候选 | D013—D016、D037 | J028—J030 | “贺礼邀请”语义待确认，不能强塞祭祀献礼 |
|
||||
| R08 成长 | D017—D020、D036 | J031—J033、J062、J070、J071 | 改造采用；各入口/筛选/角色状态分别保留，证明等价后才共用 R08 实现 |
|
||||
| R10/R11 备忘/功德 | D008、D009、D024、D056 | J025—J027、J037—J039 | 现有 operation 范围内采用；缺详情/编辑的动作关闭 |
|
||||
| R09/重要证件 | D055 | J019、J020 | 人生事件与证件均缺 owner；证件另有隐私风险，保持关闭/待确认 |
|
||||
| N01/N02 与 G01/M01 未读入口 | D052、D055 | J047、J048、J075 | 列表/已读采用；未读计数使用唯一 `C-N-UNREAD-COUNT` owner，当前缺 operation 不从分页长度推断；N02 仅列表当代投影，详情/目标跳转关闭 |
|
||||
| M01—M10 | D039—D042、D053、D055 | J049—J057、J064—J068、J075—J078、JU07 | M08 保持当前“家谱邀请票据” owner；资料/安全/帮助/反馈/关于采用；APP 推广、推荐码、奖励、变现均为无当前路由候选，分别使用 `C-M-PROMO/C-M-REFERRAL/C-M-REWARD/C-M-MONEY`，不得冒充家谱邀请 |
|
||||
| S-ID/S-PERM/S-FILE/S-REGION | D003、D004、D032、D036、D038、D045、D056、D057 | 所有含 ID、权限、上传、地区动作的 J/JU 记录 | 全域唯一 owner；任何一个域不得另造兼容 ID、权限或上传协议 |
|
||||
|
||||
## 八、规范产品动作账本
|
||||
|
||||
本账本在用户确认规划前冻结产品动作身份和分母。`PA-xxx` 是产品动作，不是来源文件数量；`CUR:` 表示当前路由基线，`!` 表示只作为反例、禁止迁移。`D001-A01`（全项目功能目录）与 `D055-A01`（全项目思维导图）由全部 PA 继承，不在每行重复。PA 的“来源证据反链”栏允许把单页、默认状态的设计动作简写为 `Dxxx-Axx`；它与源表中的完整 `Dxxx-P01-S01-Axx` 是同一 ID，不是新增来源。相同 PA 下的多个来源仍保留各自 `D/J/JX/JU` 状态 ID、六类结论和验收记录；共用 owner 不等于合并状态证据。
|
||||
|
||||
边界固定为：`必需`进入产品完成分母；`候选`保留稳定 PA ID，但用户未单独批准时不进入完成分母，初始 `productCompletion=NOT_APPLICABLE`。规划阶段没有任何 PA 可标 `COMPLETE`。表中 `P/B/NA` 分别表示 `PARTIAL/BLOCKED/NOT_APPLICABLE`。
|
||||
|
||||
### 8.1 A 认证：PA-001—PA-006
|
||||
|
||||
| PA | 唯一 owner / 产品动作 | 边界 | 合同键 | 来源证据反链 | 初始 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| `PA-001` | A01 密码＋TAC 登录 | 必需 | `C-A-TAC-API/C-A-TAC-A11Y/C-A-LOGIN` | D005-A01；J002-A01；CUR:A01 | B |
|
||||
| `PA-002` | A01 短信 TAC、发码并登录 | 必需 | `C-A-TAC-API/C-A-TAC-A11Y/C-A-SMS-SEND/C-A-SMS-LOGIN` | D005-A01〔登录视觉态〕；CUR:A01 | B |
|
||||
| `PA-003` | A04 TAC、发码并注册 | 必需 | `C-A-TAC-API/C-A-TAC-A11Y/C-A-SMS-SEND/C-A-REGISTER` | D005-A03；J002-A02；J067-A01—A03；CUR:A04 | B |
|
||||
| `PA-004` | A05 TAC、发码并找回密码 | 必需 | `C-A-TAC-API/C-A-TAC-A11Y/C-A-SMS-SEND/C-A-RESET` | D005-A02；J002-A03；CUR:A05 | B |
|
||||
| `PA-005` | A-LEGAL 阅读服务条款/隐私协议 | 必需 | `C-LOCAL` | J065-A01；J067-A03；D005-A01—A03〔登录协议态〕 | P |
|
||||
| `PA-006` | A01 微信一键登录 | 候选 | `C-A-WECHAT` | D005-A04；D041-A03；J002-A04 | NA |
|
||||
|
||||
### 8.2 G 家谱工作区：PA-007—PA-034
|
||||
|
||||
| PA | 唯一 owner / 产品动作 | 边界 | 合同键 | 来源证据反链 | 初始 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| `PA-007` | G01 查看/筛选我的家谱列表 | 必需 | `C-G-MINE` | D050-A01；D054-A01〔主题态〕；J001-A01；J007-A01/A03；J069-A01；CUR:G01 | B |
|
||||
| `PA-008` | G01 切换当前家谱上下文 | 必需 | `C-G-MINE/C-G-OVERVIEW` | J001-A02；D012-A01/A02、D043-A01/A02〔不同总览状态〕；CUR:G01 | B |
|
||||
| `PA-009` | G03 两阶段创建家谱及首位人物；仅首写稳定返回 ID 后续办 | 必需 | `C-S-REGION-CHILDREN/C-S-REGION-PATH/C-S-REGION-SEARCH/C-S-REGION-DETAIL/C-G-CREATE-GENEALOGY/C-T-PERSON-CREATE/C-G-CREATE-RECOVERY` | D004-A01；D050-A03；D054-A02；J005-A01；CUR:G03 | B |
|
||||
| `PA-010` | G05 查看家谱总览并进入模块 | 必需 | `C-G-OVERVIEW` | D012-A01/A02〔状态一〕；D043-A01/A02〔状态二〕；J001-A03；JU01-A01〔菜单态〕；!JU01-A02；CUR:G05 | B |
|
||||
| `PA-011` | G06 搜索公开家谱 | 必需 | `C-G-PUBLIC/C-G-OPTIONS` | D050-A02；CUR:G06 | B |
|
||||
| `PA-012` | G08 提交普通加入申请 | 必需 | `C-G-JOIN-CREATE/C-G-JOIN-RECOVERY` | D050-A04；D054-A03；CUR:G08 | B |
|
||||
| `PA-013` | G09 查看我的加入申请 | 必需 | `C-G-JOIN-MINE` | CUR:G09 | B |
|
||||
| `PA-014` | G09 撤回加入申请 | 必需 | `C-G-JOIN-WITHDRAW` | CUR:G09 | B |
|
||||
| `PA-015` | G10 查看待审核申请 | 必需 | `C-G-JOIN-PENDING` | D052-A03；J047-A02〔通知回流态〕；CUR:G10 | B |
|
||||
| `PA-016` | G10 审核申请（同意/拒绝） | 必需 | `C-G-JOIN-AUDIT` | D052-A03；J047-A02；CUR:G10 | B |
|
||||
| `PA-017` | G11 查看家谱设置 | 必需 | `C-G-OVERVIEW` | CUR:G11 | B |
|
||||
| `PA-018` | G11 更新允许修改的家谱设置 | 必需 | `C-G-SETTINGS` | CUR:G11 | B |
|
||||
| `PA-019` | G12 查看字辈/代次 | 必需 | `C-G-POEM` | D010-A01；D060-A01；J008-A01；CUR:G12 | B |
|
||||
| `PA-020` | G12 新增字辈 | 必需 | `C-G-POEM` | D010-A03；D060-A02〔管理入口〕；J009-A01；CUR:G12 | B |
|
||||
| `PA-021` | G12 编辑字辈 | 必需 | `C-G-POEM` | D010-A02；D049-A01/A02；J009-A01；CUR:G12 | B |
|
||||
| `PA-022` | G12 停用/恢复字辈 | 必需 | `C-G-POEM` | D049-A03；J009-A02 | B |
|
||||
| `PA-023` | M08 选择有正式邀请权限的家谱并查看当前活动票据状态 | 必需 | `C-G-MINE/C-G-INVITE-LIST` | CUR:M08 | B |
|
||||
| `PA-024` | G06 解析、确认、兑换家谱邀请码，查询结果并刷新权威工作区后直接入谱 | 必需 | `C-G-INVITE-RESOLVE/C-G-INVITE-REDEEM/C-G-INVITE-RESULT/C-G-MINE/C-G-OVERVIEW` | D011-A01；D050-A05；J004-A01；CUR:G06 | B |
|
||||
| `PA-025` | G01 调整多个家谱展示顺序 | 候选 | `C-G-SORT` | J069-A02 | NA |
|
||||
| `PA-026` | G-SORT 调整始祖世代 | 候选 | `C-G-SORT` | D006-A01；J063-A01〔空壳反例〕 | NA |
|
||||
| `PA-027` | G-ADMIN 查看管理员列表 | 候选 | `C-G-ADMIN/C-G-MEMBER-READ` | D025-A01；D026-A01〔管理态〕；J040-A01 | NA |
|
||||
| `PA-028` | G-ADMIN 选择并新增管理员 | 候选 | `C-G-ADMIN/C-G-MEMBER-READ` | D025-A02；D027-A01；!J041-A01；!J062-A02〔未完成分支〕 | NA |
|
||||
| `PA-029` | G-ADMIN 查看/修改管理员权限 | 候选 | `C-G-ADMIN` | D026-A03；D028-A01；J042-A01/A02；!J041-A02 | NA |
|
||||
| `PA-030` | G-ADMIN 移除管理员 | 候选 | `C-G-ADMIN/C-G-MEMBER-REMOVE` | D026-A02；J040-A02 | NA |
|
||||
| `PA-031` | G-MEMBER 移除家谱账号成员 | 候选 | `C-G-MEMBER-REMOVE` | 当前成员合同；D055-A01 | NA |
|
||||
| `PA-032` | G-MEMBER 主动退出家谱 | 候选 | `C-G-MEMBER-LEAVE` | 当前成员合同；D055-A01 | NA |
|
||||
| `PA-033` | G-MEMBER 转移家谱所有者 | 候选 | `C-G-MEMBER-TRANSFER` | 当前成员合同；D055-A01 | NA |
|
||||
| `PA-034` | G01 删除家谱 | 候选 | `C-G-DELETE` | J007-A02 | NA |
|
||||
|
||||
### 8.3 T 世系与成员：PA-035—PA-052
|
||||
|
||||
| PA | 唯一 owner / 产品动作 | 边界 | 合同键 | 来源证据反链 | 初始 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| `PA-035` | T01 读取并呈现头像人物卡世系树 | 必需 | `C-T-TREE/C-S-FILE-READ` | D032-A01；D033-A01—A10〔面板前置态〕；J046-A01；JU02-A01〔另一树态〕；CUR:T01 | B |
|
||||
| `PA-036` | T01 横纵浏览、搜索并定位人物 | 必需 | `C-T-TREE/C-T-LIST` | D031-A01/A02；D032-A02；CUR:T01；CUR:T07 | B |
|
||||
| `PA-037` | T01 选择人物并打开唯一操作面板 | 必需 | `C-T-TREE` | D033-A01—A10〔十入口面板态〕；J046-A01—A03；JU02-A01—A09 | B |
|
||||
| `PA-038` | T03 查看人物真实资料；R02 为独立展示状态 | 必需 | `C-T-DETAIL` | D033-A01；D034-A01〔空/未绑定态〕；J046-A02；J058-A01；J059-A01；JU02-A02；CUR:T03；CUR:R02 | B |
|
||||
| `PA-039` | T03 查看亲属并继续进入亲属资料 | 必需 | `C-T-DETAIL/C-T-LIST` | D034-A02；D035-A01/A02；J058-A01 | B |
|
||||
| `PA-040` | T04 添加父亲 | 必需 | `C-T-PARENT` | D033-A02；J046-A03；J061-A02；JU02-A03；!J060-A02〔宽表单〕；CUR:T04 | B |
|
||||
| `PA-041` | T04 添加母亲 | 必需 | `C-T-PARENT` | D033-A03；J061-A02；JU02-A03；CUR:T04 | B |
|
||||
| `PA-042` | T04 添加配偶 | 必需 | `C-T-SPOUSE` | D033-A04；J046-A03；J061-A03；JU02-A04；CUR:T04 | B |
|
||||
| `PA-043` | T04 添加兄弟姐妹 | 必需 | `C-T-SIBLING` | D033-A05；J061-A04；JU02-A05；CUR:T04 | B |
|
||||
| `PA-044` | T04 添加儿子 | 必需 | `C-T-CHILD` | D033-A07；J061-A05；JU02-A06；CUR:T04 | B |
|
||||
| `PA-045` | T04 添加女儿 | 必需 | `C-T-CHILD` | D033-A08；J061-A05；JU02-A07〔`addSon` 反例〕；CUR:T04 | B |
|
||||
| `PA-046` | T06 原子调整同辈排行 | 必需 | `C-T-RANK` | D033-A06；D036-A02；!J060-A02；J061-A08；CUR:T06 | B |
|
||||
| `PA-047` | T-BIND 邀请并绑定人物与账号 | 必需 | `C-T-BIND-INVITE/C-T-BIND-IDENTITY/C-T-BIND-MUTATION/C-T-BIND-RESULT` | D033-A09；D034-A03；D036-A01；J058-A02；!J060-A01 | B |
|
||||
| `PA-048` | T05 编辑人物资料及头像；R02 编辑入口只委托本 owner | 必需 | `C-T-EDIT/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` | D033-A10；D034-A04；D036-A02；D038-A01；!D038-A02〔扩展隐私字段〕；J046-A03；!J060-A02/A03；!J061-A06〔通用人物新建〕；J061-A07；JU02-A08；CUR:T05；CUR:R02 | B |
|
||||
| `PA-049` | T07 查看/搜索世系人物目录；R01 为独立展示状态 | 必需 | `C-T-LIST` | D031-A01/A02；J062-A01；CUR:T07；CUR:R01 | B |
|
||||
| `PA-050` | T08 查看人物/成员状态 | 必需 | `C-T-LIST/C-G-MEMBER-READ` | D034-A01〔未绑定态〕；CUR:T08 | B |
|
||||
| `PA-051` | T05 停用世系人物 | 候选 | `C-T-DELETE` | J046-A04；JU02-A10 | NA |
|
||||
| `PA-052` | T01 使用表格式世系辅助模式 | 候选 | `C-T-TREE` | D030-A01〔表格态〕；J045-A01〔递归态〕 | NA |
|
||||
|
||||
### 8.4 F 家族内容：PA-053—PA-082
|
||||
|
||||
| PA | 唯一 owner / 产品动作 | 边界 | 合同键 | 来源证据反链 | 初始 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| `PA-053` | F01 查看家族动态列表 | 必需 | `C-F-FEED-READ` | D051-A01/A02；J043-A01；CUR:F01 | B |
|
||||
| `PA-054` | F03 查看动态详情 | 必需 | `C-F-FEED-READ` | D051-A01/A02〔动态内容态〕；CUR:F03 | B |
|
||||
| `PA-055` | F02 发布文字/图片动态 | 必需 | `C-F-FEED-WRITE/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` | D029-A01；D051-A04；J044-A01/A02；CUR:F02 | B |
|
||||
| `PA-056` | F02 唯一编辑 owner 编辑动态；F03 仅提供入口 | 必需 | `C-F-FEED-WRITE` | CUR:F02；入口 CUR:F03 | P |
|
||||
| `PA-057` | F03 删除动态 | 必需 | `C-F-FEED-WRITE` | J043-A04 | P |
|
||||
| `PA-058` | F03 点赞/取消点赞 | 必需 | `C-F-FEED-WRITE` | 当前 feed 合同；CUR:F03 | P |
|
||||
| `PA-059` | F03 评论或回复动态 | 必需 | `C-F-COMMENT-READ/C-F-COMMENT-WRITE` | D051-A03；J043-A02/A03 | B |
|
||||
| `PA-060` | F03 删除本人评论 | 必需 | `C-F-COMMENT-WRITE` | 当前评论合同；CUR:F03 | P |
|
||||
| `PA-061` | F01 置顶动态 | 候选 | `C-F-FEED-MODERATION` | D029-A02 | NA |
|
||||
| `PA-062` | F01 加精动态 | 候选 | `C-F-FEED-MODERATION` | D029-A03 | NA |
|
||||
| `PA-063` | F04 浏览谱文分类与列表 | 必需 | `C-F-ARTICLE` | D047-A01/A02；J010-A01；J011-A01；CUR:F04 | P |
|
||||
| `PA-064` | F05 阅读谱文详情 | 必需 | `C-F-ARTICLE` | D048-A01；J012-A01〔独立详情态〕；J013-A03；CUR:F05 | P |
|
||||
| `PA-065` | F06 新建谱文 | 必需 | `C-F-ARTICLE/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` | D048-A02；D057-A01；J013-A01；CUR:F06 | B |
|
||||
| `PA-066` | F06 编辑谱文 | 必需 | `C-F-ARTICLE/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` | D048-A02；D057-A01；J013-A02；CUR:F06 | B |
|
||||
| `PA-067` | F05 唯一删除 owner 删除谱文；F04 仅提供入口 | 必需 | `C-F-ARTICLE` | J011-A03；CUR:F05 | P |
|
||||
| `PA-068` | F04 增改删谱文分类 | 候选 | `C-F-ARTICLE-CATEGORY-WRITE` | D046-A01 | NA |
|
||||
| `PA-069` | F05 设置、校验或重置谱文访问密码；获批前不启用 | 候选 | `C-S-CONTENT-LOCK` | J011-A02；J014-A01 | NA |
|
||||
| `PA-070` | F07 查看相册列表 | 必需 | `C-F-ALBUM` | D058-A01/A03；J015-A01；CUR:F07 | P |
|
||||
| `PA-071` | F07 新建相册 | 必需 | `C-F-ALBUM` | D058-A02；D059-A01；J016-A01 | P |
|
||||
| `PA-072` | F07 编辑相册资料/封面 | 必需 | `C-F-ALBUM/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` | D003-A01；D045-A04；J018-A01 | B |
|
||||
| `PA-073` | F07 删除相册 | 必需 | `C-F-ALBUM` | D003-A02 | P |
|
||||
| `PA-074` | F08 查看并预览相册照片 | 必需 | `C-F-PHOTO-READ/C-S-FILE-READ` | D045-A01/A02；J017-A01；CUR:F08 | B |
|
||||
| `PA-075` | F09 上传文件并新增照片记录 | 必需 | `C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ/C-F-PHOTO-WRITE` | D045-A03；J017-A02；CUR:F09 | B |
|
||||
| `PA-076` | F08 删除照片 | 必需 | `C-F-PHOTO-WRITE` | J017-A03 | P |
|
||||
| `PA-077` | F10 查看家族视频列表 | 必需 | `C-F-VIDEO-READ` | D044-A01；J021-A01；CUR:F10 | B |
|
||||
| `PA-078` | F10 播放/查看视频详情 | 必需 | `C-F-VIDEO-READ` | D044-A02；J021-A02；J024-A01〔全局 URL 反例〕 | B |
|
||||
| `PA-079` | F10 发布视频 | 候选 | `C-F-VIDEO-WRITE/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` | D007-A01；D044-A04；J022-A01/A02 | NA |
|
||||
| `PA-080` | F10 编辑视频 | 候选 | `C-F-VIDEO-WRITE/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` | D044-A03〔管理入口〕；J022-A02 | NA |
|
||||
| `PA-081` | F10 删除视频 | 候选 | `C-F-VIDEO-READ/C-F-VIDEO-DELETE` | D002-A01；J021-A03 | NA |
|
||||
| `PA-082` | F10 纵滑短视频浏览/播放模式 | 候选 | `C-F-VIDEO-READ` | J072-A01；J074-A01@browse；JX001-A01；JU03-A01；JU04-A01/A02；JU05-A01/A02；JU06-A01/A02；!J072-A05；!J074-A02；!JU05-A05；!JU06-A05 | NA |
|
||||
|
||||
### 8.5 R 人物与族务：PA-083—PA-124
|
||||
|
||||
| PA | 唯一 owner / 产品动作 | 边界 | 合同键 | 来源证据反链 | 初始 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| `PA-083` | R03 查看/筛选人情往来记录 | 必需 | `C-R-RELATIVE` | D021-A01；D022-A01〔管理态〕；J034-A01；CUR:R03 | P |
|
||||
| `PA-084` | R04 查看人情记录详情 | 必需 | `C-R-RELATIVE` | J035-A01；CUR:R04 | P |
|
||||
| `PA-085` | R04 新建人情记录 | 必需 | `C-R-RELATIVE` | D021-A02；D023-A01；J036-A01；CUR:R04 | P |
|
||||
| `PA-086` | R04 编辑人情记录 | 必需 | `C-R-RELATIVE` | D023-A01；J036-A02；CUR:R04 | P |
|
||||
| `PA-087` | R04 唯一删除 owner 删除人情记录；R03 仅提供入口 | 必需 | `C-R-RELATIVE` | D022-A02；J034-A02；CUR:R04 | P |
|
||||
| `PA-088` | R05 查看祭祀/礼仪列表 | 必需 | `C-R-CEREMONY` | CUR:R05 | P |
|
||||
| `PA-089` | R06 查看祭祀/礼仪详情 | 必需 | `C-R-CEREMONY` | D037-A01〔通用长文状态，入口决定 owner〕；CUR:R06 | P |
|
||||
| `PA-090` | R07 新建祭祀/礼仪 | 必需 | `C-R-CEREMONY` | CUR:R07 | P |
|
||||
| `PA-091` | R07 编辑祭祀/礼仪 | 必需 | `C-R-CEREMONY` | CUR:R07 | P |
|
||||
| `PA-092` | R06 唯一删除 owner 删除祭祀/礼仪；R05 仅提供入口 | 必需 | `C-R-CEREMONY` | 当前 ceremony 合同；CUR:R06 | P |
|
||||
| `PA-093` | R06 查看祭祀献礼 | 必需 | `C-R-CEREMONY` | 当前 gifts 合同 | P |
|
||||
| `PA-094` | R06 新增祭祀献礼 | 必需 | `C-R-CEREMONY` | 当前 gifts 合同；CUR:R06 | P |
|
||||
| `PA-095` | R06 删除祭祀献礼 | 必需 | `C-R-CEREMONY` | 当前 gifts 合同；CUR:R06 | P |
|
||||
| `PA-096` | R08 查看/筛选成长记录 | 必需 | `C-R-GROWTH` | D017-A01/A02〔普通态〕；D019-A01〔管理态〕；J031-A01〔旧入口〕；J070-A01〔人物/分类态〕；J071-A01/A02〔分类态〕；CUR:R08 | P |
|
||||
| `PA-097` | R08 查看成长记录详情 | 必需 | `C-R-GROWTH` | D018-A01；J031-A03；J032-A01 | P |
|
||||
| `PA-098` | R08 新建成长记录 | 必需 | `C-R-GROWTH` | D017-A03；D020-A01；J033-A01/A03；J070-A04 | P |
|
||||
| `PA-099` | R08 编辑成长记录 | 必需 | `C-R-GROWTH` | J033-A02 | P |
|
||||
| `PA-100` | R08 删除成长记录 | 必需 | `C-R-GROWTH` | D019-A02；J031-A02；J070-A03；!J071-A03〔错位逻辑〕 | P |
|
||||
| `PA-101` | R08 选择成长记录对应人物 | 必需 | `C-T-LIST/C-R-GROWTH` | D036-A01/A03；J062-A01 | B |
|
||||
| `PA-102` | R08 设置、校验或重置成长记录访问密码 | 候选 | `C-S-CONTENT-LOCK` | J014-A02；J070-A02 | NA |
|
||||
| `PA-103` | R10 查看备忘录列表 | 必需 | `C-R-MEMO` | D024-A01；J037-A01；CUR:R10 | P |
|
||||
| `PA-104` | R10 查看备忘详情 | 必需 | `C-R-MEMO` | J038-A03；J039-A01 | P |
|
||||
| `PA-105` | R10 新建备忘 | 必需 | `C-R-MEMO` | D024-A02；J038-A01 | P |
|
||||
| `PA-106` | R10 编辑备忘 | 必需 | `C-R-MEMO` | J038-A02 | P |
|
||||
| `PA-107` | R10 删除备忘 | 必需 | `C-R-MEMO` | J037-A02 | P |
|
||||
| `PA-108` | R11 查看功德记录 | 必需 | `C-R-MERIT-BASE` | D008-A01〔普通态〕；D009-A01〔管理态〕；J025-A01；CUR:R11 | P |
|
||||
| `PA-109` | R11 新增功德记录 | 必需 | `C-R-MERIT-BASE/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` | D056-A01；J026-A01 | B |
|
||||
| `PA-110` | R11 删除功德记录 | 必需 | `C-R-MERIT-BASE` | D009-A02；J025-A02 | P |
|
||||
| `PA-111` | R11 查看独立功德详情 | 候选 | `C-R-MERIT-DETAIL` | D008-A02〔进入管理/详情证据〕；J026-A03；J027-A01 | NA |
|
||||
| `PA-112` | R11 编辑功德记录 | 候选 | `C-R-MERIT-EDIT` | J026-A02 | NA |
|
||||
| `PA-113` | R09 查看/管理人生事件 | 必需 | `C-R-LIFE` | D055-A01；CUR:R09 | B |
|
||||
| `PA-114` | R-DOCUMENT 查看重要证件列表 | 候选 | `C-R-DOCUMENT` | J019-A01 | NA |
|
||||
| `PA-115` | R-DOCUMENT 查看重要证件详情 | 候选 | `C-R-DOCUMENT` | J019-A01〔列表进入详情状态〕 | NA |
|
||||
| `PA-116` | R-DOCUMENT 新建重要证件 | 候选 | `C-R-DOCUMENT/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` | J020-A01/A02 | NA |
|
||||
| `PA-117` | R-DOCUMENT 编辑重要证件 | 候选 | `C-R-DOCUMENT/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` | J020-A01/A02 | NA |
|
||||
| `PA-118` | R-DOCUMENT 删除重要证件 | 候选 | `C-R-DOCUMENT` | J019-A03 | NA |
|
||||
| `PA-119` | R-DOCUMENT 校验或重置证件访问密码 | 候选 | `C-S-CONTENT-LOCK` | J014-A03；J019-A02 | NA |
|
||||
| `PA-120` | R-GREETING 查看/筛选贺礼邀请列表 | 候选 | `C-R-GREETING` | D013-A01/A02；D014-A01〔管理态〕；J028-A01/A02 | NA |
|
||||
| `PA-121` | R-GREETING 查看贺礼邀请详情 | 候选 | `C-R-GREETING` | D015-A01；J029-A01；D037-A01〔通用详情态〕 | NA |
|
||||
| `PA-122` | R-GREETING 新建贺礼邀请 | 候选 | `C-R-GREETING` | D013-A03；D016-A01；J030-A01/A03 | NA |
|
||||
| `PA-123` | R-GREETING 编辑贺礼邀请 | 候选 | `C-R-GREETING` | D016-A01；J030-A02/A04 | NA |
|
||||
| `PA-124` | R-GREETING 删除贺礼邀请 | 候选 | `C-R-GREETING` | D014-A02；J028-A03 | NA |
|
||||
|
||||
### 8.6 N 消息：PA-125—PA-131
|
||||
|
||||
| PA | 唯一 owner / 产品动作 | 边界 | 合同键 | 来源证据反链 | 初始 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| `PA-125` | N01 查看通知活动集合，并由 G01/M01 消费同一未读计数 owner | 必需 | `C-N-LIST/C-N-UNREAD-COUNT` | D052-A01；J047-A01〔混排反例〕；CUR:N01；CUR:G01；CUR:M01 | B |
|
||||
| `PA-126` | N01 标记单条通知已读 | 必需 | `C-N-READ-ONE` | 当前通知合同；CUR:N01 | B |
|
||||
| `PA-127` | N01 全部标记已读 | 必需 | `C-N-READ-ALL` | D052-A02；CUR:N01 | B |
|
||||
| `PA-128` | N02 查看通知详情 | 必需 | `C-N-DETAIL-SAME-SESSION/C-N-DETAIL-COLD-START` | D052-A04；J048-A01；CUR:N02 | B |
|
||||
| `PA-129` | N01 从通知安全回流目标业务页 | 必需 | `C-N-LIST/C-N-DETAIL-COLD-START` | D052-A03/A04；J047-A02；!J047-A03 | B |
|
||||
| `PA-130` | N02 查看广告/宣传消息详情 | 候选 | `C-N-DETAIL-SAME-SESSION/C-N-DETAIL-COLD-START/C-M-PROMO` | J075-A01 | NA |
|
||||
| `PA-131` | N01 支持生日、疫苗、备忘等类型化提醒 | 候选 | `C-N-TYPED-REMINDER` | D055-A01 | NA |
|
||||
|
||||
### 8.7 M 我的：PA-132—PA-160
|
||||
|
||||
| PA | 唯一 owner / 产品动作 | 边界 | 合同键 | 来源证据反链 | 初始 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| `PA-132` | M01 查看“我的”主页和本人资料摘要 | 必需 | `C-A-PROFILE-READ` | D053-A01；J049-A01；JU07-A01〔另一布局态〕；CUR:M01 | B |
|
||||
| `PA-133` | M02 编辑本人资料及头像 | 必需 | `C-A-PROFILE-READ/C-A-PROFILE-WRITE/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` | J061-A01；CUR:M02 | B |
|
||||
| `PA-134` | M03 查看安全设置入口及脱敏绑定信息 | 必需 | `C-A-PROFILE-READ` | D053-A04；J051-A01；JU07-A04；CUR:M03 | B |
|
||||
| `PA-135` | M04 修改登录密码 | 必需 | `C-A-PASSWORD-CHANGE` | J052-A01；CUR:M04 | B |
|
||||
| `PA-136` | M05 换绑手机号 | 必需 | `C-A-TAC-API/C-A-TAC-A11Y/C-A-PHONE-SEND/C-A-PHONE-CHANGE` | J068-A01；CUR:M05 | B |
|
||||
| `PA-137` | M06 浏览/搜索帮助分类与列表 | 必需 | `C-M-HELP-LIST` | D039-A01/A02；J050-A01/A02；J064-A01；JU07-A03；CUR:M06 | B |
|
||||
| `PA-138` | M06 阅读帮助文章 | 必需 | `C-M-HELP-LIST` | D040-A01；D037-A01〔通用长文态〕；J057-A01；J065-A02 | B |
|
||||
| `PA-139` | M07 提交反馈 | 必需 | `C-M-FEEDBACK` | D042-A01；D053-A03〔反馈入口〕；J053-A01；JU07-A02；CUR:M07 | P |
|
||||
| `PA-140` | M07 查看本人反馈记录 | 必需 | `C-M-FEEDBACK` | 当前 feedback GET；CUR:M07 | P |
|
||||
| `PA-141` | M-PROMO 查看 APP 推广内容 | 候选 | `C-M-PROMO` | D053-A02；J049-A02；J054-A01 | NA |
|
||||
| `PA-142` | M-PROMO 分享应用 | 候选 | `C-M-PROMO/C-S-PLATFORM-SHARE` | D041-A01；J054-A02；!旧跳转创建家谱 | NA |
|
||||
| `PA-143` | M-PROMO 展示/复制 APP 推广推荐码或二维码 | 候选 | `C-M-REFERRAL/C-M-PROMO/C-S-PLATFORM-CLIPBOARD` | J066-A01/A02 | NA |
|
||||
| `PA-144` | M-PROMO 展示邀请奖励或积分 | 候选 | `C-M-REWARD` | D041-A02 | NA |
|
||||
| `PA-145` | M09 查看 VIP 套餐 | 必需 | `C-M-VIP-READ` | J055-A01；CUR:M09 | P |
|
||||
| `PA-146` | M09 创建 VIP 订单 | 必需 | `C-M-VIP-ORDER` | J055-A02；CUR:M09 | B |
|
||||
| `PA-147` | M09 查看 VIP 订单记录 | 必需 | `C-M-VIP-READ` | J056-A01；CUR:M09 | P |
|
||||
| `PA-148` | M09 支付并确认 VIP 最终结果 | 候选 | `C-M-VIP-PAY` | J055-A02；J056-A01〔假成功页反例〕 | NA |
|
||||
| `PA-149` | M10 查看关于、协议、版本信息 | 必需 | `C-LOCAL` | D053-A05；J051-A02；J065-A02；CUR:M10 | P |
|
||||
| `PA-150` | M10 唯一会话 owner 安全退出登录；M01/M03 仅提供入口 | 必需 | `C-A-LOGOUT` | D053-A06；JU07-A05；CUR:M10 | B |
|
||||
| `PA-151` | M03 注销账号 | 候选 | `C-A-DEACTIVATE/C-A-SMS-SEND` | J049-A03 | NA |
|
||||
| `PA-152` | M-MONEY 查看余额和资金流水 | 候选 | `C-M-MONEY` | J076-A01/A02 | NA |
|
||||
| `PA-153` | M-MONEY 提交提现申请及收款码 | 候选 | `C-M-MONEY/C-S-FILE-BINARY-WRITE/C-S-FILE-REFERENCE-WRITE/C-S-FILE-READ` | J076-A03；J077-A01—A03；!J077-A04 | NA |
|
||||
| `PA-154` | M-MONEY 查看提现记录和状态 | 候选 | `C-M-MONEY` | J078-A01 | NA |
|
||||
| `PA-155` | M-PROMO 调起平台分享并承接变现资格/结果 | 候选 | `C-M-MONEY/C-M-PROMO/C-S-PLATFORM-SHARE` | J066-A04 | NA |
|
||||
| `PA-156` | M-PROMO 查看广告/宣传视频 | 候选 | `C-M-PROMO-VIDEO` | J001-A04；J023-A01；J049-A02〔广告/视频混排反例〕；J073-A01；!J073-A03〔旧接口〕 | NA |
|
||||
| `PA-157` | M08 幂等签发家谱邀请票据并在结果未知时恢复权威状态 | 必需 | `C-G-INVITE-ISSUE/C-G-INVITE-LIST` | !J006-A01〔空壳反例〕；CUR:M08 | B |
|
||||
| `PA-158` | M08 显示、复制并系统分享当前活动家谱邀请票据 | 必需 | `C-G-INVITE-LIST/C-S-PLATFORM-CLIPBOARD/C-S-PLATFORM-SHARE` | CUR:M08 | B |
|
||||
| `PA-159` | M08 撤销活动家谱邀请票据并收敛竞态/未知结果 | 必需 | `C-G-INVITE-REVOKE/C-G-INVITE-LIST` | CUR:M08 | B |
|
||||
| `PA-160` | M-PROMO 经官方 allowlist 打开应用下载页 | 候选 | `C-M-PROMO/C-S-SAFE-EXTERNAL-OPEN` | J066-A03 | NA |
|
||||
|
||||
### 8.8 F/M 视频互动追加候选：PA-161—PA-166
|
||||
|
||||
这些动作追加在账本末尾，是因为交叉评审发现旧 PA-082 把浏览、评论、点赞、分享误并到读取合同，且宣传视频不能借家族视频 owner；稳定 PA 不回收、不重排。
|
||||
|
||||
| PA | 唯一 owner / 产品动作 | 边界 | 合同键 | 来源证据反链 | 初始 |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| `PA-161` | F10 查看/发表短视频评论 | 候选 | `C-F-VIDEO-COMMENT` | J072-A02；J074-A01@comment；JU05-A03；JU06-A03 | NA |
|
||||
| `PA-162` | F10 点赞/取消点赞短视频 | 候选 | `C-F-VIDEO-REACTION` | J072-A03；JU05-A04@reaction；JU06-A04@reaction | NA |
|
||||
| `PA-163` | F10 系统分享短视频 | 候选 | `C-F-VIDEO-READ/C-S-PLATFORM-SHARE` | J072-A04；JU05-A04@share；JU06-A04@share | NA |
|
||||
| `PA-164` | M-PROMO 查看/发表宣传视频评论 | 候选 | `C-M-PROMO-VIDEO-COMMENT` | J073-A02@comment | NA |
|
||||
| `PA-165` | M-PROMO 点赞/取消点赞宣传视频 | 候选 | `C-M-PROMO-VIDEO-REACTION` | J073-A02@reaction | NA |
|
||||
| `PA-166` | M-PROMO 系统分享宣传视频 | 候选 | `C-M-PROMO-VIDEO/C-S-PLATFORM-SHARE` | J073-A02@share | NA |
|
||||
|
||||
### 8.9 共享门禁、状态变体与冻结计数
|
||||
|
||||
共享门禁不是额外的用户产品动作，不增加 PA 分母，但所有相关 PA 必须通过：
|
||||
|
||||
| 门禁 owner | 完成前置 |
|
||||
| --- | --- |
|
||||
| `S-ID` | 全部 ID 使用安全十进制字符串 wire |
|
||||
| `S-PERM` | 服务端 capability、撤权刷新和 403 语义 |
|
||||
| `S-FILE` | 选择/上传、业务引用、访问 URL、重进显示 |
|
||||
| `S-REGION` | 行政区划和 `regionCode` |
|
||||
| `S-SESSION` | 会话持久化、失效、账号切换和迟到响应隔离 |
|
||||
| `S-NAV` | route key、必填参数、返回与根切换 |
|
||||
| `S-A11Y` | 触控、字号、焦点、读屏和系统返回 |
|
||||
|
||||
PA 是产品动作分母，状态变体是独立验收分母。已知跨路由复用与 N02 状态先冻结为：
|
||||
|
||||
| 状态 ID | 入口与条件 | `contractState` | `dataMode` | `productCompletion` |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| `PA-038-S01` | 从 T01/T07 进入 T03 查看人物资料 | `CONTRACT_CONFLICT` | `LOCAL_PREVIEW` | `BLOCKED` |
|
||||
| `PA-038-S02` | 从 F01→R01→R02 的人物录上下文查看同一人物资料 | `CONTRACT_CONFLICT` | `LOCAL_PREVIEW` | `BLOCKED` |
|
||||
| `PA-048-S01` | T03 进入 T05 编辑；T05 是唯一 mutation owner | `CONTRACT_CONFLICT` | `LOCAL_PREVIEW` | `BLOCKED` |
|
||||
| `PA-048-S02` | R02 的编辑入口只导航 T05，不在 R02 本地保存或报成功 | `CONTRACT_CONFLICT` | `CLOSED` | `BLOCKED` |
|
||||
| `PA-049-S01` | T01 进入 T07 世系成员目录 | `CONTRACT_CONFLICT` | `LOCAL_PREVIEW` | `BLOCKED` |
|
||||
| `PA-049-S02` | F01 进入 R01 人物录，并保留 R01→R02→R01 返回现场 | `CONTRACT_CONFLICT` | `LOCAL_PREVIEW` | `BLOCKED` |
|
||||
| `PA-125-S01` | N01 读取通知活动集合 | `CONTRACT_CONFLICT` | `LOCAL_PREVIEW` | `BLOCKED` |
|
||||
| `PA-125-S02` | G01 显示共享未读计数；不得从分页列表长度推断 | `MISSING_OPERATION` | `CLOSED` | `BLOCKED` |
|
||||
| `PA-125-S03` | M01 显示同一共享未读计数；账号切换后必须失效 | `MISSING_OPERATION` | `CLOSED` | `BLOCKED` |
|
||||
| `PA-128-S01` | 从 N01 当前会话、且完整列表项快照仍在时打开 | `CONTRACT_CONFLICT` | `LOCAL_PREVIEW` | `PARTIAL` |
|
||||
| `PA-128-S02` | 冷启动、进程重启、外部深链或快照丢失 | `MISSING_OPERATION` | `CLOSED` | `BLOCKED` |
|
||||
|
||||
R02 现存的“通用新建人物本地预览”和 T06 现存的“关系修正本地预览”不是已批准 PA：二者均不得保存、造 ID、改列表或显示成功；本轮分别关闭/移除，不能偷换成 T04 关系新增、G03 首人创建或 PA-046 排行。用户以后若明确需要独立创建人物或关系修正，必须重新规划独立产品动作及原子合同。
|
||||
|
||||
其他外观相似、同路由或同动作来源也按 `PA-xxx-Snn` 追加独立状态验收记录；只有入口、对象、数据、接口、权限、动作和返回行为全部证明等价时才能复用状态实现，不能删除来源状态 ID 或减少验收分母。规划阶段的 `P/PARTIAL` 只说明当前存在结构或 `LOCAL_PREVIEW`，不代表动作是 LIVE，也不能绕过 `C-S-ID/C-S-CAPABILITY` 等共享冲突。
|
||||
|
||||
冻结计数为：
|
||||
|
||||
- `productActionsTotal=166`；
|
||||
- `requiredActions=111`，进入产品完成分母；
|
||||
- `candidateActions=55`，用户未单独批准时不进入完成分母；
|
||||
- `approvedCandidateActions=0`；
|
||||
- 规划阶段 `completeRequiredActions=0`、`partialRequiredActions=42`、`blockedRequiredActions=69`、`notApplicableCandidateActions=55`。
|
||||
|
||||
候选日后获批只改变边界和完成态，不创建新 PA ID；用户拒绝的候选也保留 ID 与拒绝记录，不删除或重排。
|
||||
|
||||
## 九、甄别分母与确认后冻结方式
|
||||
|
||||
当前源证据共拆出 341 条动作记录：
|
||||
|
||||
| 结论 | 设计源 | 完成项目活动/注释路由 | 未注册文件 | 合计 |
|
||||
| --- | ---: | ---: | ---: | ---: |
|
||||
| 直接采用 | 0 | 0 | 0 | 0 |
|
||||
| 改造后采用 | 86 | 75 | 0 | 161 |
|
||||
| 仅参考交互 | 19 | 26 | 26 | 71 |
|
||||
| 后端缺失，暂时关闭 | 15 | 18 | 0 | 33 |
|
||||
| 与当前产品冲突，明确舍弃 | 5 | 17 | 3 | 25 |
|
||||
| 待用户确认 | 14 | 36 | 1 | 51 |
|
||||
| 合计 | 139 | 172 | 30 | 341 |
|
||||
|
||||
这里的 341 是“源状态动作记录”，不是 341 个已经判定互不相同或已经判定重复的产品功能。多个截图和旧页面可能是独立状态，也可能在证据充分后共用同一个实现 owner。
|
||||
|
||||
`D001-A01` 与 `D055-A01` 是全部 PA 继承的全局覆盖目录；`D001-A02`、`D055-A02—A04` 是非本仓库端形态，统一作为全局冲突舍弃证据；`J003-A01` 是纯日期时间选择演示，统一作为全局冲突舍弃证据。`J003` 是唯一不生成 PA 反链的源基 ID；上述全局动作仍必须进入 341 条来源证据计数，不能用全局规则掩盖其他逐动作遗漏。
|
||||
|
||||
本次交给用户确认的证据与产品动作范围分别冻结为：
|
||||
|
||||
- `referenceEvidenceRecords=341`；
|
||||
- `adaptedReferenceEvidenceRecords=161`，只是“改造后采用”的来源证据数量，不是产品动作分母；
|
||||
- `interactionEvidenceRecords=71`，只增加独立交互/状态验收证据，不新增数据合同；
|
||||
- `closedReferenceEvidenceRecords=33`；
|
||||
- `rejectedReferenceEvidenceRecords=25`；
|
||||
- `pendingReferenceEvidenceRecords=51`，已反链到候选 PA，用户未单独批准时不进入实现范围；
|
||||
- `productActionsTotal=166`、`requiredActions=111`、`candidateActions=55`、`approvedCandidateActions=0`；
|
||||
- `approvedNewRoutes=0`，当前提案全部先落现有 owner 或诚实关闭。
|
||||
|
||||
用户确认后，执行第 0 批只能：
|
||||
|
||||
1. 重算源文件、活动/注释路由与未注册文件清单，确认 341 条状态动作记录未因源变化失效；
|
||||
2. 原样冻结 PA-001—PA-166、111 个必需动作、55 个候选动作及全部来源反链；执行阶段不得再归并、拆分、删除或重排 PA；
|
||||
3. 对已证明等价的状态动作可共用实现 owner，但每个来源状态 ID 仍保留独立验收记录；新发现的角色/数据/权限/错误状态追加 `PA-xxx-Snn`，不能覆盖既有状态或改变产品动作身份；
|
||||
4. “待用户确认”若本次仍无单独选择，一律维持候选 PA 的 `NOT_APPLICABLE`，不新增路由；
|
||||
5. 分别报告路由分母、`requiredActions=111`、`liveCompletedActions`、逐 PA 四字段和 341 条来源证据去向，不得把来源证据条数、代码复用或结构遍历充当产品完成率；
|
||||
6. 任一参考动作即使关闭态检查通过，其必需 PA 的 `productCompletion` 仍可为 `BLOCKED`；候选未获批则为 `NOT_APPLICABLE`，不能写成整个项目 PASS。
|
||||
|
||||
## 十、参考项目资产复用索引
|
||||
|
||||
用户已允许把第二参考源中的图标等资产作为当前产品的复用候选。当前只读分母为 `referenceAssetFiles=531`，全部位于 `Jiapu-App\static`，约 6.45 MiB；按声明扩展名为 PNG 307、GIF 221、SVG 2、JPG 1，按文件签名为 PNG 311、GIF 217、SVG 2、JPG 1。已发现 6 个扩展名/MIME 不一致和 14 组完全重复文件。
|
||||
|
||||
资产不会增加或改变 PA 分母。任何文件在复制前必须建立 `RAxxx` 记录并绑定一个已批准 PA 及其目标路由/组件/状态；相似图标、不同选中态、禁用态、权限态或主题态仍分别留证。逐文件字段和来源、隐私、旧品牌、格式、安全、视觉、无障碍、性能、候选构建验收门禁以主计划第 11.10 节为准。
|
||||
|
||||
当前候选分类只用于确定优先甄别顺序，不是逐文件采用结论；在 `RAxxx` 记录通过门禁前，以下各类采用数都仍为 0：
|
||||
|
||||
| 类别 | 例子 | 初始决定 |
|
||||
| --- | --- | --- |
|
||||
| 水墨/宗祠/谱书氛围 | `iconpng/902.png`、`iconpng/z8526@2x.png`、`login/bj.jpg`、`iconpng/book.png` | 优先甄别，尚未形成采用结论；固定文字、裁切、格式和可读性先处理 |
|
||||
| 世系人物卡装饰 | `iconpng/treeBJ.png` | 优先甄别，尚未形成采用结论；若采用优先九宫格或重绘，避免 81×105 小图直接拉伸 |
|
||||
| 中性导航/功能图标 | `icon/index.svg`、`navigation/*`、`tabulation/*`、`pu/*`、`jr.png` | 优先逐文件甄别直接复用或重绘，尚未形成采用结论；必须统一当前图标系统 |
|
||||
| 默认头像风格 | `nan.png`、`nv.png`、`treeman.png` 及尺寸变体 | `待用户确认`具体风格；先过来源、肖像、偏见和重复哈希门禁 |
|
||||
| 水墨蝴蝶动效 | `login/hd*.gif` | 仅作动效方向候选；必须有静态降级、减少动态效果和性能预算 |
|
||||
| QQ 表情、抖音/视频实验、支付/微信/支付宝、VIP/奖励、旧 logo/口号 | `emojis/qq/*`、`douyin/*`、视频实验图、`wx.png`、`zfb.png`、`logo.png` 等 | `与当前产品冲突，明确舍弃`直接迁入；必要时仅参考语义并重绘 |
|
||||
|
||||
规划确认时固定：
|
||||
|
||||
- `referenceAssetFiles=531`；
|
||||
- `approvedDirectReuseAssets=0`；
|
||||
- `approvedAdaptReuseAssets=0`；
|
||||
- `assetReuseAuthorization=USER_ALLOWED_WITH_PER_FILE_GATES`。
|
||||
|
||||
收到“开始执行”后，采用数只能随已完成门禁的 `RAxxx` 增加；不能整目录复制，不能用资产存在反向启用 F10、支付、邀请奖励等关闭或候选功能，也不能迁移旧组件、样式或外部资源地址。
|
||||
+451
-124
@@ -1,36 +1,117 @@
|
||||
# 今晚全量联调与明早测试执行计划
|
||||
|
||||
> 修订日期：2026-07-24（北京时间）
|
||||
> 时间口径：“今晚”固定指 2026-07-23 晚间，“明早”固定指 2026-07-24 上午。
|
||||
> 当前状态：用户已明确说“开始执行”，实施、测试与 MuMu 基座联调已启动；用户将本轮硬截止提前为 `T_due=2026-07-24 08:00`。55 个候选 PA 本轮仍不纳入（`approvedCandidateActions=0`）。
|
||||
|
||||
> 本次续执行状态：逐页 Apifox 账本已覆盖 53 个页面文件；当前页面目录不再导入 `data/mock`。已接线但未实测的创建/维护动作仍统一记为 `DECLARED_UNVERIFIED`；缺 DTO、ID、权限或上传 owner 的页面已改为明确关闭态，不以 fixture、本地数组、timer 或本地成功提示冒充服务端结果。本次续执行只做静态 API 语法和源代码归属核验，未构建、未操作 MuMu、未发起任何真实写入。
|
||||
|
||||
## 0. 已执行记录与人工回归保留
|
||||
|
||||
- 已通过 HBuilderX 标准基座连接 `emulator-5554` 并完成差量编译、同步、启动；本轮不构建或安装独立测试包。
|
||||
- A01 密码登录页已在 MuMu 实机完成账号密码提交、协议勾选和真实供应商 TAC challenge 展示验证；TAC 已改为供应商原生呈现，不再叠加项目标题、主题、按钮或覆盖供应商刷新/关闭控件。
|
||||
- 已自动通过 A01/A04/A05 的认证合同、认证接口映射、短信冷却、TAC renderjs 安全传输、注册后导航和编译审计；原始截图仅保存在本机临时受限目录，仓库不保留账号、手机号、令牌、短信或 TAC 相关截图。
|
||||
- 2026-07-23 20:56 全量夜跑逻辑调度 `208` 项：`PASS=162`、`EXPECTED_BLOCKED=19`、`FAIL=0`、`INFRA_ERROR=27`、`timedOut=0`。27 项均依赖“`localhost:5173` 的 H5 页面 + `127.0.0.1:9222` 的 Chrome 调试页”；临时 H5 服务可启动，但当前执行环境拒绝启动 Chrome 调试端口，故夜跑器已将这组前置条件显式标为 `H5_CHROME_RUNTIME_UNAVAILABLE`，不将其写成产品失败或通过。临时 H5 服务已停止。
|
||||
- 2026-07-23 23:01 HBuilderX 5.07 已通过标准基座向 `emulator-5554` 完成最新差量编译；控制台末次记录为“项目 jiapuapp 编译成功”。未生成或安装独立测试包。
|
||||
- 同轮 Apifox 合同收紧后的最小验证已通过：`compile-audit`、`navigation-flow-contract`、`t04-relative-remote-close-contract`、`t05-member-remote-close-contract`、`lineage-write-apifox-contract`、`t03-t08-member-flow-contract`、`tree-member-fixture-runtime-smoke`。新增 Apifox 写入合同脚本尚未纳入 20:56 的历史全量夜跑，后续全量统计须重新计算，不得沿用 `208` 作为最新 inventory。
|
||||
- 2026-07-23 23:29 已移除 T01 旧固定底部抽屉；点击头像人物卡现在直接打开唯一人物操作面板，面板中央头像可进入 T03，十个入口仍由同一 `selected` 人物上下文承载。相关 T01 面板、视觉、导航、文档流与编译审计已通过；23:28 的 HBuilderX 标准基座差量编译同样成功，未生成或安装独立测试包。
|
||||
- 2026-07-23 23:37 已按 Apifox 的已登录改密 owner 接通 M04：`PUT /genealogy/app/auth/password`、`oldPassword/newPassword` 32 位 MD5 摘要、鉴权与 APP `clientId` 由统一请求层持有。页面移除“仅本地校验、不提交”伪流程，成功/明确失败/离页取消均有对应状态；本轮不实际修改测试账号密码，真实调用与密码恢复保留人工窗口。
|
||||
- 2026-07-23 23:42 已按 Apifox 的已登录退出 owner 接通 M10：REMOTE 模式使用 `DELETE /genealogy/app/auth/logout`，无请求体，鉴权与 APP `clientId` 继续由统一请求层持有；严格成功才可确认远端已响应。无论请求失败、取消或结果未知，本机会话均安全清理并回到 A01，不自动重试、不把失败写成服务端已退出。本轮未对测试账号发送该敏感请求。M10、M04 的静态契约、页面归属、导航和编译审计均已通过；23:42 HBuilderX 标准基座差量编译成功，未生成或安装独立测试包。
|
||||
- 2026-07-23 23:50 当前源码的全量夜跑已完整执行 `209/209`：`PASS=163`、`EXPECTED_BLOCKED=19`、`FAIL=0`、`INFRA_ERROR=27`、`timedOut=0`、`NOT_RUN=0`。库存为 `baselineInventoryTests=204` 加本轮 `newExecutableTests=5`。27 项均是需 `localhost:5173` 页面及 `127.0.0.1:9222` Chrome 调试页的 H5 运行时检查，统一记 `H5_CHROME_RUNTIME_UNAVAILABLE`，不写成产品失败或通过；因此本轮尚无可冻结候选。T01 唯一操作面板替换造成的五项旧断言/孤儿资产偏差已外科式收口并重跑通过。23:50 HBuilderX 5.07 标准基座差量编译成功，未生成或安装独立测试包。
|
||||
- 2026-07-24 00:00 已从 `emulator-5554` 的 HBuilderX 标准基座读取 A01 实机画面：国风登录页、密码/验证码切换、协议入口、注册/忘记密码与微信登录入口均正常呈现，无白块、截断或覆盖。此检查未输入账号密码、未触发 TAC、短信、注册、找回或任何远端写操作；截图只保留在本机临时受限目录，不入库，也不替代登录后的完整实机验收。
|
||||
- 2026-07-24 00:13 已用 HBuilderX 临时 Web 运行复核 H5 页面服务，`http://localhost:5173` 返回 `200`；但 `127.0.0.1:9222/json/list` 仍超时，当前执行环境不允许启动隔离 Chrome 调试端口。故 27 项 H5 Chrome 运行时检查继续统一记 `H5_CHROME_RUNTIME_UNAVAILABLE`，不改变其测试口径，也不将 H5 服务可达写成浏览器运行时通过。
|
||||
- 2026-07-24 00:30 已在本机临时验收目录建立唯一 `role-seed-matrix.json`：仅登记脱敏测试角色别名、允许动作、人工 TAC/短信阻塞与清理责任，当前对象 ID 为零；不含账号、手机号、密码、令牌、验证码、TAC proof 或原始响应。
|
||||
- 2026-07-24 00:31 已对当前源码重新执行 T0 夜跑：`inventory=209`、`scheduled=25`、`executed=25`、`PASS=6`、`EXPECTED_BLOCKED=19`、`FAIL=0`、`INFRA_ERROR=0`、`timedOut=0`、`notRunScheduled=0`；其余 184 项为本次 T0 未调度项，不得写成已通过。输出仅保存在本机临时验收目录。
|
||||
- 2026-07-24 00:33 已重跑 T01/T03—T08 的 12 项人物流门禁：唯一人物操作面板、树状态/视觉/文档流、成员详情映射、亲属与资料写入合同、排行关闭态、Apifox 写入合同及树 fixture runtime 均通过。此为静态/运行时映射证据，不替代未取得的真实服务端写入响应。
|
||||
- 2026-07-24 00:36 已对受保护的“我的家谱”读取执行无鉴权只读探测：远端可达，HTTP 成功信封内业务码为 `401` 且数据为空。未携带账号、令牌或其他凭据，未发送写请求；后续受保护读取/写入的唯一下一步仍是人工完成 TAC 并建立会话。
|
||||
- 2026-07-24 00:40 已对当前源码完整执行 `ALL` 夜跑 `209/209`：`PASS=163`、`EXPECTED_BLOCKED=19`、`FAIL=0`、`INFRA_ERROR=27`、`timedOut=0`、`NOT_RUN=0`。27 项均在连接 `localhost:5173` 的 Chrome 调试页前被统一标记 `H5_CHROME_RUNTIME_UNAVAILABLE`，没有进入产品断言；不得将它们记为产品失败或通过。输出仅保存在本机临时验收目录。
|
||||
- 2026-07-24 00:45 已再次读取 `emulator-5554` 的 HBuilderX 标准基座 A01 画面：国风背景、密码/验证码切换、手机号与密码输入区、协议入口、注册和找回入口完整可见，无白屏、截断或遮挡。未输入账号、未触发 TAC/短信或远端写操作；截图只保存在本机临时受限目录。
|
||||
- 2026-07-24 00:51 已在 Apifox 的 APP 目录核对“搜索行政区划” operation 为 `GET /genealogy/region/search`，随后以只读请求取得当前部署实证：HTTP `200`、业务码 `200`、服务器 `Date=Thu, 23 Jul 2026 16:51:08 GMT`，单条结果稳定含字符串 `regionCode`、`label`、`parentCode`、`ancestors`、`regionName`、`regionLevel`、`regionType` 与 `leaf`。当前部署的旧 `/genealogy/app/region/search` 同样返回该投影，但 Apifox 的 APP 目录 owner 仍以前者为准；不将双路径同响应静默写成兼容 owner。
|
||||
- 2026-07-24 00:52 已重订 G03 客户端历史门禁：它只校验明确本地预览且不存在虚构的原子 bootstrap、结果查询、错误区域路径或远端请求，已转为可通过并从预期阻塞清单移除。保护 OpenAPI 门禁同时改为只报告实际快照与 Apifox 的合同冲突，不再要求项目实现未声明的 bootstrap。
|
||||
- 2026-07-24 00:55 已对更新后的当前源码再次完整执行 `ALL` 夜跑 `209/209`：`PASS=164`、`EXPECTED_BLOCKED=18`、`FAIL=0`、`INFRA_ERROR=27`、`timedOut=0`、`NOT_RUN=0`。库存仍为 `baselineInventoryTests=204` 加本轮 `newExecutableTests=5`。27 项均因当前执行环境拒绝提供 `127.0.0.1:9222` 的 Chrome 调试运行时而在产品断言前标记为 `H5_CHROME_RUNTIME_UNAVAILABLE`；不记为产品失败或通过。输出仅保存在本机临时验收目录。
|
||||
- 2026-07-24 00:56 已重订 M06 帮助中心的旧 OpenAPI 门禁：不再要求受保护快照提供 `RListHelpArticleVo`、文章分类/标题/纯文本正文等当前 Apifox 未声明的 DTO，也不引入独立详情 owner。门禁现已通过并从预期阻塞清单移除；M06 页面补充“本地使用说明、非服务端文章”的可见来源提示，仍只提供本地说明与 M07 反馈入口，远端列表保持 `DECLARED_UNVERIFIED`。
|
||||
- 2026-07-24 00:57 已对 M06 变更后的当前源码再次完整执行 `ALL` 夜跑 `209/209`：`PASS=165`、`EXPECTED_BLOCKED=17`、`FAIL=0`、`INFRA_ERROR=27`、`timedOut=0`、`NOT_RUN=0`。27 项仍全部为 `H5_CHROME_RUNTIME_UNAVAILABLE`，未进入产品断言；输出仅保存在本机临时验收目录。
|
||||
- 2026-07-24 00:58 HBuilderX 5.07 控制台记录“开始编译…”后输出“项目 jiapuapp 编译成功”，已通过标准基座同步 `emulator-5554`；未生成或安装独立测试包。前台 CLI 未自行退出但对应基座仍正常前台，故只将 IDE 的成功回执计为编译证据，不将 CLI 常驻误记为失败或额外构建。
|
||||
- 2026-07-24 01:04 已读取同步后的 `emulator-5554` 标准基座 A01 画面：登录页完整可见，密码/验证码登录切换、手机号/密码输入、找回、微信、注册与协议入口均无白屏、截断或错位。未输入账号、未勾选协议、未触发 TAC/短信或任何远端写请求；截图只保存在本机临时受限目录。
|
||||
- 2026-07-24 01:08 已重订认证旧 OpenAPI 门禁：密码登录的唯一请求 wire 为 `phone`、MD5 `password` 与 `grantType=password`，原生 TAC 保持客户端前置，不上传 `validToken`；短信发送仍为唯一消费 `validToken` 的认证动作。门禁与认证 API runtime 均通过，并从预期阻塞清单移除。
|
||||
- 2026-07-24 01:10 已对当前源码完整执行 `ALL` 夜跑 `209/209`：`PASS=167`、`EXPECTED_BLOCKED=15`、`FAIL=0`、`INFRA_ERROR=27`、`timedOut=0`、`NOT_RUN=0`。剩余 15 项均为仍缺真实合同、稳定 DTO/权限投影或人工前置的精确阻塞；27 项仍为未取得 `127.0.0.1:9222` Chrome 调试运行时的 `H5_CHROME_RUNTIME_UNAVAILABLE`，未进入产品断言。输出仅保存在本机临时验收目录。
|
||||
- 2026-07-24 01:12 已修复 G03 OpenAPI 门禁以中文计划文件名读取时在 Windows PowerShell 无 BOM 解析下产生的伪阻塞；该门禁现只依据快照/客户端合同判断并通过，也已从预期阻塞清单移除。若同版本快照以后出现错误 owner，仍会以精确 `BLOCKED` 报告。
|
||||
- 2026-07-24 01:20 已再跑最新 T0：`25/25`，`PASS=10`、`EXPECTED_BLOCKED=15`、`FAIL=0`、`INFRA_ERROR=0`、`NOT_RUN=184`。本轮 allowlist 与计划中的 15 条精确阻塞逐项一致；其余 H5 运行时前置只在 `ALL` 中作为基础设施阻塞统计。
|
||||
- 2026-07-24 03:59 已将 M04/M10 的旧快照门禁改为当前 Apifox 已核对客户端接线门禁：M04 校验 `PUT /genealogy/app/auth/password` 的 MD5 body 与取消归属；M10 校验 `DELETE /genealogy/app/auth/logout` 的无 body、取消归属与本机会话兜底。两项均通过并从预期阻塞清单移除；真实改密、服务端退出继续分别保留人工恢复/登录会话验证，未发起任何远端 mutation。随后完整执行 `ALL` 夜跑 `209/209`：`PASS=169`、`EXPECTED_BLOCKED=13`、`FAIL=0`、`INFRA_ERROR=27`、`timedOut=0`、`NOT_RUN=0`。27 项仍均为缺失 `127.0.0.1:9222` Chrome 调试运行时的 `H5_CHROME_RUNTIME_UNAVAILABLE`，未进入产品断言；输出仅保存在本机临时验收目录。
|
||||
- 2026-07-24 04:00 已按更新后的 manifest 再跑 T0：`23/23`，`PASS=10`、`EXPECTED_BLOCKED=13`、`FAIL=0`、`INFRA_ERROR=0`、`NOT_RUN=186`；allowlist 与第 0.2 节的 13 条精确自动阻塞逐项一致。该结果只说明安全/合同候选门禁没有新增失败，不替代人工 TAC、短信、敏感 mutation 或登录后实机闭环。
|
||||
- 早晨人工回归保留：密码登录真实拖动 TAC；短信登录、注册、忘记密码的真实短信与 TAC。不得绕过、猜解或重复请求这些人机/短信步骤。
|
||||
|
||||
### 0.1 明早人工回归最短清单
|
||||
|
||||
1. 使用已启动的 HBuilderX 标准基座进入 A01；不构建或安装独立测试包。
|
||||
2. 人工勾选协议后，在密码登录页使用已单独提供的测试账号发起一次登录；在供应商原生 TAC 中由人工完成拖动，不添加任何项目自定义样式或覆盖层。成功后检查是否进入 G01，并冷启动一次确认会话恢复；不记录或截图凭据、令牌、验证码和 TAC proof。
|
||||
3. 短信登录、注册和忘记密码各自需要真实收码人和原生 TAC：每个场景只在本人在场时发起一次，遵守页面冷却；未能完成即记录“人工 TAC/短信阻塞”，不重试、不猜解、不绕过。
|
||||
4. 换绑手机号、修改密码、注销、支付、提现、删除和退出家谱均不在无人值守阶段执行。若人工验证修改密码，结束后按约定恢复，并只在本机临时脱敏台账登记结果。
|
||||
5. 人工结果只记录页面、动作、时间、四字段结论和非敏感对象 ID；远端返回、手机号、账号、密码、令牌、验证码、TAC proof、邀请码和个人资料一律不进入仓库、文档或截图文件名。
|
||||
|
||||
### 0.2 当前 12 条精确自动阻塞与解除条件
|
||||
|
||||
| 门禁 | 当前阻塞 | 解除条件 |
|
||||
| --- | --- | --- |
|
||||
| Android 认证无障碍 | 原生 TAC 的 TalkBack、键盘与大字号无法由当前自动化可靠判定 | 早晨在 MuMu/真机人工完成原生 TAC 无障碍回归 |
|
||||
| G11 家谱设置 | 依赖的 mine/overview 工作区读取未取得唯一稳定 owner | 先收敛工作区读取合同与真实权限投影 |
|
||||
| G12 字辈诗 | 正常列表、维护列表、批量预览与保存已接线，但尚未获得真实登录会话下的读取/预览/保存响应 | 在人工可观察会话中按“读列表→读维护→预览→保存→维护回读”验证；浏览器 CORS 仅是 H5 环境前置，不替代 APP 业务合同 |
|
||||
| 家谱工作区 | 单家谱 overview owner 在受保护快照中缺失或不唯一 | 以 Apifox 与同版本快照收敛唯一读取路径、DTO 与权限 |
|
||||
| 邀请票据 | 无“我的票据/签发/撤销/接受”当前 operation | 后端提供独立邀请票据闭环，不以普通申请替代 |
|
||||
| 加入申请 | public 搜索/申请 operation 标识与快照不一致 | 后端同版本合同明确查询、提交、撤回、审核及结果语义 |
|
||||
| 世系 locator | 缺少精确定位人物的读取 operation | 后端声明并实测人物定位/恢复读取 owner；不得从列表猜 ID |
|
||||
| 通知读取 | 缺未读数 operation 且列表无稳定通知 DTO | 后端提供未读数与列表 item 的 ID、正文、类型/跳转投影 |
|
||||
| 通知已读状态 | notification ID wire 与 `RVoid` 信封约束不完整 | 同一 owner 收紧 ID、响应和错误语义，再用可控通知种子实测 |
|
||||
| 换绑手机号 | 缺专用受保护发码 operation 与资料前置投影 | 后端补齐 operation/DTO 后，在人工 TAC/短信窗口实测 |
|
||||
| 个人资料读取 | `RObject` 未声明可消费资料字段 | 后端提供稳定资料 DTO、权限与脱敏语义 |
|
||||
| 个人资料更新 | 缺 profileVersion/If-Match 与合并 body 合同 | 后端提供版本并发与字段白名单，再对测试账号做可恢复验证 |
|
||||
|
||||
M04 和 M10 的客户端接线门禁现只以 Apifox 已核对的 owner、方法、body/空 body、取消归属与本机会话收口为准，已不再把旧受保护导出中虚构的会话安全语义当作阻塞。两项真实远端 mutation 仍均为 `DECLARED_UNVERIFIED`：改密必须在可恢复的人工窗口完成后恢复约定密码；服务端退出必须由人工登录会话确认撤销结果。两者均不得在无人值守期间发起。
|
||||
|
||||
F01/F02/F03 必须拆开处理：F01 已删除本地动态列表，因列表条目 DTO 缺失而明确关闭正文/详情入口；F02 已按唯一可映射的 `feedContent` 接通发布，不发送媒体、排序或状态猜测字段；F03 动态正文继续不接线、不猜字段，一级评论已有 `FamilyFeedCommentView[]` 和明确提交 body，客户端已按该合同接通真实读取/提交并在提交后回读。没有真实登录会话、实际响应和人工可观察写入前，三页均仍是 `DECLARED_UNVERIFIED`，绝不能把接线写成已完成。
|
||||
|
||||
## 一、计划地位
|
||||
|
||||
本文是今晚到明早的唯一执行顺序与验收入口。既有治理文档继续提供历史背景和长期发布约束，但与今晚的批次顺序、时间分配或“可测试”口径冲突时，以本文为准。`APP.openapi.yaml` 和 `APP.openapi.json` 只读且受保护，不得修改、格式化、覆盖或删除。
|
||||
本文是今晚到明早的唯一执行顺序与验收入口；[产品参考页面功能映射表](./产品参考页面功能映射表.md) 是本文直接引用的权威附件，二者必须一起评审、一起确认。既有治理文档继续提供历史背景和长期发布约束，但与今晚的批次顺序、时间分配或“可测试”口径冲突时，以本文及该附件为准。`APP.openapi.yaml` 和 `APP.openapi.json` 只读且受保护，不得修改、格式化、覆盖或删除。
|
||||
|
||||
当前处于“规划重整”阶段。在用户明确确认本版规划前，冻结业务代码、页面样式、接口接线、构建和 MuMu 操作；只允许只读核对与中文规划文档写入。规划确认后再按本文批次测试先行实施，不以已存在的半成品或局部截图代替用户确认。
|
||||
当前处于“执行与验证”阶段。用户已完成三人交叉评审后的规划确认并明确说“开始执行”，因此允许按本文对业务代码、页面样式、接口接线、测试、HBuilderX 与 MuMu 标准基座做最小必要变更与验证；仍不得以已存在的半成品、旧报告、参考项目能运行或局部截图代替当前项目验收。
|
||||
|
||||
## 二、明早交付目标
|
||||
## 二、明早交付目标与项目范围
|
||||
|
||||
明早交付一套连接 `https://backend-api.ddxcjp.cn/`、能够在 MuMu 中从认证入口开始遍历的 UniApp 测试版本。`pages.json` 中全部 52 条活动路由都必须可进入、可返回、无白屏和死路；后端已有接口的页面必须调用真实接口，后端确实没有接口的页面必须显示“服务暂未开放”或同义的明确状态，不得用 mock、fixture、timer 或假成功伪装闭环。
|
||||
本规划对象是当前 `jiapuapp` UniApp 整个项目，不只覆盖认证或世系树。A、G、T、F、R、N、M 七个路由域、共享导航与会话、文件上传、权限、异常恢复、视觉、参考资产、无障碍、构建和 MuMu 验收都在范围内。参考思维导图中的后台管理、公司官网和独立 PC 管理端不是本仓库的实现范围，只能为 APP 角色、权限和后端依赖提供参考，不能据此在当前仓库静默扩张成三个新项目。
|
||||
|
||||
当前 `pages.json` 的 52 条活动路由是今晚的最低活动基线，不是产品功能的永久上限，也不能单独代表整个项目完成。两个参考源中发现的候选功能必须先逐页面、逐动作、逐接口完成书面甄别；只有结论为“直接采用”或“改造后采用”，且明确当前路由归属或新增路由必要性后，才进入最终活动清单。最终遍历分母为“52 条基线路由＋本轮明确采纳并已注册的新增路由”，报告必须同时给出基线分母和最终分母，禁止用 52/52 掩盖已确认但未纳入的产品功能。
|
||||
|
||||
明早目标是在用户授权开始执行后，交付一套连接 `https://backend-api.ddxcjp.cn/`、能够在 MuMu 中从认证入口开始遍历的 UniApp 测试版本。最终活动清单中的页面必须可进入、可返回、无白屏和死路；后端已有且合同可用的动作必须调用真实接口，后端确实没有可靠 operation 的动作必须显示“服务暂未开放”或同义的明确状态，不得用 mock、fixture、timer、本地数组写入或假成功伪装闭环。
|
||||
|
||||
测试版本不等同于正式发布版本。发布签名、正式域名 CORS、后端未实现合同和真实支付等外部条件可以保留为发布阻塞，但必须提供失败门禁、复现证据、解除条件和继续步骤。
|
||||
|
||||
“全量”分三层报告，禁止混为一个结论：
|
||||
“全量”按五个互不替代的层级报告，禁止把较低层通过写成整个产品完成：
|
||||
|
||||
1. 已接真实接口的链路执行 live E2E，并据证据判定通过或失败。
|
||||
2. 尚无后端 operation 的页面执行路由、交互、状态和视觉回归，并明确标为服务未开放，不能记作接口通过。
|
||||
3. OpenAPI、签名、正式域名和其他发布门禁按预期发布阻塞单列，不能把预期红灯吞成全绿，也不能让它掩盖本机可修复失败。
|
||||
1. **产品库存覆盖**：52 条当前基线路由、已批准新增路由、60 个设计文件、78 条参考活动路由、1 条注释路由声明、7 个未注册参考页面文件和 531 个参考媒体资产均有稳定 ID、候选池或书面去向；资产候选池覆盖不等于逐文件批准复用。
|
||||
2. **路由结构遍历**：某候选包中的已注册活动路由可进入、可返回、无白屏和死路；这只证明结构可遍历。
|
||||
3. **实时接口迁移**：单个动作的合同、权限、请求、响应、刷新和重进闭环均完成，并通过引导式真实设备实时验收；当前没有可证明自动操控设备与断言业务结果的完整 E2E harness，因此不使用“自动 live E2E”表述。
|
||||
4. **明早最低候选**：存在可追溯的冻结候选，当前 7 个直接 `appApi` consumer 的主链结果、其余页面的数据模式、参考甄别结论和精确剩余项齐全；完整九小时窗口的目标还包括 52 条基线路由结构结果。若有效窗口不足或结构遍历未完成，未跑路由必须记 `NOT_RUN`，本层不得冒充达成。
|
||||
5. **整个产品完成**：所有已批准产品动作均达到产品完成条件；任一必需动作仍为关闭、半成品、未运行或合同阻塞时，整个产品不得标记完成。
|
||||
|
||||
今晚的可靠最低交付是“52/52 路由可进入返回 + 当前 7 个 remote consumer 的主链可信联调 + 其余页面诚实标记数据模式”；在此基础上按完成定义继续扩大 LIVE 页面数量。不得为了追求数字把只完成路径拼接、宽 DTO 直传或单一成功样例的页面提前标记为 LIVE。
|
||||
完整九小时窗口的可靠目标是第 1、2、4 层和可在时间窗内诚实完成的第 3 层；窗口缩短时第 1 层与精确剩余项仍必须交付，第 2、3、4 层按实际结果报告，不承诺在一个夜间窗口内把全部 52 页与所有参考候选都迁成 LIVE。不得为了追求数字把路径拼接、宽 DTO 直传、页面内 fixture、timer 提示、诚实关闭页或单一成功样例提前标记为产品完成。
|
||||
|
||||
## 三、已确认口径
|
||||
|
||||
- 当前源码基线由用户在 2026-07-23 手动拉取最新 `main` 后提供。本轮及后续执行均不进行任何 Git 操作，也不读取或写入 HEAD、分支、dirty、提交哈希作为实施前置；计划中的旧提交哈希全部视为历史记录，不再代表当前基线。
|
||||
- 第一参考源为 `C:\Users\Rain\Desktop\job\app设计`，当前只读清单为 59 张 PNG 和 1 份 PDF。项目内 `docs/design/references/产品参考原稿` 与其中 59 个同名文件 SHA-256 一致；源目录新增 `思维导图.png`，本轮只把它作为规划证据，不在用户确认前复制或归档。
|
||||
- 第二参考源为 `C:\Users\Rain\Desktop\job\Jiapu-App`。第一轮只读盘点确认其 `pages.json` 有 79 个 `path` 文本，其中 `pages/index/vertical-swiper/vertical-swiper` 整段已注释，故活动路由为 78 条；另有 79 个 Vue 文件、6 个 NVue 文件、7 个未注册页面文件和 113 个旧 API wrapper。未安装依赖、未运行、未构建、未修改。它使用旧技术与旧接口封装，只能证明候选页面、动作和状态存在，不能证明当前后端合同可用。
|
||||
- 用户已明确允许把第二参考源中的图标、插画、背景等资产作为复用候选。该授权只改变“可以逐文件甄别”的边界，不代表整目录批准，也不证明第三方/商标素材的来源或平台规范；任何资产仍须绑定已批准 PA、页面和状态，并逐文件通过来源、隐私、旧品牌、格式、视觉、无障碍和性能门禁。
|
||||
- 产品目标以用户对当前项目的明确需求为第一优先；接口路径、方法、字段、权限、状态码和失败语义以当前真实后端合同与可复现响应为准；当前项目架构、安全和国风视觉决定落地方式；截图和已完成参考项目排在最后，只作候选证据。
|
||||
- 唯一后端为 `https://backend-api.ddxcjp.cn/`，今晚联调使用 remote 模式。
|
||||
- 已提供有效测试账号；账号凭据只用于本机联调，不写入源码、测试、文档、日志或 Git。
|
||||
- 已用标准 JSON 请求确认密码登录返回 HTTP 200，`/captcha/challenge` 返回 HTTP 200、`TIANAI/SLIDER` 和完整挑战数据。此前空体 500 是 PowerShell 调用原生 `curl` 时 JSON 引号被破坏造成的错误诊断，不再作为后端阻塞。
|
||||
- 规划前在 2026-07-23 曾以标准 JSON 观察到密码登录和 `/captcha/challenge` 返回 HTTP 200，challenge 摘要为 `TIANAI/SLIDER`；后端可识别版本未留存，敏感响应不进入规划。该记录只解释此前因命令行 JSON 引号破坏得到的空体 500，不属于本轮 `LIVE_VERIFIED` 或 `PASS`。收到“开始执行”后仍须对冻结的线上合同和部署重新取证。
|
||||
- 密码登录、短信登录、注册、忘记密码都必须显示并完成 TAC。密码登录接口不接收 `validToken`，滑动成功只作为客户端强制前置；短信发送接口必须消费对应场景的 `validToken`。
|
||||
- 允许操作 MuMu，并把实机画面、返回路径和交互状态纳入验收。
|
||||
- 沿用当前 `static` 国风视觉资产和现有页面结构；今晚修复白块、截断、错位、默认控件、触控尺寸、长文本和不同宽度适配，不重做整套视觉。
|
||||
- 只有用户明确说“开始执行”后才允许操作 MuMu，并把实机画面、返回路径和交互状态纳入验收；规划确认本身不构成 MuMu 授权。
|
||||
- 当前 `static` 国风视觉资产、token 和现有页面结构仍是唯一视觉基线；参考项目资产可在逐文件通过门禁后直接复用、裁切重导出或重绘，不能反向改变已批准产品动作，也不能把旧整页红色主题、旧组件或旧样式一并迁入。
|
||||
- 允许测试账号创建带“联调测试”标识的家谱、成员、申请、动态、文章、相册、礼仪、备忘、功德和反馈等测试数据。
|
||||
- 不删除已有真实数据；无人值守期间不执行支付、换绑手机号、注销账号或不可逆操作。修改密码若经人工窗口测试，结束后恢复约定密码。
|
||||
- 不执行 `git add`、`commit`、`push`、`restore`、`checkout` 或 `reset`，除非用户另行明确授权。
|
||||
- 本轮不执行任何 Git 命令或 Git 写操作；源码同步由用户自行负责。
|
||||
|
||||
## 四、单页完成定义
|
||||
|
||||
@@ -42,138 +123,289 @@
|
||||
4. MuMu 实际画面没有白块、文字截断、控件错位、默认原生底色或不可点击区域；普通内容、长内容和状态页均可阅读。
|
||||
5. 页面对应的 mapper/runtime 测试、静态合同、编译检查和实机检查均通过。
|
||||
|
||||
页面内存在按钮不等于功能完成。每个主动作还必须验证“入口人物或对象正确 → 参数身份正确 → 权限来自可靠合同 → 请求结果可判定 → 返回后源页面刷新为服务端事实 → 重进页面仍一致”的跨页闭环；其中任一环仍依赖 fixture、旧参考接口、timer 或本地数组写入时，该动作不得标记完成。一个页面有多个主动作时逐动作记状态，不能用一个成功动作覆盖其他未完成动作。
|
||||
|
||||
自动脚本通过不能替代实机视觉合格，单张静态截图也不能替代接口与交互合格。
|
||||
|
||||
所有报告项只使用以下五种状态：`PASS`、`FAIL`、`EXPECTED_BLOCKED`、`NOT_RUN`、`INFRA_ERROR`。每项必须同时记录首次结果；如果进行了允许的只读重试，另记重试结果，不覆盖首次失败。
|
||||
每个动作必须同时记录四个正交字段，禁止用一个“通过”覆盖不同含义：
|
||||
|
||||
| 字段 | 允许值 | 判定用途 |
|
||||
| --- | --- | --- |
|
||||
| `contractState` | `LIVE_VERIFIED`、`DECLARED_UNVERIFIED`、`CONTRACT_CONFLICT`、`MISSING_OPERATION`、`NOT_APPLICABLE` | 当前后端合同及真实部署证据；纯本地权威内容用 `NOT_APPLICABLE` |
|
||||
| `dataMode` | `LIVE`、`LOCAL_PREVIEW`、`CLOSED` | 页面当前从哪里取得或是否允许提交数据；唯一 owner 的正式本地静态内容可为 `LIVE` |
|
||||
| `checkResult` | `PASS`、`FAIL`、`EXPECTED_BLOCKED`、`NOT_RUN`、`INFRA_ERROR` | 某一次合同、测试、构建或实机检查的结果 |
|
||||
| `productCompletion` | `COMPLETE`、`PARTIAL`、`BLOCKED`、`NOT_APPLICABLE` | 用户所需产品动作是否真正闭环 |
|
||||
|
||||
`CLOSED` 页面的关闭文案、返回路径和无假成功检查可以得到 `checkResult=PASS`，但必需动作仍须记 `productCompletion=BLOCKED`；不能由此把页面或产品写成完成。已知合同门禁脚本只有在“非零退出＋精确 `... BLOCKED` 标记”同时成立时才记 `checkResult=EXPECTED_BLOCKED`，它与关闭页行为检查的 `PASS` 不是同一结果。`LOCAL_PREVIEW` 最多为 `PARTIAL`。只有已批准动作在 LIVE 模式完成权限、请求、结果确认、刷新和重进闭环时，动作才可为 `COMPLETE`。
|
||||
|
||||
汇总规则固定为：
|
||||
|
||||
1. 动作逐项保留四字段，不取平均值。
|
||||
2. 页面另报 `structuralCheck` 和 `productCompletion`；任一必需动作 `productCompletion=BLOCKED`，页面产品完成度即 `BLOCKED`；没有 BLOCKED 但存在 `productCompletion=PARTIAL`，或必需检查 `checkResult=NOT_RUN`，页面最多为 `PARTIAL`。
|
||||
3. 域与整个项目只按已批准必需动作向上汇总；出现 `BLOCKED` 即不得宣称完成，全部为 `COMPLETE/NOT_APPLICABLE` 才能标记域或产品 `COMPLETE`。
|
||||
4. 每个 `checkResult` 同时记录首次结果；允许重试时另记重试结果，不覆盖首次失败。
|
||||
|
||||
## 五、接口判定和实现规则
|
||||
|
||||
1. Apifox 用于判断接口业务用途；线上 `/v3/api-docs` 和真实请求用于确认当前部署路径、字段及故障表现；受保护 OpenAPI 只作离线补充。
|
||||
2. 先列出当前批次的“页面 → 动作 → 方法 → 路径 → 输入 → 页面字段 → 成功/失败表现”，再写该批次失败测试，随后实现。
|
||||
3. 接口存在就接入；4xx、5xx、空体、缺字段或身份错配必须展示真实失败，不回退 mock。
|
||||
4. 后端没有对应 operation 时，页面保留完整视觉和返回路径，动作显示服务未开放，不伪造保存、发送、上传、支付、邀请或审核成功。
|
||||
5. 单个接口排查超过 15 分钟仍无本机解决路径时，立即记录复现证据并继续其他页面，避免阻塞整夜。
|
||||
6. 每个合同只有一个 owner；新合同落地时同步移除同类 fixture、旧入口、兼容读取和过时测试期望。
|
||||
7. 真实写操作仅限测试账号和本轮新建、带“联调测试”标识且已登记 ID 的对象。GET 可按退避规则重试；写操作只有接口明确提供幂等键且结果可判定时才允许重试，超时、5xx、断线或进程终止造成结果未知时立即停止该动作并查只读结果。
|
||||
### 5.1 Apifox 桌面端优先的合同发现门禁（本轮新增硬约束）
|
||||
|
||||
每条路由的执行记录至少包含：`route`、真实入口、必填参数、测试角色/种子、`dataMode(LIVE/LOCAL_PREVIEW/CLOSED)`、主动作、返回结果、页面状态证据、LIVE 请求响应证据、MuMu 结果和 blocker。
|
||||
导出的 `APP.openapi.yaml`、`APP.openapi.json` 和线上 `/v3/api-docs` 均可能缺少 Apifox 工作区中已经维护、但未导出的接口；它们只能作索引和交叉核验，绝不能作为“接口不存在”或“接口完整”的结论。每个受影响动作在写代码、关闭入口、补测试或判定 `MISSING_OPERATION` 前，必须先在用户已打开的 **Apifox 桌面端**逐项只读核对：
|
||||
|
||||
1. 所属目录、接口名称、HTTP 方法和完整路径；
|
||||
2. 鉴权方式、必填请求头、路径/查询/请求体字段及类型；
|
||||
3. 成功与失败响应示例、业务码、分页/ID wire 和权限语义；
|
||||
4. 是否存在同一业务动作的补充接口、前置接口或结果查询接口；
|
||||
5. 与导出文档、当前 `utils/api.js`、参考项目或真实请求不一致之处。
|
||||
|
||||
核对结果须以“动作 → Apifox 证据 → 当前部署实测 → 结论”写入临时脱敏账本；不得记录 Token、手机号、验证码、TAC proof、邀请口令或原始敏感响应。Apifox 与导出文档不一致时，以 Apifox 的业务定义为先导，并用真实部署响应复核 wire/权限/失败语义；两者仍不能证实时标为 `CONTRACT_CONFLICT` 或 `DECLARED_UNVERIFIED`，不得凭导出缺项关闭功能。只有 Apifox 也不存在、且经目录/关键词/相邻业务链检索留证后，才可标记 `MISSING_OPERATION`。
|
||||
|
||||
#### 5.1.1 本轮 Apifox 只读核对记录（2026-07-23 晚）
|
||||
|
||||
下表只记录已在用户打开的 Apifox 桌面端逐页读取到的声明；尚未通过测试账号取得同一部署的脱敏真实响应，故均不得写成 `LIVE_VERIFIED`。
|
||||
|
||||
| 动作/对象 | Apifox 桌面端声明 | 当前结论 |
|
||||
| --- | --- | --- |
|
||||
| 世系树读取 | `GET /genealogy/app/genealogies/{genealogyId}/lineage/tree`，`genealogyId` 为必填 `int64` 路径参数，APP `clientId` header 必填 | 路径与当前读取 owner 一致；ID wire 和权限投影仍待实测，`DECLARED_UNVERIFIED` |
|
||||
| 人物详情 | `GET /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}`，两个路径 ID 均为必填 `int64`，响应为 `LineagePersonResult` | 路径与当前读取 owner 一致；`DECLARED_UNVERIFIED` |
|
||||
| 人物新增/编辑 | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons` 与 `PUT /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}` 均使用统一人物 body；`name` 必填，`sex` 仅说明“建议使用系统字典值”，`avatarOssId` 只能来自统一上传，`sortOrder` 仅说明“数值越小越靠前”。已以“字典”“性别”检索 APP/PC 目录，均未发现可供 APP 消费的枚举 operation | 首人/编辑可继续按 body 收紧；性别字典、上传闭环和单人排序的并发语义未证实，不能虚构枚举或把 `sortOrder` 当原子排行 |
|
||||
| 新增父母/子女/兄弟姐妹/配偶 | 已分别声明 `POST .../parents`、`POST .../children`、`POST .../siblings`、`POST .../spouses`，均返回 `LineagePersonResult` | 原来按导出文档作出的“无 operation”结论无效；关系方向、性别字典、冲突、权限、结果未知恢复尚待实测，先列为 `DECLARED_UNVERIFIED`，不得以本地成功替代 |
|
||||
| 统一文件上传与人物头像 | `POST /genealogy/app/files/upload`，APP `clientId` header 必填，`multipart/form-data` 仅有必填 `file`；返回 `ossId`、`url`、`thumbUrl`、`fileName`、`originalName`。树与人物详情只声明 `avatarOssId`，未声明可重进读取的头像 URL/file projection | 上传本身为 `DECLARED_UNVERIFIED`；不得把 `avatarOssId` 拼接为 URL，也不把一次上传响应 URL 持久化成资料事实。T01 使用确定性国风默认头像；真实头像显示仍等待文件读取投影与真实重进验证 |
|
||||
| 已登录密码修改 | `PUT /genealogy/app/auth/password`，要求鉴权与 APP `clientId`，body 为 `oldPassword`、`newPassword` 两个 32 位 MD5 字段 | 与 A05 的无登录态 `PUT /genealogy/app/auth/password/reset` 不是同一 owner；M04 已按独立 owner 接线，未发生本轮真实 mutation，仍为 `DECLARED_UNVERIFIED`，人工恢复窗口验证前不得标记完成 |
|
||||
| 已登录手机号换绑 | `PUT /genealogy/app/auth/phone`，要求鉴权与 APP `clientId`，body 为 `clientId`、新 `phone`、四位 `smsCode`；通用短信发送接口声明允许 `APP_PHONE_CHANGE`，但前置 `validToken` 需先完成验证码中心 | 当前 profile 响应未声明可安全消费的手机号 DTO，且真实 TAC/短信需要人工窗口；M05 不猜字段、不静默发码或换绑，保持人工 `DECLARED_UNVERIFIED` |
|
||||
| 已登录退出 | `DELETE /genealogy/app/auth/logout`，要求鉴权与 APP `clientId`，无 body，响应 `RVoid`/`data:null` | M10 已接严格 REMOTE owner；当前未发真实退出 mutation，仍为 `DECLARED_UNVERIFIED`。本机退出与服务端撤销确认分开记录，不能把前者写成后者 |
|
||||
| 家族圈列表、正文详情与发布 | 列表：`GET /genealogy/app/genealogies/{genealogyId}/feeds`（`ListResult`）；详情：`GET /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}`（`ObjectResult`）；发布：同一路径 `POST`（`ObjectResult`）。三者均需鉴权与 APP `clientId`，路径 ID 均为 `int64`。发布 body 仅明确 `feedContent` 非空必填；`feedType` 默认 `text`、`mediaOssIds` 为英文逗号分隔 OSS ID、`sortOrder` 默认 `0`、`status` 默认正常 | 列表只见 `property1/property2` 通用项，正文详情和发布也未声明页面可消费 DTO；F01 已删除本地列表，F03 正文不猜字段。F02 只发送 `feedContent`，且只有严格成功信封后才显示已提交；不能把泛型响应当作列表条目或已完成验收；三者均为 `DECLARED_UNVERIFIED` |
|
||||
| 家族圈一级评论 | 读取：`GET /genealogy/app/genealogies/{genealogyId}/feeds/{feedId}/comments` 返回 `FamilyFeedCommentView[]`；提交：同路径 `POST`，`commentContent:string` 必填且最多 1000 字，`parentCommentId:int64|null` 可选。读取 item 已声明 `commentId/genealogyId/feedId/appUserNickName/commentContent/replyCount/createTime` 等字段 | F03 已删除本地动态/评论 fixture；读取仅展示 `commentId`、昵称、内容、回复数和创建时间的已声明映射；提交只发送 `commentContent`，成功后重新读取服务端列表 | 客户端已接线，但未取得真实登录态响应或人工可观察的提交结果；仍为 `DECLARED_UNVERIFIED`，正文详情 DTO 缺失不影响评论 owner 的独立核对 |
|
||||
| 谱文列表、详情与创建 | 列表：`GET /genealogy/app/genealogies/{genealogyId}/articles`；详情：`GET .../articles/{articleId}`，均为通用响应。创建：`POST .../articles`，已声明 `articleTitle/articleContent` 必填，`categoryId/articleSummary/coverOssId/authorName/sortOrder/status` 可选 | F04/F05 已删除本地文章、分类、搜索和正文展示，等待稳定 item/详情 DTO；F06 只发送 `articleTitle/articleContent`，无分类 ID 来源时不发送分类。编辑需要可靠详情/文章 ID 来源而关闭 | 创建客户端已接线但未实测，列表/详情/编辑仍为 `DECLARED_UNVERIFIED`；不得用本地预览或泛型成功响应冒充谱文展示闭环 |
|
||||
| 帮助文章列表 | `GET /genealogy/app/help-articles`，Apifox 显示鉴权、`clientId`（带默认值）与通用 `ListResult`，`data` 为未声明字段的 object 数组；另有详情 endpoint，但尚未作为当前页面 owner 读取 | M06 需要稳定的分类、标题与纯文本正文；当前声明仍只有 `property1/property2`，不能把硬编码 FAQ 冒充远端帮助内容。继续保持本地说明与 M07 反馈入口，远端帮助读取为 `DECLARED_UNVERIFIED` |
|
||||
| 消息通知列表与已读 | 列表：`GET /genealogy/app/notifications`，鉴权与 APP `clientId` 必填，通用 `ListResult` object 数组；单条已读：`POST /genealogy/app/notifications/{notificationId}/read`，`notificationId:int64`、鉴权与 APP `clientId` 必填、无 body、`VoidResult/data:null`。目录还声明“全部标记已读” | 未发现通知详情读取 operation，列表没有类型、目标、正文或稳定 ID 的消费 DTO；N01/N02 不能由通用数组猜业务跳转，未读不能由分页长度推断。没有登录态和可控通知种子时不发送任何已读 mutation，读取/已读均为 `DECLARED_UNVERIFIED` |
|
||||
| 我的家谱列表 | `GET /genealogy/app/genealogies/mine`，鉴权与 APP `clientId` 必填，通用 `ListResult` object 数组 | G01 需要稳定的家谱 ID、名称、角色与上下文能力；Apifox 当前仍只给出 `property1/property2`。不把响应存在误记为工作区/切谱闭环，保持 `DECLARED_UNVERIFIED` |
|
||||
| 相册与图片 | 相册列表：`GET /genealogy/app/genealogies/{genealogyId}/albums`，`genealogyId:int64`、鉴权与 APP `clientId` 必填，通用 `ListResult`。创建 body 仅可安全使用 `albumName`；图片写入要求既有 `ossId` | F07 已删除相册 fixture，创建仅发送 `albumName` 并等待成功信封；F08 已关闭无 DTO 的照片展示；F09 已删除 mock 图片和预览，等待文件上传 owner、真实 OSS 回执和访问 URL 投影。创建待真实响应核验，其他展示/上传为 `DECLARED_UNVERIFIED` / `BLOCKED_BY_MEDIA_OWNER` |
|
||||
| 备忘录 | 列表：`GET /genealogy/app/genealogies/{genealogyId}/memos`，`genealogyId:int64`、鉴权与 APP `clientId` 必填，响应为通用 `ListResult`。新增：同路径 `POST`，body 明确 `memoTitle` 必填；`memoContent`、`remindTime`、`completed`、`mediaOssIds`、`sortOrder`、`status` 可选，其中 `mediaOssIds` 为逗号分隔 OSS ID。目录另有详情、修改、删除动作 | R10 已删除列表 fixture，创建只发送 `memoTitle/memoContent/remindTime`；完成状态、媒体、排序、状态无来源不发送，详情/修改/删除因无 DTO/ID 来源关闭。创建待真实响应核验，整体仍为 `DECLARED_UNVERIFIED` |
|
||||
| 成长记录 | 列表：`GET /genealogy/app/genealogies/{genealogyId}/growth-records`，`genealogyId:int64`、鉴权与 APP `clientId` 必填，响应为通用 `ListResult`。新增：同路径 `POST`，body 明确 `recordTitle` 必填；`lineagePersonId:int64`、`recordType`、`recordContent`、`recordDate`、`remindTime`、`mediaOssIds`、`sortOrder`、`status` 可选，其中 `mediaOssIds` 为逗号分隔 OSS ID。目录另有详情、修改、删除动作 | R08 已删除列表 fixture，创建只发送 `recordTitle/recordContent/recordDate`；人物绑定、类型、提醒、媒体、排序、状态无来源不发送，详情/修改/删除因无 DTO/ID 来源关闭。创建待真实响应核验，保持 `DECLARED_UNVERIFIED` |
|
||||
| 功德记录 | 列表：`GET /genealogy/app/genealogies/{genealogyId}/merit-records`，`genealogyId:int64`、鉴权与 APP `clientId` 必填，响应为通用 `ListResult`。新增：同路径 `POST`，body 的 `donorName`、`meritTitle` 必填；`meritType`、`meritContent`、`amount:double`、`meritTime`、`sortOrder`、`status` 可选。目录仅见删除，未见详情或修改 | R 功德列表及新增响应尚无稳定页面消费 DTO；不可把当前路径与参考项目的人情/贺礼混为一谈。未在无登录态下发送新增或删除 mutation，保持 `DECLARED_UNVERIFIED` |
|
||||
| 祭祀与祭祀献礼 | 祭祀列表：`GET /genealogy/app/genealogies/{genealogyId}/ceremonies`，通用 `ListResult`；创建：同路径 `POST`，`ceremonyType`、`ceremonyTitle` 必填，`ceremonyDesc`、`ceremonyTime`、`location`、`coverOssId:int64`、`sortOrder`、`status` 可选。献礼列表：`GET /genealogy/app/genealogies/{genealogyId}/ceremonies/{ceremonyId}/gifts`，两个路径 ID 均为 `int64`；新增：同路径 `POST`，`giftAmount:double` 必填，`giverName`、`giftMessage` 可选。上述均要求鉴权与 APP `clientId`，目录还声明祭祀详情/修改、删除活动和删除单条祭品 | 祭祀和献礼均有专属父对象与语义；它们不是人情簿，也不是可发放/绑定的贺礼邀请。列表/新增响应仍无稳定页面 DTO，且未在无登录态下发送写入或删除请求，整体保持 `DECLARED_UNVERIFIED` |
|
||||
| 亲友记录 | 列表：`GET /genealogy/app/genealogies/{genealogyId}/relative-records`，`genealogyId:int64`、鉴权与 APP `clientId` 必填，响应为通用 `ListResult`。新增：同路径 `POST`，`relativeName` 必填；`relationName`、`eventName`、`eventTime`、`giftAmount:double`、`recordContent`、`mediaOssIds`、`sortOrder`、`status` 可选。目录另有详情、修改、删除动作 | R03/R04 已删除 fixture 列表和详情，创建只提交亲友姓名、关系、事项、时间、金额、备注；媒体/排序/状态无来源不发送。详情/修改/删除无 DTO/ID 来源关闭；创建待真实响应核验，保持 `DECLARED_UNVERIFIED` |
|
||||
| 人生事件与重要证件 | 已在 Apifox APP/PC 目录分别以“人生”“证件”检索，均未返回对应 operation；相邻的亲友、成长、备忘、功德、祭祀目录不能替代 | R09 没有当前业务 owner，维持硬关闭和可返回状态；`MISSING_OPERATION`，不以本地表单、文件上传或参考项目页面伪造保存 |
|
||||
| 视频 | Apifox 按“视频”检索只发现 APP 删除视频动作；未发现当前 F10 所需的视频列表、可播放 URL、发布/编辑、评论、点赞或分享闭环 | F10 继续保持非 LIVE；不能把参考短视频动作或单一删除 endpoint 扩展成视频产品能力，`MISSING_OPERATION` |
|
||||
| 意见反馈 | `POST /genealogy/app/feedback`，鉴权与 APP `clientId` 必填；body 的 `feedbackContent` 必填，`feedbackType` 与 `contactInfo` 可选，响应 `ObjectResult` | 与 M07 的严格 normalizer、POST owner 和提交状态机一致；静态/API 冒烟已通过，未用测试账号提交真实反馈，故远端结果仍为 `DECLARED_UNVERIFIED` |
|
||||
| 当前用户资料 | `GET /genealogy/app/auth/profile`，鉴权与 APP `clientId` 必填，响应 `ObjectResult`，当前仅给出 `property1/property2`；目录另有 `PUT /genealogy/app/auth/profile` | M01—M03/M05 需要稳定的账号、资料与手机号投影；不能从通用对象猜字段或让资料更新覆盖未知字段。读取、编辑与换绑前置均保持 `DECLARED_UNVERIFIED`，M05 另受人工 TAC/短信窗口约束 |
|
||||
| 微信登录 | 已以“微信”检索 Apifox APP/PC 目录，未返回登录授权、code 交换、回调、会话创建或结果查询 operation | A01 的微信入口不能借参考项目旧接口接通；保持 `MISSING_OPERATION` 关闭候选，是否长期纳入由用户后续确认 |
|
||||
| 家谱邀请码 | 已以“邀请码”检索 Apifox APP/PC 目录，未返回邀请码签发、校验、直入加入、撤销或结果查询 operation | G/M 的邀请码能力无当前 owner；普通加入申请、成员维护和人物邀请绑定都不能替代，保持 `MISSING_OPERATION` |
|
||||
| 行政区划搜索 | Apifox APP 目录声明 `GET /genealogy/region/search`：`keyword` 必填，`level` 可选（1 省、2 市、3 区县、4 街道、5 村社区），`limit` 可选；`clientId` header 可选，响应为通用 `ListResult`。2026-07-24 00:51 的只读部署响应为 HTTP/业务码 `200`，服务器时间 `Thu, 23 Jul 2026 16:51:08 GMT`，单条结果含字符串 `regionCode`、`label`、`parentCode`、`ancestors`、`regionName`、`regionLevel`、`regionType` 与 `leaf`；同目录另有下级查询、路径查询与详情 | 此读取 owner 为 `LIVE_VERIFIED`，G03 可消费返回的字符串 `regionCode`，但不能把 `leaf` 推断为可提交能力。非 APP 前缀为唯一业务 owner；当前部署旧 `/genealogy/app/region/search` 虽同响应，仍只记路径并存证据，不作兼容 owner。G03 两次写入及结果未知恢复仍分别按其独立合同判定，不能由该读取验证代替 |
|
||||
| 邀请绑定 | 已展开“家谱（12）”“家谱成员（6）”全部接口，并以“邀请”“绑定”检索 APP/PC 目录；仅见普通申请/审核和成员维护，无邀请票据、身份绑定、绑定 mutation 或结果查询接口 | `MISSING_OPERATION`；普通申请不能替代邀请绑定，保持诚实关闭 |
|
||||
|
||||
### 5.2 通用判定和实现规则
|
||||
|
||||
1. Apifox 用于优先发现和判断接口业务用途；线上 `/v3/api-docs` 和真实请求用于确认当前部署路径、字段及故障表现；受保护 OpenAPI 只作离线补充。参考项目 `api/index.js` 中的旧路径、参数和响应处理不属于当前接口证据。
|
||||
2. 每个动作先进入统一账本。`LIVE_VERIFIED` 只允许用于本轮开始后、绑定后端可识别版本或时间戳的真实证据；受保护 OpenAPI 有声明但未取本轮真实响应时为 `DECLARED_UNVERIFIED`；文档、部署、权限、静态门禁或页面期望冲突时为 `CONTRACT_CONFLICT`；没有可靠 operation 时为 `MISSING_OPERATION`。operation 是否存在另记为证据字段，不是第五种状态；同一最小动作同时“有声明但已知冲突”时必须取更严重的 `CONTRACT_CONFLICT`，不得写两个 `contractState`。不得把接口名相似、历史 HTTP 200 或参考项目成功写成已接通。
|
||||
3. 先列出当前批次的“当前页面 → 用户动作 → 对象身份 → 权限来源 → 方法 → 完整路径 → 输入 → 页面消费字段 → 成功/失败/结果未知表现 → 刷新确认”，再写该批次失败测试，随后实现。
|
||||
4. 只有 `LIVE_VERIFIED` 动作允许记为 LIVE。`DECLARED_UNVERIFIED` 先做只读或可控测试验证；`CONTRACT_CONFLICT` 记录冲突并失败关闭；`MISSING_OPERATION` 保留完整视觉和返回路径，动作显示服务未开放，不伪造保存、发送、上传、支付、邀请、绑定、排行或审核成功。
|
||||
5. 4xx、5xx、空体、缺字段或身份错配必须展示真实失败，不回退 mock。参考项目成功、受保护 OpenAPI 存在 operation 或当前页面已有 `appApi` 方法，都不能单独解除这一规则。
|
||||
6. 单个接口排查超过 15 分钟仍无本机解决路径时，立即记录复现证据并继续其他页面，避免阻塞整夜。
|
||||
7. 每个合同只有一个 owner；新合同落地时同步移除同类 fixture、旧入口、兼容读取和过时测试期望。若一个参考动作无法明确归入现有 owner，先判定是否需要新 owner，不能塞进名称相近的旧接口。
|
||||
8. 真实写操作仅限测试账号和本轮新建、带“联调测试”标识且已登记 ID 的对象。GET 可按退避规则重试；写操作只有接口明确提供幂等键且结果可判定时才允许重试，超时、5xx、断线或进程终止造成结果未知时立即停止该动作并查只读结果。
|
||||
9. 新增全域 P0 ID 门禁：`genealogyId`、`personId`、`memberId`、`appUserId`、父母/配偶/子女引用、内容 ID、文件 ID 与 `avatarOssId` 等 `int64` wire 必须验证服务端以十进制字符串返回且请求端接受十进制字符串。任何超出 JavaScript 安全整数的 JSON number 一经解析已不可恢复，禁止再转字符串继续使用；相关读写统一记 `CONTRACT_CONFLICT` 并关闭，直到同一 ID owner 在 schema、运行时、validator 和请求端同时收紧。
|
||||
10. 三个现有静态门禁本身与已确认规划/快照冲突，收到“开始执行”后的第一项测试工作是先按唯一 owner 重订失败期望，再实施业务：`auth-tac-openapi-contract.ps1` 不得再要求密码登录上传 `validToken`；两个 G03 门禁不得再要求未声明的原子 bootstrap、错误的 `/genealogy/app/region/search` 或不存在的结果查询；`help-center-openapi-contract.ps1` 与 M06 统一为“完整列表是唯一远端 owner、文章阅读由列表项投影承接”，不新增独立远端详情 owner。门禁目标路径不能写成当前 operation，也不能因旧测试期望而覆盖真实后端合同。
|
||||
|
||||
每条路由的执行记录至少包含：`route`、真实入口、必填参数、测试角色/种子、四个正交状态字段、参考来源、候选动作、六类甄别结论、接口 owner、权限 owner、主动作、返回结果、页面状态证据、LIVE 请求响应证据、候选包 ID、MuMu 结果和 blocker。
|
||||
|
||||
每次汇总必须同时列出这些分母，任何一个都不能被“52/52”代替：
|
||||
|
||||
- `baselineRoutes=52`；
|
||||
- `approvedNewRoutes`（规划确认采纳、但不一定已注册）；
|
||||
- `registeredRoutes`（候选包实际注册）；
|
||||
- `traversedRoutes`（绑定该候选包完成结构遍历）；
|
||||
- `referenceEvidenceRecords=341`，以及六类证据结论数量：直接采用、改造后采用、仅参考交互、后端缺失暂关、冲突舍弃、待用户确认；
|
||||
- `productActionsTotal=166`、`requiredActions=111`、`candidateActions=55`、`approvedCandidateActions=0`；产品完成分母固定为附件 PA-001—PA-166 中的 111 个必需动作；
|
||||
- `liveCompletedActions`、各动作的 `productCompletion`，以及按必需/可选、A/G/T/F/R/N/M/共享 owner 的分组结果；
|
||||
- `inventoryTests`、`scheduledTests`、`executedTests`、`notRunTests`、`timedOutTests` 与各 `checkResult` 数量。
|
||||
|
||||
## 六、执行批次与相对时间
|
||||
|
||||
### 第 0—0.5 小时：硬预检与全量映射
|
||||
以下计时只在用户明确说“开始执行”后启动。在此之前，参考映射与产品取舍必须已在权威附件中完成并由用户确认；执行第 0 批只能重算清单/哈希、冻结确认结果，不得再临场作重大产品决策。
|
||||
|
||||
- 核对当前 HEAD、工作区、52 条路由、构建入口和已有测试。
|
||||
- 按页面盘点真实接口、现有 fixture、入口、写操作和视觉风险。
|
||||
- 只维护一张执行表和必要阻塞证据，不扩写与今晚交付无关的治理长文。
|
||||
- 夜跑前确认源码 HEAD 与 dirty diff、remote 配置、后端版本、网络、磁盘、MuMu 在线/解锁、测试包安装、测试账号会话、测试家谱 ID 和账号角色。缺少第二角色账号时，跨账号申请/审核不得伪造通过，单列测试数据阻塞。
|
||||
- 建立唯一夜跑入口：按固定清单发现测试，单项有超时，失败后继续下一项，记录检查点并支持从最后完成项续跑；结束时回收子进程。连续认证失败、429、同域 5xx、设备离线、磁盘不足或写结果未知触发对应域熔断。
|
||||
### 6.1 时间模型与降级规则
|
||||
|
||||
### 第 0.5—1.5 小时：A 认证与 TAC
|
||||
- `T_start`：收到用户“开始执行”的北京时间。
|
||||
- `T_due`：用户已更新为 2026-07-24 08:00（北京时间）。
|
||||
- 正常候选周期为 `T_start + 9h`，但不得越过 `T_due`；要获得完整九小时窗口，最迟须在 2026-07-24 01:00 开始。
|
||||
- `T_test_cutoff = min(T_start + 6h, T_due - 3h)`。截止前必须完成本轮测试调度和首个候选尝试；截止后反向保留 0.5 小时候选修复/冻结、1.75 小时最终实机和 0.75 小时缓冲，不能用缩短窗口挤占这三段。
|
||||
- 首个候选固定预留 `firstCandidateWorstCase=30m`：2 分钟重算输入清单并准备全新输出根、15 分钟构建、3 分钟生成输出清单/指纹、7 分钟部署或安装、3 分钟设备身份确认。测试只有在 `now + testWorstCase + firstCandidateWorstCase <= T_test_cutoff` 时才允许启动；全部已调度测试收口后，首个候选只有在 `now + firstCandidateWorstCase <= T_test_cutoff` 时才允许启动。任何在途进程都不得跨越 `T_test_cutoff`：意外超时时在截止点终止本轮进程树，具体测试记 `timedOutTests/INFRA_ERROR`，候选尝试记基础设施失败，然后一次性冻结计数。不得以“已经开始”为由占用后续三小时。
|
||||
- `T_start >= T_due` 时不启动本轮执行，先请用户重新确认截止时间；`T_test_cutoff <= T_start` 时不启动代码、测试或构建批次，只交付预检与“无冻结候选”的精确原因。
|
||||
- 有效窗口不足 9 小时时不压缩人工认证和上述尾部三段：6—9 小时优先削减 F/R/N/M 的新增 LIVE 扩展；3—6 小时只在 `T_test_cutoff` 前做 P0 合同/安全修复、七个现有 `appApi` consumer 和首个候选尝试；不足 3 小时时不启动无法留出验证时间的代码批次，只做可完成的预检、现状与报告。所有被削减项记 `NOT_RUN`，不得改写成通过。
|
||||
- 九小时只是一次可靠候选周期，不是整个产品的完成承诺；明早报告必须把第 2 节五个层级分别结论化。
|
||||
|
||||
- 页面：A01、A04、A05及认证状态、协议和返回相关入口。
|
||||
- 链路：密码登录、短信登录、注册、忘记密码、TAC challenge/verify、短信发送、会话保存和 G01 跳转。
|
||||
- 重点视觉：验证码倒计时、禁用按钮、输入行、协议、Toast、TAC 弹层、短屏滚动和 360/412 宽度。
|
||||
- 用户宣布准备休息时，暂停其他工作并进入 45—60 分钟人工窗口。密码登录 TAC、A01 短信登录、A04 注册和 A05 找回是四条独立流程；若同时具备已注册收码号码和未注册号码则逐条验证，否则把缺少号码的流程标记测试数据阻塞。人工完成后验证会话在页面重进和应用重启后仍有效。
|
||||
- 记录会话有效性但不记录令牌；无人值守阶段若会话失效，停止需要身份的实机动作并标记 `EXPECTED_BLOCKED`，不尝试绕过认证。
|
||||
- 无人值守阶段不循环发送短信，不自动破解或绕过 TAC。自动接口测试取得的临时令牌只验证登录后接口，不能冒充认证页面验收。
|
||||
### 6.2 正常九小时批次
|
||||
|
||||
### 第 1.5—3.5 小时：remote 主链与 B 高风险页面
|
||||
#### 第 0—0.5 小时：冻结基线、合同、角色与夜跑清单
|
||||
|
||||
- G01、G03、G05、G06、G08、G09、G10、G11、G12。
|
||||
- T01、T03—T08及所有活动世系路由。
|
||||
- 优先完成 A01 → G01 → G05 → T01 和 M07 已接线主链的 P0/P1，再按测试角色和后端合同推进我的家谱、原子建谱、公开搜索、普通申请、我的申请/撤回、待审/审核、设置、字辈、成员详情、编辑和关系操作。
|
||||
- T01 不按当前文字节点和简单底部操作条直接验收；必须先按第十一节完成头像人物卡、选中态、人物操作面板、关系快捷动作和长世代布局的测试门禁，再进入 T03—T06 的真实读写接线。
|
||||
- 后端未提供的邀请码、详情或冲突控制不混入其他普通申请链路；缺失功能显示明确不可用状态。
|
||||
- 以用户手动拉取的当前文件为源码基线，不执行 Git；重算 52 条路由、60 个设计文件、78 条参考活动路由、1 条注释路由声明、7 个未注册参考页面文件、531 个参考媒体资产和权威附件覆盖率。
|
||||
- 在任何“接口缺失”、接口接线、写操作或页面关闭结论之前，先按第 5.1 节在 Apifox 桌面端完成当前批次动作的目录、请求、响应、鉴权和相邻链路检索；把未导出的接口和与导出文档不一致的字段列入脱敏合同账本，再决定实测、实现或阻塞。不得跳过此步骤直接按导出 OpenAPI 结论推进。
|
||||
- 冻结线上 `/v3/api-docs` 的取证时间与可识别版本；受保护 OpenAPI 保持只读。接口或参考源相对已确认附件发生变化时，只记录差异并暂停受影响动作，不静默改变产品范围。
|
||||
- 先在仓库外的本机临时验收目录建立唯一 `role-seed-matrix.json` owner：只记录脱敏角色别名、角色类型、对象类型、十进制字符串对象 ID、来源/创建时间、允许的动作和清理责任；不得写账号、手机号、Token、OTP、TAC proof 或其他凭据。普通成员、家谱所有者或管理员、第二账号，以及测试家谱、人物、申请、内容和媒体均由该矩阵登记。缺少角色、跨账号对象或收码号码时，对应动作标记测试数据阻塞。
|
||||
- 机械生成当前 204 个可执行脚本的 manifest 基表和显式 override，并冻结 `baselineInventoryTests=204=150 PS1+54 JS`。`tests/night-run.ps1` 与 `tests/night-run.manifest.json` 是编排入口/清单，不计测试项；实施中为本轮变更新建的每个可执行测试都记入 `newExecutableTests` 并追加到 manifest，最终 `inventoryTests=baselineInventoryTests+newExecutableTests`。每项先按第 6.3 节确定风险层级、依赖、是否远端写入及预期结果；第 0 批只校验已确认的 `PA-xxx` 产品动作和来源反链未漂移，禁止重新归并、拆分或改变产品动作分母。任何参考资产复制前另建逐文件 `RAxxx` 记录；资产选择可以在已批准 PA 内发生，但不能新增产品动作或跳过来源门禁。
|
||||
- 在仓库外的本机临时验收目录准备候选输入清单模板。每次候选构建/部署前，对项目自有源码、配置、资产和 lockfile 重算规范化逐文件 SHA-256；明确排除 `.git`、`unpackage`、依赖/工具缓存、日志、截图、报告和清单自身，并另记 HBuilderX、插件及解析后依赖版本。输入清单的规范化与第 6—6.5 小时输出清单使用同一算法，且不含凭据。
|
||||
- 检查 remote 配置、网络、磁盘、HBuilderX、MuMu 状态和测试账号，但此时不把任何历史运行结果算入本轮。
|
||||
|
||||
### 第 3.5—5.5 小时：52 路由 MuMu 遍历
|
||||
#### 第 0.5—1.75 小时：A 认证人工窗口与会话
|
||||
|
||||
- 按 A/G/T/F/R/N/M 顺序记录每页真实入口、必填参数、默认状态、Android 返回和根切换。
|
||||
- 这一阶段不以匆忙接接口为目标；先发现白屏、死路、缺参数、上下文串谱和明显视觉破损，并为每页标记 LIVE、LOCAL_PREVIEW 或 CLOSED。
|
||||
- 本轮先完成密码登录页、账号密码提交、TAC challenge 展示、challenge/verify 合同、会话保存与 G01 跳转的可自动化验证；密码登录的真实拖动、短信登录、注册和找回密码的短信/TAC 全部保留为早晨人工回归，四条流程不互相替代。
|
||||
- 不循环发码、不破解或绕过 TAC。测试账号凭据只保留在当前安全会话，绝不写入仓库、文档、截图或日志。
|
||||
- 人工完成后验证页面重进和应用重启的会话；不记录 token。会话失效时停止身份写操作并熔断，不以临时接口 token 冒充认证页面验收。
|
||||
|
||||
### 第 5.5—7 小时：C/D/E 接口扩展与代表性状态视觉
|
||||
#### 第 1.75—4 小时：A/G/T P0 主链与 T01/T03
|
||||
|
||||
- F01—F10：动态、评论、文章、相册、照片、媒体、视频和上传相关页面。
|
||||
- R01—R11：人物、礼簿、礼仪、成长、人生事件、备忘和功德。
|
||||
- 已有读取和写入接口接真实服务；上传链不完整时不得显示假上传成功；人生事件无接口时显示服务未开放。
|
||||
- N01、N02和 M01—M10同步按风险扩展通知、资料、安全、帮助、反馈、推广、VIP、关于和退出。
|
||||
- 换绑、支付、注销等敏感或缺少完整后端闭环的动作在无人值守阶段只验证页面、校验和真实不可用状态。
|
||||
- 视觉按共享形态覆盖认证表单、列表、详情、编辑器、弹窗、上传和关闭页；共享控件缺陷一次修全，高风险页补长文、空、错和无权限。320/412 用响应式运行检查补充，MuMu 当前设备证据不冒充其他宽度原生证据。
|
||||
- 按 A01 → G01 → G05 → T01、G03 两阶段建谱、G06/G08—G12、T03—T08推进；每个动作先过合同、ID、权限和结果未知门禁。
|
||||
- T01 优先完成头像人物卡、选择态和唯一人物面板；十入口逐项落到 T03/T04/T05/T06/邀请流程。合同不足的入口只允许诚实关闭，其关闭检查可 PASS，但 T01 产品完成度仍为 BLOCKED。
|
||||
- T03 始终从未完成半成品起算；已有 normalizer、fixture 或旧门禁不得计完成。
|
||||
- 本批时间用尽即停止扩张并留下可验证断点，不把 T01 大型布局和十条真实写链压缩成单一“完成”。
|
||||
|
||||
### 第 7—8.25 小时：全量测试、重编译和候选包
|
||||
#### 第 4—4.5 小时：F/R/N/M 风险优先扩展
|
||||
|
||||
- 运行 PowerShell、Node、语法、纯 Node、活动 Vue 脚本和构建检查。
|
||||
- 构建测试版本并在 MuMu 中从认证根页遍历四个主入口和全部活动页面。
|
||||
- 检查重新进入、切换家谱、凭证失效、弱网、重复点击、请求取消、空数据、4xx/5xx和返回行为。
|
||||
- 安全覆盖 HTTP 200 业务错误、400/401/403/404/409/429/500、超时、畸形 JSON、重复或失真 ID、撤权、快速切页、离页取消、前后台切换和迟到响应；不适合对真实服务触发的故障使用确定性本地传输注入，不能攻击线上服务。
|
||||
- 输出已通过、后端阻塞、缺测试数据和需人工复验四类结果，不用含糊的“基本完成”。
|
||||
- 优先处理已经有当前后端声明、且能在剩余时间内完成闭环的读取和小型写入；无视频完整链、人生事件、重要证件、通知详情、支付/提现等保持诚实关闭。
|
||||
- 换绑、注销、支付、所有者转移、退出家谱、删除真实内容等敏感动作不在无人值守阶段执行。
|
||||
- 每域更新动作分母与四字段，不要求为了“全绿”把全部参考候选临时实现。
|
||||
|
||||
### 第 8.25—9 小时：候选包回归与证据归档
|
||||
#### 第 4.5—6 小时：分层测试、首个候选与全量硬截止
|
||||
|
||||
- 对候选测试版本快速重走认证根页、四个主入口、家谱上下文和本轮失败项。
|
||||
- 汇总五种状态、首次结果、熔断、人工项和精确继续步骤，保留至少 45 分钟缓冲，不在最后时刻追加未验证接口。
|
||||
- 唯一测试清单 owner 为执行时建立的 `tests/night-run.manifest.json`，唯一入口为 `tests/night-run.ps1`；二者只在用户说“开始执行”后创建。manifest 逐项明确脚本、解释器、排序、120 秒默认超时、依赖、预期退出码、预期标记、领域、是否允许写远端及检查点；当前 12 个 allowlist 项必须各自冻结完整且唯一的 `expectedBlockedMarker`，不得用包含匹配；4 个 JSON 数据文件不是可执行脚本。
|
||||
- 测试分三层：`T0` 为 P0 安全/合同、路由、编译及本轮实际修改 owner 的门禁，是形成候选的必要条件；`T1` 为 A/G/T/F/R/N/M 受影响域的其余 mapper/runtime/合同回归；`T2` 为未受影响域和历史扩展检查。204 个基线项与所有 `newExecutableTests` 全部进入 inventory，但只有 manifest 明确列入当轮的项目计入 `scheduledTests`；先执行 T0，再在硬截止前执行 T1，T2 仅在 T0/T1 完成且仍有时间时调度。未调度或未执行项分别如实进入 `notRunTests`，不得把 inventory 数量写成执行数量。
|
||||
- 一级顺序固定为 T0 → T1 → T2；每层内部再按纯静态/合同 PowerShell → 纯 Node mapper/runtime → 该层编译/专项检查排序，全部已调度测试收口后才形成候选构建。PowerShell 使用 `powershell.exe -NoProfile -ExecutionPolicy Bypass -File <exact-script>`；Node 使用 `node <exact-script>`。无网络、无共享写入且无相互依赖的本地脚本最多 4 个并发 worker；远端、写操作、编译和构建一律串行。单项失败继续下一项并回收子进程，域熔断只跳过同一远端风险动作。
|
||||
- 当前 150 个 PowerShell、54 个 Node 脚本以及实施中新增的每个可执行测试必须逐一进入 manifest；runner 和 manifest 自身不计测试项。本轮“预期阻塞”只允许以下 12 条精确脚本，并同时要求非零退出和各自精确 `... BLOCKED` 标记；其他非零均为 `FAIL`：`auth-android-accessibility-release-gate.ps1`、`g11-settings-openapi-contract.ps1`、`g12-generation-poem-openapi-contract.ps1`、`genealogy-workspace-openapi-contract.ps1`、`invite-ticket-openapi-contract.ps1`、`join-application-openapi-contract.ps1`、`lineage-openapi-contract.ps1`、`notification-read-openapi-contract.ps1`、`notification-read-state-openapi-contract.ps1`、`phone-change-openapi-contract.ps1`、`profile-openapi-contract.ps1`、`profile-update-openapi-contract.ps1`。已转绿的 `auth-tac`、两个 G03、F 家族圈、M04、M06、M10 与 T03 门禁不得再被列作预期阻塞；M04/M10 的真实 mutation 仍只进入人工窗口。清单冻结前须核对这些脚本的实际退出语义，不能仅因文件含 “BLOCKED” 字样放行。
|
||||
- allowlist 脚本若本轮变为退出码 `0` 且出现精确 PASS 标记，按 `PASS` 接受并从预期阻塞清单移除；只有非零退出且精确 BLOCKED 标记匹配才是 `EXPECTED_BLOCKED`。退出码与标记任一不匹配均为 `FAIL` 或 runner 错误，不能因历史预期而放行。
|
||||
- 夜跑在每项结束后原子写入本机临时验收目录中的 checkpoint（脚本、开始/结束、退出码、标记、耗时、首次结果），续跑只从最后完整记录之后开始。总入口退出码固定为：`0`＝无 FAIL/INFRA 且预期阻塞完全匹配；`2`＝测试或合同断言失败；`3`＝构建、部署、安装或设备基础设施失败；`4`＝manifest 漂移、单项超时、测试执行基础设施或 runner 自身错误；同时出现时按 `4 > 3 > 2 > 0` 聚合。单项超时记该测试 `checkResult=INFRA_ERROR` 并进入 `timedOutTests`；无法归到具体测试的 manifest/runner 故障另记 `runnerInfraErrors`，不塞入测试恒等式。任何 `EXPECTED_BLOCKED` 都必须在摘要中单列，退出 0 不等于产品全绿。
|
||||
- 全部已调度测试按层级收口后，首个候选严格使用第 6.1 节 30 分钟预算与同一构建入口；任一子段超时即本次候选失败，不把失败段的剩余时间转给另一段，也不在 cutoff 前启动第二次首候选尝试。第 6—6.5 小时只负责复用该候选或进行一次受限修复/最终冻结。
|
||||
- `T_test_cutoff` 是测试调度与首个候选尝试的硬截止；每项按第 6.1 节 `latestStart` 准入，不能在最坏耗时将越过 cutoff 时启动。截止时终止意外仍在途的项目，排队但未启动的已调度项进入 `notRunScheduledTests`，再一次性冻结 `scheduledTests/executedTests/notRunScheduledTests/notRunTests/timedOutTests` 和最终恒等式。T0 未全部取得允许结果或候选无法追溯时，不进入最终实机验收。
|
||||
- 构建入口固定为仓库根目录与 `.hbuilderx/launch.json` 中的 `uni-app:app-android`。执行前记录实际 HBuilderX CLI 绝对路径、版本、命令、退出码和输出目录；不得把旧 `unpackage` 产物冒充新包。
|
||||
|
||||
#### 第 6—6.5 小时：仅修复候选阻塞并冻结最终候选
|
||||
|
||||
- 本阶段只能二选一，不得借用后续 105 分钟实机窗口。若首个候选之后源码输入和生成输出均未变化，前 20 分钟内重算输入/输出 manifest 并逐项确认 hash 完全相同，必须复用该候选且不重复构建；随后最多使用 7 分钟部署/安装、3 分钟设备身份确认。若必须修复，前 5 分钟的组合硬上限同时覆盖一次 P0/P1 外科式修复、受影响的聚焦测试和 `sourceManifestSha256` 重算；随后 15 分钟的组合硬上限同时覆盖最终构建、完整输出 manifest 与 `outputManifestSha256`，再用 7 分钟 DBG 部署或 APK 安装、3 分钟设备身份确认，合计正好 30 分钟。任一组合段内的前置工作耗尽预算，后续工作来不及完成时即判该路径失败，不能把清单/指纹移出预算。
|
||||
- 任一路径在准入时无法按最坏预算于本阶段结束前收口，或任一硬上限内未完成，立即终止本轮启动的进程树、停止继续安装并记退出码 `3/INFRA_ERROR`，交付“无冻结候选”；不得重试、不得压缩身份核验，也不得挤占 MuMu 窗口。
|
||||
- 候选分两类且必须二选一取得可追溯、可复验的指纹：APK 使用 `APK-YYYYMMDD-HHMM-<apkSha256前12位>`，记录完整 APK SHA-256；HBuilderX 调试部署使用 `DBG-YYYYMMDD-HHMM-<outputManifestSha256前12位>`。两类都绑定 `sourceManifestSha256`、测试 manifest 结果、开始/结束时间、输出目录、应用包名/版本、HBuilderX/插件/依赖版本、部署或安装回执，以及 MuMu 已安装包的包名、版本、签名摘要和安装时间。
|
||||
- 源码输入与 DBG 输出清单的规范化算法固定为：以各自声明的根目录生成相对路径，路径分隔符统一为 `/`，按相对路径 ordinal 升序，每行写 `sha256<TAB>bytes<TAB>relativePath`，整体使用 UTF-8 无 BOM 与 LF。源码侧沿用第 0 批明确列出的排除集合。DBG 输出根固定为本轮 HBuilderX 新生成的准确输出目录，输出 manifest 存放在根目录之外并递归纳入全部生成文件；输出侧只允许排除存在时的 `Thumbs.db`、`.DS_Store`，且必须逐项记录，除此之外不得排除。`outputManifestSha256` 是完整规范化输出清单的 SHA-256，`sourceManifestSha256` 同理。
|
||||
- 找不到可重复构建/部署入口、无法取得上述任一指纹或安装结果与指纹不一致时记 `INFRA_ERROR`，明确报告“无冻结候选”，不得进入 MuMu 最终验收。任何代码或生成输出变化都会使旧设备证据失效，必须取得新候选 ID 并重验。
|
||||
|
||||
#### 第 6.5—8.25 小时：冻结候选的最终实机验收
|
||||
|
||||
- 本阶段 105 分钟固定拆为：前 10 分钟核对已安装身份、冷启动、证据目录和一次故障恢复余量；随后 65 分钟完成“52 条基线路由＋已批准且已注册新增路由”的合计结构遍历，基线路由优先；最后 30 分钟做 P0 实时 smoke。结构遍历开始时计算 `routeBudgetSeconds=floor(3900/registeredRoutes)`（只有 52 条基线路由时为 75 秒），按基线路由优先的冻结顺序给每条路由一次预算；已启动路由超预算记 `FAIL` 并继续，65 分钟到点仍未启动的路由记 `NOT_RUN`。任何新增路由、低优先路由或故障恢复都不得侵占 P0 时段。
|
||||
- 结构遍历报告基线、已批准新增、实际注册、实际遍历和 `NOT_RUN` 五个分母/结果。P0 smoke 在同一候选上覆盖认证根页 A01、四个主入口 G01/F01/N01/M01、A/G/T P0 主链以及本轮改变的 F/R/N/M 动作；检查上下文、返回、空/错/无权限、重复点击、取消、前后台与迟到响应。更深的状态矩阵在各实现批次持续取证，最终候选至少重复 P0 smoke，旧候选证据不得沿用。
|
||||
- 本地故障注入只能证明客户端分支，不能证明远端实时接口；真实服务不做攻击性 4xx/5xx/429 压测。所有设备证据绑定候选 ID、分辨率、density、角色和种子。
|
||||
|
||||
#### 第 8.25—9 小时：45 分钟保留缓冲与交付收口
|
||||
|
||||
- 本时段是保留缓冲，不安排新功能。前面持续写入的报告在此校验四字段、首次结果、分母、熔断、人工项和继续步骤。
|
||||
- 若前序超时，缓冲只用于恢复、必要重建和最短复验；未完成项分别记清 `checkResult=NOT_RUN`、`productCompletion=PARTIAL` 或 `productCompletion=BLOCKED`，不得混写成一个状态。若缓冲未使用，可增加探索检查，但不得改变冻结候选或既定结论。
|
||||
|
||||
### 6.3 测试风险层级与计数规则
|
||||
|
||||
测试层级在第 0 批依据文件名、manifest 元数据和本轮人工变更账本机械生成，不依赖 Git diff，也不能由执行者为了赶时间临时降级：
|
||||
|
||||
| 层级 | 确定性纳入规则 | 候选门禁 |
|
||||
| --- | --- | --- |
|
||||
| `T0` | `compile-audit.ps1`、路由/导航/会话/运行配置/共享 ID 与权限门禁、第 6.2 节预期阻塞 allowlist，以及本轮每个被修改 owner 对应的合同、runtime 和视觉专项 | 全部必须取得 `PASS` 或精确允许的 `EXPECTED_BLOCKED`；否则无冻结候选 |
|
||||
| `T1` | 与本轮被修改 owner 同域的其余 A/G/T/F/R/N/M mapper/runtime、文档流、状态和响应式回归 | 在 `T_test_cutoff` 前尽量全部执行；未执行项记 `NOT_RUN` 并降低相应域结论 |
|
||||
| `T2` | 未受影响域、历史扩展、仓库卫生与探索性检查 | 仅在 T0/T1 完成且时间有余时调度；不以 T2 未跑伪装全量测试通过 |
|
||||
|
||||
计数恒等式固定为：
|
||||
|
||||
- `baselineInventoryTests=204=150 PS1+54 JS`，4 个 JSON 仅作为数据文件，runner/manifest 仅作编排，均不计可执行测试；
|
||||
- `inventoryTests=baselineInventoryTests+newExecutableTests`，本轮未新增测试脚本时 `newExecutableTests=0`；
|
||||
- `scheduledTests=executedTests+notRunScheduledTests`；
|
||||
- `executedTests=passTests+failTests+expectedBlockedTests+infraErrorTests`，其中 `timedOutTests` 是 `infraErrorTests` 的诊断子集，不重复相加；
|
||||
- `notRunTests=(inventoryTests-scheduledTests)+notRunScheduledTests`。
|
||||
|
||||
`runnerInfraErrors`、构建/部署/安装/设备基础设施错误另列，不进入上述测试项恒等式；只要存在任一此类错误，候选和报告仍按对应退出码失败。报告必须同时给出各层级数量、首次结果和重试结果。默认 120 秒只是单项上限，不是预计耗时；四 worker 也不能用理论并发量承诺完整 inventory 必然在 1.5 小时内跑完。冻结候选只宣称 T0 门禁已满足和实际执行范围，不能把 inventory 数量写成“全通过”。
|
||||
|
||||
## 七、三人交叉复核
|
||||
|
||||
主代理是唯一写入者。两位评审者只读检查每一批的接口、业务、交互、异常和视觉；发现分歧时给出证据并互相反驳，统一结论后由主代理修改。评审在批次边界进行，不并发写文件，也不把开放式讨论拖入下一批。
|
||||
三人固定为主代理和两位只读评审者，主代理是唯一写入者。三人都必须完整检查本规划，不能把范围割裂后只看自己的一部分；为增强对抗性，主代理重点复核产品全量覆盖与参考甄别，评审一重点攻击后端合同、权限和数据闭环，评审二重点攻击执行顺序、时间预算、测试证据和回归风险，然后互相核对对方领域。
|
||||
|
||||
规划评审必须在交给用户确认前完成，至少检查：
|
||||
|
||||
1. 是否覆盖 A/G/T/F/R/N/M、共享基础和参考候选，而非只覆盖认证或 T01。
|
||||
2. 每个采纳动作是否有唯一页面 owner、唯一接口 owner、权限来源、状态矩阵和完成定义。
|
||||
3. T03 是否始终标为未完成，T01 十个入口是否逐项落到真实流程或诚实关闭态。
|
||||
4. 两个参考源是否逐页面、逐动作、逐接口留有结论，是否误带旧地址、旧字段、旧组件、凭据、日志或视觉。
|
||||
5. 52 条基线路由与新增采纳路由是否分母清楚，时间预算是否把阻塞、人工项和最小可靠交付说清。
|
||||
6. 参考资产是否逐文件绑定已批准 PA 和具体页面状态，是否误把用户的候选复用许可解释为整包批准，是否遗漏第三方、隐私、旧品牌、格式、无障碍和性能风险。
|
||||
|
||||
任一评审提出有证据的疑点时，主代理必须修改规划或书面保留为待用户确认项；不能以多数票掩盖未解决的合同冲突。实施开始后，三人仍在批次边界复核接口、业务、交互、异常和视觉，不并发写文件，也不把开放式讨论拖入下一批。
|
||||
|
||||
本次规划评审已于 2026-07-23 收口：
|
||||
|
||||
| 评审角色 | 最终结论 | 已复核证据 |
|
||||
| --- | --- | --- |
|
||||
| 产品主审（主代理） | `PASS` | A/G/T/F/R/N/M 七域、共享 owner、52 条 CUR、T01 十入口、T03 半成品、两个参考源 341 条基记录、166 个 PA、状态分离和 531 项资产逐文件门禁完整；当前项目职责没有被参考项目覆盖 |
|
||||
| 合同评审 | `PASS` | 122 个合同键唯一且 PA 无未定义引用；125 个唯一当前 operation 均可回到 153-operation 只读快照；M08 家谱邀请、G03、TAC、N02、帮助、家族视频与宣传视频 owner 已拆清 |
|
||||
| 执行评审 | `PASS` | 204 项测试基线与动态 inventory、`latestStart`、首候选 30 分钟预留、最终候选双路径、输出指纹、65 分钟路由预算、退出码和双门禁均可机械执行 |
|
||||
|
||||
最终无剩余 P0/P1；评审提出的 P2 也已处理，包括复合来源证据的稳定 `@browse/@comment/@reaction/@share` 后缀。机械结果为：PA-001—PA-166 连续唯一（111 必需、55 候选），初始 42 `PARTIAL`＋69 `BLOCKED`＋55 `NOT_APPLICABLE`；52 条当前路由全部反链；341 条来源基记录均有 PA 或全局去向；两份权威文档无旧计数和表格列错位。
|
||||
|
||||
## 八、无人值守边界
|
||||
|
||||
- 可以继续读取、创建带测试标识的数据、运行测试、构建和操作 MuMu。
|
||||
- 不发送外部消息，不循环请求短信，不破解验证码，不使用生产数据做破坏性试验。
|
||||
- 本节只有用户明确说“开始执行”后生效；此前只允许规划范围内的只读核对和规划文档写入。
|
||||
- 执行授权生效后，可以继续读取、创建带测试标识的数据、运行测试、构建和操作 MuMu。
|
||||
- 不循环请求短信，不破解验证码，不使用生产数据做破坏性试验。除用户指定的最终停止通知外不发送外部消息；本轮真正停止时仅向用户已打开的微信“文件传输助手”发送“已经停下了”。
|
||||
- 不支付、不换绑、不注销、不删除已有家谱或用户内容。
|
||||
- 后端、测试账号、发布签名或 MuMu 人工验证码成为硬阻塞时，记录：失败门禁、请求与响应、复现步骤、解除条件、恢复后的第一步。
|
||||
- 用户有新消息时优先处理；用户说“准备睡了”即进入认证人工窗口。
|
||||
- 用户有新消息时优先处理。只有已经收到“开始执行”后，“准备睡了”才可作为第 0.5—1.75 小时既定认证人工窗口的提前提醒或提前触发；它不改变 `T_start`、不另起第二套时间线，也不能单独授权代码、测试、构建或 MuMu。
|
||||
- Authorization、手机号、OTP、TAC proof、邀请码和个人资料不得进入报告、截图文件名或仓库日志。原始运行日志和截图放在本机临时验收目录，限制容量并在报告中只引用脱敏摘要。
|
||||
- TalkBack、系统大字号和无法可靠自动化的原生辅助功能只做可重复的早晨人工项，自动截图不得冒充无障碍通过。
|
||||
|
||||
## 九、明早交付物
|
||||
|
||||
1. MuMu 中可启动和遍历的测试版本；能够产出测试 APK 时同时给出 APK 路径，缺发布签名不阻塞开发测试包。
|
||||
2. 52 条路由的完成状态与入口清单。
|
||||
3. 页面—接口映射和真实请求结果。
|
||||
4. 自动测试、构建检查和 MuMu 实机验收结果。
|
||||
5. 后端阻塞、测试数据阻塞和需要人工复验的精确清单。
|
||||
6. 明早从登录开始的最短人工回归步骤。
|
||||
7. 运行元数据：源码 HEAD/dirty 状态、开始结束时间、后端地址与可识别版本、MuMu 分辨率/density、账号角色、各项耗时和熔断记录；不包含任何凭据。
|
||||
1. MuMu 中可启动和遍历、且绑定 `APK-*` 或 `DBG-*` 可追溯/可复验指纹、`sourceManifestSha256` 和设备侧安装身份的冻结测试候选；若两类指纹均无法取得，明确交付“无冻结候选”与 `INFRA_ERROR` 证据，不能用旧安装包代替。
|
||||
2. 52 条基线路由及所有已采纳新增路由的入口和结构结果，并分别报告 `baselineRoutes`、`approvedNewRoutes`、`registeredRoutes`、`traversedRoutes` 与 `NOT_RUN` 路由。
|
||||
3. 当前页面—动作—接口映射、真实请求结果，以及两个参考源逐页面/逐动作/逐接口的采纳结论。
|
||||
4. `referenceEvidenceRecords` 与六类证据数量、权威 PA 动作分母、`liveCompletedActions` 和逐动作四字段结果。
|
||||
5. `inventoryTests`、`scheduledTests`、`executedTests`、`notRunTests`、`timedOutTests`，以及构建/部署和 MuMu 实机验收结果。
|
||||
6. 本轮实际评估/采用的 `RAxxx` 参考资产清单、来源确认、改造方式、重复 canonical owner、包体影响及逐状态验收证据；未使用的 531 项不冒充已审。
|
||||
7. 后端阻塞、测试数据阻塞和需要人工复验的精确清单。
|
||||
8. 明早从登录开始的最短人工回归步骤。
|
||||
9. 运行元数据：用户确认的源码基线说明、开始结束时间、后端地址与可识别版本、MuMu 分辨率/density、账号角色、各项耗时和熔断记录；不调用 Git 取得 HEAD/dirty 信息，不包含任何凭据。
|
||||
|
||||
## 十、执行记录
|
||||
## 十、规划阶段只读核对记录
|
||||
|
||||
| 批次 | 状态 | 已通过 | 阻塞或人工项 |
|
||||
| --- | --- | --- | --- |
|
||||
| 断点与映射 | PASS | HEAD、dirty 工作区、OpenAPI 哈希、52 条路由、remote 配置、构建产物、MuMu 设备和当前接口 owner 已核对 | 无 APK；开发测试包可由 HBuilderX 继续运行 |
|
||||
| A 认证与 TAC | 进行中 | 后端密码登录与 challenge 均只读确认 200；认证专项自动门禁已通过；A01 短信默认态 MuMu 视觉已通过 | 四条 TAC/短信流程和倒计时态留待睡前人工窗口 |
|
||||
| B 家谱与世系 | 规划重整中 | G01/G05/T01 已有部分真实接口改动 | 实施冻结；先确认第十一节，再测试先行重做 T01 并复核 T03—T06 |
|
||||
| C/D 内容与族务 | 待执行 | 无 | 待接口盘点 |
|
||||
| E 消息与我的 | 待执行 | M07 已有真实反馈接口基础 | 待接口盘点 |
|
||||
| 全量验收 | 待执行 | 无 | 构建、MuMu 和整体验收待执行 |
|
||||
| 核对对象 | 当前事实 | 规划结论 |
|
||||
| --- | --- | --- |
|
||||
| 当前源码 | 用户确认已手动拉取 2026-07-23 最新 `main`；本轮未执行任何 Git 命令 | 不再沿用旧 HEAD/dirty 断点；以当前文件事实为准 |
|
||||
| 当前活动范围 | `pages.json` 有 52 条活动路由，`pages` 下有 53 个 Vue 文件 | 52 是最低基线；最终分母还要加入明确采纳的新增路由 |
|
||||
| 当前数据接线 | `runtimeConfig.mode` 为 `remote`；仅 A01、A04、A05、G01、G05、T01、M07 七页直接消费 `appApi`；40 页直接导入 `data/mock`，28 页含 `setTimeout` | 七页也须逐动作验真；其余页面逐项归类 LIVE/LOCAL_PREVIEW/CLOSED；timer 不能自动等同假成功，也不能逃过甄别 |
|
||||
| 当前 T03 | 页面已调用 `appApi.getPerson` 的 Apifox 人物详情 owner，具备严格 normalizer、取消控制与无 fixture 回退；测试目录已有静态与 mapper 门禁 | 仍未取得测试账号下的本轮真实人物响应、权限投影、跨页刷新与重进证据；明确为未完成半成品，不得记为 `LIVE_VERIFIED`、页面完成或产品完成 |
|
||||
| 受保护 OpenAPI | 本地 JSON/YAML 快照为 112 paths、153 operations，只读 | operation 存在仅记 `DECLARED_UNVERIFIED`，仍需对照线上文档和真实响应 |
|
||||
| “app设计”源 | `C:\Users\Rain\Desktop\job\app设计` 共 59 PNG＋1 PDF；项目归档与 59 个旧文件哈希一致，新增 `思维导图.png` | 作为第一参考源；新图先用于规划，不在确认前复制 |
|
||||
| 已完成参考项目 | `C:\Users\Rain\Desktop\job\Jiapu-App` 有 78 条活动路由＋1 条注释路由声明、79 Vue、6 NVue、7 个未注册页面文件、113 个旧 API wrapper；使用旧后端封装且没有可用测试脚本 | 作为第二参考源；78 是活动分母，注释路由和未注册文件单列候选；禁止复制其请求层、旧地址、组件和数据模型 |
|
||||
| 参考项目资产 | `Jiapu-App\static` 有 531 个媒体文件、约 6.45 MiB；声明扩展名为 307 PNG、221 GIF、2 SVG、1 JPG，文件签名实为 311 PNG、217 GIF、2 SVG、1 JPG；已发现 6 个扩展名/MIME 不一致、14 组完全重复、第三方/商标、旧品牌、固定旧文案、示例头像与短视频实验素材 | 用户允许逐文件复用候选；不整目录复制。高价值候选优先看水墨/宗祠、谱书、人物卡边框和中性功能图标；QQ 表情、短视频实验、支付/微信品牌、VIP/奖励、旧 logo 先排除直接复用 |
|
||||
| 参考映射 | 权威附件逐一登记 60 个设计文件、78 条活动路由、1 条注释路由声明和 7 个未注册页面文件 | 产品取舍必须在用户确认前完成；执行阶段只重算并冻结，不再用前 30 分钟临场决定范围 |
|
||||
| 测试与设备 | `tests` 下有 208 个文件：150 PS1、54 JS、4 JSON；当前没有统一夜跑 manifest；本轮没有运行测试、构建或 MuMu | 收到“开始执行”后才建立显式 manifest 并取得新鲜证据，旧 PASS 不冒充本轮 PASS |
|
||||
|
||||
### 第 0 批硬预检证据
|
||||
### 当前接口覆盖初判
|
||||
|
||||
- 源码基线：`main`，HEAD `f1edc6b53320755a8638c99d492250153a8dcb17`；工作区包含续作改动，未执行暂存、提交、还原或重置。
|
||||
- 受保护 OpenAPI：
|
||||
- `APP.openapi.yaml`：`8964CD583CE172425B63BBFD802F7EB587EB3641EADFD6F9D3B264FAA8090C6C`
|
||||
- `APP.openapi.json`：`87DB1DC148C5E6E877815AFF7B3A7FC7C7ECA95A2CEC50A88B42F3908961F31A`
|
||||
- 活动路由共 52 条：A 3、G 9、T 7、F 10、R 11、N 2、M 10；导航路由与导航流程门禁均通过。
|
||||
- 当前真实接口 consumer 共 7 页：A01、A04、A05、G01、G05、T01、M07。其余 45 页在逐页接线前均按 `LOCAL_PREVIEW` 或 `CLOSED` 报告，不冒充 LIVE。
|
||||
- MuMu 设备在线：Android 12，720×1280，density 320，HBuilder 基座处于前台；现有 `app-plus` 开发构建可运行，尚无 APK。
|
||||
- 测试账号密码登录成功；只读查询“我的家谱”返回空列表，可作为 G01 空态种子。后续通过 G03 创建带“联调测试”标识的本轮家谱后，登记返回 ID 再继续 owner 链路。
|
||||
- 普通申请、撤回、待审和审核需要第二独立账号形成申请人/管理员双角色；当前缺少第二角色时标为测试数据阻塞，不伪造跨账号通过。
|
||||
- 注册需要一个未注册且能接收短信的手机号；未提供前只完成页面、TAC 前置和接口合同，真实注册标为测试数据阻塞。
|
||||
| 域 | 本地受保护快照中的接口证据 | 明确缺口或待验真项 |
|
||||
| --- | --- | --- |
|
||||
| A 认证 | 登录、短信登录、注册、找回、发码、资料、安全操作均有声明 | TAC 服务端消费、密码 wire、短信场景、会话撤销和真实错误语义仍需验真；微信登录无当前 APP operation |
|
||||
| G 家谱 | mine/public/create/detail/update、普通申请/撤回/审核、成员、字辈和行政区划均有声明 | G03 只有“创建家谱＋另建首位人物”两次独立写；`regionCode` 必填，但第一步响应尚未保证稳定返回词法 `genealogyId`，创建结果查询也没有 operation，因此恢复链为 `MISSING_OPERATION`。只有第一步真实响应本身稳定给出字符串 ID 才允许进入第二步；首写超时、断线、5xx、空体或缺 ID 时立即停止并人工对账，禁止按展示名/“联调测试”标识从无正式 item DTO 的 mine 列表猜 ID，也禁止重复建谱；邀请码签发/直接加入、家谱排序、管理员 capability 没有可靠当前 owner |
|
||||
| T 世系 | tree、人物列表/详情/增改停用、父母/配偶/兄弟姐妹/子女写入均有声明 | 所有读取权限字段缺失；int64 wire、T04 性别字典、T06 原子排行、邀请四段链、两个绑定 mutation owner、头像上传到访问闭环均冲突或缺失 |
|
||||
| F 家族内容 | 动态、评论/回复/点赞、谱文、相册、照片和文件上传有声明 | 视频仅见删除操作，列表/发布/详情链不完整；视频评论、点赞和分享分别是独立候选，不能借动态互动或视频读取合同；置顶等参考动作无当前 owner |
|
||||
| R 族务记录 | 亲友记录、祭祀/献礼、成长记录、备忘录、功德记录有声明 | 人生事件和重要证件无明确 APP owner；参考“贺礼”与当前“祭祀献礼”语义必须先拆清 |
|
||||
| N 消息 | 通知列表、单条已读、全部已读有声明 | 未读计数没有 operation，G01/M01 不得从分页列表长度推断；没有通知详情 operation，列表还是无 item schema 的通用结果；N02 同一会话且列表项含完整正文时的投影单独记 `dataMode=LOCAL_PREVIEW`，冷启动、深链或缓存缺失状态单独记 `dataMode=CLOSED`；业务跳转、消息类型和目标参数均不能从文案猜测 |
|
||||
| M 我的 | 资料、安全、帮助、反馈、推广内容、VIP 套餐/订单有声明 | M08 保持当前家谱邀请 owner，票据查看、签发、撤销分别由 `C-G-INVITE-LIST/ISSUE/REVOKE` 拥有，复制与系统分享分别由唯一平台剪贴板、分享 owner 负责拒绝/失败/返回；邀请票据 operation 当前缺失。参考 APP 推广/推荐码/奖励无当前路由且保持候选；真实支付、提现/变现及部分敏感操作缺完整结果链；“关于”只用本地静态 owner，不依赖帮助列表 |
|
||||
|
||||
## 十一、产品参考功能基线与 T01 世系树重做计划
|
||||
|
||||
### 11.1 参考资料的归档与换路径办法
|
||||
|
||||
1. 原参考目录 `C:\Users\Administrator\Desktop\job\app设计` 只视为一次性导入源，不是项目运行依赖，也不是长期权威路径。业务代码、测试、文档合同和构建脚本均不得硬编码该绝对路径。
|
||||
2. 当前已取得的参考资料保存在项目相对目录 `docs/design/references/产品参考原稿`。该目录作为换电脑、原目录改名或移动后的本地参考副本；是否采用某个功能仍以用户确认和后续中文映射表为准，不能因为图片已归档就默认全部照搬。
|
||||
3. 当前电脑性能较弱，本阶段不批量解码图片、不做 OCR、不生成缩略图、不跑图像相似度或全量构建。用户回家并提供新的参考目录后再执行完整核对。
|
||||
4. 新目录核对只读进行：先枚举相对文件名、类型、大小和 SHA-256，再与项目内参考副本比较；只归档新增或内容变化的文件。旧副本不因源目录缺文件而自动删除，发现冲突先列清单给用户确认。
|
||||
5. 完整核对后建立 `docs/产品参考页面功能映射表.md`。每张参考页面必须映射到：参考文件、项目路由、保留功能、调整后的交互、沿用的国风视觉、明确舍弃的旧行为、接口 owner、数据模式、测试门禁和 MuMu 验收项。没有映射的参考图不得直接驱动代码。
|
||||
6. 参考 App 是功能和交互来源，不是整套视觉照抄目标。项目继续使用当前 `static` 中已确定的国风资产、色彩和组件语言；旧稿的亮红导航、卡片比例等只在用户明确点名时采用。
|
||||
7. 用户回家后的恢复步骤固定为：提供新目录 → 只读清单与哈希差异 → 补充归档 → 完成中文页面映射 → 用户确认映射 → 才把对应功能纳入实现批次。目录再次变化时重复相同步骤，不改业务代码中的路径。
|
||||
8. 用户后续提供的“已经完成的项目”作为第二参考源，价值高于单张截图对交互细节的表达，但仍不是当前项目的需求、接口或代码权威源。即使页面名称相同，也不得默认业务含义、角色权限、字段、接口和异常处理相同。
|
||||
9. 完成项目在用户给出新绝对路径后先只读盘点；第一轮不安装依赖、不运行构建、不修改参考仓库。检查范围包括路由、页面、组件、状态流、API 封装、数据模型、权限判断、视觉资产和异常分支，同时排除凭据、令牌、环境地址、签名、用户数据和机器专属配置。
|
||||
10. 禁止按目录、页面文件或组件整包迁移。甄别和采用的最小单位是“页面中的一个用户动作及其完整状态”，逐项映射后才能进入当前项目的测试先行批次。
|
||||
1. 第一参考源固定为 `C:\Users\Rain\Desktop\job\app设计`，只作为本机规划输入，不是运行依赖。业务代码、测试、接口合同和构建脚本均不得硬编码该绝对路径。
|
||||
2. 该目录当前有 59 张 PNG 和 1 份 PDF。项目相对目录 `docs/design/references/产品参考原稿` 保存了其中 58 张 PNG 和 1 份 PDF，59 个同名文件的 SHA-256 全部一致；源目录新增 `思维导图.png`。在用户确认规划前，不复制新增文件、不删除旧副本。
|
||||
3. `思维导图.png` 同时包含 APP、后台管理、公司官网和 PC 管理端分支。只有“用户端苹果安卓 APP”分支可直接进入当前产品候选池；其他分支只用于理解角色、权限和服务依赖，不能自动变成当前 UniApp 路由。
|
||||
4. 第二参考源固定为 `C:\Users\Rain\Desktop\job\Jiapu-App`。第一轮只读盘点已完成路由、页面和 API wrapper 清单；继续甄别时不安装依赖、不运行构建、不修改参考仓库，也不读取或迁移其 Git 历史。
|
||||
5. 参考项目使用旧的 Vue/uView 结构、旧后端地址和宽松请求封装，且请求层会输出参数和响应；这些实现、环境值、日志方式、Token 处理、组件和数据模型全部禁止迁入当前项目。API wrapper 只用于证明“参考项目曾尝试过某动作”，不能作为当前接口合同。
|
||||
6. `docs/产品参考页面功能映射表.md` 必须在交给用户确认前完成。第一源使用 `Dxxx-Pxx-Sxx-Axx` 标识文件、PDF 页/区域、页面、状态和动作；每张单页 PNG 默认自身就是独立 `S01` 状态证据，表内可省略 `S01` 作短写。第二源按 `Jxxx-Sxx-Axx` 标识 78 条活动路由的状态与动作，注释路由单列 `JX001`，7 个未注册文件使用 `JUxx-Sxx-Axx`。附件必须有正向逐项表和按当前 A/G/T/F/R/N/M owner 的反向覆盖索引；组合展示不能省略任何源 ID。
|
||||
7. 参考截图和参考项目不按文件整包采纳。甄别最小单位固定为“一个页面状态下的一个用户动作”。文件名相近、画面相似、路由目标相同或代码结构近似都不能直接判为重复：它们可能是普通、管理、编辑、空、错误、权限、角色或主题状态。只有入口、对象、动作、数据、接口和返回行为均被证明等价后，才能共用当前 owner；共用后仍须保留每个来源状态 ID。查看、创建、编辑、删除、邀请、分享、支付等动作可以分别得出不同结论。
|
||||
8. 当前项目继续使用已确定的国风资产、色彩和组件语言。参考稿的亮红导航、原卡片比例、旧弹窗、默认 uView 控件和旧图标只表达信息结构，不默认成为视觉验收目标。
|
||||
9. 参考源出现、当前项目没有路由或接口 owner 的功能先进入“候选缺口”，必须判断是复用现有页面、增加新路由、后端缺失暂关，还是与当前产品冲突舍弃；不得为了保持 52 条路由而遗漏，也不得为追求功能数量临时创建假页面。隐私资料、重要证件、资金、删除、退出家谱、所有者转移和账号注销一律作为敏感候选单列，参考源存在不构成采纳授权。
|
||||
10. 两个源再次变化时，重复“只读文件清单与哈希差异 → 更新页面/动作映射 → 记录新旧结论”的流程；不因源目录缺文件自动删除项目内归档，也不在业务代码里保存机器绝对路径。
|
||||
|
||||
### 11.2 T01 目标画面与交互
|
||||
|
||||
@@ -195,7 +427,9 @@ T01 的验收目标不是“能显示一棵文字树”，而是能够识别人
|
||||
- 邀请绑定；
|
||||
- 编辑信息。
|
||||
6. 面板遮罩点击、关闭按钮、Android 系统返回键、页面返回键、重复点击和焦点恢复行为必须一致。提交中的动作禁用重复触发；页面离开或响应迟到时不得把结果写入错误人物。
|
||||
7. 操作入口是否可见和可用由服务端权限或明确能力字段决定。不能因为当前账号从管理入口进入，就在前端猜测其拥有编辑、邀请或调整关系权限。
|
||||
7. 当前 Apifox 的 tree/person/member 投影均没有稳定 `canEdit/canInvite/canManage/actionCapabilities` 字段，前端不得猜测角色或伪造 capability。十个必需入口保持可发现；已有单一 declared write operation 的入口可提交最小白名单请求，由服务端最终裁决，并对 403/409/5xx/超时明确失败且不本地假成功。403 只能证明该次请求被拒绝，不能反推出可持续的前端权限。每个动作账本仍须记录权限字段、来源 operation、撤权后的刷新和 403 语义。
|
||||
|
||||
已完成参考项目只证明这组动作是产品候选，不证明实现可迁移：其树页面中“添加女儿”仍复用了 `addSon` 意图、“添加母亲”存在注释掉的入口、“邀请绑定”按钮没有闭合动作，删除又混用旧通用用户接口。因此 T01 必须按十个入口分别定义意图和合同，不能复制参考页面后把同名按钮视为完成。
|
||||
|
||||
### 11.3 页面职责与唯一 owner
|
||||
|
||||
@@ -205,11 +439,20 @@ T01 的验收目标不是“能显示一棵文字树”，而是能够识别人
|
||||
| T03 成员详情 | 读取并展示真实人物资料；承接“点击头像查看资料” | 不以本地 fixture 冒充服务端人物 |
|
||||
| T04 添加亲属 | 统一承接父亲、母亲、配偶、兄弟姐妹、儿子、女儿六类新增关系 | 不为六个入口复制六套提交合同，不猜测缺失 ID |
|
||||
| T05 编辑成员 | 修改头像和允许编辑的基础人物资料 | 不承担排行或关系拓扑修改 |
|
||||
| T06 关系维护 | 调整排行及后端明确支持的关系维护 | 不退化为另一份通用人物编辑页 |
|
||||
| T06 排行调整 | 原子调整同辈排行 | 不退化为另一份通用人物编辑页，也不保留旧“关系修正本地预览”假成功路径；关系修正若以后获批必须另立产品动作和原子合同 |
|
||||
| 邀请绑定流程 | 在独立合同下邀请用户并绑定人物 | 不与普通加入家谱申请或邀请码直接加入混为一条链 |
|
||||
| T07/T08 | 成员目录、成员状态等辅助读取 | 不成为 T01 写操作的旁路 owner |
|
||||
|
||||
T04 的六个入口只传递稳定的词法 ID、`relationType` 和必要的意图提示；页面先展示当前人物和待添加关系，最终字段及性别等约束由后端合同校验。不得复制人物来模拟配偶，也不得仅凭“儿子/女儿”等按钮文案在本地推导超出请求意图的数据。
|
||||
T04 的六个入口只在路由内部传递经 validator 验证的十进制字符串 ID、内部 `relationType` 枚举和必要意图提示；`relationType` 不是 wire 字段，严禁发送到 `additionalProperties:false` 的 `LineagePersonBody`。页面先展示当前人物和待添加关系，只有性别字典、关系约束和真实响应共同确认后才允许提交。不得复制人物模拟配偶，也不得仅凭中文按钮在本地猜测 wire 值。
|
||||
|
||||
| UI 意图 | 完整 endpoint | 请求意图约束 | 当前状态 |
|
||||
| --- | --- | --- | --- |
|
||||
| 添加父亲 | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/parents` | 关系方向由 `/parents` owner 决定；只发送当前已声明并采集的基础人物字段，不发送 `relationType` 或猜测的性别 code | `DECLARED_UNVERIFIED`，待测试账号实测服务端性别/冲突/权限与读后刷新 |
|
||||
| 添加母亲 | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/parents` | 同上；不得将“母亲”中文标签直接当成 `sex` wire | `DECLARED_UNVERIFIED`，待实测 |
|
||||
| 添加配偶 | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/spouses` | 不发送 `relationType`；`relationName` 未由页面采集，暂不猜测 | `DECLARED_UNVERIFIED`，待关系方向、重复/冲突、权限与读后刷新实测 |
|
||||
| 添加兄弟姐妹 | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/siblings` | 不发送 `relationType`；不把单人 `sortOrder` 当同辈排行 | `DECLARED_UNVERIFIED`，待字典/冲突/权限实测 |
|
||||
| 添加儿子 | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/children` | 关系方向由 `/children` owner 决定；不猜测性别 code | `DECLARED_UNVERIFIED`，待实测 |
|
||||
| 添加女儿 | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/children` | 同上 | `DECLARED_UNVERIFIED`，待实测 |
|
||||
|
||||
### 11.4 接口映射与启用条件
|
||||
|
||||
@@ -217,29 +460,42 @@ T04 的六个入口只传递稳定的词法 ID、`relationType` 和必要的意
|
||||
| --- | --- | --- | --- |
|
||||
| 展示世系树 | T01 | `GET /genealogy/app/genealogies/{genealogyId}/lineage/tree` | 树 DTO、稳定 ID、代际、配偶与父子连接关系已收紧并通过运行时测试 |
|
||||
| 查看人物资料 | T03 | `GET /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}` | 路由参数与响应投影一致，不回退 fixture |
|
||||
| 添加儿子/女儿 | T04 | `POST .../lineage/persons/{personId}/children` | 请求 DTO、写入结果、重复提交与结果未知规则明确 |
|
||||
| 添加父亲/母亲 | T04 | `POST .../lineage/persons/{personId}/parents` | 同上，并由服务端校验关系冲突 |
|
||||
| 添加兄弟姐妹 | T04 | `POST .../lineage/persons/{personId}/siblings` | 同上，不通过复制已有节点伪造 |
|
||||
| 添加配偶 | T04 | `POST .../lineage/persons/{personId}/spouses` | 同上，并能读取提交后的真实关系 |
|
||||
| 添加儿子/女儿 | T04 | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/children` | 性别 enum、请求 DTO、写入结果、重复提交与结果未知规则明确 |
|
||||
| 添加父亲/母亲 | T04 | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/parents` | 同上，并由服务端校验关系冲突 |
|
||||
| 添加兄弟姐妹 | T04 | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/siblings` | 性别/排行合同明确，不通过复制已有节点伪造 |
|
||||
| 添加配偶 | T04 | `POST /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}/spouses` | 请求合同明确，并能读取提交后的真实关系 |
|
||||
| 编辑人物资料/头像引用 | T05 | `PUT /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}` | 字段白名单、头像上传/引用/访问 URL 闭环和结果确认完整 |
|
||||
| 调整排行 | T06 | 后端明确支持的关系或 `sortOrder` 写操作 | 并发、权限、冲突和结果确认规则明确后才启用 |
|
||||
| 邀请绑定 | 独立流程 | 待 Apifox、线上合同和真实响应共同确认 | 必须有明确 operation、身份安全和幂等/结果查询规则；缺失时显示“服务暂未开放” |
|
||||
| 调整排行 | T06 | 仅有候选 `PUT /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}` 的 `sortOrder` | 当前为 `CONTRACT_CONFLICT`：无批量/原子同辈重排、版本或冲突协议，不得逐人写出部分成功 |
|
||||
| 邀请签发、送达与接受 | 独立邀请流程 | 无可靠 operation | `contractState=MISSING_OPERATION`，保持关闭 |
|
||||
| 邀请目标身份查找 | 独立邀请流程 | 无隐私安全的可靠 operation | `contractState=MISSING_OPERATION`，保持关闭 |
|
||||
| 绑定 mutation | 独立邀请流程 | 成员 PUT 的 `lineagePersonId` 与人物 PUT 的 `appUserId` 是两个候选 | `contractState=CONTRACT_CONFLICT`，确认唯一 owner 前禁止双写 |
|
||||
| 邀请绑定结果查询 | 独立邀请流程 | 无可恢复查询 operation | `contractState=MISSING_OPERATION`，结果未知时禁止重试 |
|
||||
|
||||
接口路径中的 `...` 仅是规划表的共同前缀缩写，实际合同和测试必须写完整路径。`avatarOssId` 的 owner 是统一上传与文件访问链路；未确认上传、文件引用和可访问 URL 三段闭环前，T05 不显示假上传成功。邀请绑定没有独立后端 operation 时记为 `EXPECTED_BLOCKED`，不能借用普通家谱加入申请或邀请码接口。
|
||||
`avatarOssId` 的 owner 是统一上传与文件访问链路；未确认上传、业务实体更新、文件引用和可访问 URL/重进显示四段闭环前，T05 不显示假上传成功。
|
||||
|
||||
邀请绑定拆成四段独立账本：
|
||||
|
||||
1. 邀请签发、送达、接受：当前没有 operation，保持关闭。
|
||||
2. 查找目标身份：当前没有隐私安全的独立 operation，保持关闭。
|
||||
3. 绑定已有成员/用户：`PUT /genealogy/app/genealogies/{genealogyId}/members/{memberId}` 的 `lineagePersonId` 与 `PUT /genealogy/app/genealogies/{genealogyId}/lineage/persons/{personId}` 的 `appUserId` 是两个冲突候选；真实合同确认后只能选择一个 owner。
|
||||
4. 结果查询：当前没有可恢复 operation，结果未知时不得重试或双写。
|
||||
|
||||
邀请绑定不能借用普通加入申请、邀请码直入或同时调用两个候选 mutation。关闭态检查可以为 `PASS`，但该必需动作的 `productCompletion` 仍为 `BLOCKED`。
|
||||
|
||||
所有写操作都必须定义提交中、成功、明确失败和结果未知四种结果。只有后端合同明确支持幂等或存在无副作用的结果查询时才允许安全恢复；超时、断网或 5xx 后不能用 timer 自动提示成功，也不能把本地草稿当成服务端已提交。
|
||||
|
||||
### 11.5 数据与状态约束
|
||||
|
||||
- `genealogyId`、`personId`、父母/配偶/子女引用均按稳定词法 ID 处理，不转数字、不截断、不以姓名定位。
|
||||
- 树投影至少明确头像访问结果、姓名、关系类型、代际、父母引用、配偶引用、同辈排行 `sortOrder` 和权限/能力；字段缺失必须进入可解释失败或降级状态，不能静默拼错树。
|
||||
- `genealogyId`、`personId`、`memberId`、`appUserId`、文件与亲属引用都以十进制字符串为唯一 ID owner。当前 OpenAPI 的 `integer/int64` 与 JavaScript 安全精度冲突；只有服务端响应以字符串返回且请求接受字符串后才能启用。超过安全整数的 number 不得在解析后转字符串补救。
|
||||
- 树投影至少明确头像访问结果、姓名、关系类型、代际、父母引用、配偶引用、同辈排行 `sortOrder` 和权限/能力；当前 capability 未声明，所有写入口先关闭。字段缺失必须进入可解释失败或降级状态，不能静默拼错树。
|
||||
- 关系类型采用单一枚举 owner，页面、API adapter、validator、测试和文档共同消费，禁止各页面维护中文字符串分支。
|
||||
- 排行调整的并发和最终顺序由服务端结果负责；前端可以预览但不能在服务失败后保留假顺序。
|
||||
- `sex`、关系、人物状态和排行语义都必须由真实合同提供 enum；T04 内部意图不能充当 wire 字典。
|
||||
- 排行调整当前为 `CONTRACT_CONFLICT`。在后端提供原子同辈顺序结果或明确并发协议前，前端只可展示关闭说明，不得逐人物写 `sortOrder` 或在失败后保留假顺序。
|
||||
- 恢复信息不得持久化手机号、头像原图、身份证明、邀请凭据等 PII；只保留完成恢复所需的最小非敏感标识和状态。
|
||||
|
||||
### 11.6 测试先行与实施顺序
|
||||
|
||||
规划经用户确认后，T01/T03—T06 按以下独立小批次执行，每批由主代理写入、两位评审者只读复核接口、业务、交互、异常和视觉，当前批通过后才进入下一批：
|
||||
只有规划经用户确认且用户随后明确说“开始执行”后，T01/T03—T06 才按以下独立小批次执行。每批由主代理写入、两位评审者只读复核接口、业务、交互、异常和视觉，当前批通过后才进入下一批：
|
||||
|
||||
1. **T01-0 失败门禁**：先新增会失败的合同，锁定头像节点、姓名/关系/代际、唯一人物操作面板、十个动作入口，并禁止旧底部操作条与新面板并存。
|
||||
2. **T01-1 树 DTO 与布局**：收紧树 normalizer 和 validator，验证父母、配偶、子女、代际、排行、缺头像、失真 ID、重复节点、断链及循环关系；旧宽 DTO 必须失败。
|
||||
@@ -250,22 +506,26 @@ T04 的六个入口只传递稳定的词法 ID、`relationType` 和必要的意
|
||||
7. **性能与视觉验收**：以小树、数十代、数百成员、长姓名、无头像和多配偶数据检查布局预算、滚动流畅度、连接线及内存；不以无限数据承诺替代明确上限。
|
||||
8. **MuMu 与无障碍**：先在 720×1280 实机检查，再补 320/412 响应式检查；验证触控尺寸、文本缩放、读屏名称、焦点顺序、弹层焦点约束、系统返回和低性能设备操作反馈。TalkBack 等无法稳定自动化的项保留可复现人工步骤。
|
||||
|
||||
### 11.7 T01 完成定义
|
||||
### 11.7 T01 检查结果与产品完成定义
|
||||
|
||||
T01 只有同时满足以下条件才能标记为 `PASS`：
|
||||
T01 必须分别报告结构/关闭态检查和产品完成度：
|
||||
|
||||
- 头像卡、连接线、选择态、唯一操作面板、十个入口可发现、禁用原因、返回行为等可以分别得到 `checkResult=PASS/FAIL`。
|
||||
- 某入口因真实后端缺失而正确显示“服务暂未开放”，只表示该关闭态检查 `PASS`；该入口的 `productCompletion=BLOCKED`，T01 产品完成度也不得为 `COMPLETE`。
|
||||
- T01 只有以下全部成立时才可记 `productCompletion=COMPLETE`：
|
||||
|
||||
1. 真实头像或确定性默认头像可见，姓名、关系、代际和连接线正确。
|
||||
2. 点击任一人物只打开一个完整操作面板，十个入口均能到达正确页面/流程，或在后端确实缺失时明确显示服务未开放。
|
||||
3. T03 展示真实详情；T04 六类关系写入、T05 编辑和 T06 排行/关系操作各自遵守唯一 owner，没有 fixture、timer、兼容旁路或假成功。
|
||||
4. 树刷新后能以服务端数据确认变更；写结果未知时停止重复写并提供恢复路径。
|
||||
2. 点击任一人物只打开一个完整操作面板；查看资料、父亲、母亲、配偶、兄弟姐妹、排行、儿子、女儿、邀请绑定和编辑十个入口均完成真实权限与业务闭环。
|
||||
3. T03 展示真实详情；T04 六类关系写入、T05 编辑、T06 原子排行及独立邀请绑定各自遵守唯一 owner，没有 fixture、timer、兼容旁路或假成功。
|
||||
4. 树刷新和重进后能以服务端数据确认变更；写结果未知时停止重复写并提供只读恢复路径。
|
||||
5. 当前国风视觉一致，长世代滚动、卡片、连接线、遮罩和返回行为在目标尺寸上稳定，无白块、截断、误触和不可读状态。
|
||||
6. 接口、业务、交互、异常、视觉、性能和无障碍门禁通过三人交叉评审；自动测试、编译检查和 MuMu 实机证据齐全。
|
||||
6. 接口、业务、交互、异常、视觉、性能和无障碍门禁通过三人交叉评审；自动测试、编译检查和绑定冻结候选包的 MuMu 实机证据齐全。
|
||||
|
||||
### 11.8 当前暂停项
|
||||
|
||||
- 已新增的 `tests/t03-member-api-runtime-smoke.js`、`tests/t03-member-remote-contract.ps1` 以及 `utils/api.js` 中 T03 normalizer 属于规划重整前留下的半成品。T03 页面尚未完成真实接线，因此整体状态是“暂停、未完成”，规划确认后从失败门禁重新核对，不能计入已完成页面。
|
||||
- 当前 T01 已有的文字节点、简单选中态、底部“查看资料/添加亲属”以及任何单张 MuMu 预览都不构成本节验收证据。
|
||||
- 在用户确认本节前不继续修改 T01/T03—T06，不批量处理参考图，不运行构建或 MuMu 验收。
|
||||
- T03 的远端 `GET` 已按 Apifox 人物详情 owner 接线并通过静态/运行时映射门禁，但尚未以测试账号取得本轮脱敏真实响应，仍是 `DECLARED_UNVERIFIED`，不能计入 `LIVE_VERIFIED` 或页面完成。
|
||||
- T01 旧的固定底部“查看资料/添加亲属”抽屉已经移除；当前只有点击人物卡打开的唯一人物操作面板。任何单张 MuMu 预览都不构成本节完整验收证据。
|
||||
- 在用户明确说“开始执行”前不继续修改 T01/T03—T06，不批量处理参考图，不运行测试、构建或 MuMu 验收。
|
||||
|
||||
### 11.9 已完成参考项目的逐项甄别门禁
|
||||
|
||||
@@ -295,7 +555,74 @@ T01 只有同时满足以下条件才能标记为 `PASS`：
|
||||
| 仅参考交互 | 只能借鉴信息结构或操作方式 | 不复制其数据层、API 代码和环境配置 |
|
||||
| 后端缺失，暂时关闭 | 当前服务没有可靠 operation 或结果确认链 | 保留诚实关闭态并登记解除条件 |
|
||||
| 与当前产品冲突，明确舍弃 | 违反当前需求、架构、安全或视觉口径 | 记录舍弃原因，禁止后续人员再次误迁移 |
|
||||
| 待用户确认 | 证据足够但会扩大产品范围、引入敏感能力或改变既有需求 | 保留书面选项，不进入代码批次 |
|
||||
|
||||
`docs/产品参考页面功能映射表.md` 对完成项目增加以下列：参考仓库相对路径、参考路由、候选动作、参考状态流、当前目标路由、当前接口证据、差异、甄别结论、改造边界、测试 owner 和用户待确认项。存在分歧或证据不足时标记“待确认”，不得由代理静默选择。
|
||||
|
||||
参考项目不得向当前仓库带入旧后端地址、账号、Token、密钥、签名、应用标识、用户数据、构建产物、依赖缓存或 Git 历史。采用其功能也必须重新通过当前项目的合同测试、运行时测试、编译、MuMu 视觉与三人交叉评审；“参考项目里能运行”不能作为当前项目完成证据。
|
||||
|
||||
### 11.10 参考项目资产逐文件复用门禁
|
||||
|
||||
用户已经允许把参考项目中的图标等资产拿来补足当前产品。该许可按“可进入逐文件甄别池”执行，不按“整包照搬”执行。规划期只读盘点得到：
|
||||
|
||||
- `C:\Users\Rain\Desktop\job\Jiapu-App\static` 共 531 个媒体文件、6,764,740 bytes（约 6.45 MiB）；`assets` 只有 JS/CSS/SCSS，`uni_modules\uni-id.zip` 是依赖包而非产品资产。
|
||||
- 声明扩展名为 PNG 307、GIF 221、SVG 2、JPG 1；文件签名实为 PNG 311、GIF 217、SVG 2、JPG 1。6 个文件扩展名与 MIME 不一致，迁入前必须规范重导出。
|
||||
- SHA-256 完全重复 14 组、28 个文件，迁入时每组只能选择一个 canonical owner。
|
||||
- `static/emojis/qq` 434 项、`static/douyin` 18 项及旧视频实验图标、微信/支付宝/支付/VIP/奖励素材、旧 logo 和固定旧文案均有第三方、旧品牌或未批准业务风险，不能因文件存在而启用对应产品功能。
|
||||
- 水墨/宗祠、谱书、人物卡边框、中性功能图标和默认头像风格是高价值候选；其中固定姓氏、口号、生成者/提示词式文件名、示例人物、水印及低分辨率仍须逐文件处理。
|
||||
|
||||
每个实际考虑复用的文件在复制前建立 `RAxxx` 记录，至少包含：源绝对/相对路径、SHA-256、重复组与 canonical ID、声明扩展名/检测 MIME、尺寸/帧数/透明度/bytes、来源页面和状态、目标 PA/路由/组件/状态、语义用途、决策、复用方式、用户对参考项目的许可记录、第三方/商标信号、个人数据/旧品牌/固定文字/无障碍/性能风险、必要改造和验收证据。决策仍使用六类口径；复用方式固定为原文件、裁切重导出、重绘、仅构图参考或禁用。
|
||||
|
||||
逐文件门禁为：
|
||||
|
||||
1. **产品门**：必须绑定已批准 PA、页面、状态和动作；资产不能反向新增功能、解除后端关闭或扩大 55 个候选 PA。
|
||||
2. **状态门**：相似图标或画面也可能代表普通、选中、禁用、权限、错误等不同状态；未证明语义和行为等价前分别记录、分别验收。
|
||||
3. **来源门**：用户已允许评估并复用参考项目资产；带 QQ、抖音、微信、支付宝等第三方/商标信号的文件还需满足当前平台规范，来源不清时只能重绘或不用，规划不写“已拥有版权”结论。
|
||||
4. **隐私与品牌门**：不带示例真人/头像、二维码、手机号、姓名、水印、定位、旧 logo、旧口号、奖励/VIP/支付旧文案或固定姓氏。无 EXIF 不等于无个人数据，仍须看画面。
|
||||
5. **技术与安全门**：扩展名与 MIME 一致；SVG 不含脚本、外链或未经审查的 data URI；位图去无用元数据；重复哈希只保留 canonical；不得沿用旧绝对路径或外部 URL。
|
||||
6. **视觉与无障碍门**：服从当前国风 token；覆盖普通、选中、禁用、加载、错误和关闭态；小图放大不糊，功能图标有语义文本，装饰图不进入读屏，动图提供静态降级和减少动态效果。
|
||||
7. **性能与验证门**：记录解码尺寸、包体和首屏影响；超预算就压缩、重绘或按需加载。只对实际采用的 RA 在目标路由各批准状态做 MuMu 截图、缩放、离线/失败检查，并绑定冻结候选 ID。
|
||||
|
||||
首批优先甄别而非预先批准的候选包括 `static/iconpng/902.png`、`static/iconpng/z8526@2x.png`、`static/login/bj.jpg`（实为 PNG）、`static/iconpng/treeBJ.png`、`static/iconpng/book.png`、`static/icon/index.svg`、`static/navigation/*`、`static/tabulation/*`、`static/pu/*`、`static/jr.png`、默认头像风格和 `static/login/hd*.gif`。`jiap.svg` 约 397 KiB 且内嵌大位图与固定文字，只作构图参考。规划确认时固定 `referenceAssetFiles=531`、`approvedDirectReuseAssets=0`、`approvedAdaptReuseAssets=0`；收到“开始执行”后，只有通过上述逐文件门禁的 RA 才增加采用数，这属于已批准 PA 内的实现选择，不改变产品动作分母。九小时批次只甄别本轮已批准 PA 实际需要的资产，未选中的候选保持未审、未复制，不把“531 个进入候选池”写成“531 个必须在今晚迁入”。
|
||||
|
||||
### 11.11 全项目功能补足矩阵
|
||||
|
||||
下表是本轮权威规划的全项目检查骨架；逐页、逐动作和逐接口结论已经落在权威附件中。执行第 0 批只重算并冻结这些结论，不得再临场扩大产品范围。
|
||||
|
||||
| 当前域 | 当前活动路由 | 两个参考源提供的候选 | 本轮必须做出的结论 |
|
||||
| --- | --- | --- | --- |
|
||||
| A 认证 | A01、A04、A05 | `登陆.png`、参考项目登录/注册/找回页，以及账号密码、短信、注册、找回、微信登录等动作 | 四条现有认证流程继续以 TAC 和当前后端为准；微信登录没有当前 APP operation，只能标记候选关闭或待用户确认，不能借旧接口接入 |
|
||||
| G 家谱工作区 | G01、G03、G05、G06、G08—G12 | 家谱列表、创建、加入、邀请码、家谱主页、字辈、家谱排序、始祖世代、管理员及权限 | G03 固定为“创建家谱→创建首位人物”两阶段，但恢复链按 `MISSING_OPERATION` 关闭：`regionCode` 由共享行政区划 owner 提供；只有第一步真实响应本身稳定返回词法 `genealogyId` 才登记待续办 ID 并进入第二步。首写结果未知或缺 ID 时停止并人工对账，禁止从 mine 列表按展示名/测试标识猜 ID，禁止假定通用对象壳含 ID，也禁止重复建谱。其余列表/搜索/普通申请/审核/设置/字辈逐项验真，邀请码直入、家谱排序、始祖世代和管理员权限分别判断 owner |
|
||||
| T 世系与成员 | T01、T03—T08 | 头像树、表格/树谱模式、人物资料、父母/配偶/兄弟姐妹/儿女、排行、邀请绑定、编辑及参考项目中的删除 | T01 十个必需入口逐项落到 T03/T04/T05/T06/独立邀请流程；T03保持未完成；删除人物/配偶不是本轮十个入口之一，须单列敏感候选，不能因参考项目有按钮而默认加入 |
|
||||
| F 家族内容 | F01—F10 | 家族圈、发布/删除/评论、谱文分类与增改删、相册分类与照片管理、视频列表/发布/编辑及短视频评论/点赞/分享 | 动态、谱文、相册、上传逐动作核对当前合同；视频浏览、评论、点赞、平台分享已拆成独立候选 owner，缺合同时诚实关闭，不用旧 API、动态评论 owner 或本地计数假成功 |
|
||||
| R 人物与族务 | R01—R11 | 人物、人情簿、贺礼邀请、成长日志、备忘录、功德录、重要证件 | R01/R02 分别作为人物目录、人物资料的独立路由状态，数据只消费 T07/T03/T05 的唯一列表/详情/编辑 owner；R02 不保留通用“新建人物本地预览”，编辑入口只导航 T05。亲友记录、祭祀/献礼、成长、备忘、功德按当前业务语义接线；“贺礼邀请”与“祭祀献礼”先拆分语义；人生事件和重要证件缺 owner 时进入候选缺口 |
|
||||
| N 消息 | N01、N02 | 加入申请、生日、贺礼、备忘、疫苗、点赞评论、推广、广告消息及详情 | 当前只有列表与已读合同，未读计数缺 operation，G01/M01 使用同一个关闭 owner 而不从分页长度推断；N02 无详情 operation。同一会话且列表项含完整正文时的投影是独立状态，记 `dataMode=LOCAL_PREVIEW`；冷启动、深链或缓存缺失是另一独立状态，明确返回 N01 并记 `dataMode=CLOSED`。只有服务端提供闭合详情、消息类型、目标 route key、参数和权限失效语义后才恢复 LIVE 详情与业务跳转 |
|
||||
| M 我的 | M01—M10 | 个人资料、帮助、设置、修改密码/手机、反馈、家谱邀请、VIP、注销、提现/变现 | M08 保持“选择家谱并管理家谱邀请票据”的当前职责，票据查看/签发/撤销与本地复制/系统分享分别归 `C-G-INVITE-LIST/ISSUE/REVOKE`、`C-S-PLATFORM-CLIPBOARD/SHARE`，缺真实 operation 时保持关闭；参考 APP 推广、推荐码、奖励和变现不得覆盖 M08，均维持无当前路由候选。支付、注销、换绑和提现属于敏感动作，必须有独立合同、人工窗口和结果确认 |
|
||||
|
||||
跨域共享项也必须进入映射：登录态与账号切换、当前家谱上下文、角色/capability、文件上传与访问 URL、通知回流、深链参数、缓存失效、写结果未知、Android 返回、触控、系统字号、TalkBack 和长列表性能。任何一个共享项不得在 A/G/T/F/R/N/M 各自复制一份合同。
|
||||
|
||||
第一轮已识别但不能静默纳入今晚代码的参考候选如下：
|
||||
|
||||
| 候选 | 参考证据 | 当前判定 |
|
||||
| --- | --- | --- |
|
||||
| 微信一键登录 | 思维导图与参考登录页 | 当前后端无 APP operation，`后端缺失，暂时关闭`；是否长期需要由用户后续确认 |
|
||||
| 管理员列表与细粒度权限 | 思维导图、参考 `admin` 三页 | 当前只有成员类接口证据，没有闭合的管理员角色/权限 owner，先列 `待用户确认` 与后端缺口 |
|
||||
| 家谱排序、始祖世代调整 | 参考 `sortGenealogy`、`ancestorsOrder` 与设计图 | 与 T01 人物排行、G12 字辈排序不是同一合同；分别缺可靠 owner，不能互相借用 |
|
||||
| 重要证件 | 参考 `document` 页面 | 当前 52 路由和 APP 合同均无 owner，列产品候选，不临时新增假入口 |
|
||||
| 家族圈置顶 | 思维导图 | 当前动态合同未见置顶 capability，暂时关闭 |
|
||||
| 广告/宣传视频 | 参考消息广告和宣传视频页面 | 与当前普通通知、通用推广和 F10 家族视频分开甄别；独立使用 `C-M-PROMO-VIDEO` 及其评论/点赞/分享候选 owner，无可靠 operation 时不采用 |
|
||||
| 提现、分享变现 | 参考“我的”页面 | 涉及真实资金且不属于已确认当前需求，保持 `待用户确认`，今晚不执行 |
|
||||
| 删除世系人物/配偶 | 参考 T01 操作面板 | 当前后端虽有停用人物声明，但用户本轮明确的是十个其他入口；删除必须另设权限、影响预览和二次确认后再决定 |
|
||||
| 扩展个人隐私资料 | 设计人物表单中的微信、QQ、住址、学历、职业等字段及参考重要证件页 | 当前需求未授权扩展收集，后端也无闭合隐私/可见性 owner，结论为 `与当前产品冲突，明确舍弃`；只保留反例证据，不采纳、不存储、不上传 |
|
||||
| 移除成员、退出家谱、所有者转移、账号注销 | 参考家谱列表/我的页与当前成员类声明 | 均为破坏性或身份敏感动作，必须单独产品确认、影响预览、再认证、结果查询和人工窗口；不因存在 operation 自动启用 |
|
||||
|
||||
### 11.12 确认与执行门禁
|
||||
|
||||
1. 用户已明确“需求说完了”，需求收集门禁已关闭。
|
||||
2. 主代理完成本文修订后，由三人按第七节交叉评审；只允许主代理吸收意见修改本文。
|
||||
3. 三人评审收口后，把完整修订版、主要变化、评审结论和仍待确认项交给用户。
|
||||
4. 交付用户时必须把两项单独列明并取得确认：`T_due=2026-07-24 08:00` 是否接受；55 个候选 PA 本轮是否维持 `approvedCandidateActions=0`。笼统沉默不视为接受具体截止时间或批准候选。
|
||||
- 用户已于 2026-07-23 确认将截止更新为 08:00，并确认 55 个候选 PA 本轮维持 `approvedCandidateActions=0`。
|
||||
5. 用户确认规划只代表规划定稿，业务代码、接口接线、样式、测试、构建和 MuMu 仍保持冻结。
|
||||
6. 只有用户明确说“开始执行”，第六节计时和第 0 批才启动；第 0 批只重算、冻结已确认映射和环境，不得重新解释为需求收集。
|
||||
7. 用户未说“开始执行”时，不因时间已到“今晚”而自行开工，也不把只读规划核对解释为代码阶段已经开始。
|
||||
|
||||
Reference in New Issue
Block a user