v24 第 16 批:旅程 / 行程两级(术语固定 · 题图16:9 · 五项统计 · 独立行程页 · 设置三页)

用户十条,逐条落地:

1. 「题图应该按照 16:9 显示,因为添加的时候是按这个比例裁剪的,现在的显示比例不对。」
   → 详情页题图容器从 4:3 改成 16:9,与 ImageSlot 的 cover 槽位同一个数字
     (部署断言比对这两处,避免哪天改一处漏一处)。

2. 「题图的右侧,显示的是参与人都有谁、去了几个城市、一共去了几天、一共几段行程,
     一共花了多少钱,这些信息,都从该活动下的所有行程统计总结,简介那一段话保留。」
   → 新增 Trip::summary():参与人(各段并集)/ 城市(去重)/ 天数 / 段数 / 总花销,
     全部读时算(与"时间城市派生"同一条原则,不存冗余)。
     天数按**日历天**含首尾(8/1→8/3 = 3 天,不是 24 小时整除的 2 天)。
     城市与时间从标题旁挪进信息区,简介保留。

3. 「活动页面,不需要上传图片,图片视频,都是针对一次具体的行程的。」
   → 删掉旅程页的照片上传板块与照片墙;照片一律挂在**行程**上
     (行程表单里有上传,附件 target_type='trip_node')。

4. 「计划行程、未成行的行程,都不要显示……只要是没有就是 0 条,那个类型就不显示了,
     现在显示的是 0 条,这样没意义。」
   → 空分组直接跳过不渲染;全空时给一句引导(否则新建旅程页面一片空白)。
     有内容的分组照常显示(计划 / 实际 / 未成行三种)。

5. 「行程的编辑功能,点击后会把页面撑破。编辑行程,打开新的页面进行编辑。」
   → 行程的新增与编辑改成**独立页面**(trips/node_new / trips/node_edit)。
     原来内联在详情页:N 份表单互相撞元素 id、密码管理器逐个扫描变卡,
     正是"把页面撑破"的成因。

6. 「添加计划行程和实际行程的按钮,都放在右上角。点击后打开新的页面进行添加。」
   → 详情页右上角两个按钮(+ 计划行程 / + 实际行程),指向独立新增页。
     顺带:标题旁边不再放时间(时间移到题图右侧信息区)。

7. 「添加和编辑行程的内容,你去找 triplog 里面的添加节点功能,跟那个一样。」
   → 字段全量照搬 TripLog 的 nodes/form.php:
     类型 / 标题 / 起止时间 / 出行方式 + 车辆 / 线路名 / 承运方 / 车次航班号 /
     座位 / 登机口 / 出发地 / 到达地 / 内容 / 参与人(含角色)/ 照片 / 花销。
     交通字段不做条件列(先填高铁车次、后来改成自驾,填过的东西不该丢)。

8. 「右上角的按钮,需要增加一个设置按钮,用来设置车辆管理、出行方式、节点类型。
     注意,我们在财务中,已经把车辆添加进去了,所以这里不用重复添加那里面的车辆,
     直接读取就可以,但是可以添加其他的车辆,比如租的车,借别人的车。」
   → 新增旅程设置菜单(三页):车辆管理 / 出行方式 / 节点类型。
     车辆**两个来源刻意不合并**:财务里 kind='car' 的账目(那是资产,没有车牌车型)
     由 Vehicle::fromLedger() 只读列出,选车下拉里标「来自财务」;
     自家 / 租的 / 借的车录进 vehicles 表。不复制财务的车(避免同一台车两处维护)。
     节点类型做成**可自定义**的表(TripLog 同款),内置 5 种不可删;
     行程里存类型**名字**,所以改类型名会级联更新已用它的行程。

9. 「活动都改名吧,改成旅程,新建旅程,旅程包含行程,这个名字就固定下来。」
   → 术语固定:**旅程**(容器)包含**行程**(单元)。
     顶层按钮「新建旅程」、详情页三组叫「计划的行程 / 实际行程 / 未成行」、
     列表「N 段行程」、设置菜单「旅程设置」。上一批的"活动"叫法全部换掉。

