跨天日程：周/日视图按列分段画成一条，不再拆成碎片 laoyang/FamilyBook#35

用户 2026-10-30：「网页端，跨天日程显示还是有问题…如果一个日程跨了三天，
应该在日历本上怎么显示呢？在周视图和日视图，应该怎么显示？现在显示的有问题。」

## 修复前是什么样（实测，不是推断）

一个「11/10 20:00 → 11/12 02:00」的跨三天日程，服务端 month() 展开成三条
（首日带 time、中间天两者皆空、末日带 end_time），喂给 build_time_grid 后：

    全天行：11/11、11/12 各一条     ← 中间两天变成"全天日程"
    时间网格：11/10 一个小块，高度仅 2.08%（≈30 分钟）

三个问题叠加：
  · 开始日的结束时刻不在同一天 ⇒ 判成"没有结束" ⇒ 退化成 30 分钟
  · 中间/末日既无 time 又不是全天 ⇒ 被"按全天处理"的兜底塞进全天行
  · 三条互不相干，用户看不出"这是同一个日程"

## 方案（用户已确认）

  1. 周视图：跨列连续长条 —— 毎列各画一段，视觉连成一条
  2. 日视图：铺满当天并标延续
  3. 中间天归时间网格，不进全天行

## 改了什么

**app/Calendar.php** —— 服务端补两个字段
  · `span_days`：整条日程跨了几天（0 = 当天来回）
  · `seg`：start / mid / end / only
  同时修掉一个真 bug：原来 `$first` 是"窗口内遍历的第一个"，
  日视图只查一天时，中间天会变成 `$first` 被当开始日处理。
  ⇒ 一律用**真实日期**跟 `$base`/`$base+span` 比较，不看遍历顺序。

**index.php::build_time_grid** —— 核心重构
  · 先按 `kind:ref_id:occ` 归堆，把同一日程的逐天条目合成一条
    （带 occ 是因为重复日程不同次发生的 ref_id 相同；带 kind 是因为
     观影/旅程的 ref_id 是各自表里的 id，`custom:5` 和 `movie:5` 是两回事）
  · 跨度以服务端 `span_days` 为准，不再用"窗口内铺了几列"推断
    （日视图下那个推断必然不成立）
  · 跨天条目拆成每列一段，按 `seg` 决定纵坐标：
    start = 开始时刻→24:00，mid = 整列，end = 0→结束时刻
  · 跨天条目**不参与 conflictLanes** —— 它必然占满整列，
    拿去分列会把同一天所有日程都挤窄

**templates/calendar/index.php** —— 分段渲染
  · `is-seg-start/mid/end` 类；延续段前面加 `↳` 标记，不重复显示时间
  · 跨天段用 `left:0; width:100%`，单天块保持原来的 `calc(2px + N%)`

**assets/css/app.css** —— 让三段看着连成一条
  · start 下圆角归零、下边框透明；mid 上下都平；end 上圆角归零、上边框透明
  · 段与段之间原本有 1px 白边 + 左右内缩，实测缝隙 10.9px，看着像断成三段
    ⇒ 跨天段贴满整列后降到 1.0px（只剩列边框）

## 为什么在列内画段，不做跨列绝对定位层

`.tg-body` 左边有 56px 固定 gutter，窄屏还会横向滚动
（`.cal-tg-card{overflow:auto}` + 每列 min-width 92px），`.tg-col` 又是
`overflow:hidden`。跨列层要自己算 gutter 偏移、跟着横向滚动跑、还不能被裁 ——
每个都是新坑。在列内画段天然对齐，代价只是段间有 1px 列边框缝，用 CSS 糊掉。

## 验证

**逻辑层（PHP，用真实 build_time_grid）**
  · 周视图跨三天：3 段（start/mid/end），全天行为空 ✓
  · 日视图三个位置（起始/中间/结束天）各自正确 ✓
  · 回归：单天 + 真全天仍正常；冲突分列仍生效；跨天与普通日程共存正常 ✓
  · 反向验证：用修复前的代码跑同一判据**正确转红**
    （旧版 timed=1 all_day=2，高度只有 2.08%），证明判据非恒真 ✓

