laoyang/FamilyBook
1
0
Fork 0
Code Issues 29 Pull Requests Actions Packages Projects Releases Wiki Activity

v24 第 2 轮：19 条清单收尾（附件预览/CalDAV/任务分类看板/全局选人/家谱/纪念日/财务）

Browse Source 
用户 2026-10-02 提的 19 条需求，本轮完成剩下的 8 条 + CalDAV 服务端：

- ③ 附件：图片/视频给缩略图，PDF/Word/Excel 给**同尺寸**图标；可预览的在本页
     弹层里看（不再新开标签页），渲染不了的点了直接下载；预览层右上角恒有下载按钮。
- ⑦b CalDAV：把「我的日历本」按 RFC 4791 只读子集分享出去（OPTIONS/PROPFIND/
     REPORT/GET，写方法一律 403）。用**专用口令**（库里只存 sha256），不是登录口令。
- ⑨⑩ 任务：分类与看板都由用户自建；已完成的任务从看板消失，改在「已完成」页
     按分类查看/搜索；设置入口在「新建任务」旁的 ☰。
- ⑪ 全局人员选择器：一个片段铺到观影/旅程/资源/日历共享/任务共享/财务共享；
     修掉了老组件「名字和拼音都搜不动」的 bug —— .att-item 自己声明了 display:flex，
     压过了浏览器 [hidden]{display:none}，过滤根本没生效。
- ⑫ 家谱：头像改方形不再裁切；姻亲不在图上的卡片给「⇄ 姻亲」入口，
     以 TA 为中心重画 + 「返回我的家谱」。
- ⑬ 纪念日：阴历/阳历都能设且按对应历法重复；名册里每个人的生日默认可见
     （实时派生，不复制一份）；全部作为全天日程进日历。
- ⑮ 财务：账本可共享，双方都能记账、都能看全部账目，资产−负债=净资产；
     金额一律以「分」存，不用浮点。

