修改功能

2026-08-29 19:06:07 +08:00
parent f94c652c7c
commit aaed0584b1
142 changed files with 6176 additions and 869 deletions
@@ -2,7 +2,7 @@

 ## 使用边界

-`Jiapu-App` 只作为产品信息架构参考。本项目的真实读取、写入和权限判断只使用当前 PC 契约及 `utils/ApiClient.js`；不得复制 App 请求路径、参数、缓存编号或测试身份信息。
+参考项目固定为 `C:\Users\Rain\Desktop\job\Jiapu-App`，只用于核对产品信息架构。本项目的真实读取、写入和权限判断只使用当前 PC 契约及 `utils/ApiClient.js`；不得复制 App 请求路径、参数、缓存编号或测试身份信息。

 没有当前 PC 接口契约的能力必须保留明确的不可操作状态，不能以静态数据、二维码、金额或成功提示替代。

@@ -14,8 +14,22 @@
 | 修改密码、换绑手机、注销、退出登录 | `profile-security.html` | 使用认证 PC 契约；表单具备校验、提交中和失败反馈。 |
 | 意见反馈、我的工单 | `profile-feedback.html`、`submit-ticket.html`、`my-tickets.html`、`ticket-detail.html` | 使用当前账号的反馈集合，提交后重读确认。 |
 | 帮助中心、平台联系与协议 | `help.html`、`profile-services.html` | 帮助文章读取使用 PC 契约；平台说明使用站内页面。 |
-| 会员套餐与订单 | `profile-services.html` | 可选择服务端套餐和我的家谱创建订单并重读；PC 未开放在线支付。 |
-| 分享奖励、推广收益、提现、推荐偏好 | `profile-share.html`、`profile-services.html` | 当前 PC 无对应读取或写入契约，明确不可操作。 |
+| 会员套餐与订单 | `profile-services.html` | 读取购买能力、套餐与订单，创建微信 NATIVE 支付单并生成扫码二维码，可查询或关闭支付。 |
+| 推广收益、提现 | `profile-earnings.html`、`profile-share.html`、`profile-services.html` | 读取余额、不可变流水和提现记录；收款码由统一上传接口产生 OSS ID，提现请求使用稳定幂等号。 |
+| 分享奖励、推荐偏好 | `profile-share.html`、`profile-services.html` | 当前 PC 无对应读取或写入契约，明确不可操作。 |
+
+## App 差异与承载决策
+
+| App 能力或入口 | 核对结果 | PC 承载方式 |
+| --- | --- | --- |
+| 家谱功能菜单 | 字辈、世系、谱文、家族圈、相册、视频、功德、祭祀、成长、证件、备忘、亲友、成员管理、会员与订单均已有真实 PC 闭环。 | 保留在 `profile-family-home.html` 的桌面工作台，不新增重复总览页。 |
+| 发布动态、邀请家人 | PC 已有独立表单和一次性邀请闭环。 | 使用 `profile-feed-edit.html`、`profile-invite.html` 独立页面；两者都有多字段或需要上下文，不使用弹窗。 |
+| 应用分享与邀请奖励 | App 通过用户编号在客户端拼接分享地址；后端只有 App 推荐关系读取接口，没有 PC 分享链接契约。 | `profile-share.html` 只说明移动端分享边界，并引导到 `profile-earnings.html` 查看真实收益和提现；不伪造二维码，也不新增页面。 |
+| 个性化推荐开关 | App 页面没有持久化请求，不能视为已完成能力。 | `profile-services.html` 使用不可操作状态；待后端提供 PC 读写契约后再原位开放，不新增设置页。 |
+| 个人亲属关系 | App 对应页面是静态演示数据，真实关系能力属于家谱世系。 | `profile-data.html` 只做引导，维护操作进入 `profile-tree.html` 或 `profile-family-admin.html`；不复制演示页。 |
+| 分享展示页、祖先排行 | App 当前分别为静态占位和空页面。 | 不移植，不制造入口、假排名或假用户数据。 |
+| 余额、提现、购买记录 | App 与 PC 都有真实业务能力，PC 契约和桌面流程已完整。 | 收益与提现集中在 `profile-earnings.html`；会员、支付和订单集中在 `profile-services.html`。支付确认适合当前页扫码区，关闭订单使用确认弹窗。 |
+| 账号安全与注销 | PC 已有完整表单和危险操作确认。 | 集中在 `profile-security.html`；注销使用确认弹窗，短信、密码等多字段继续使用页面内表单。 |

 ## 家谱工作台

