家谱APP首页样式设计完成，落地80%

2026-07-13 00:23:04 +08:00
commit 1da4d8cf1f
117 changed files with 9476 additions and 0 deletions
@@ -0,0 +1,62 @@
+# 真实接口核心流程 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`
+
+- [x] 写失败测试，要求存在显式模式、登录方法、`data` 解包、token 与当前家谱 ID 持久化。
+- [x] 运行 PowerShell 合同测试并确认因方法缺失失败。
+- [x] 实现最小 API 适配层和上下文模块。
+- [x] 重跑合同测试，确认通过。
+
+### Task 2: 认证与我的家谱
+
+**Files:**
+- Modify: `pages/auth/login.vue`, `pages/genealogy/index.vue`, `components/GenealogyCard.vue`
+- Test: `tests/core-flow-contract.ps1`
+
+- [x] 写失败测试，要求登录页调用 API、保存 token，家谱卡片和列表使用真实 ID。
+- [x] 运行测试确认失败。
+- [x] 实现密码登录、错误状态与列表加载状态。
+- [ ] 重跑测试并在 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`
+
+- [x] 写失败测试，要求新页面、路由参数和 API 方法存在，且不得写死 `1001`/`3`。
+- [x] 运行测试确认失败。
+- [x] 实现创建家谱后录入首代、按路由 ID 加载详情/树/成员。
+- [x] 重跑合同测试与 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`
+
+- [x] 写失败测试，要求申请和审核使用当前家谱 ID，通知读取操作有对应 API 方法。
+- [x] 运行测试确认失败。
+- [x] 实现上下文传递与明确的本地状态更新。
+- [x] 重跑所有项目测试及 HBuilderX 实际样式/模块请求验证。