用户原话:「旅程这个模块,我准备大改…如果按照计划行程和实际行程来分别管理,
会变的很复杂…根据我的想法,重构这个模块。」
—— 这不是加需求,是把「双轨」架构换成「一条记录 + 状态机」。
## 用户确认的三个决定
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 —— 一条没丢。
117 lines
5.8 KiB
PHP
117 lines
5.8 KiB
PHP
<?php
|
||
/**
|
||
* 行程节点表单(新增 / 编辑共用;被 show.php 循环 require)。
|
||
*
|
||
* v24 第 13 批:旅程重构后,**行程不再分两条轨**,而是**一条记录 + 状态机**。
|
||
* 用户原话:「这个实际的行程和计划行程,是一条记录,不是两条」。
|
||
* 所以这里加一个「这是哪一类」的下拉:计划行程 / 实际行程
|
||
* (新建时由用户选;编辑时是当前状态)。
|
||
* 「修正」「标记为实际」「完成」「标记未成行」是**另外三个按钮**(在 show.php 上),
|
||
* 不走这张表单 —— 它们的语义是"对既有行程的操作",不是"填一遍字段"。
|
||
*
|
||
* 变量(require 前设好):
|
||
* $nfNode 被编辑的节点数组,或 null(新增)
|
||
* $nfTripId 旅程 id(events.id)
|
||
* $nfCategory 【兼容保留】'plan' | 'reality'(新版只用来定默认值)
|
||
* $nfPeople 可选人名册(选参与人用),为空就不显示成员多选
|
||
* $nfMembers 已选成员 id 列表
|
||
*/
|
||
$nfIsEdit = !empty($nfNode);
|
||
$nfPrefix = $nfIsEdit ? 'ne' . (int)$nfNode['id'] : 'nn';
|
||
// 默认状态:编辑时用它的 stage;新建时按调用方给的 $nfCategory 映射(兼容旧调用)
|
||
$nfStage = $nfIsEdit
|
||
? (string)($nfNode['stage'] ?? (($nfNode['category'] ?? 'plan') === 'reality' ? 'actual' : 'plan'))
|
||
: ($nfCategory === 'reality' ? 'actual' : 'plan');
|
||
?>
|
||
<form class="node-form" method="post" action="<?= e(url($nfIsEdit ? 'trips/node_update' : 'trips/node_add')) ?>">
|
||
<?= csrf_field() ?>
|
||
<input type="hidden" name="trip_id" value="<?= (int)$nfTripId ?>">
|
||
<?php /* v24 第 13 批:新建时选「计划 / 实际」——用户原话第 2 条明确要求。
|
||
一旦创建后要改,走行程上那三个按钮(修正/完成/标记未成行),不在这张表里。 */ ?>
|
||
<input type="hidden" name="stage" value="<?= e($nfStage) ?>">
|
||
<?php if ($nfIsEdit): ?>
|
||
<input type="hidden" name="id" value="<?= (int)$nfNode['id'] ?>">
|
||
<?php endif; ?>
|
||
|
||
<div class="nf-grid">
|
||
<div class="field">
|
||
<label for="<?= e($nfPrefix) ?>-title">这一段 *</label>
|
||
<input class="input" id="<?= e($nfPrefix) ?>-title" name="title" required
|
||
value="<?= e($nfNode['title'] ?? '') ?>" placeholder="如:栈桥看海">
|
||
</div>
|
||
<div class="field">
|
||
<label for="<?= e($nfPrefix) ?>-type">类型</label>
|
||
<select class="select" id="<?= e($nfPrefix) ?>-type" name="node_type">
|
||
<?php foreach (\App\Trip::NODE_TYPES as $tk => $tv): ?>
|
||
<option value="<?= e($tk) ?>"<?= ($nfNode['node_type'] ?? 'other') === $tk ? ' selected' : '' ?>>
|
||
<?= e($tv[1] . ' ' . $tv[0]) ?>
|
||
</option>
|
||
<?php endforeach; ?>
|
||
</select>
|
||
</div>
|
||
<?php if (!$nfIsEdit): ?>
|
||
<div class="field">
|
||
<label for="<?= e($nfPrefix) ?>-stage">这是哪一类 *</label>
|
||
<select class="select" id="<?= e($nfPrefix) ?>-stage" name="stage_pick">
|
||
<option value="plan"<?= $nfStage === 'plan' ? ' selected' : '' ?>>计划行程(还没走)</option>
|
||
<option value="actual"<?= $nfStage === 'actual' ? ' selected' : '' ?>>实际行程(已经走过)</option>
|
||
</select>
|
||
<span class="tip">计划行程走完后可用「修正 / 完成」转成实际行程。</span>
|
||
</div>
|
||
<?php else: ?>
|
||
<div class="field">
|
||
<label>当前状态</label>
|
||
<div class="node-stage-ro"><?= e(\App\Trip::stageWord($nfStage)) ?></div>
|
||
</div>
|
||
<?php endif; ?>
|
||
<div class="field">
|
||
<label for="<?= e($nfPrefix) ?>-place">地点</label>
|
||
<input class="input" id="<?= e($nfPrefix) ?>-place" name="place"
|
||
value="<?= e($nfNode['place'] ?? '') ?>" placeholder="选填">
|
||
</div>
|
||
<div class="field">
|
||
<label for="<?= e($nfPrefix) ?>-status">状态</label>
|
||
<select class="select" id="<?= e($nfPrefix) ?>-status" name="status">
|
||
<?php foreach (\App\Trip::NODE_STATUS as $sk => $sv): ?>
|
||
<option value="<?= e($sk) ?>"<?= ($nfNode['status'] ?? 'planned') === $sk ? ' selected' : '' ?>>
|
||
<?= e($sv) ?>
|
||
</option>
|
||
<?php endforeach; ?>
|
||
</select>
|
||
</div>
|
||
<?php /* 用户 2026-10-04 第 7 条:节点的起止也是**一个范围**,一次选完 */ ?>
|
||
<div class="field dt-range">
|
||
<label>开始 / 结束</label>
|
||
<?php $dtName = 'starts_at'; $dtValue = $nfNode['starts_at'] ?? '';
|
||
$dtId = $nfPrefix . '-s'; $dtSeconds = true; $dtRange = 'start';
|
||
require __DIR__ . '/../_datetime.php'; ?>
|
||
<?php $dtName = 'ends_at'; $dtValue = $nfNode['ends_at'] ?? '';
|
||
$dtId = $nfPrefix . '-e'; $dtSeconds = true; $dtRange = 'end';
|
||
require __DIR__ . '/../_datetime.php'; ?>
|
||
<span class="tip">结束时间可不填。</span>
|
||
</div>
|
||
<div class="field full">
|
||
<label for="<?= e($nfPrefix) ?>-detail">记录</label>
|
||
<textarea class="input" id="<?= e($nfPrefix) ?>-detail" name="detail" rows="2"
|
||
placeholder="这一段发生了什么"><?= e($nfNode['detail'] ?? '') ?></textarea>
|
||
</div>
|
||
<?php if (!empty($nfPeople)): ?>
|
||
<div class="field full">
|
||
<label>这一段里有谁(不勾 = 全趟同行的人)</label>
|
||
<div class="nf-members">
|
||
<?php foreach ($nfPeople as $p): ?>
|
||
<label class="check-item">
|
||
<input type="checkbox" name="members[]" value="<?= (int)$p['id'] ?>"
|
||
<?= in_array((int)$p['id'], $nfMembers, true) ? 'checked' : '' ?>>
|
||
<span><?= e(person_name($p)) ?></span>
|
||
</label>
|
||
<?php endforeach; ?>
|
||
</div>
|
||
</div>
|
||
<?php endif; ?>
|
||
</div>
|
||
<div class="btn-row">
|
||
<button class="btn btn-sm" type="submit"><?= $nfIsEdit ? '保存' : '加一段' ?></button>
|
||
</div>
|
||
</form>
|