laoyang
89b956205d
用户原话：「旅程这个模块，我准备大改…如果按照计划行程和实际行程来分别管理，
会变的很复杂…根据我的想法，重构这个模块。」
—— 这不是加需求，是把「双轨」架构换成「一条记录 + 状态机」。
## 用户确认的三个决定
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 —— 一条没丢。
294 lines
14 KiB
PHP
294 lines
14 KiB
PHP
<?php
|
||
/**
|
||
* 旅程详情（v12）：封面 + 小结 + 同行的人 + 照片 + 行程节点（计划 / 执行双轨）。
|
||
*
|
||
* ⚠️ 双轨的意义：出发前排的是「打算怎么走」，走完记的是「实际怎么走的」。
|
||
* 两轨并存才能回看"本来想去哪、后来去了哪"—— 这是 TripLog 最有价值的一点，搬过来时保留了。
|
||
*/
|
||
$canWrite = \App\Auth::canWrite();
|
||
// v24 第 13 批：不再按 category 双轨分，按**状态机 stage** 分三组展示。
|
||
// 计划行程 / 实际行程 / 未成行（未成行的也要显示，用户明确要求"只不过要标记上"）。
|
||
$bysStage = ['plan' => [], 'actual' => [], 'skipped' => []];
|
||
foreach ((array)($nodes ?? []) as $n) {
|
||
$sg = (string)($n['stage'] ?? (($n['category'] ?? 'plan') === 'reality' ? 'actual' : 'plan'));
|
||
if (!isset($bysStage[$sg])) { $sg = 'plan'; }
|
||
$bysStage[$sg][] = $n;
|
||
}
|
||
// 每条行程带上它的修正历史（模板里画"原计划 → 实际"的对比）
|
||
foreach ($bysStage as $sg => &$lst) {
|
||
foreach ($lst as &$nd) {
|
||
$nd['revisions'] = \App\Trip::revisions((int)$nd['id']);
|
||
}
|
||
unset($nd);
|
||
}
|
||
unset($lst);
|
||
$memberIds = array_map('intval', array_column((array)($t['attendees'] ?? []), 'id'));
|
||
?>
|
||
<div class="page-head">
|
||
<h1><?= e((string)$t['title']) ?></h1>
|
||
<span class="sub"><?= e(\App\Trip::formatSpan($t['starts_at'] ?? null, $t['ends_at'] ?? null)) ?></span>
|
||
<div class="actions">
|
||
<?php if ($canWrite): ?>
|
||
<a class="btn btn-ghost" href="<?= e(url('trips/edit', ['id' => (int)$t['id']])) ?>">编辑</a>
|
||
<form method="post" action="<?= e(url('trips/destroy')) ?>"
|
||
onsubmit="return confirm('确定删除「<?= e((string)$t['title']) ?>」吗？照片与行程节点会一起删掉，不可恢复。')">
|
||
<?= csrf_field() ?>
|
||
<input type="hidden" name="id" value="<?= (int)$t['id'] ?>">
|
||
<button class="btn btn-danger" type="submit">删除</button>
|
||
</form>
|
||
<?php endif; ?>
|
||
<a class="btn btn-ghost" href="<?= e(url('trips')) ?>">返回旅程</a>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="card card-pad trip-hero">
|
||
<div class="trip-hero-cover">
|
||
<?php if (!empty($t['cover_key'])): ?>
|
||
<img src="<?= e(media_url((string)$t['cover_key'])) ?>" alt="">
|
||
<?php else: ?>
|
||
<span class="trip-cover-empty">🧳</span>
|
||
<?php endif; ?>
|
||
</div>
|
||
<div class="trip-hero-body">
|
||
<?php if (!empty($t['location'])): ?>
|
||
<p class="trip-loc">📍 <?= e((string)$t['location']) ?></p>
|
||
<?php endif; ?>
|
||
<?php if (!empty($t['summary'])): ?>
|
||
<p class="info-text"><?= nl2br(e((string)$t['summary'])) ?></p>
|
||
<?php endif; ?>
|
||
<?php if (!empty($t['attendees'])): ?>
|
||
<div class="viewers-list">
|
||
<?php foreach ($t['attendees'] as $a): ?>
|
||
<?= person_chip($a, url('people/show', ['id' => (int)$a['id']])) ?>
|
||
<?php endforeach; ?>
|
||
</div>
|
||
<?php endif; ?>
|
||
<?php if (!empty($t['note'])): ?>
|
||
<p class="remark-text"><?= nl2br(e((string)$t['note'])) ?></p>
|
||
<?php endif; ?>
|
||
</div>
|
||
</div>
|
||
|
||
<?php /* ---- 照片 ---- */ ?>
|
||
<div class="card card-pad">
|
||
<h2 class="cinema-h2">照片</h2>
|
||
<?php if (!$photos): ?>
|
||
<p class="empty-hint">还没有照片。</p>
|
||
<?php else: ?>
|
||
<div class="photo-grid">
|
||
<?php foreach ($photos as $ph): ?>
|
||
<figure class="photo-cell">
|
||
<?php /* v24 第 3 条：照片也在**本页**预览（原来 target=_blank 是另开一个标签页
|
||
只显示一张图，既没有下载按钮也不好回来看） */ ?>
|
||
<a href="<?= e(media_url((string)$ph['key'])) ?>"
|
||
data-prev="image"
|
||
data-src="<?= e(media_url((string)$ph['key'])) ?>"
|
||
data-dl="<?= e(media_url((string)$ph['key'], ['dl' => 1])) ?>"
|
||
data-name="<?= e((string)($ph['name'] ?? '照片')) ?>">
|
||
<img src="<?= e(media_url((string)$ph['key'])) ?>" alt="<?= e((string)($ph['name'] ?? '')) ?>">
|
||
</a>
|
||
<?php if ($canWrite): ?>
|
||
<form method="post" action="<?= e(url('trips/photo_del')) ?>" class="photo-del">
|
||
<?= csrf_field() ?>
|
||
<input type="hidden" name="id" value="<?= (int)$t['id'] ?>">
|
||
<input type="hidden" name="photo_id" value="<?= (int)$ph['id'] ?>">
|
||
<button class="btn btn-ghost btn-sm" type="submit"
|
||
onclick="return confirm('删掉这张照片？')">删除</button>
|
||
</form>
|
||
<?php endif; ?>
|
||
</figure>
|
||
<?php endforeach; ?>
|
||
</div>
|
||
<?php endif; ?>
|
||
<?php if ($canWrite): ?>
|
||
<form class="inline-form" method="post" enctype="multipart/form-data" action="<?= e(url('trips/photo_add')) ?>">
|
||
<?= csrf_field() ?>
|
||
<input type="hidden" name="id" value="<?= (int)$t['id'] ?>">
|
||
<input type="file" name="photo" accept="image/*" multiple required>
|
||
<button class="btn btn-sm" type="submit">上传照片</button>
|
||
</form>
|
||
<?php endif; ?>
|
||
</div>
|
||
|
||
<?php /* ==================== 行程（v24 第 13 批重构）====================
|
||
用户 2026-10-05 原话要点：
|
||
· 刚开始添加时选「计划行程 / 实际行程」
|
||
· 计划行程有三个按钮：删除（**标记未成行，不真删**）、修正（记实际执行，可无限次）、
|
||
完成（实际＝计划，直接变实际）
|
||
· 未成行的仍显示、但带标记；不上日程、不进往年今日
|
||
· 实际行程上日程 + 往年今日
|
||
分三组渲染：计划 / 实际 / 未成行（未成行放最后，用灰调）。 */ ?>
|
||
<?php
|
||
$stageMeta = [
|
||
'plan' => ['计划行程', '还没走，下面的「修正 / 完成 / 标记未成行」都能用'],
|
||
'actual' => ['实际行程', '已走过 —— 会出现在日历与首页「往年今日」'],
|
||
'skipped' => ['未成行', '这次计划没成行；不再出现在日程与「往年今日」，但在这里保留可查'],
|
||
];
|
||
foreach (['plan', 'actual', 'skipped'] as $sg):
|
||
$list = $bysStage[$sg];
|
||
?>
|
||
<div class="card card-pad trip-stage-card stage-<?= e($sg) ?>">
|
||
<h2 class="cinema-h2">
|
||
<?= e($stageMeta[$sg][0]) ?>
|
||
<span class="group-n"><?= count($list) ?> 段</span>
|
||
</h2>
|
||
<p class="stage-hint"><?= e($stageMeta[$sg][1]) ?></p>
|
||
|
||
<?php if (!$list): ?>
|
||
<p class="empty-hint">
|
||
<?= $sg === 'plan' ? '还没有排计划。' : ($sg === 'actual' ? '还没有走过的行程。' : '没有未成行的计划。') ?>
|
||
</p>
|
||
<?php else: ?>
|
||
<ol class="node-list">
|
||
<?php foreach ($list as $n): ?>
|
||
<li class="node-row status-<?= e((string)$n['status']) ?> stage-<?= e($sg) ?>"
|
||
id="node-<?= (int)$n['id'] ?>">
|
||
<span class="node-ico" title="<?= e(\App\Trip::typeWord((string)$n['node_type'])) ?>">
|
||
<?= e(\App\Trip::typeIcon((string)$n['node_type'])) ?>
|
||
</span>
|
||
<div class="node-body">
|
||
<div class="node-head">
|
||
<b><?= e((string)$n['title']) ?></b>
|
||
<span class="node-badge nb-<?= e($sg) ?>"><?= e(\App\Trip::stageWord($sg)) ?></span>
|
||
<?php if ((int)($n['revision_n'] ?? 0) > 0): ?>
|
||
<span class="rev-badge" title="已修正过多次，点下方「看修正记录」查看">已修正 <?= (int)$n['revision_n'] ?> 次</span>
|
||
<?php endif; ?>
|
||
<?php if (!empty($n['place'])): ?>
|
||
<span class="node-place">📍 <?= e((string)$n['place']) ?></span>
|
||
<?php endif; ?>
|
||
</div>
|
||
<?php $span = \App\Trip::formatSpan($n['starts_at'] ?? null, $n['ends_at'] ?? null); ?>
|
||
<?php if ($span !== '日期待补'): ?>
|
||
<div class="node-time">
|
||
<?= e($span) ?>
|
||
<?php if ($sg === 'actual'): ?><span class="actual-tag">实际</span><?php endif; ?>
|
||
</div>
|
||
<?php endif; ?>
|
||
<?php if (!empty($n['detail'])): ?>
|
||
<p class="node-detail"><?= nl2br(e((string)$n['detail'])) ?></p>
|
||
<?php endif; ?>
|
||
<?php if (!empty($n['members'])): ?>
|
||
<div class="trip-people">
|
||
<?php foreach ($n['members'] as $mm): ?><?= person_chip($mm) ?><?php endforeach; ?>
|
||
</div>
|
||
<?php endif; ?>
|
||
<?php if (!empty($n['attachs'])): ?>
|
||
<?php
|
||
$attRows = $n['attachs'];
|
||
$attCanEdit = false;
|
||
$attDelUrl = '';
|
||
require __DIR__ . '/../_attachments.php';
|
||
?>
|
||
<?php endif; ?>
|
||
|
||
<?php /* ---- 修正记录：原计划 → 每次修正的对比 ---- */ ?>
|
||
<?php if (!empty($n['revisions'])): ?>
|
||
<details class="rev-hist">
|
||
<summary class="link-quiet">看修正记录（<?= count($n['revisions']) ?> 条）</summary>
|
||
<table class="rev-table">
|
||
<thead>
|
||
<tr><th>#</th><th>时间</th><th>地点</th><th>说明</th></tr>
|
||
</thead>
|
||
<tbody>
|
||
<?php foreach ($n['revisions'] as $rv): ?>
|
||
<tr>
|
||
<td><?= (int)$rv['seq'] === 1 ? '原计划' : '第 ' . ((int)$rv['seq'] - 1) . ' 次修正' ?></td>
|
||
<td class="small"><?= e(\App\Trip::formatSpan($rv['starts_at'] ?? null, $rv['ends_at'] ?? null)) ?></td>
|
||
<td><?= e((string)($rv['place'] ?? '')) ?></td>
|
||
<td class="small"><?= e((string)($rv['detail'] ?? '')) ?></td>
|
||
</tr>
|
||
<?php endforeach; ?>
|
||
</tbody>
|
||
</table>
|
||
</details>
|
||
<?php endif; ?>
|
||
</div>
|
||
|
||
<?php if ($canWrite): ?>
|
||
<div class="node-ops">
|
||
<?php /* ---- 计划行程：三个动作（用户点名的三个按钮）---- */ ?>
|
||
<?php if ($sg === 'plan'): ?>
|
||
<details class="rev-open">
|
||
<summary class="btn btn-ghost btn-sm">修正</summary>
|
||
<div class="rev-panel">
|
||
<p class="rev-tip">
|
||
记录**实际**执行情况。这仍与上面那条计划是<b>同一条记录</b>，
|
||
原来的计划数据会保留在「修正记录」里，方便日后对比。
|
||
点完这里<b>行程仍是计划</b>；确认无误后再点「标记为实际」。
|
||
</p>
|
||
<?php
|
||
$rvNode = $n; $rvTripId = (int)$t['id'];
|
||
$rvPeople = $people ?? [];
|
||
$rvMembers = array_map('intval', array_column((array)($n['members'] ?? []), 'id'));
|
||
require __DIR__ . '/_revise_form.php';
|
||
?>
|
||
</div>
|
||
</details>
|
||
<form method="post" action="<?= e(url('trips/node_done')) ?>"
|
||
onsubmit="return confirm('实际执行与计划完全相同，直接转为实际行程？')">
|
||
<?= csrf_field() ?>
|
||
<input type="hidden" name="id" value="<?= (int)$n['id'] ?>">
|
||
<input type="hidden" name="trip_id" value="<?= (int)$t['id'] ?>">
|
||
<button class="btn btn-sm" type="submit">完成</button>
|
||
</form>
|
||
<form method="post" action="<?= e(url('trips/node_skip')) ?>"
|
||
onsubmit="return confirm('标记为「未成行」？它不会再出现在日程与往年今日，但在这趟旅程里仍然看得到。')">
|
||
<?= csrf_field() ?>
|
||
<input type="hidden" name="id" value="<?= (int)$n['id'] ?>">
|
||
<input type="hidden" name="trip_id" value="<?= (int)$t['id'] ?>">
|
||
<button class="btn btn-ghost btn-sm" type="submit">标记未成行</button>
|
||
</form>
|
||
<?php if ((int)($n['revision_n'] ?? 0) > 0): ?>
|
||
<form method="post" action="<?= e(url('trips/node_actual')) ?>">
|
||
<?= csrf_field() ?>
|
||
<input type="hidden" name="id" value="<?= (int)$n['id'] ?>">
|
||
<input type="hidden" name="trip_id" value="<?= (int)$t['id'] ?>">
|
||
<button class="btn btn-sm btn-primary" type="submit">标记为实际</button>
|
||
</form>
|
||
<?php endif; ?>
|
||
<?php elseif ($sg === 'skipped'): ?>
|
||
<form method="post" action="<?= e(url('trips/node_restore')) ?>">
|
||
<?= csrf_field() ?>
|
||
<input type="hidden" name="id" value="<?= (int)$n['id'] ?>">
|
||
<input type="hidden" name="trip_id" value="<?= (int)$t['id'] ?>">
|
||
<button class="btn btn-ghost btn-sm" type="submit">恢复为计划</button>
|
||
</form>
|
||
<?php endif; ?>
|
||
|
||
<details class="node-edit">
|
||
<summary class="link-quiet">编辑</summary>
|
||
<?php
|
||
$nfNode = $n; $nfTripId = (int)$t['id']; $nfCategory = $sg;
|
||
$nfPeople = $people ?? [];
|
||
$nfMembers = array_map('intval', array_column((array)($n['members'] ?? []), 'id'));
|
||
require __DIR__ . '/_node_form.php';
|
||
?>
|
||
</details>
|
||
<form method="post" action="<?= e(url('trips/node_del')) ?>"
|
||
onsubmit="return confirm('**彻底删除**这一段？连同它的修正记录一起消失，不可恢复。\n\n如果你只是想表达"这次没去成"，请用「标记未成行」。')">
|
||
<?= csrf_field() ?>
|
||
<input type="hidden" name="id" value="<?= (int)$n['id'] ?>">
|
||
<input type="hidden" name="trip_id" value="<?= (int)$t['id'] ?>">
|
||
<button class="btn btn-ghost btn-sm" type="submit">彻底删除</button>
|
||
</form>
|
||
</div>
|
||
<?php endif; ?>
|
||
</li>
|
||
<?php endforeach; ?>
|
||
</ol>
|
||
<?php endif; ?>
|
||
|
||
<?php if ($canWrite && $sg !== 'skipped'): ?>
|
||
<details class="node-add">
|
||
<summary class="link-quiet">+ 加一段<?= e($stageMeta[$sg][0]) ?></summary>
|
||
<?php
|
||
$nfNode = null; $nfTripId = (int)$t['id']; $nfCategory = $sg;
|
||
$nfPeople = $people ?? []; $nfMembers = $memberIds;
|
||
require __DIR__ . '/_node_form.php';
|
||
?>
|
||
</details>
|
||
<?php endif; ?>
|
||
</div>
|
||
<?php endforeach; ?>
|
||
|