Skip to content

项目现状与路线图 ​

一句话定位 ​

云族记是一个私有部署的家族管理应用,由两大模块组成:人际关系(族谱关系网络)与家族事务(图文纪事、收支)。它核心解决传统族谱软件"只会画父系树、表达不了真实婚姻与跨家关系、误删不可恢复"的问题。

当前状态 ​

V1(1.0.x)核心流程与两大模块均已走通并正式发版,已在真实家族投入日常使用。

  • 族谱画布、分身体系、称呼引擎、权限模型、归档撤销、真人认领等核心业务链路完整可用
  • 第二大模块「家族事务」(活动记录册、图文照片、收支台账、已读存档)已完整可用,详见家族事务
  • 称呼体系支持多套切换、逐条改词、自建与跨家族复制;另提供家谱 AI 助手与深色模式
  • 多种登录方式:微信小程序微信一键登录,H5 / App 账号密码 + 手机短信验证码登录,登录注册页均为自建
  • App 检查更新:启动时静默比对云端版本,有新版本提示并整包更新;Android 采用云打包、自装分发
  • 工程上已引入 TypeScript,核心算法由无头回归脚本守护(一条命令跑完)
  • 仓库内保留多个模拟家族(黄氏、陆氏、云氏、赵氏等)作为关系算法的测试夹具

已经完成 ​

关系建模与展示

  • 一人多位的分身体系,配偶 / 外亲跨家族挂接
  • Canvas 全自绘画布:缩放、平移、长按菜单、等待区拖拽上树、图片导出
  • 200+ 条规则的自动称呼引擎,支持血亲 / 姻亲 / 双向称呼,且称呼体系可切换、可自建、可复制
  • 父系族谱模式、配偶覆盖矩形、近亲关系提示、分身连线

身份与治理

  • 真人注册 → 认领模拟登记 → 身份合并的完整认证链路
  • 家族认领自证题,防止同名误认
  • 家族开放三档(开放 / 半开放 / 封闭)+ 逐人特批名单
  • 分身匿名、主分身设置、默认进入家族偏好

安全与可恢复

  • 三层权限(数据库 schema / 云函数校验 / 前端显隐)
  • 数据出口的匿名 id 净化,防止抓包反推
  • 全写操作归档留痕,删除 / 认领 / 导入均可撤销,删除虚影可恢复

数据与工程

  • CSV 批量导入(预览 → 提交 → 可整批撤销)与全族导出
  • GEDCOM 5.5.1 / 7.0 转换兼容
  • 云函数按业务域拆分 + 公共核心模块
  • Node 无头回归脚本,一条命令跑完全部核心校验
  • 自建登录注册与认证页:微信一键、手机短信验证码、账号密码多种登录方式
  • App 检查更新:云端版本表 + 多段版本逐段比对,提示并整包更新
  • Android 云打包、自装分发(不上架公开市场)

家族事务

  • 公开的家族活动记录册:信纸式发布 / 浏览,活动可持续追加多条进展并附照片画廊
  • 收支台账:收入 / 支出 + 用途 + 金额,管理员可代填,成员一人一笔自助登记
  • 已读名单、存档只读但全员可见且可恢复,删改详情同步回收云端图片

计划中 ​

以下是 V1 之后的主要方向(会随实际使用反馈调整优先级):

  • 工程整理与重构:在保留一个"可运行基线版本"后,对历史中间态代码做模块化重构、死代码清理
  • 家族事务可选优化:照片上传前压缩、记录按标题 / 年份搜索(模块定位为极简记录册,不扩展通知 / 审批 / 财务报表)
  • 更多导出形态:族谱大图、分页打印、代际报告

设计原则 ​

这些原则贯穿了整个开发过程,也是面对新需求时的取舍依据:

  1. 数据真相唯一:服务端数据库行是唯一事实源,前端缓存只做加速,不定义关系语义。
  2. 危险操作必须可逆:族谱数据不可再生,宁可归档留痕,也不做无法挽回的物理删除。
  3. 列表不过滤、操作才校验:搜索和候选列表不按性别 / 生日等条件硬筛(避免误杀真实数据),校验放到用户真正提交的那一刻。
  4. 前端隐藏不是安全边界:所有权限在服务端重新判定。
  5. 接口失败不覆盖正常内容:网络出错时保留页面上已有的数据,不用空结果把界面清空。
  6. 面向自家人,而非公网:私有部署、威胁模型小,安全护栏按"低成本保险"设计,不引入面向公共互联网的重型防滥用机制。

技术栈速览 ​

uni-app(Vue 3 + Vite)· TypeScript · uniCloud 支付宝云(云函数 + 文档数据库)· TDesign · Canvas 2D · 微信小程序 / App / H5 三端。

详细的架构说明见 技术架构。

关于源码与协作 ​

云族记是一个独立开发的实践项目,源码暂未公开(私有项目)。如果你对其中的关系建模、称呼算法或权限设计感兴趣,欢迎交流。

私有部署 · 家族专用