v24 第 13 批：旅程模块重构（双轨 → 一条记录 + 状态机）
用户原话：「旅程这个模块，我准备大改…如果按照计划行程和实际行程来分别管理，
会变的很复杂…根据我的想法，重构这个模块。」
—— 这不是加需求，是把「双轨」架构换成「一条记录 + 状态机」。
## 用户确认的三个决定
1. 两层：**活动**（顶层容器）→ **行程**（挂其下，字段沿用原节点）
2. **修正不立即转实际**：修正只是记录，行程仍标"计划（已修正 N 次）"，
要再点一次「标记为实际」才转实际
3. 老数据**按现有轨道自动迁移**（category=reality → stage=actual）
## 状态机（本次重构的心脏）
trip_nodes.stage：
· plan 计划行程 —— 唯一以「计划时间」上日程的状态，三个动作都能用
· actual 实际行程 —— 上日程（实际时间）+ 进「往年今日」
· skipped 未成行 —— **不上日程、不进往年今日**，但旅程里仍显示并标注
（用户："还是要显示，只不过要标记上"）
旧的 category(plan/reality) 保留作兼容，业务一律看 stage（saveNode 同步维护两者）。
## 三个动作（Trip.php）
· reviseNode —— 记一次修正。🔴 **第一次修正前先把原计划存成 seq=1 快照**，
否则用户要的"之前的计划行程数据要保留，为了以后做对比"就落空。**不动 stage**。
可无限次（seq 递增）。
· completeNode —— 实际＝计划，直接转 actual，**不产生修正历史**（没有变化就没有历史）。
· markActual —— 把（已修正过的）计划正式转 actual。
· skipNode —— **不是真删**，只置 stage='skipped'（用户明确"不要真的删除，只是做一个标记"）。
· restoreNode —— 撤销未成行（点错了能改回来）。
界面上的「彻底删除」与「标记未成行」是两个并列动作，弹窗文案里写明区别。
## 修正历史（Schema v19，新表 trip_node_revisions）
每次修正一行：实际起止 / 实际地点 / 说明 / 参与人快照。
第 1 条 = 原计划快照，第 2..n 条 = 各次修正 —— 详情页用表格展示，可直接对比。
## 日历与往年今日（用户点名的联动）
· 日历：`n.stage IN ('plan','actual')` —— 去掉旧的 `status<>'cancelled'`
（那是双轨口径；现在"未成行"是 stage）。实际行程标题加 ✓ 前缀便于区分。
· **活动本身绝不上日程**（用户："活动因为可能跨越的时间比较长"）。
· 往年今日：旅程部分从「整趟 events」改成**实际行程**（stage='actual'），
标题带活动名前缀；未成行的不出现。
## 验证
新增 _trip_e2e12.py **30/0**：建活动 → 加行程（可选计划/实际）→ 修正（仍计划 /
历史保留原计划 09:00 / 可无限次）→ 标记为实际 → 完成（无历史）→ 标记未成行（未真删）
→ 日历四种情形（已转实际✓ 新建实际✓ 完成✓ 未成行✗ 活动✗）→ 往年今日只看实际。
回归：e2e 787/0、升级 129/0（含 v19 路径）、batch_e 91/0、batch10 46/0、batch9 38/0、
picker 28/0 + 11/0、crop 17/0、formbloat 9/0、semi 27/0、geom 5/5、mobile 688/0、
interact 92/0、drag 5/0。
e2e 两条旧断言（"双轨两块/两轨各一条"）按重构语义更新为"三组渲染 / stage 各一条
+ category 与 stage 同步"。
部署断言新增 1 大组，含**反退化防线**：skipNode 若被改成 DELETE 立即变红。
线上自检 19/19；线上真实账号验收 16/0。
线上老数据迁移实测：#222 计划3+实际1、#221 实际4、#220 实际13 —— 一条没丢。
This commit is contained in:
@@ -504,19 +504,57 @@ function home_memories(int $familyId, int $limit = 6): array
|
||||
{
|
||||
$today = date('Y-m-d');
|
||||
$year = (int)date('Y');
|
||||
$md = substr($today, 5, 5);
|
||||
$rows = [];
|
||||
|
||||
// ① 观影：照旧（events kind=movie）
|
||||
$sql = "SELECT e.id, e.title, e.starts_at, e.kind,
|
||||
(SELECT COUNT(*) FROM event_attendees a WHERE a.event_id = e.id) AS n
|
||||
FROM events e
|
||||
WHERE e.family_id = ? AND e.kind IN ('movie','trip') AND e.starts_at IS NOT NULL
|
||||
WHERE e.family_id = ? AND e.kind = 'movie' AND e.starts_at IS NOT NULL
|
||||
AND YEAR(e.starts_at) < ?
|
||||
AND DATE_FORMAT(e.starts_at, '%m-%d') = ?
|
||||
ORDER BY e.starts_at DESC LIMIT " . (int)$limit;
|
||||
$st = Database::get()->prepare($sql);
|
||||
$st->execute([$familyId, $year, substr($today, 5, 5)]);
|
||||
$rows = $st->fetchAll();
|
||||
$st->execute([$familyId, $year, $md]);
|
||||
foreach ($st->fetchAll() as $r) {
|
||||
$rows[] = $r;
|
||||
}
|
||||
|
||||
// ② 旅程：改成看**实际行程**（trip_nodes stage='actual'），不是整趟旅程。
|
||||
// 用户 2026-10-05：「实际行程，都会出现在日历和首页的往年今日中」，
|
||||
// 而"标记未成行 / 仍是计划"的都不该出现（"就权当没有这个日程"）。
|
||||
// ⚠️ 用 starts_at 而不是 events.starts_at —— 实际行程的时间才是"那天真的走了"。
|
||||
$sql2 = "SELECT n.id, n.title, n.starts_at, 'trip_node' AS kind,
|
||||
(SELECT COUNT(*) FROM trip_node_members m WHERE m.node_id = n.id) AS n,
|
||||
e.id AS trip_id, e.title AS trip_title, n.node_type
|
||||
FROM trip_nodes n
|
||||
JOIN events e ON e.id = n.event_id AND e.kind = 'trip'
|
||||
LEFT JOIN trip_details d ON d.event_id = e.id
|
||||
WHERE n.family_id = ? AND n.stage = 'actual' AND n.starts_at IS NOT NULL
|
||||
AND COALESCE(d.is_public, 1) = 1
|
||||
AND YEAR(n.starts_at) < ?
|
||||
AND DATE_FORMAT(n.starts_at, '%m-%d') = ?
|
||||
ORDER BY n.starts_at DESC LIMIT " . (int)$limit;
|
||||
$st2 = Database::get()->prepare($sql2);
|
||||
$st2->execute([$familyId, $year, $md]);
|
||||
foreach ($st2->fetchAll() as $r) {
|
||||
// 标题带上"是哪趟旅程的哪一段"，否则只看到一个"栈桥看海"不知道是何时的
|
||||
$r['title'] = (string)$r['trip_title'] . ' · ' . (string)$r['title'];
|
||||
$rows[] = $r;
|
||||
}
|
||||
|
||||
// 合并后按时间倒序，取前 N
|
||||
usort($rows, static fn(array $a, array $b): int => strcmp((string)$b['starts_at'], (string)$a['starts_at']));
|
||||
$rows = array_slice($rows, 0, $limit);
|
||||
|
||||
foreach ($rows as &$r) {
|
||||
$r['years_ago'] = $year - (int)substr((string)$r['starts_at'], 0, 4);
|
||||
$r['href'] = url($r['kind'] === 'trip' ? 'trips/show' : 'movies/show', ['id' => (int)$r['id']]);
|
||||
if ($r['kind'] === 'trip_node') {
|
||||
$r['href'] = url('trips/show', ['id' => (int)$r['trip_id']]) . '#node-' . (int)$r['id'];
|
||||
} else {
|
||||
$r['href'] = url($r['kind'] === 'trip' ? 'trips/show' : 'movies/show', ['id' => (int)$r['id']]);
|
||||
}
|
||||
}
|
||||
unset($r);
|
||||
return ['rows' => $rows, 'exact' => true];
|
||||
@@ -2907,6 +2945,9 @@ switch ($r) {
|
||||
'node_type' => (string)($_POST['node_type'] ?? 'other'),
|
||||
'status' => (string)($_POST['status'] ?? 'planned'),
|
||||
'category' => (string)($_POST['category'] ?? 'plan'),
|
||||
// v24 第 13 批：新建时用户在表单里选的「计划 / 实际」。
|
||||
// 编辑时表单带的是隐藏 stage（保持原状态），也一并读。
|
||||
'stage' => (string)($_POST['stage_pick'] ?? $_POST['stage'] ?? 'plan'),
|
||||
'members' => filter_family_person_ids((array)($_POST['members'] ?? []), $familyId),
|
||||
];
|
||||
if ($d['title'] === '') {
|
||||
@@ -2934,6 +2975,97 @@ switch ($r) {
|
||||
redirect('trips/show', ['id' => $tripId]);
|
||||
break;
|
||||
|
||||
// ---- 计划行程的三个动作（v24 第 13 批）----
|
||||
// 用户原话：「如果是计划行程，则这个行程下面有几个按钮，用来进一步操作，
|
||||
// 一个是删除，如果是标记为删除，不要真的删除，只是做一个标记…
|
||||
// 另外一个按钮，用来记录实际的情况，按钮名字就叫修正…
|
||||
// 还有一个按钮，就是完成…这个行程直接就变成了实际行程。」
|
||||
//
|
||||
// ⚠️ 三个动作都**只改状态、不真删** —— 这是用户明确要求的语义。
|
||||
|
||||
/** 「修正」：记一次实际执行情况（可无限次；行程仍是计划，要再点「标记为实际」） */
|
||||
case 'trips/node_revise':
|
||||
$familyId = (int)Auth::familyId();
|
||||
Auth::requireWrite();
|
||||
csrf_check();
|
||||
$tripId = (int)($_POST['trip_id'] ?? 0);
|
||||
if (!Trip::find($familyId, $tripId)) {
|
||||
flash('err', '找不到这趟旅程。');
|
||||
redirect('trips');
|
||||
}
|
||||
$nid = (int)($_POST['id'] ?? 0);
|
||||
$seq = Trip::reviseNode($nid, [
|
||||
'starts_at' => (string)(read_dt_input('rev_starts_at') ?? ''),
|
||||
'ends_at' => (string)(read_dt_input('rev_ends_at') ?? ''),
|
||||
'place' => trim((string)($_POST['place'] ?? '')),
|
||||
'detail' => trim((string)($_POST['detail'] ?? '')),
|
||||
'members' => filter_family_person_ids((array)($_POST['members'] ?? []), $familyId),
|
||||
], (int)Auth::personId());
|
||||
flash('ok', $seq > 0 ? '已记录第 ' . $seq . ' 次修正。它仍是**计划行程**；'
|
||||
. '确认无误后点「标记为实际」即可转为实际行程。' : '修正没成功。');
|
||||
redirect('trips/show', ['id' => $tripId]);
|
||||
break;
|
||||
|
||||
/** 「标记为实际」：把（已经修正过的）计划行程正式转为实际行程 */
|
||||
case 'trips/node_actual':
|
||||
$familyId = (int)Auth::familyId();
|
||||
Auth::requireWrite();
|
||||
csrf_check();
|
||||
$tripId = (int)($_POST['trip_id'] ?? 0);
|
||||
if (!Trip::find($familyId, $tripId)) {
|
||||
flash('err', '找不到这趟旅程。');
|
||||
redirect('trips');
|
||||
}
|
||||
Trip::markActual((int)($_POST['id'] ?? 0));
|
||||
flash('ok', '已转为**实际行程** —— 它会出现在日历与首页的「往年今日」。');
|
||||
redirect('trips/show', ['id' => $tripId]);
|
||||
break;
|
||||
|
||||
/** 「完成」：实际与计划完全相同 → 直接变实际行程（不产生修正历史） */
|
||||
case 'trips/node_done':
|
||||
$familyId = (int)Auth::familyId();
|
||||
Auth::requireWrite();
|
||||
csrf_check();
|
||||
$tripId = (int)($_POST['trip_id'] ?? 0);
|
||||
if (!Trip::find($familyId, $tripId)) {
|
||||
flash('err', '找不到这趟旅程。');
|
||||
redirect('trips');
|
||||
}
|
||||
Trip::completeNode((int)($_POST['id'] ?? 0));
|
||||
flash('ok', '这一段已按计划完成，转为**实际行程**。');
|
||||
redirect('trips/show', ['id' => $tripId]);
|
||||
break;
|
||||
|
||||
/** 「标记未成行」：不真删，只打标记（不上日程、不进往年今日，但旅程里仍显示） */
|
||||
case 'trips/node_skip':
|
||||
$familyId = (int)Auth::familyId();
|
||||
Auth::requireWrite();
|
||||
csrf_check();
|
||||
$tripId = (int)($_POST['trip_id'] ?? 0);
|
||||
if (!Trip::find($familyId, $tripId)) {
|
||||
flash('err', '找不到这趟旅程。');
|
||||
redirect('trips');
|
||||
}
|
||||
Trip::skipNode((int)($_POST['id'] ?? 0));
|
||||
flash('ok', '已标记为**未成行**。它不再出现在日程与往年今日，但在这趟旅程里仍然看得到。');
|
||||
redirect('trips/show', ['id' => $tripId]);
|
||||
break;
|
||||
|
||||
/** 撤销「未成行」→ 退回计划行程（点错了要能改回来） */
|
||||
case 'trips/node_restore':
|
||||
$familyId = (int)Auth::familyId();
|
||||
Auth::requireWrite();
|
||||
csrf_check();
|
||||
$tripId = (int)($_POST['trip_id'] ?? 0);
|
||||
if (!Trip::find($familyId, $tripId)) {
|
||||
flash('err', '找不到这趟旅程。');
|
||||
redirect('trips');
|
||||
}
|
||||
Trip::restoreNode((int)($_POST['id'] ?? 0));
|
||||
flash('ok', '已恢复为计划行程，它会重新出现在日程里。');
|
||||
redirect('trips/show', ['id' => $tripId]);
|
||||
break;
|
||||
|
||||
// ==================== 日程 / 日历（v12） ====================
|
||||
// 自定义日程落在 calendar_events；**观影与旅行两本是派生的**（从 events 实时汇总，
|
||||
// 不复制），给这两本"加日程"= 真的建一条观影 / 旅程记录。
|
||||
|
||||
Reference in New Issue
Block a user