10. 「新建旅程里面,怎么还有备注啊,同行的人啊,这些都不要了,这些都是从行程里面
      总结出来的。在新建旅程和编辑旅程的时候,都不要了。」
   → 旅程表单只剩:标题 → 题图 → 简介 + 公开开关。
     备注与同行的人全部移除(参与人 = 各段行程参与人的合集)。
     ⚠️ 但**老数据里活动级那份参与人名单不能被清空**(那时还没有行程级参与人),
     所以路由"没传这个键就不动",并加了断言钉住这一点。

数据结构(Schema v21,老库自动升级):
· 新表 vehicles(自家/租的/借的)、node_types(可自定义)、trip_expenses(行程级花销)
· trip_nodes 补 9 列:出行方式 / 车辆 / 线路名 / 承运方 / 车次 / 座位 / 登机口 / 起终点
· trip_node_members 补 role_tag(司机 / 摄影担当这类角色)
· 花销金额存**分**,解析走字符串拆小数点(128.55*100 在浮点下会差一分)

验证:e2e 891/0(+46 条本批断言)· 升级 134/0 · 桌面几何 428/0 · 交互 92/0 ·
窄屏溢出 30/0(扩到行程表单 + 设置三页 + 详情页)· 题图点击 4/0 · 静态体检全绿。
**反向验证 6/6**:题图退回 4:3、标题旁加回时间、空分组照旧渲染、编辑退回非独立页、
车辆不读财务、总花销不汇总 —— 六种坏法全部被断言抓住。
部署静态断言新增第 16 批一组(含"空分组不许渲染""行程页不许有照片上传"
"旅程表单不许有备注与同行的人""题图必须 16:9"等反退化防线)。
部署后服务器自检 19/19,六个关键文件 md5 与线上逐一核对一致。
This commit is contained in:
2026-10-05 13:26:49 +08:00
parent 7138314dc7
commit 2e51d3f5e4
16 changed files with 2265 additions and 456 deletions
+130
View File
@@ -0,0 +1,130 @@
<?php
/**
* 车辆管理(v24 第 16 批 用户第 8 条)。
*
* 用户原话:「注意,我们在财务中,已经把车辆添加进去了,所以这里不用重复添加
* 那里面的车辆,直接读取就可以,但是可以添加其他的车辆,
* 比如租的车,借别人的车。」
*
* 所以这一页有两块:
* ① **财务里已登记的车**(只读)—— 只列出来,不给改不给删(那是财务的数据);
* ② **出行用的车**(本表)—— 自家 / 租的 / 借的,可增删改。
*
* @param array $ledger Vehicle::fromLedger() 的结果(只读)
* @param array $mine Vehicle::all() 的结果
*/
$canWrite = \App\Auth::canWrite();
$ledger = $ledger ?? [];
$mine = $mine ?? [];
$back = url('trips');
?>
<div class="page-head">
<h1>车辆管理</h1>
<span class="sub">出行时能挑的车:自家的、租的、借别人的</span>
<div class="actions">
<a class="btn btn-ghost" href="<?= e($back) ?>">返回旅程</a>
<?php $trSetCurrent = 'vehicles'; require __DIR__ . '/_settings_menu.php'; ?>
</div>
</div>
<?php /* ---- ① 来自财务的车(只读引用)---- */ ?>
<div class="card card-pad">
<h2 class="cinema-h2">
财务里已登记的车
<span class="hint">只读 —— 要改请到财务模块</span>
</h2>
<?php if (!$ledger): ?>
<p class="empty-hint">
财务里还没有登记车子。到「财务 → 记一笔」里把车子作为一项资产记下来,
这里就会自动出现(<b>不必在这里重复添加</b>)。
</p>
<?php else: ?>
<ul class="veh-list">
<?php foreach ($ledger as $v): ?>
<li class="veh-row veh-ro">
<span class="veh-ico">🚗</span>
<span class="veh-name"><?= e((string)$v['name']) ?></span>
<span class="veh-tag">来自财务</span>
</li>
<?php endforeach; ?>
</ul>
<p class="small muted">
这些是财务里的**资产记录**(有一台车值多少钱),不一定有车牌与车型。
出行要选车时它们也会出现在下拉里,标着「来自财务」。
</p>
<?php endif; ?>
</div>
<?php /* ---- ② 出行用的车(本表)---- */ ?>
<div class="card card-pad">
<h2 class="cinema-h2">
出行用的车
<span class="hint">自家车可以录一台方便选;租的车、借的车录在这里</span>
</h2>
<?php if ($mine): ?>
<ul class="veh-list">
<?php foreach ($mine as $v): ?>
<li class="veh-row">
<span class="veh-ico"><?= ($v['vtype'] ?? 'own') === 'rental' ? '🔑' : (($v['vtype'] ?? 'own') === 'borrowed' ? '🤝' : '🚗') ?></span>
<?php if ($canWrite): ?>
<form class="inline-form veh-form" method="post" action="<?= e(url('trips/vehicles_save')) ?>">
<?= csrf_field() ?>
<input type="hidden" name="id" value="<?= (int)$v['id'] ?>">
<input class="input" name="plate" value="<?= e((string)$v['plate']) ?>"
placeholder="车牌" aria-label="车牌">
<input class="input" name="name" value="<?= e((string)$v['name']) ?>"
placeholder="车型名" required aria-label="车型名">
<select class="select" name="vtype" aria-label="来源">
<?php foreach (\App\Vehicle::TYPES as $vk => $vv): ?>
<option value="<?= e($vk) ?>"<?= (string)$v['vtype'] === $vk ? ' selected' : '' ?>>
<?= e($vv) ?>
</option>
<?php endforeach; ?>
</select>
<input class="input" name="vendor" value="<?= e((string)($v['vendor'] ?? '')) ?>"
placeholder="租车公司 / 车主" aria-label="租车公司或车主">
<label class="veh-def">
<input type="checkbox" name="is_default" value="1"<?= (int)$v['is_default'] === 1 ? ' checked' : '' ?>>
<span>默认</span>
</label>
<button class="btn btn-sm" type="submit">保存</button>
</form>
<form class="inline-form" method="post" action="<?= e(url('trips/vehicles_del')) ?>">
<?= csrf_field() ?>
<input type="hidden" name="id" value="<?= (int)$v['id'] ?>">
<button class="btn btn-ghost btn-sm" type="submit"
onclick="return confirm('删掉这辆车?')">删</button>
</form>
<?php else: ?>
<span class="veh-name"><?= e(\App\Vehicle::label($v)) ?></span>
<span class="veh-tag"><?= e(\App\Vehicle::TYPES[(string)$v['vtype']] ?? '') ?></span>
<?php endif; ?>
</li>
<?php endforeach; ?>
</ul>
<?php else: ?>
<p class="empty-hint">还没有。自家车录一台,出行时能直接挑。</p>
<?php endif; ?>
<?php if ($canWrite): ?>
<h3 class="set-sub">加一辆车</h3>
<form class="inline-form veh-form veh-add" method="post" action="<?= e(url('trips/vehicles_save')) ?>">
<?= csrf_field() ?>
<input class="input" name="plate" placeholder="车牌(借的车可不填)" aria-label="车牌">
<input class="input" name="name" placeholder="车型名,如「大众朗逸」" required aria-label="车型名">
<select class="select" name="vtype" aria-label="来源">
<?php foreach (\App\Vehicle::TYPES as $vk => $vv): ?>
<option value="<?= e($vk) ?>"><?= e($vv) ?></option>
<?php endforeach; ?>
</select>
<input class="input" name="vendor" placeholder="租车公司 / 车主" aria-label="租车公司或车主">
<input class="input" name="order_no" placeholder="租车订单号" aria-label="租车订单号">
<label class="veh-def">
<input type="checkbox" name="is_default" value="1">
<span>设为默认</span>
</label>
<button class="btn btn-sm" type="submit">加进车辆库</button>
</form>
<?php endif; ?>
</div>