杨氏族谱小程序

杨氏家谱项目是一套面向宗族内部使用的数字化家谱管理系统，采用“微信小程序 + PHP 后台管理 + MySQL/Redis”架构建设，服务于家族成员信息沉淀、谱系关系展示、宗族文化传承和家族事务管理。
- 将分散的纸质家谱、口述关系、家族照片和宗族资料数字化沉淀。
- 建立统一的家族成员档案，降低信息缺失、重复登记和关系混乱问题。
- 通过树状谱系、搜索、关系计算等能力，提升寻亲、认亲和族谱查询效率。
- 将公告、资讯、字辈、渊源、家族大事记等内容集中展示，形成宗族文化传播载体。
- 通过后台管理统一维护成员、内容、邀请链接和统计数据，提升家族事务管理效率。

业务功能总览

项目由“小程序前端”和“后台管理端”两部分组成。

小程序端核心业务

- 登录与邀请准入
- 首页总览
- 族谱查询与树状展示
- 家族专题功能大厅
- 个人中心与资料维护

后台管理端核心业务

- 管理员登录
- 仪表盘数据总览
- 成员档案管理
- 邀请链接管理
- 公告资讯管理
- 宗族文化管理
- 家族相册管理
- 家族大事记管理
- 字辈排行管理
- 统计刷新与维护

业务设计原则
项目设计遵循以下原则：

- 内部使用优先，不做公开游客系统
- 以成员与关系为核心，以文化与内容为扩展
- 先满足查询和展示，再逐步增强维护和治理能力
- 尽量控制系统复杂度，优先用稳定、易维护的技术实现

系统采用前后端分离架构，整体分为四层：

- 展示层：微信小程序前端 + 单页后台管理界面
- 接口层：ThinkPHP 路由、控制器、中间件
- 业务层：登录鉴权、族谱查询、成员管理、内容管理、统计服务
- 数据层：MySQL 持久化存储 + Redis 缓存

### 前端

- 微信原生小程序
- 主包负责登录、首页、族谱、功能大厅、个人中心
- 分包负责相册、文化、家族大事记、工具页、用户资料页
- 通用组件负责导航、搜索、卡片、加载、空状态等界面复用

### 后端

- ThinkPHP 8 提供路由、请求分发和应用骨架
- `api` 模块面向小程序端提供业务接口
- `admin` 模块面向后台管理端提供管理接口
- 中间件负责前台用户鉴权和后台管理员鉴权
- 服务层负责统计聚合等相对独立的业务逻辑
- 公共响应类统一返回结构

### 数据与缓存

- MySQL 存储成员、关系、公告、资讯、文化、相册、大事记、邀请链接、用户等核心数据
- Redis 存储邀请链接缓存、登录态缓存、后台登录态缓存、统计结果缓存

难点与解决方案
家谱关系不是简单树，而是“树 + 横向关系”

### 难点说明

传统树结构通常只处理父子层级，但家谱系统中还存在大量横向关系，尤其是：

- 配偶关系
- 再婚或多段婚姻关系
- 非血缘身份标记
- 子女与父母的双向关系维护

如果简单使用单一父节点树结构，很容易出现：

- 配偶显示缺失
- 关系链不完整
- 树结构和人物详情不一致

### 解决方案

项目采用“两层建模”：

- 成员表负责人物主体
- 关系表负责人物之间的连接关系

在树展示时：

- 先按父子结构构树
- 再补充配偶上下文
- 额外生成关系边与婚姻状态信息

这种实现兼顾了树形展示和复杂关系表达。