修改功，现在补齐页面

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