laoyang
02f5d072a4
用户 2026-10-03 提的四条：
① 家谱卡片重做
· 去掉「⇄ 姻亲」按钮，改成**每个人**卡片右下角都有「以 TA 为中心」
（点了以他重画一张家谱，涵盖原来的姻亲场景）。
· 头像外框改**长方形**（96×72，宽度贴合头像），object-fit: contain 不裁切，
姓名/称呼在头像下方。
· 修「点右下角按钮误进成员页」：卡片不再整张是 <a>，
只有姓名是链接，右下角是独立的 <button>（物理上分开，不抢点击）。
② 家谱文案与按钮清理
· 去掉副标题与下方图例说明；整块去掉「看全部 / 回到我 / 回到我的家谱」
（顺带消掉"出现两个回到我的家谱"）。镜头由库自动 fit，拖拽/滚轮即可。
③ 首页控制台
· 标题下显示个人 slogan；去掉右侧三个统计；「我的资料/我的家谱」换成图标按钮；
去掉与导航条重复的「名册」按钮。
· 去掉「接下来的日子」（生日归到"未来七天"里，不再重复）。
· 新增统计信息块：按时段随机问候 + 今日天气（Open-Meteo，免 key，可留空不显示）
+ 近七天日程/待办/逾期数。
· 新增各模块小结卡（任务/日程/纪念日/观影/旅程/财务/名册/家谱/资源）。
· 个人设置新增「首页上的模块」：可勾选与拖动排序（每人一份，存 user_settings）。
· 保留「往年的今天」。
④ 名册改列表
· 卡片网格 → **竖向列表**：左头像、中间姓名+与我的关系+手机号+生日。
· 修拖动「只能往后不能往前」：落点改为显式记录"插到谁前面/后面"，
并排除被拖元素自身。
· 去掉那句拖动提示（能力保留）。
· 搜索新增**姓名首字母**检索（y / yy / yyq 都命中「杨永全」）：
新 app/Pinyin.php，intl 优先 + 内置常用字表兜底（本地无 intl 也能测）；
纯字母/数字查询词不走 SQL LIKE（拼音与加密手机号在库里都比不了）。
附带上两轮的收尾：
· 菜单点外部自动关闭（全局事件委托，覆盖所有 details.menu）。
· 旅程 is_public：列表与日历只显示公开的；详情页不拦（不丢数据）。
· 重复日程：新 app/Repeat.php（RRULE 解析/生成/展开，含"工作日"），
新表 calendar_event_skips（RFC 的 EXDATE）；日历按规则展开；
编辑支持三档「全部 / 这一次及以后 / 仅此一次」。
· 结束时间可添加/去掉，并随开始时间联动。
验证：端到端 772 项通过 / 0 失败；几何 368、交互 97、移动端 516、家谱 26、
升级 123 全绿；SQL 列名静态校验 0 处可疑；部署 11 条线上探针全过。
420 lines
16 KiB
PHP
420 lines
16 KiB
PHP
<?php
|
||
/**
|
||
* 旅程（v12，从 TripLog 迁入；导航条上叫「旅程」）。
|
||
*
|
||
* 与观影一样挂在**统一事件原语**上：
|
||
* events(kind='trip') —— 骨架：标题 / 起止时刻 / 地点（目的地）/ 备注
|
||
* trip_details —— 卫星表：封面图 + 一段话小结
|
||
* event_attendees —— 同行的人
|
||
* attachments(target=trip) —— 照片与附件
|
||
* trip_nodes —— 行程节点：这趟旅程里的一段一段（计划 / 实际走过的双轨）
|
||
*
|
||
* 为什么不把 TripLog 的 activities/trip_nodes 原样搬过来：
|
||
* TripLog 的 activities 与家书的 events 是同一个东西（一次出行 = 一个有时间、有人、
|
||
* 要上日历的事件）。再建一张 activities 就会出现"两条时间线"，日历要同时读两张表，
|
||
* 迁移后还得保证两边同步 —— 那正是统一事件原语要消灭的重复。
|
||
*
|
||
* 计划/执行双轨（TripLog 最有价值的一点）保留了：
|
||
* 出发前排的行程是 plan，真正走完记的是 reality，两轨并存，
|
||
* 于是"我们本来打算去哪、后来实际上去了哪"都能回看。
|
||
*/
|
||
|
||
declare(strict_types=1);
|
||
|
||
namespace App;
|
||
|
||
final class Trip
|
||
{
|
||
/** 节点类型（TripLog 的 node_types 简化成固定几种 —— 家庭出游用不到那么多） */
|
||
public const NODE_TYPES = [
|
||
'play' => ['游玩', '🎡'],
|
||
'meal' => ['用餐', '🍜'],
|
||
'move' => ['赶路', '🚗'],
|
||
'stay' => ['住宿', '🏨'],
|
||
'other' => ['其他', '📌'],
|
||
];
|
||
|
||
public const NODE_STATUS = [
|
||
'planned' => '计划中',
|
||
'ongoing' => '进行中',
|
||
'done' => '已完成',
|
||
'cancelled' => '已取消',
|
||
];
|
||
|
||
/** 全部旅程（按出发时间倒序） */
|
||
public static function all(int $familyId, string $keyword = ''): array
|
||
{
|
||
// ⚠️ 用户 2026-10-03 第 4 条：「旅程的活动中，只显示 is_public=1 的活动」。
|
||
// 用 LEFT JOIN + COALESCE 而不是 INNER JOIN：
|
||
// 老数据/异常情况下 trip_details 可能缺行，INNER JOIN 会让整趟旅程
|
||
// 从列表里消失（"行程丢了"比"多显示一条"严重得多），
|
||
// COALESCE(...,1) 表示"没有这行就算公开"。
|
||
$sql = 'SELECT e.id, e.title, e.starts_at, e.ends_at, e.location, e.note,
|
||
d.cover_key, d.summary, COALESCE(d.is_public, 1) AS is_public,
|
||
(SELECT COUNT(*) FROM event_attendees a WHERE a.event_id = e.id) AS attendee_count,
|
||
(SELECT COUNT(*) FROM trip_nodes n WHERE n.event_id = e.id) AS node_count
|
||
FROM events e
|
||
LEFT JOIN trip_details d ON d.event_id = e.id
|
||
WHERE e.family_id = ? AND e.kind = ? AND COALESCE(d.is_public, 1) = 1';
|
||
$bind = [$familyId, 'trip'];
|
||
$kw = trim($keyword);
|
||
if ($kw !== '') {
|
||
$sql .= ' AND (e.title LIKE ? OR e.location LIKE ? OR e.note LIKE ?)';
|
||
$like = '%' . $kw . '%';
|
||
array_push($bind, $like, $like, $like);
|
||
}
|
||
$sql .= ' ORDER BY e.starts_at DESC, e.id DESC';
|
||
$st = Database::get()->prepare($sql);
|
||
$st->execute($bind);
|
||
return $st->fetchAll();
|
||
}
|
||
|
||
/**
|
||
* 给一批旅程补上「同行的人」。
|
||
*
|
||
* ⚠️ 必须一次性补（N+1 会让列表在几十趟旅程时明显变慢，观影就是这么踩的）。
|
||
* 一次查询拿全部 event_attendees，再按 event_id 分桶挂回去。
|
||
*/
|
||
public static function attachAttendees(array &$rows, int $viewerId = 0): void
|
||
{
|
||
$ids = [];
|
||
foreach ($rows as $r) {
|
||
$id = (int)($r['id'] ?? 0);
|
||
if ($id > 0) {
|
||
$ids[] = $id;
|
||
}
|
||
}
|
||
$byEvent = [];
|
||
foreach ($rows as $r) {
|
||
$byEvent[(int)$r['id']] = [];
|
||
}
|
||
if ($ids) {
|
||
$in = implode(',', array_fill(0, count($ids), '?'));
|
||
$st = Database::get()->prepare(
|
||
'SELECT a.event_id, p.id, p.name, p.avatar, p.avatar_color, n.nickname AS my_nickname
|
||
FROM event_attendees a JOIN persons p ON p.id = a.person_id
|
||
LEFT JOIN nicknames n ON n.target_id = p.id AND n.viewer_id = ?
|
||
WHERE a.event_id IN (' . $in . ')
|
||
ORDER BY a.position, p.id'
|
||
);
|
||
$st->execute(array_merge([$viewerId], $ids));
|
||
foreach ($st->fetchAll() as $a) {
|
||
$byEvent[(int)$a['event_id']][] = $a;
|
||
}
|
||
}
|
||
foreach ($rows as &$r) {
|
||
$r['attendees'] = $byEvent[(int)$r['id']] ?? [];
|
||
}
|
||
unset($r);
|
||
}
|
||
|
||
/** 一条完整旅程 */
|
||
public static function find(int $familyId, int $id, int $viewerId = 0): ?array
|
||
{
|
||
$st = Database::get()->prepare(
|
||
// ⚠️ 单条详情**不按 is_public 拦**：勾了"不公开"只代表不进列表/日历，
|
||
// 直接拿到链接的人（或行程成员）仍应该能打开它 —— 否则非遗漏一次就找不回来。
|
||
"SELECT e.*, d.cover_key, d.summary, COALESCE(d.is_public, 1) AS is_public
|
||
FROM events e LEFT JOIN trip_details d ON d.event_id = e.id
|
||
WHERE e.family_id = ? AND e.id = ? AND e.kind = 'trip'"
|
||
);
|
||
$st->execute([$familyId, $id]);
|
||
$row = $st->fetch();
|
||
if (!$row) {
|
||
return null;
|
||
}
|
||
$row['attendees'] = self::attendees($id, $viewerId);
|
||
$row['photos'] = \App\Attachment::list('trip', $id);
|
||
return $row;
|
||
}
|
||
|
||
/** 同行的人（带「我叫他什么」与主色，页面按人画标签） */
|
||
public static function attendees(int $eventId, int $viewerId = 0): array
|
||
{
|
||
$st = Database::get()->prepare(
|
||
'SELECT p.id, p.name, p.avatar, p.avatar_color, n.nickname AS my_nickname
|
||
FROM event_attendees a JOIN persons p ON p.id = a.person_id
|
||
LEFT JOIN nicknames n ON n.target_id = p.id AND n.viewer_id = ?
|
||
WHERE a.event_id = ?
|
||
ORDER BY a.position, p.id'
|
||
);
|
||
$st->execute([$viewerId, $eventId]);
|
||
return $st->fetchAll();
|
||
}
|
||
|
||
/** @return int 事件 id */
|
||
public static function create(int $familyId, ?int $creatorId, array $d): int
|
||
{
|
||
$db = Database::get();
|
||
$db->prepare(
|
||
"INSERT INTO events (family_id, creator_id, kind, title, starts_at, ends_at, location, note, source_ref)
|
||
VALUES (?, ?, 'trip', ?, ?, ?, ?, ?, ?)"
|
||
)->execute([
|
||
$familyId, $creatorId, (string)$d['title'],
|
||
self::dtOrNull($d['starts_at'] ?? ''), self::dtOrNull($d['ends_at'] ?? ''),
|
||
self::textOrNull($d['location'] ?? ''), self::textOrNull($d['note'] ?? ''),
|
||
$d['source_ref'] ?? null,
|
||
]);
|
||
$id = (int)$db->lastInsertId();
|
||
self::saveDetails($id, $d);
|
||
self::saveAttendees($id, $d['attendees'] ?? []);
|
||
return $id;
|
||
}
|
||
|
||
public static function update(int $familyId, int $id, array $d): void
|
||
{
|
||
$db = Database::get();
|
||
$db->prepare(
|
||
"UPDATE events SET title=?, starts_at=?, ends_at=?, location=?, note=?
|
||
WHERE id=? AND family_id=? AND kind='trip'"
|
||
)->execute([
|
||
(string)$d['title'],
|
||
self::dtOrNull($d['starts_at'] ?? ''), self::dtOrNull($d['ends_at'] ?? ''),
|
||
self::textOrNull($d['location'] ?? ''), self::textOrNull($d['note'] ?? ''),
|
||
$id, $familyId,
|
||
]);
|
||
self::saveDetails($id, $d);
|
||
self::saveAttendees($id, $d['attendees'] ?? []);
|
||
}
|
||
|
||
private static function saveDetails(int $eventId, array $d): void
|
||
{
|
||
$db = Database::get();
|
||
$row = [
|
||
self::keyOrNull($d['cover_key'] ?? ''),
|
||
self::textOrNull($d['summary'] ?? ''),
|
||
// 用户第 4 条：是否公开。
|
||
// ⚠️ 必须区分「这个键没传」与「用户明确取消勾选」：
|
||
// · 没传（程序化创建 / 迁移 / 老调用）→ **按公开(1)**，
|
||
// 与建表默认值一致；默认 0 会让数据**静默消失**在列表里，
|
||
// 那是最坏的一种失败（用户只会看到"我的行程不见了"）。
|
||
// · 传了 0（表单里取消勾选）→ 真的不公开。
|
||
array_key_exists('is_public', $d) ? (!empty($d['is_public']) ? 1 : 0) : 1,
|
||
];
|
||
$has = $db->prepare('SELECT COUNT(*) FROM trip_details WHERE event_id = ?');
|
||
$has->execute([$eventId]);
|
||
if ((int)$has->fetchColumn() > 0) {
|
||
$db->prepare('UPDATE trip_details SET cover_key=?, summary=?, is_public=? WHERE event_id=?')
|
||
->execute([...$row, $eventId]);
|
||
} else {
|
||
$db->prepare('INSERT INTO trip_details (cover_key, summary, is_public, event_id) VALUES (?,?,?,?)')
|
||
->execute([...$row, $eventId]);
|
||
}
|
||
}
|
||
|
||
public static function saveAttendees(int $eventId, array $personIds): void
|
||
{
|
||
$db = Database::get();
|
||
$db->prepare('DELETE FROM event_attendees WHERE event_id = ?')->execute([$eventId]);
|
||
$ins = $db->prepare('INSERT IGNORE INTO event_attendees (event_id, person_id, position) VALUES (?,?,?)');
|
||
$pos = 0;
|
||
foreach ($personIds as $pid) {
|
||
$pid = (int)$pid;
|
||
if ($pid > 0) {
|
||
$pos += 10;
|
||
$ins->execute([$eventId, $pid, $pos]);
|
||
}
|
||
}
|
||
}
|
||
|
||
public static function destroy(int $familyId, int $id): void
|
||
{
|
||
// 照片与节点附件一并清（events 级联只带走数据库行，存储对象要自己删）
|
||
foreach (\App\Attachment::list('trip', $id) as $a) {
|
||
\App\Attachment::remove((int)$a['id']);
|
||
}
|
||
foreach (self::nodes($id) as $n) {
|
||
foreach (\App\Attachment::list('trip_node', (int)$n['id']) as $a) {
|
||
\App\Attachment::remove((int)$a['id']);
|
||
}
|
||
}
|
||
Database::get()->prepare("DELETE FROM events WHERE id=? AND family_id=? AND kind='trip'")
|
||
->execute([$id, $familyId]);
|
||
}
|
||
|
||
// ---------------- 行程节点 ----------------
|
||
|
||
/** 这趟旅程的全部节点（plan / reality 两轨，按 position 排） */
|
||
public static function nodes(int $eventId, int $viewerId = 0): array
|
||
{
|
||
$st = Database::get()->prepare(
|
||
'SELECT * FROM trip_nodes WHERE event_id = ? ORDER BY category, position, starts_at, id'
|
||
);
|
||
$st->execute([$eventId]);
|
||
$rows = $st->fetchAll();
|
||
$ids = array_map('intval', array_column($rows, 'id'));
|
||
// 一次性把全部节点的附件取出来（逐节点查会让"十几段的旅程"变成几十次查询）
|
||
$attach = [];
|
||
foreach ($ids as $nid) {
|
||
$attach[$nid] = [];
|
||
}
|
||
if ($ids) {
|
||
$in = implode(',', array_fill(0, count($ids), '?'));
|
||
$sa = Database::get()->prepare(
|
||
"SELECT * FROM attachments WHERE target_type = 'trip_node' AND target_id IN ($in)
|
||
ORDER BY position, id"
|
||
);
|
||
$sa->execute($ids);
|
||
foreach ($sa->fetchAll() as $a) {
|
||
$attach[(int)$a['target_id']][] = $a;
|
||
}
|
||
}
|
||
foreach ($rows as &$n) {
|
||
$n['members'] = self::nodeMembersFor((int)$n['id'], $viewerId);
|
||
$n['attachs'] = $attach[(int)$n['id']] ?? [];
|
||
}
|
||
unset($n);
|
||
return $rows;
|
||
}
|
||
|
||
public static function node(int $id): ?array
|
||
{
|
||
$st = Database::get()->prepare('SELECT * FROM trip_nodes WHERE id = ?');
|
||
$st->execute([$id]);
|
||
$r = $st->fetch();
|
||
return $r ?: null;
|
||
}
|
||
|
||
public static function saveNode(int $familyId, int $eventId, array $d, ?int $id = null): int
|
||
{
|
||
$db = Database::get();
|
||
$fields = [
|
||
self::textOrNull2($d['title'] ?? ''),
|
||
self::textOrNull($d['detail'] ?? ''),
|
||
self::textOrNull($d['place'] ?? ''),
|
||
self::dtOrNull($d['starts_at'] ?? ''),
|
||
self::dtOrNull($d['ends_at'] ?? ''),
|
||
in_array($d['node_type'] ?? '', array_keys(self::NODE_TYPES), true) ? $d['node_type'] : 'other',
|
||
in_array($d['status'] ?? '', array_keys(self::NODE_STATUS), true) ? $d['status'] : 'planned',
|
||
($d['category'] ?? '') === 'reality' ? 'reality' : 'plan',
|
||
(int)($d['position'] ?? 100),
|
||
];
|
||
if ($id !== null && $id > 0) {
|
||
$db->prepare(
|
||
'UPDATE trip_nodes SET title=?, detail=?, place=?, starts_at=?, ends_at=?,
|
||
node_type=?, status=?, category=?, position=? WHERE id=?'
|
||
)->execute([...$fields, $id]);
|
||
$nid = $id;
|
||
} else {
|
||
$db->prepare(
|
||
'INSERT INTO trip_nodes (family_id, event_id, title, detail, place, starts_at, ends_at,
|
||
node_type, status, category, position) VALUES (?,?,?,?,?,?,?,?,?,?,?)'
|
||
)->execute([$familyId, $eventId, ...$fields]);
|
||
$nid = (int)$db->lastInsertId();
|
||
}
|
||
self::saveNodeMembers($nid, $d['members'] ?? []);
|
||
return $nid;
|
||
}
|
||
|
||
public static function deleteNode(int $id): void
|
||
{
|
||
foreach (\App\Attachment::list('trip_node', $id) as $a) {
|
||
\App\Attachment::remove((int)$a['id']);
|
||
}
|
||
Database::get()->prepare('DELETE FROM trip_nodes WHERE id = ?')->execute([$id]);
|
||
}
|
||
|
||
/**
|
||
* 这一段里有谁。
|
||
*
|
||
* ⚠️ 昵称必须按**看页面的那个人**的视角取，所以要显式传 $viewerId ——
|
||
* 成员表里只有"谁参加了"，没有"谁在看"。
|
||
*/
|
||
public static function nodeMembersFor(int $nodeId, int $viewerId): array
|
||
{
|
||
$st = Database::get()->prepare(
|
||
'SELECT p.id, p.name, p.avatar, p.avatar_color, n.nickname AS my_nickname
|
||
FROM trip_node_members m JOIN persons p ON p.id = m.person_id
|
||
LEFT JOIN nicknames n ON n.target_id = p.id AND n.viewer_id = ?
|
||
WHERE m.node_id = ? ORDER BY p.id'
|
||
);
|
||
$st->execute([$viewerId, $nodeId]);
|
||
return $st->fetchAll();
|
||
}
|
||
|
||
public static function saveNodeMembers(int $nodeId, array $personIds): void
|
||
{
|
||
$db = Database::get();
|
||
$db->prepare('DELETE FROM trip_node_members WHERE node_id = ?')->execute([$nodeId]);
|
||
$ins = $db->prepare('INSERT IGNORE INTO trip_node_members (node_id, person_id) VALUES (?,?)');
|
||
foreach ($personIds as $pid) {
|
||
$pid = (int)$pid;
|
||
if ($pid > 0) {
|
||
$ins->execute([$nodeId, $pid]);
|
||
}
|
||
}
|
||
}
|
||
|
||
// ---------------- 展示 ----------------
|
||
|
||
/** 起止日期的人话展示（与 Movie::formatWatch 同款口径） */
|
||
public static function formatSpan(?string $start, ?string $end): string
|
||
{
|
||
if ($start === null || $start === '') {
|
||
return '日期待补';
|
||
}
|
||
$ts = strtotime($start);
|
||
if ($ts === false) {
|
||
return '日期待补';
|
||
}
|
||
$s = date('Y年n月j日', $ts);
|
||
if ($end === null || $end === '') {
|
||
return $s;
|
||
}
|
||
$te = strtotime($end);
|
||
if ($te === false) {
|
||
return $s;
|
||
}
|
||
return $s . ' – ' . date('Y年n月j日', $te);
|
||
}
|
||
|
||
public static function typeWord(string $key): string
|
||
{
|
||
return self::NODE_TYPES[$key][0] ?? '其他';
|
||
}
|
||
|
||
public static function typeIcon(string $key): string
|
||
{
|
||
return self::NODE_TYPES[$key][1] ?? '📌';
|
||
}
|
||
|
||
public static function statusWord(string $key): string
|
||
{
|
||
return self::NODE_STATUS[$key] ?? '计划中';
|
||
}
|
||
|
||
// ---------------- 小工具 ----------------
|
||
|
||
private static function dtOrNull(string $v): ?string
|
||
{
|
||
$v = trim($v);
|
||
if ($v === '') {
|
||
return null;
|
||
}
|
||
if (preg_match('/^\d{4}-\d{2}-\d{2}$/', $v)) {
|
||
$v .= ' 00:00:00';
|
||
}
|
||
return preg_match('/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/', $v) ? $v : null;
|
||
}
|
||
|
||
private static function textOrNull(string $v): ?string
|
||
{
|
||
$v = trim($v);
|
||
return $v !== '' ? $v : null;
|
||
}
|
||
|
||
private static function textOrNull2(string $v): string
|
||
{
|
||
return mb_substr(trim($v), 0, 200, 'UTF-8');
|
||
}
|
||
|
||
private static function keyOrNull(string $v): ?string
|
||
{
|
||
$v = ltrim(trim($v), '/');
|
||
if ($v === '' || strpos($v, '..') !== false || strpos($v, "\0") !== false) {
|
||
return null;
|
||
}
|
||
return $v;
|
||
}
|
||
}
|