**视觉层（Playwright + 真实 CSS + include 真实模板）32 项全过**
  · 横向连续：start→mid 缝隙 1.0px，mid→end 1.0px（判据 ≤2.5px）✓
  · 纵向：start 底边贴列底 0px；mid 占满整列（顶 0 / 底 0）；
    end 顶边贴列顶 0px 且只占开头一小段 ✓
  · 样式：start 下圆角 0px + 下边框透明；mid 上下圆角 0；end 上圆角 0 +
    上边框透明 ✓
  · 无裁切：三段都落在列内 ✓
  · 回归：真全天仍在全天行；跨天不再出现在全天行；单天日程正常 ✓
  · 窄屏 375px：三段仍可见（w=91）✓

**反向验证 4/4 全部抓到**
  故意做坏四个变体（段留单天内缩 / 保留圆角 / 中间段只画 30% /
  下边框不透明），判据全部转红 —— 说明"32 项全过"不是因为判据恒真。

## 已知取舍

跨天段占满整列，同一天的普通日程与它在视觉上会重叠。
这是日历的固有取舍（Google 日历同样如此），用户确认的方案里也接受。

app/Calendar.php

@@ -1526,9 +1526,29 @@ final class Calendar
                     $vetm = $vd['ends_at'] ? substr((string)$vd['ends_at'], 11, 5) : '';
                     // 跨天日程：从这次发生的当天起，按事件本身的长度铺开
                     $span = (int)floor((strtotime($bed) - strtotime($bsd)) / 86400);
-                    $first = true;
-                    foreach (self::eachDay($base, date('Y-m-d', strtotime($base . ' +' . $span . ' day')), $from, $to) as $d2) {
-                        $isLast = ($d2 === date('Y-m-d', strtotime($base . ' +' . $span . ' day')));
+                    /* 🔴 v88（工单 #35）：`$first` 原来是"窗口内遍历的第一个"，**这是错的**。
+                       日视图只查一天时，如果那天正好是跨天日程的**中间天**，
+                       它就成了 `$first` ⇒ 被当作"开始日"处理（但 `time` 是空的），
+                       于是落到全天行；同理 `$isLast` 也会把中间天当结束日。
+                       ⇒ 一律用**真实日期**跟 `$base`/`$base+span` 比较，不看遍历顺序。
+
+                       另外把「这条跨度」本身也带出去（`span_days` / `seg`），
+                       让端上/网页端不必再靠"同一次发生铺了几条"去猜 ——
+                       那个推断在窗口被裁剪时（日视图）必然不成立。 */
+                    $baseEnd = date('Y-m-d', strtotime($base . ' +' . $span . ' day'));
+                    foreach (self::eachDay($base, $baseEnd, $from, $to) as $d2) {
+                        $isFirst = ($d2 === $base);
+                        $isLast  = ($d2 === $baseEnd);
+                        // 段形态：整天（span=0）就是 only
+                        if ($span === 0) {
+                            $segKind = 'only';
+                        } elseif ($isFirst) {
+                            $segKind = 'start';
+                        } elseif ($isLast) {
+                            $segKind = 'end';
+                        } else {
+                            $segKind = 'mid';
+                        }
                         $out[] = [
                             'cal'     => (int)$e['calendar_id'],
                             'color'   => (string)($c['color'] ?? '#4A7C82'),
@@ -1536,12 +1556,17 @@ final class Calendar
                             'title'   => (string)$vd['title'],
                             'date'    => $d2,
                             // 跨天的第二、三天只显示"还在进行"，不再重复挂一个开始时刻
-                            'time'    => ($first && empty($vd['all_day'])) ? $vtm : '',
+                            'time'    => ($isFirst && empty($vd['all_day'])) ? $vtm : '',
                             // 结束时刻同理：只落在**最后一天**上（那才是它真正结束的那天）
                             'end_time'=> ($isLast && $vetm !== '' && empty($vd['all_day'])) ? $vetm : '',
                             'all_day' => !empty($vd['all_day']),
                             'kind'    => 'custom',
                             'ref_id'  => (int)$e['id'],
+                            /* 跨度信息（v88）：网页端据此把一条画成多列分段；
+                               日视图下窗口只给一天也不会判错。
+                               `span_days` = 跨了几天（0 表示当天来回）。 */
+                            'span_days' => $span,
+                            'seg'       => $segKind,
                             // 🔴 v43（用户第 6 条）：条目详情浮层要显示"更多信息"，
                             //    所以地点/备注/状态也要带出去（原来模板只用得到 title/time）。
                             'location'     => (string)($vd['location'] ?? ''),
@@ -1553,7 +1578,6 @@ final class Calendar
                             '_can_write' => $canW,
                             'href'    => url('calendar/event', ['id' => (int)$e['id'], 'd' => $day]),
                         ];
-                        $first = false;
                     }
                 }
             }