5.1 KiB
5.1 KiB
规划
项目目标
将“代代相传”建设为由官网、用户 PC 管理端、用户 APP 端和平台后台组成的家谱服务。四个端共享家谱、成员、内容和权限规则，但分别交付，不能用用户 PC 页面替代 APP 或平台后台。
当前基线
- 当前工作区共有 55 个 HTML 页面，现有页面之间没有指向不存在 HTML 页的站内链接。
PC.openapi2.json是当前后端正式接口源，包含 37 个操作：认证登录 11、验证中心 4、文件上传 6、行政区划 4、家族圈 12。- 已完成真实接口闭环：注册、密码登录、短信登录、找回密码、个人资料、安全设置、头像上传、地区选择、家族圈动态。
- 家谱列表、家谱创建/加入、成员、权限、世系、谱文、相册、视频、贺礼、成长、备忘、功德、消息、反馈等页面已保留设计，但尚无对应正式接口，不得伪造请求或静态数据为真实业务。
实施进度
- 第一轮：家谱基础页面状态收口。已覆盖家谱列表、创建与加入、审核、家族管理、邀请、世系和字辈页面；未开发功能会显示统一提示并阻止伪造操作。
- 第二轮：内容与协作页面状态收口。已覆盖除家族圈动态外的内容、记录、消息、反馈、管理员权限与资料提醒页面；家族圈动态保持真实功能并保留跳转入口。
- 第三轮：剩余用户 PC 业务入口收口。已覆盖家谱主页、应用分享和帮助与会员服务页面；家族圈动态入口保持真实跳转。
- 第四轮：官网静态页面补齐。已新增新闻、法律文档入口、通用状态和工单页面；在线工单功能明确处于开发中，法律正文必须在发布前由法务替换确认。
产品边界
官网
保留首页、数字家谱、家谱广场、姓氏百科、家族文化、应用下载、帮助中心、关于我们、搜索、公告和工单入口。
需要补齐的独立页面：
- 新闻列表、新闻分类、新闻详情。
- 隐私政策、儿童个人信息处理规则、服务协议。
- 我的工单、工单详情。
- 404、无权限、系统维护等通用状态页。
用户 PC 管理端
现有页面覆盖了思维导图中的大部分视觉入口：我的家谱、家谱主页、世系图、字辈、谱文、相册、视频、家族圈、贺礼、成长日志、备忘录、功德录、家族管理、管理员权限、入谱审核、消息、个人资料和安全设置。
需要补齐的关键页面：
- 家族成员名册与成员详情，用于按成员筛选、查看资料、维护角色；世系图不能替代成员名册。
- 家族圈动态详情，用于承载可分享链接、完整评论和通知跳转。
- 无家谱首次引导、无权限、空列表等状态视图。
用户 APP 端
APP 是独立交付物，负责移动端查看家谱、上传照片/视频、发布内容、消息和个人中心。当前 PC 项目只需共享接口契约和视觉规范，不直接复制为 APP 页面。
平台后台
平台后台是独立项目，负责全站家谱审核、内容治理、会员/VIP、系统设置和运营数据。它不应通过隐藏按钮混入用户 PC 端。
后端接口开发顺序
第一阶段：家谱基础
- 我的家谱列表、家谱详情、创建家谱、加入家谱、加入审核。
- 家谱成员列表、成员详情、邀请、移除、角色与管理员权限。
- 家谱入口必须返回真实
genealogyId，让世系、内容和家族圈能从同一上下文进入。
第二阶段：世系与资料
- 世系树查询。
- 成员新增、编辑、删除。
- 父母、配偶、子女等关系维护。
- 字辈列表与维护。
第三阶段：内容与协作
- 谱文及分类。
- 相册、照片、视频。
- 贺礼、成长日志、备忘录、功德录。
- 消息中心、点赞评论通知、生日提醒、入谱审核通知。
- 意见反馈、工单列表与详情。
第四阶段：官网内容与合规
- 新闻资讯、公告、公开内容检索。
- 隐私、未成年人保护和服务协议。
- 客服工单的提交、查询和回复。
契约要求
每个业务对象都必须提供明确 DTO，至少包括列表、详情和写入请求模型。禁止前端依赖泛型 object 或猜测字段名。
最优先需要后端补充的模型：
GenealogyDTO、GenealogyMemberDTO、MemberRoleDTO。LineagePersonDTO、LineageRelationDTO、GenerationDTO。FeedDTO、CommentDTO。ArticleDTO、AlbumDTO、VideoDTO、CeremonyDTO、GrowthLogDTO、MemoDTO、MeritDTO。NotificationDTO、TicketDTO、NewsDTO。
交付规则
- 有正式接口和 DTO 的页面，才接入真实读写功能。
- 未开发接口对应的页面保留设计，但明确显示“功能开发中”或空状态，不伪造成功数据。
- 家谱业务全部从真实
genealogyId进入，不写死示例家谱编号。 - 访客、普通成员、家谱管理员、平台管理员必须有独立权限边界。
- 测试账号仅用于运行时验收；账号和密码不写入仓库、文档、测试、日志或配置。