FamilyBook/templates/trips/_revise_form.php

<?php
/**
 * 「修正」表单（v24 第 13 批）：记录一段计划旅程的**实际**执行情况。
 *
 * 用户原话：「另外一个按钮，用来记录实际的情况，按钮名字就叫修正，但是记住，
 *            这个实际的行程和计划行程，是一条记录，不是两条，点击这个按钮，
 *            则让用户选择实际的执行时间，包括开始和结束时间，实际的参与人等信息，
 *            就相当于是修改了一下这个行程，只不过，之前的计划行程数据要保留，
 *            为了以后做对比。修正，是无限次数的。」
 *
 * ⚠️ 与「编辑」的区别：
 *   · 编辑 = 改**计划**本身（排错了计划就改它）；
 *   · 修正 = 记**实际**发生了什么（计划不动，实际值进历史，供对比）。
 *   两者都作用在同一条 trip_nodes 记录上（用户明确"是一条记录，不是两条"）。
 *
 * 🔴 v50（用户 2026-10-14）三条：
 *   ① 「修正一个计划行程的时候的开始和结束时间，仍然是之前的那种**控件样式**，
 *      应该改成我们**最新的控件**样式。」
 *      ⇒ 换 `$dtPlugin = 'antd'`（与「添加/编辑行程」的 node_form.php 同款）。
 *      当年（v41）这里刻意**没换**，理由是"修正表单内联在 `<details>` 里、
 *      一段行程一份、可能十几份并存，antd 每份都要挂 React 组件，不划算"。
 *      用户现在明确要统一，且实测详情页通常只有一两段计划行程需要修正 ——
 *      按用户要求换，代价可接受。
 *   ② 「上面记录实际执行情况那一段话说明也不要了。」
 *      ⇒ 删掉 `.rev-tip` 那段（那段文字在 show.php 的 `.rev-panel` 里，见那边的改动）。
 *   ③ 「记录这次修正的按钮应该放在**右边**，另外应该加一个**关闭/取消**的按钮，
 *      就是如果不再修正的话，应该有一个取消，不要让这个框显示了。」
 *      ⇒ 按钮行右对齐；补一颗「取消」——`.rev-open` 是 `<details>`，
 *        取消 = 把 `open` 去掉（见下面内联脚本 + show.php 的委托）。
 *
 * 变量（require 前设好）：
 *   $rvNode     被修正的这段旅程
 *   $rvTripId   活动 id
 *   $rvPeople   人名册（选实际参与人）
 *   $rvMembers  当前参与人 id
 */
$rvPrefix = 'rv' . (int)$rvNode['id'];
$rvN      = (int)($rvNode['revision_n'] ?? 0);
?>
<form class="rev-form" method="post" action="<?= e(url('trips/node_revise')) ?>">
  <?= csrf_field() ?>
  <input type="hidden" name="trip_id" value="<?= (int)$rvTripId ?>">
  <input type="hidden" name="id" value="<?= (int)$rvNode['id'] ?>">

  <div class="nf-grid">
    <?php /* 实际的起止时间：默认填计划值，方便"只改时间"这种最常见的情况。
           🔴 v50：换成与「添加/编辑行程」**同一套最新控件**（AntD RangePicker）。
           ⚠️ 隐藏字段仍是 `rev_starts_at_date/_hour/_minute`，提交契约不变
              （trips/node_revise 收的还是 read_dt_input 那一套）。 */ ?>
    <div class="field dt-range full">
      <label>实际的开始 / 结束</label>
      <?php $dtName = 'rev_starts_at'; $dtValue = $rvNode['starts_at'] ?? '';
            $dtId = $rvPrefix . '-s'; $dtRange = 'start'; $dtPlugin = 'antd';
            require __DIR__ . '/../_datetime.php'; ?>
      <?php $dtName = 'rev_ends_at'; $dtValue = $rvNode['ends_at'] ?? '';
            $dtId = $rvPrefix . '-e'; $dtRange = 'end'; $dtPlugin = 'antd';
            require __DIR__ . '/../_datetime.php'; ?>
      <span class="tip">默认是计划的时间，改成实际发生的即可。</span>
    </div>
    <?php /* 用户第 17 批 第 3 条：「参与人那里，和记录电影人一样，**弹框选择**，
             不要全列出来，太多了。」——修正表单也是"选参与人"，同样走统一组件。
           ⚠️ 本批同时**去掉了「实际地点」输入框**：用户第 1 条把"地点"这件事
             收敛成了**出发地 / 到达地**（城市由它们聚合），单留一个 free-text
             「实际地点」会让人分不清它和出发地是什么关系。
             修正要记的就是用户第 13 批原话里那三样：实际时间 / 实际参与人 / 说明。 */ ?>
    <div class="field full">
      <label for="<?= e($rvPrefix) ?>-detail">这次修正的说明</label>
      <input class="input" id="<?= e($rvPrefix) ?>-detail" name="detail"
             placeholder="如：航班延误，改到下午才到">
    </div>
    <?php if (!empty($rvPeople)): ?>
      <div class="field full">
        <label>实际参与的人</label>
        <?php
        $ppName     = 'members[]';
        $ppPeople   = $rvPeople;
        $ppSelected = $rvMembers;
        $ppMode     = 'multi';
        $ppOpenBtn  = '+ 选择实际参与的人';
        $ppTitle    = '这次实际去的都有谁';
        require __DIR__ . '/../_person_picker.php';
        ?>
      </div>
    <?php endif; ?>
  </div>
  <?php /* 🔴 v50 用户第 3 条：按钮**靠右**（`margin-left:auto` 把主按钮推过去），
         并补一颗「取消」把 details 收起来（不再修正时用）。 */ ?>
  <div class="btn-row rev-foot">
    <?php if ($rvN > 0): ?>
      <span class="tip rev-foot-note">之前已记过 <?= $rvN ?> 次；原计划数据都留着。</span>
    <?php endif; ?>
    <button class="btn btn-ghost btn-sm" type="button" data-rev-cancel>取消</button>
    <button class="btn btn-sm" type="submit">
      <?= $rvN > 0 ? '再记一次修正' : '记录这次修正' ?>
    </button>
  </div>
</form>
<?php unset($rvPrefix, $rvN); ?>