# 真实接口核心流程设计

## 目标

把现有静态界面升级为可在 Mock 和远端接口之间明确切换的核心流程：登录后进入我的家谱，按当前家谱 ID 查看详情、世系树和成员，并完成创建家谱后录入首代人物。

## 方案选择

- 采用显式 `mode: 'mock' | 'remote'` 配置；远端请求失败时显示错误，不自动切回 Mock。
- 认证支持密码登录和短信登录。密码登录用于已有测试账号；短信入口按 OpenAPI 请求验证码和登录。
- API 适配层统一解包 OpenAPI 的 `{ code, msg, data }` 响应，统一保存/清除 token，并在 401/403 时提示重新登录。
- 当前家谱 ID 以页面参数为主、持久化上下文为辅。详情、树、成员、审核、家族动态不得再写死 `1001`。

## 范围

本阶段完成认证、会话、家谱上下文、创建家谱、录入首代、详情、世系树、成员档案的真实数据链路。

本阶段不实现谱文、相册、祭祀、VIP、帮助、反馈等内容模块；这些入口继续明确提示“后续开放”。

## 验收

1. Mock 模式下可完成：登录、创建家谱、录入首代、进入对应世系树、打开对应成员档案。
2. Remote 模式下所有请求携带 `clientid` 与已保存 token，并按接口响应的 `data` 字段消费。
3. 远端登录/接口失败时不会跳转成功、不会静默返回 Mock 数据，并能给出可理解提示。
4. 页面跳转不再依赖硬编码家谱 ID 或成员 ID。

## 已知外部限制

当前远端密码登录探测返回 HTTP 500，前端会保留远端模式和错误提示，但无法在服务端恢复前完成真实账号的端到端验收。