30 lines
1.7 KiB
Markdown
30 lines
1.7 KiB
Markdown
# 真实接口核心流程设计
|
|
|
|
## 目标
|
|
|
|
把现有静态界面升级为可在 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，前端会保留远端模式和错误提示，但无法在服务端恢复前完成真实账号的端到端验收。
|