1.7 KiB
1.7 KiB
真实接口核心流程设计
目标
把现有静态界面升级为可在 Mock 和远端接口之间明确切换的核心流程：登录后进入我的家谱，按当前家谱 ID 查看详情、世系树和成员，并完成创建家谱后录入首代人物。
方案选择
- 采用显式
mode: 'mock' | 'remote'配置；远端请求失败时显示错误，不自动切回 Mock。 - 认证支持密码登录和短信登录。密码登录用于已有测试账号；短信入口按 OpenAPI 请求验证码和登录。
- API 适配层统一解包 OpenAPI 的
{ code, msg, data }响应，统一保存/清除 token，并在 401/403 时提示重新登录。 - 当前家谱 ID 以页面参数为主、持久化上下文为辅。详情、树、成员、审核、家族动态不得再写死
1001。
范围
本阶段完成认证、会话、家谱上下文、创建家谱、录入首代、详情、世系树、成员档案的真实数据链路。
本阶段不实现谱文、相册、祭祀、VIP、帮助、反馈等内容模块；这些入口继续明确提示“后续开放”。
验收
- Mock 模式下可完成：登录、创建家谱、录入首代、进入对应世系树、打开对应成员档案。
- Remote 模式下所有请求携带
clientid与已保存 token，并按接口响应的data字段消费。 - 远端登录/接口失败时不会跳转成功、不会静默返回 Mock 数据，并能给出可理解提示。
- 页面跳转不再依赖硬编码家谱 ID 或成员 ID。
已知外部限制
当前远端密码登录探测返回 HTTP 500，前端会保留远端模式和错误提示，但无法在服务端恢复前完成真实账号的端到端验收。