2.9 KiB
真实接口核心流程 Implementation Plan
For agentic workers: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (
- [ ]) syntax for tracking.
Goal: 让家谱 App 的认证、当前家谱上下文、创建首代和世系浏览形成可验证的 Mock/远端双模式核心闭环。
Architecture: utils/config.js 显式决定数据模式；utils/api.js 是唯一远端响应解包和错误转换位置；utils/session.js 与新增的上下文模块持久化 token 和当前家谱 ID。页面只调用 appApi 并从路由读取对象 ID。
Tech Stack: uni-app Vue 3、HBuilderX、uni.request、PowerShell 合同测试。
Global Constraints
- 不将测试账号、密码或 token 写入源码、测试或文档。
- 远端模式失败必须显示错误，不能自动返回 Mock 数据。
- 所有新增页面必须登记在
pages.json并纳入编译审计。
Task 1: API 会话与响应契约
Files:
-
Modify:
utils/config.js,utils/session.js,utils/api.js -
Create:
utils/genealogy-context.js,tests/core-flow-contract.ps1 -
写失败测试，要求存在显式模式、登录方法、
data解包、token 与当前家谱 ID 持久化。 -
运行 PowerShell 合同测试并确认因方法缺失失败。
-
实现最小 API 适配层和上下文模块。
-
重跑合同测试，确认通过。
Task 2: 认证与我的家谱
Files:
-
Modify:
pages/auth/login.vue,pages/genealogy/index.vue,components/GenealogyCard.vue -
Test:
tests/core-flow-contract.ps1 -
写失败测试，要求登录页调用 API、保存 token，家谱卡片和列表使用真实 ID。
-
运行测试确认失败。
-
实现密码登录、错误状态与列表加载状态。
-
重跑测试并在 Mock 模式下手动走通登录至列表。
Task 3: 当前家谱与首代录入
Files:
-
Modify:
pages.json,pages/genealogy/create.vue,pages/genealogy/detail.vue,pages/tree/index.vue,pages/member/detail.vue -
Create:
pages/lineage/first-person.vue -
Test:
tests/core-flow-contract.ps1 -
写失败测试，要求新页面、路由参数和 API 方法存在，且不得写死
1001/3。 -
运行测试确认失败。
-
实现创建家谱后录入首代、按路由 ID 加载详情/树/成员。
-
重跑合同测试与 HBuilderX Sass/语言诊断。
Task 4: 加入审核与通知的上下文修复
Files:
-
Modify:
pages/genealogy/search.vue,pages/genealogy/applications.vue,pages/notification/index.vue,utils/api.js -
Test:
tests/core-flow-contract.ps1 -
写失败测试，要求申请和审核使用当前家谱 ID，通知读取操作有对应 API 方法。
-
运行测试确认失败。
-
实现上下文传递与明确的本地状态更新。
-
重跑所有项目测试及 HBuilderX 实际样式/模块请求验证。