家史

一款围绕“人物关系、人生经历与情感留存”打造的数字家史小程序。

家史 不只是一个传统的家谱工具。它将家族关系管理、人生时间轴记录、协作审批、非血缘关系树、时光胶囊与纪念刻字等能力整合在一起，帮助用户建立一个可视化、可持续更新、可长期沉淀的数字记忆空间。

项目简介

本项目基于 uni-app 开发，面向微信小程序等多端场景，前端负责关系树展示、页面交互与内容记录，后端基于 FastAPI 提供登录鉴权、关系管理、消息审批、生涯事件、时光胶囊、刻字等核心业务接口。

项目的核心目标不是只展示关系，而是把“人、关系、经历、纪念内容”连接起来，让家族记忆和人物故事可以持续积累、长期保存、逐步传承。

核心功能

1. 血缘关系树

• 以可视化画布形式展示家庭成员之间的血缘关系
• 支持展开父家庭、子家庭、兄弟姐妹、配偶、后代等结构
• 支持新增正式成员、创建临时成员、邀请临时成员注册接管
• 支持关系新增、关系删除、审批确认等协作流程
• 支持从人物卡片跳转到用户资料、生涯、非血缘关系树等页面

2. 人生生涯时间轴

• 为每个用户建立人生时间轴
• 支持记录日常、成长、旅行、挑战、成就等不同类型经历
• 支持新增、编辑、删除经历
• 支持查看自己或他人的生涯内容
• 支持事件图片、阶段事件、公开可见性控制
• 支持邀请其他用户加入共同经历

3. 消息与审批中心

• 统一管理发送消息、接收消息、审批通知
• 支持家庭关系申请审批
• 支持共同经历邀请审批
• 支持非血缘关系增删审批
• 支持消息已读、分页加载、详情查看
• 让重要关系变更具备可确认、可追踪的流程机制

4. 非血缘关系树

• 支持创建独立的非血缘关系树
• 适用于师承、组织、同门、团队或自定义关系场景
• 支持关系树名称、简介、头像、标签等配置
• 支持设置关系树管理员
• 支持成员标签、搜索可见性、生涯可见性等权限配置
• 支持新增/删除关系的审批式处理

5. 时光胶囊

• 支持创建图文胶囊或视频胶囊
• 支持指定接收对象与未来解锁时间
• 支持查看“我发送的胶囊”和“我收到的胶囊”
• 支持胶囊详情查看与已读标记
• 适合用于未来寄语、纪念表达与情感留存

6. 纪念刻字

• 支持上传图片或输入文字进行雕刻
• 支持文字转图、底图合成、坐标定位
• 支持查看自己上传过的作品
• 支持举报和删除图片
• 支持将刻字内容关联到人物生涯或具体经历
• 以更具仪式感的方式保存纪念内容

7. 个人中心与资料管理

• 支持微信登录
• 支持编辑头像、昵称、性别、生日、简介等资料
• 支持离世状态与相关信息维护
• 支持管理员设置
• 支持隐私边界与可见性配置
• 支持查看产品说明、更新公告、帮助内容

产品特点

• 同时支持血缘关系与非血缘关系管理
• 支持关系变更审批机制
• 支持人生时间轴沉淀
• 支持未来寄语与纪念内容保存
• 支持临时成员邀请注册替换
• 支持图文与视频等多种内容表达形式

适用场景

• 家庭家谱整理
• 家族记忆保存
• 人物成长记录
• 家庭协作管理
• 师承关系整理
• 社群或组织关系记录
• 纪念内容与未来寄语存档

当前说明

• 项目中“影像留声”入口目前仍为预留状态，尚未形成完整业务页面
• 部分消息能力存在预留展示结构，后续可继续扩展
• 当前项目包含前端 uni-app 与独立 Python 后端两部分

后续可扩展方向

• 更完整的官网与产品展示页
• 更细化的权限体系
• 家族内容检索与统计能力
• 多媒体纪念内容扩展
• 更完善的后台管理与运营能力

一些见解

1 软件声明，作者是一个理想主义者，做这个软件纯粹是践行自己的理想，软件将拒绝一切资本介入，相比下面的愿景 钱是最不重要的

2 感觉现在市面上 缺少一个这种统一的平台 能帮助那些不懂电脑技术的人 把自己的故事经历和感悟留下去，留到历史里面去，他和别的族谱系统不一样，我们可以实现全记录，现有的族谱记录软件，是由上向下记录，需要>有一个管理者进行家族记录，且只能记录一脉的血脉传承信息，本软件是全记录，他是通过递归家庭的方式记录，我们只需要记录和管理自己的家庭成员关系，每个家庭成员会自动关联到其他人，理论上可以记录所有人的血脉 传承信息。（未来对查看家族遗传病史提前预防、家族信托 等 有所帮助）

3 这个世界有人生有人死，就算是历史的长河也不应该湮灭我们存在过的痕迹，我们此刻留下的数据片段或许在未来的某一天会成为激励后来人走下去动力。

4 有些回忆可能会随着时间在脑内遗忘，但是当我们未来需要从这回忆中汲取力量和勇气的时候，当我们垂垂老矣的时候，我们知道一直有一个地方帮我们保存着这份回忆，有空的时候可以拿出来细细品味一番。

5 从陈胜吴广起义到 抗战胜利 我们的先辈留下的诸多精神文化遗产，我们的事迹可能会像先辈一样永久流传，成为后辈的精神文化遗产。

6 有了这个软件，我们可以不仅仅是历史的亲历者，更可以是历史的见证者和记录者，我们可以记录 我们所经历的时代的变化，比如疫情，当然这也是对 如秦桧 和珅 一样的人的一种威慑，历史上的皇帝不敢胡来的原因不就 是有一代代一个史官妄不畏死的记录吗

7 这也是一层保险，在我看来现在不结婚不生育、资源分配不平衡、金钱至上的社会现象 在作者看来其实是一种思想病毒，入侵了我们的文化，任由这些思想主导我们的社会价值 我相信文本终将衰亡 ，但是我觉得要为这个文明做些什么，当我们的后代 打开这个软件看到，自己的血脉是由 一代一代人 传承下来的，当有人打开软件看到 坏人在历史上被唾弃好人在历史上被赞扬， 我相信这是抵抗文明级别额思想病毒的的一种微薄方法。

8 最后 作者从这个时代感受到了，时代在向上走，但是人心在向下走，我希望凭借我的努力能拉一拉。

前端运行

1. 使用 HBuilderX 打开项目根目录
2. 选择运行到微信小程序或其他支持平台
3. 根据 manifest.json 中的小程序配置完成调试

后端运行

1. 进入 backend 目录
2. 安装 Python 依赖
3. 配置 .env 中的环境变量
4. 启动 FastAPI 服务
5. 确保前端请求地址与后端服务地址一致