验证：端到端 724 项通过 / 0 失败；几何 368、交互 97、移动端 516、家谱 24、
升级 123 全绿；SQL 列名静态校验 0 处可疑；部署 11 条线上探针全过。
This commit is contained in:
laoyang
2026-10-03 08:18:05 +08:00
parent 72dc6c0006
commit 8f80f3e835
47 changed files with 5363 additions and 578 deletions
Download Patch File Download Diff File Expand all files Collapse all files
app/Calendar.php
+290 -30
View File
@@ -19,6 +19,9 @@ namespace App;
final class Calendar
{
/** 日程附件的宿主类型（统一附件表用；v24 第 6 条：日程也能挂附件） */
public const ATTACH = 'calendar_event';
/** 系统预置的两本默认日历（kind 与名字都写死，用户的自定义本一律 kind='custom'） */
public const DEFAULT_KINDS = [
'movie' => ['观影', '#7A4E8C'],
@@ -32,9 +35,30 @@ final class Calendar
* 太浅看不清字，太艳会盖过整个月视图。
*/
public const PRESET_CAL_COLORS = [
'#4A7C82', '#7A4E8C', '#3F7D5A', '#B0763A', '#5566A8',
'#A8574F', '#8A6B4B', '#5C8A48', '#9A5C7A', '#3D6B8E',
'#8C7A3F', '#6B5B95',
'#A63030', '#A65C30', '#A68930', '#97A630',
'#6BA630', '#3FA630', '#30A64E', '#30A67A',
'#30A6A6', '#307AA6', '#304EA6', '#3F30A6',
'#6B30A6', '#9730A6', '#A63089', '#A6305C',
];
/**
* 提醒档位：提前多久（分钟）—— 对应 RFC 5545 的 VALARM / TRIGGER。
*
* ⚠️ 顺序就是用户 2026-10-02 第 6 条原话的顺序，别按数值大小重排：
* 下拉里"5 分钟、10 分钟、15 分钟…1 天"读起来是递进的，
* 按数值排也一样，但一改动顺序用户就会以为自己选错了。
*/
public const REMINDERS = [
5 => '提前 5 分钟',
10 => '提前 10 分钟',
15 => '提前 15 分钟',
30 => '提前 30 分钟',
60 => '提前 1 小时',
120 => '提前 2 小时',
240 => '提前 4 小时',
480 => '提前 8 小时',
720 => '提前 12 小时',
1440 => '提前 1 天',
];
/** 新建一本 */
@@ -120,6 +144,23 @@ final class Calendar
return ($cal['perm'] ?? '') === 'write';
}
/**
* 按 id 取一本「我能看到的」日历（带 perm / shared）。
*
* ⚠️ 判权限时**必须**走这里而不是 Calendar::find()：find() 返回的是 calendars
* 表原行，里面没有 perm —— 于是「共享给我的、可读写的本子」一律被判成不能写，
* 被共享的人建了日程也改不了（蹲在 calendar/event 页上看只读提示）。
*/
public static function mineOne(int $familyId, int $personId, int $calendarId): ?array
{
foreach (self::mine($familyId, $personId) as $c) {
if ((int)$c['id'] === $calendarId) {
return $c;
}
}
return null;
}
/** 给某人补建两本默认日历（幂等） */
public static function seedDefaults(int $familyId, int $personId): void
{
@@ -176,39 +217,63 @@ final class Calendar
// ---------------- 日程 ----------------
/**
* 新建一条日程。
*
* ⚠️ v24（第 5、6 条）：起止是**完整的 DATETIME（精确到秒）**，不再分成
* "日期一列 + 时刻一列" —— 分开存就表达不了"今天 22:30 到明天 01:15"，
* 而且用户填的时候也得分两处。全天日程仍然写 DATETIME，只是时间部分是 00:00:00。
* ⚠️ uid 一定要在**插入时**生成：CalDAV 客户端靠 UID 认日程，
* 没有 UID 的日程每同步一次就被当成新日程再建一条（无限重复）。
*/
public static function addEvent(int $calendarId, array $d): int
{
$db = Database::get();
$db->prepare(
'INSERT INTO calendar_events
(calendar_id, title, starts_at, ends_at, start_time, end_time, all_day, note, created_by)
VALUES (?,?,?,?,?,?,?,?,?)'
(calendar_id, uid, title, location, starts_at, ends_at, all_day,
reminder_minutes, status, transp, rrule, note, created_by)
VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?)'
)->execute([
$calendarId,
self::newUid(),
mb_substr(trim((string)$d['title']), 0, 200, 'UTF-8'),
self::textOrNull((string)($d['location'] ?? ''), 255),
$d['starts_at'],
$d['ends_at'] ?: null,
$d['start_time'] ?: null,
$d['end_time'] ?: null,
!empty($d['all_day']) ? 1 : 0,
self::reminderMinutes($d['reminder_minutes'] ?? null),
self::statusOf($d['status'] ?? null),
!empty($d['transp']) ? 1 : 0,
self::textOrNull((string)($d['rrule'] ?? ''), 255),
self::textOrNull($d['note'] ?? ''),
$d['created_by'] ?: null,
]);
return (int)$db->lastInsertId();
}
/**
* 改一条日程。
*
* ⚠️ SEQUENCE 每次 +1（RFC 5545）：CalDAV 客户端拿它判断"服务端这版比我新吗"。
* 不加的话，改完日程客户端可能还抱着旧的不放。
*/
public static function updateEvent(int $id, array $d): void
{
Database::get()->prepare(
'UPDATE calendar_events SET title=?, starts_at=?, ends_at=?, start_time=?, end_time=?,
all_day=?, note=? WHERE id=?'
'UPDATE calendar_events SET title=?, location=?, starts_at=?, ends_at=?, all_day=?,
reminder_minutes=?, status=?, transp=?, rrule=?, note=?, sequence = sequence + 1
WHERE id=?'
)->execute([
mb_substr(trim((string)$d['title']), 0, 200, 'UTF-8'),
self::textOrNull((string)($d['location'] ?? ''), 255),
$d['starts_at'],
$d['ends_at'] ?: null,
$d['start_time'] ?: null,
$d['end_time'] ?: null,
!empty($d['all_day']) ? 1 : 0,
self::reminderMinutes($d['reminder_minutes'] ?? null),
self::statusOf($d['status'] ?? null),
!empty($d['transp']) ? 1 : 0,
self::textOrNull((string)($d['rrule'] ?? ''), 255),
self::textOrNull($d['note'] ?? ''),
$id,
]);
@@ -216,9 +281,165 @@ final class Calendar
public static function deleteEvent(int $id): void
{
Attachment::removeAll(self::ATTACH, $id);
Database::get()->prepare('DELETE FROM calendar_events WHERE id = ?')->execute([$id]);
}
/** 一条日程（含所属本子；用来判权限） */
public static function event(int $id): ?array
{
$st = Database::get()->prepare(
'SELECT e.*, c.owner_id, c.name AS cal_name, c.color AS cal_color, c.kind AS cal_kind
FROM calendar_events e JOIN calendars c ON c.id = e.calendar_id
WHERE e.id = ?'
);
$st->execute([$id]);
$r = $st->fetch();
return $r ?: null; // 「能不能写」另走 canWriteEvent()（要按人查共享表，塞不进这一行）
}
/**
* 这条日程我能写吗（按它所在本子的归属与共享权限判）。
*
* ⚠️ 单独开一个方法而不是让调用方自己拼数组给 canWrite()：
* canWrite() 吃的是「日历本」那一行（要带 perm），拿日程行直接喂进去
* 会因为没有 perm 而恒判成不能写。
*/
public static function canWriteEvent(array $event, int $personId): bool
{
if ((int)($event['owner_id'] ?? 0) === $personId) {
return true;
}
$st = Database::get()->prepare(
'SELECT perm FROM calendar_shares WHERE calendar_id = ? AND person_id = ?'
);
$st->execute([(int)$event['calendar_id'], $personId]);
return (string)$st->fetchColumn() === 'write';
}
/** 一条日程的 UID（CalDAV 那边按 UID 取） */
public static function newUid(): string
{
return bin2hex(random_bytes(12)) . '@familybook';
}
/**
* 导出 ics 用的行集（用户 2026-10-02 第 7 条）。
*
* 三本日历的内容来源不一样，但**导出时都要有东西**：
* · custom → calendar_events 里真存着的自定义日程；
* · movie → events(kind=movie) 派生；
* · trip → trip_nodes 派生（与日历视图同一口径：出节点，不出整趟旅程）。
* 统一成 calendar_events 那一套字段名（starts_at/ends_at/title/...），
* Ics 那边就不必分辨来源是哪种。
*
* @return array<int,array>
*/
public static function exportRows(array $cal, int $familyId, int $me): array
{
$kind = (string)$cal['kind'];
if ($kind === 'movie' || $kind === 'trip') {
// 派生本：先按一个足够宽的范围取日历视图，再把每一条映射成可导出的行
$from = '1970-01-01';
$to = '2100-01-01';
$out = [];
$seen = [];
foreach (self::month($familyId, [$cal], $me, $from, $to) as $e) {
$key = $e['kind'] . '-' . $e['ref_id'] . '-' . $e['date'];
if (isset($seen[$key])) {
continue; // 跨天日程会逐天出一条，导出时一条就够
}
$seen[$key] = true;
$day = (string)$e['date'];
$out[] = [
'uid' => $e['kind'] . '-' . (int)$e['ref_id'] . '@familybook',
'title' => (string)$e['title'],
'starts_at' => $day . ' ' . ($e['time'] !== '' ? $e['time'] . ':00' : '00:00:00'),
'ends_at' => null,
'all_day' => empty($e['time']) ? 1 : 0,
'location' => null,
'note' => null,
'status' => 'confirmed',
'transp' => 0,
'sequence' => 0,
'created_at' => null,
'updated_at' => null,
'reminder_minutes' => null,
'rrule' => null,
];
}
return $out;
}
$st = Database::get()->prepare(
'SELECT * FROM calendar_events WHERE calendar_id = ? ORDER BY starts_at'
);
$st->execute([(int)$cal['id']]);
return $st->fetchAll();
}
/**
* 导入一条 ics 里的 VEVENT。
*
* ⚠️ 判重用 UID + 日历本：同一本日历里 UID 已存在就**更新**而不是再插一条 ——
* 否则同一个 .ics 导入两次，日历里就是两份一模一样的日程（用户最常见的操作
* "导一次没看清，再导一次"会立刻翻车）。
*
* @return string 'added' | 'updated'
*/
public static function importEvent(int $calendarId, array $v, int $createdBy): string
{
$db = Database::get();
$uid = (string)($v['uid'] ?? '');
if ($uid !== '') {
$st = $db->prepare('SELECT id FROM calendar_events WHERE calendar_id = ? AND uid = ?');
$st->execute([$calendarId, $uid]);
$old = (int)$st->fetchColumn();
if ($old > 0) {
self::updateEvent($old, $v);
return 'updated';
}
} else {
$uid = self::newUid();
}
$db->prepare(
'INSERT INTO calendar_events
(calendar_id, uid, title, location, starts_at, ends_at, all_day,
reminder_minutes, status, transp, rrule, note, created_by)
VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?)'
)->execute([
$calendarId,
$uid,
mb_substr(trim((string)($v['title'] ?? '')), 0, 200, 'UTF-8'),
self::textOrNull((string)($v['location'] ?? ''), 255),
$v['starts_at'],
$v['ends_at'] ?: null,
!empty($v['all_day']) ? 1 : 0,
self::reminderMinutes($v['reminder_minutes'] ?? null),
self::statusOf($v['status'] ?? null),
0,
self::textOrNull((string)($v['rrule'] ?? ''), 255),
self::textOrNull((string)($v['note'] ?? '')),
$createdBy ?: null,
]);
return 'added';
}
/** 提醒分钟数：只认预设档位与 0/NULL，乱传的落 NULL（不提醒） */
private static function reminderMinutes($v): ?int
{
if ($v === null || $v === '' || $v === false) {
return null;
}
$n = (int)$v;
return isset(self::REMINDERS[$n]) ? $n : null;
}
private static function statusOf($v): string
{
$v = (string)$v;
return in_array($v, ['confirmed', 'tentative', 'cancelled'], true) ? $v : 'confirmed';
}
/**
* 某个月（或某段日期）里**全部**日程：
* 自定义日程（calendar_events）+ 观影（events kind=movie）+ 旅行（events kind=trip）
@@ -249,8 +470,9 @@ final class Calendar
$in = implode(',', array_fill(0, count($ids), '?'));
$st = Database::get()->prepare(
"SELECT * FROM calendar_events
WHERE calendar_id IN ($in) AND starts_at <= ? AND COALESCE(ends_at, starts_at) >= ?
ORDER BY starts_at, start_time"
WHERE calendar_id IN ($in)
AND DATE(starts_at) <= ? AND DATE(COALESCE(ends_at, starts_at)) >= ?
ORDER BY starts_at"
);
$st->execute(array_merge($ids, [$to, $from]));
$calById = [];
@@ -259,21 +481,26 @@ final class Calendar
}
foreach ($st->fetchAll() as $e) {
$c = $calById[(int)$e['calendar_id']] ?? null;
$end = $e['ends_at'] ?: $e['starts_at'];
$sd = substr((string)$e['starts_at'], 0, 10);
$ed = substr((string)($e['ends_at'] ?: $e['starts_at']), 0, 10);
// 跨天日程：在范围内**每天**都出一条（群晖日历就是这么画的）
foreach (self::eachDay((string)$e['starts_at'], (string)$end, $from, $to) as $day) {
$first = true;
foreach (self::eachDay($sd, $ed, $from, $to) as $day) {
$tm = substr((string)$e['starts_at'], 11, 5);
$out[] = [
'cal' => (int)$e['calendar_id'],
'color' => (string)($c['color'] ?? '#4A7C82'),
'calname' => (string)($c['name'] ?? ''),
'title' => (string)$e['title'],
'date' => $day,
'time' => empty($e['all_day']) ? substr((string)$e['start_time'], 0, 5) : '',
// 跨天的第二、三天只显示"还在进行"，不再重复挂一个开始时刻
'time' => ($first && empty($e['all_day'])) ? $tm : '',
'all_day' => !empty($e['all_day']),
'kind' => 'custom',
'ref_id' => (int)$e['id'],
'href' => url('calendar/event', ['id' => (int)$e['id']]),
];
$first = false;
}
}
}
@@ -306,32 +533,46 @@ final class Calendar
}
}
// ---- 旅行（events kind=trip）----
// ---- 旅程（trip_nodes，不是 events）----
// ⚠️ v24（用户 2026-10-02 第 2 条）：日历里出的是**行程节点**，不是「这趟旅程」本身。
// 原来把整趟旅程摊成一条跨天全天日程，于是日历上一整周都被"云南之行"占满，
// 真正要看的"几点出发 / 几点到景点"全都看不见 —— 旅程是个容器，节点才是日程。
// 现在按 trip_nodes.starts_at 出条目，跨天的节点同样逐天铺开。
if (isset($byKind['trip'])) {
$c = $byKind['trip'][0];
$st = Database::get()->prepare(
"SELECT id, title, starts_at, ends_at FROM events
WHERE family_id = ? AND kind = 'trip' AND starts_at IS NOT NULL
AND DATE(starts_at) <= ? AND COALESCE(DATE(ends_at), DATE(starts_at)) >= ?
ORDER BY starts_at"
"SELECT n.id AS node_id, n.title AS node_title, n.starts_at, n.ends_at,
n.node_type, n.status AS node_status,
e.id AS event_id, e.title AS trip_title
FROM trip_nodes n
JOIN events e ON e.id = n.event_id AND e.kind = 'trip'
WHERE n.family_id = ? AND n.starts_at IS NOT NULL
AND n.status <> 'cancelled'
AND DATE(n.starts_at) <= ? AND COALESCE(DATE(n.ends_at), DATE(n.starts_at)) >= ?
ORDER BY n.starts_at"
);
$st->execute([$familyId, $to, $from]);
foreach ($st->fetchAll() as $e) {
foreach (self::eachDay(substr((string)$e['starts_at'], 0, 10),
substr((string)($e['ends_at'] ?: $e['starts_at']), 0, 10),
$from, $to) as $day) {
foreach ($st->fetchAll() as $n) {
$start = substr((string)$n['starts_at'], 0, 10);
$end = substr((string)($n['ends_at'] ?: $n['starts_at']), 0, 10);
// 节点跨天时只在**第一天**显示时间（后面的天是"还在进行"，不是"又开始了"）
$tm = substr((string)$n['starts_at'], 11, 5);
$first = true;
foreach (self::eachDay($start, $end, $from, $to) as $day) {
$out[] = [
'cal' => (int)$c['id'],
'color' => (string)$c['color'],
'calname' => (string)$c['name'],
'title' => '🧳 ' . (string)$e['title'],
'title' => Trip::typeIcon((string)$n['node_type']) . ' ' . (string)$n['node_title'],
'date' => $day,
'time' => '',
'all_day' => true,
'time' => $first ? ($tm === '00:00' ? '' : $tm) : '',
'all_day' => $first && $tm === '00:00',
'kind' => 'trip',
'ref_id' => (int)$e['id'],
'href' => url('trips/show', ['id' => (int)$e['id']]),
'ref_id' => (int)$n['node_id'],
'href' => url('trips/show', ['id' => (int)$n['event_id']])
. '#node-' . (int)$n['node_id'],
];
$first = false;
}
}
}
@@ -364,6 +605,25 @@ final class Calendar
];
}
// ---- 纪念日（v24 第 13 条）----
// 用户明确要求：纪念日一律作为**全天日程**出现在日历里。
// 数据是**实时派生**的（生日读 persons、农历逐年换算），所以这里不查表、直接算。
// ⚠️ 农历那一路必须按"这一年"换算 —— 同一条农历生日在不同年份落在不同公历日期。
foreach (Anniversary::between($familyId, $personId, $from, $to) as $a) {
$out[] = [
'cal' => 0,
'color' => '#B4633C',
'calname' => '纪念日',
'title' => '🎂 ' . (string)$a['title'],
'date' => (string)$a['date'],
'time' => '',
'all_day' => true, // 全天（用户点名要求）
'kind' => 'anniv',
'ref_id' => (int)($a['id'] ?? 0),
'href' => $a['id'] > 0 ? url('days/edit', ['id' => (int)$a['id']]) : url('days'),
];
}
usort($out, static function ($a, $b) {
return strcmp($a['date'], $b['date'])
?: strcmp((string)$a['time'], (string)$b['time'])