@@ -30,7 +44,11 @@
 | 谱文、相册、视频 | `profile-article.html`、`profile-album.html`、`profile-video.html` 及各自编辑/详情页 | 已提供列表、详情和编辑闭环；没有文件访问 URL 时只展示安全业务元数据。 |
 | 祭祀、贺礼邀约 | `profile-ceremony.html`、`profile-ceremony-detail.html`、`profile-gift.html`、`profile-gift-edit.html` | 活动、祭品和当前账号邀约使用当前 PC 契约。 |
 | 成长、亲友、备忘、功德记录 | 对应 `profile-*-edit.html` 与列表页 | 各自使用当前 PC CRUD 契约和真实家谱上下文。 |
-| 家谱证件、成员邀请、家谱排序、家谱删除 | `profile-family-home.html`、`profile-invite.html`、`profile-families.html` | 当前 PC 没有完整契约，明确不可操作。 |
+| 成员邀请 | `profile-invite.html` | 生成一次性邀请、预览/兑换、查看本人邀请及撤销待使用邀请。 |
+| 资料提醒 | `profile-data-reminders.html` | 按当前家谱读取成员资料缺项，并跳转世系维护。 |
+| 重要证件 | `profile-documents.html` | 按人物维护档案和附件，使用业务字典、统一上传、临时访问令牌与密码保护。 |
+| 家谱生命周期 | `profile-family-settings.html` | 支持归档、恢复；永久删除先读取能力并校验家谱全名和短信验证码。 |
+| 家谱排序 | `profile-families.html` | 使用“我的家谱”响应生成选择项，支持上移、下移并保存稳定 ID 顺序。 |
 | 个人亲属关系页 | `profile-data.html` | 当前 PC 未提供个人关系列表；页面明确引导至当前家谱的成员管理与世系维护。 |

 ## 验收边界
@@ -19,17 +19,20 @@

 ## 验证方式

- 自动回归：`npm test`，362 项通过。
+- 自动回归：`npm test`，379 项通过。
+- 独立无界面 Chrome 点击回归：132 条流程通过。除原有认证、表单、权限和异常流程外，逐页覆盖 33 个家谱工作区页面、14 个账号工作区页面，实际点击 22 个家谱侧栏入口和 12 个账号侧栏入口，并检查顶部/左侧位置、宽度、吸顶行为、当前项、父级展开、家谱上下文以及 1440px、1024px、390px 三档横向溢出。
 - 真实流程：登录后进入真实家谱列表、选择家谱主页，并在 1249px 桌面与 390px 手机视口检查导航和首屏。
 - 验收使用隔离浏览器配置；测试账号、登录令牌及真实家谱标识不写入仓库。

 ## 20% 后续维护记录

- 个人中心继续以 Jiapu-App 的账户与家谱能力为信息架构参考；真实读写仅使用当前 PC 客户端契约。
+- 个人中心继续以 `C:\Users\Rain\Desktop\job\Jiapu-App` 的账户与家谱能力为信息架构参考；真实读写仅使用当前 PC 客户端契约。
 - 已补齐当前家谱上下文传递、业务页统一加载/空数据/失败/无权限状态，以及账户、家谱和内容表单的标签与失败反馈。
- PC 尚未声明契约的资料提醒、家谱邀请、家谱删除、家谱排序、分享奖励、推广收益与提现，保留明确的不可操作状态；不展示模拟金额、记录、二维码或成功结果。
+- 2026-08-27 按后端最新 `genealogy-pc-openapi.yaml` 复核后，资料提醒、家谱邀请、重要证件、家谱生命周期、推广收益与提现、VIP 微信扫码支付均已有正式 PC 契约并已接入；分享奖励、推荐偏好仍保持不可操作，不展示模拟数据。
 - 交给后端的完整补齐范围、最小 DTO、权限和验收要求见 `docs/PC后端补齐清单.md`；该清单只描述 PC 能力，不迁用 App 接口。
- 本次当前全量回归为 362 项通过；测试账号、密码、令牌和真实家谱信息仍不写入代码、文档或 Git。
+- 本次当前全量回归为 379 项通过；测试账号、密码、令牌和真实家谱信息仍不写入代码、文档或 Git。
+- 全部根目录 HTML 的站内链接和页面锚点已做自动完整性检查；空锚点形式的退出操作已改为语义正确的按钮，避免被误判为导航和被自动巡检误触。
+- 活动页在没有任何可邀请成员时不再提交空名单，避免无意义写请求及误清空邀请；该边界已纳入无界面浏览器连续提交回归。
 - 角色运行时验收受阻：已用隔离身份只读确认谱主能力和未认证访问闭环，但该身份可访问的家谱中没有管理员或普通成员实体。未创建成员、未提交申请或写入家谱数据；解除条件是提供已有的隔离管理员、普通成员身份，或预先在隔离家谱中准备对应角色关系。
 - 最新只读复核跳过：隔离登录响应未提供可明确消费的令牌字段；为避免打印原始响应或猜测字段，未继续请求角色接口。该项不影响现有静态权限回归，待测试环境恢复标准 PC 登录响应后再验收。