main
用户 2026-11-05:「还有5天,也就是10月2号,这个不好。因为"还有5天"这个事情 比较重要,所以方形框里面应该写几天,比如还有5天就写5天;现在还有5天, 那个位置应该写上10月2日。如果是农历的话,就要写上农历十月二日。 下面还要写上阳历:换算完之后,今年阳历是多少?比如11月10日, 都放在右侧"满42周岁"这个位置。」 上一版信息分工正好是**反的**:方框里放了「日」(几号),右侧放了「还有 N 天」。 用户要的相反。 重排后: 方框(84x84 浅主题色块) = **还剩几天**(大数字)+ 下方「天」/「今天」 右侧第一行 = 日期(农历生日「农历十月初二」;其余「11月16日」) 右侧第二行 = 阳历换算(**只有农历生日才画**) 右侧第三行 = 满 N 周岁 服务端 Anniversary::occurrences() 补两个**成品文字**字段: lunar_label = 「十月初二」「闰四月初五」(农历生日才有) solar_md = 「11月10日」(今年实际发生那天的公历月日) ⚠️ 农历文字为什么不在端上拼:Lunar 有完整的月名/日名对照表 (正月/冬月/腊月、初一/廿三…),端上再抄一份必然漂移, 而且闰月(闰四月)这种特例得一起处理。 ⚠️ solar_md 用 $date(今年换算后的实际日期)而不是 $a['month']/$a['day']: 农历生日的 month/day 是**农历**月日,直接拼出来会是错的公历。 ⚠️ 公历生日时 dateSolar() 返回空串 ⇒ 不画第二行: 那时第一行已经是「11月16日」,再画一次一模一样,纯噪音。 ⚠️ days = 0(就是今天)时方框写「今」而不是「0」: 0 看着像没数据,而且底下那行写「今天」,配成「今 / 今天」很奇怪。 实测服务端输出: 高雪玉 的农历生日 days=5 lunar=十月初二 solar=11月10日 date=2026-11-10 领证纪念日 days=7 lunar=(空) solar=11月12日 date=2026-11-12 杨永全 的农历生日 days=8 lunar=十月初五 solar=11月13日 date=2026-11-13 杨永全 的生日 days=11 lunar=(空) solar=11月16日 date=2026-11-16 刘巧莲 的农历生日 days=29 lunar=十月廿六 solar=12月4日 date=2026-12-04 编译通过,已装真机。
FamilyBook
家书,记录家庭的全部生活,一本用岁月写成的家谱。
把一个家的「人」「日子」「去过的地方、看过的电影」收进同一本书里。
它是什么
一个自托管的家庭生活系统。它不是又一个待办清单,而是这个家的长期档案 —— 十年之后还能翻出孩子第一次观影的票根、那年暑假走过的路线。
围绕三个圈展开:
- 人:家庭成员、亲友通讯录,以及他们之间的共享关系
- 时间:日历、日程、提醒,以及任务的期限
- 事件:观影、旅行、其他活动 —— 一切都落在同一条时间轴上
它在做什么
| 阶段 | 主题 | 内容 |
|---|---|---|
| 0 | 地基 | 名册、账号、登录、权限模型、安装向导 |
| 1 | 通信 | 通讯录、共享给某个成员、CardDAV 服务端 |
| 2 | 时间 | 日历本、重复日程、提醒、CalDAV 服务端 |
| 3 | 归一 | 观影与旅行迁入统一事件模型 |
| 4 | 任务 | 任务管理,期限自动映射成日历事件 |
| 5 | 回看 | 统计、年度家书、时间轴 |
当前进度:阶段 0 起步,仓库里只有图标与脚手架。
技术选型
- PHP 7.4+(无框架、无 Composer,上传到站点目录即可运行)
- MySQL 5.7+ / 8.0(
utf8mb4) - 前端为原生 HTML / CSS / JavaScript,无构建步骤
⚠️ 注意 CalDAV / CardDAV 是双向协议,和单纯的 .ics 文件导出不是一个量级的东西。
部署
- 把代码放到站点根目录;
- 复制
config.example.php为config.php,填写数据库与app_key; - 访问站点根,按引导页确认 PHP 版本、扩展、配置、数据库连接四项都通过。
config.php 不入库(已在 .gitignore 中忽略),其中包含数据库口令与加密密钥。
⚠️ app_key 一旦开始记录数据就不能再改(换掉即解不开已有数据),
并且它必须单独备份 —— 密钥丢失等同于数据永久丢失。
隐私
身份证号、手机号属于敏感个人信息,一律加密存储。 (就家庭自用而言,身份证号其实没有多少必须存的场景,启用前请三思。)
图标
见 assets/icons/。概念是「这本书就是家」:屋顶即一本摊开的书,
屋顶下纸做的墙上,三行横线是这个家写下的日子。
开源协议
Languages
PHP
81.6%
JavaScript
9.3%
CSS
9.1%