v53：纪念日记年份算「第几个」/ 首页待办排在进行中下面 / 日程编辑浮层跨满整行 / 新增成员打标签 / 新增页一次填完称呼与备注

用户 2026-10-16 五条。 ① 纪念日要记录年份，才能知道「第几个」用户原话：「纪念日需要记录年份，这样才能知道**是第几个纪念日**。」 **真根因有两层**（两处一起才构成"没有年份"）： · 表里没有：anniversaries 只有 month + day（当年当成"一年一度，年份无意义"）； · 表单有、但被丢掉：日期控件本来就带年份（<input type="date"> 是 YYYY-MM-DD），而拆分 JS **只取 mm/dd**（`mo.value = m[2]; dy.value = m[3];`）⇒ 想存也没存上。修法：anniversaries.year（SMALLINT UNSIGNED NULL）+ 升级路径 addColumn；表单补 hidden year、拆分 JS 一并写；Anniversary::save 收 year（**区间守卫 1900..2100**）； occurrences() 输出 year 与 nth；列表页显示「2018 年起 · 第 9 个」。 ⚠️ 年份**可空、且不给默认值**：老数据就是没有年份，猜一个（按创建年之类）会让页面算出一个**错的**"第 N 个"。NULL = 只按月日过、不显示序号 —— 诚实。 ⚠️ 顺带修一个自相矛盾：repeat_type='once' 原来落在公历分支 ⇒ **年年都冒出来**；现在有年份了 ⇒ 只在那一年出现（没年份的保持老行为，不凭空丢）。 🔴 **序号算法抽成单点来源 `Anniversary::nthFor()`** —— `occurrences()`（临近区）与 days/index.php（我添加的那张表）**都调它**；两处各写一遍是"改一处忘一处"的温床。用**今天所在的年**（"今年是第几个"），不是"下一次发生那年"。 🔴🔴 **踩坑（最值钱）**：`addColumn`（ALTER TABLE）**必须排在那张表 CREATE TABLE 之后**。第一版放进 movie_details 那段（anniversaries 的建表更靠后）⇒ 全新安装 `1146 Table 'fb_test.anniversaries' doesn't exist` ⇒ 整段 ensure() 抛异常 ⇒ **install 直接"安装失败"**（POST 回 200、不自删、schema_version=None、库一片空白）。新建库走 CREATE TABLE、老库走 addColumn —— **两条路都要在**。 ② 首页近期任务：把待办也放进来（排在进行中下面）用户原话：「首页的近期任务，**把待办也放进来吧，放在进行中的下面**。」原来只收「进行中 + **已逾期**的待办」（当年怕待办一多首页变长清单）。 ⇒ 现在**全部**收进来、按**状态分组**（doing 在前、todo 在后）；两组内部仍按截止时间升序（byStatus 的 ORDER BY 已排好）。 ⚠️ 配套改统计：`count($tasks) 件在做` 会把待办也算成"在做" ⇒ 改成**按状态拆开数** （进行中→「件在做」、待办→「件待办」，两数相加=列表行数，仍同源）。「件待办」原读 stat7['todos']（**与列表不同源**，v24 踩过"数字和列表对不上"）。 ⚠️ 空态：「没有进行中的任务，也没有待办。」 ⚠️ .hd-pane-body 本来就是 overflow-y:auto + flex:1 1 auto/min-height:0，行数变多**内部滚动**、卡片高度不变（v32"两块外框恒等高"那套兜住了）。 ③ 日程编辑浮层「只有左侧有内容，右侧空白，好像分栏了」 **真根因**（assets/css/app.css）：日程编辑页 event.php 里，`.mv-grid`（观影式**纵向**列表）被嵌在**两列**的 `.form-grid` 里 ⇒ 它只占**第一列**。整页形态下看不出来（页面宽），但**浮层里面板只有 620px** ⇒ 两列各 286px ⇒ 所有字段挤在左边 286px、右边整列空着。实测：panel=620 / form-grid=588 / cols="286px 286px" / mv-grid w=286 →修后 mv-grid w=588（95% of panel）、标题输入框 w=516、距右缘 ~2px。修法：`.form-grid > .mv-grid { grid-column: 1 / -1; }` —— **一行 CSS**。 ⚠️ 不去改 event.php 里"整页保留两列、浮层用 mv-grid"那个结构判断（那是有意保留的）； `.mv-grid` 本身就是"一整块、占满宽度"的语义，天生不该被塞进半列。 ⚠️ 排查手法：这种"看起来像分栏"的问题**量几何比读 CSS 快** —— getBoundingClientRect 打出 panel/grid/cols/内层宽，一眼看出"嵌了几层 grid"。 ④ 添加成员时是**打标签**，不是选分组用户原话：「名册中添加成员时，**不是选择分组，而是打标签**。现在已经没有分组的概念了， **只有标签的概念**。」 ⇒ 新增分支的「所属分组」下拉（group_id）换成**标签输入**（复用 v51 的 #ptBlock 那套：候选勾选 + 自由输入，**文本框是唯一提交源**）。 ⚠️ 只在**新增**时出现在那个位置（编辑时上面那个 #ptBlock 已在管标签，出现两块会让人以为填两遍）。 ⚠️ **分组表结构 person_roster.group_id 保留不动**（名册"拖动归档"还在用、历史数据也在），只是**新增入口不再要求人选**。 ⚠️ e2e 里 v14「新增表单**有**分组下拉」与新需求正相反 ⇒ 改成「没有 group_id + 有 name=tags」。 ⑤ 添加成员页一次填完「我对他的称呼 + 我的备注」用户原话：「我在添加一个成员的时候，是不是可以直接在添加成员的页面里填写**我对他的称呼** 以及**我对他的备注**，**一次就解决**？要不然还得先添加、再返回他的名册去填，有点麻烦。」 ⇒ 新增页也出现这两栏： · **我对他的备注**（person_notes）—— 条件从 `$isEdit && !$isSelf` 改成 `!$isSelf`； · **我对他的称呼**（nicknames）—— **新加的输入框** `name="my_nick"`。服务端 people/create 落两表（挂**我**名下：viewer=我, target=他）。 ⚠️ 判"表单里有没有这一栏"用 **array_key_exists**（不是判值是否为空）—— 与编辑路径同一口径：**空串是明确的"清空"语义**（Nickname::set('') 会删行）。 ⚠️ 四处**重渲染路径**（撞名确认/校验失败/手机号重复/people/new 初始）都要带上 myTags/tagChoices/myNick，否则一撞名或一报错，刚打的标签与刚写的称呼备注就全没了。 ⚠️ 编辑页也补 myNick 回显（否则"新增时填了、编辑页看不见"会以为没存上）。验证（新增 2 套件 + 更新 e2e/deploy 断言）： · _fb_v53_ui.py（**26 条**真机断言） · _b53_falsify.py（**10 注入 / 10 全抓**，基线 26/0） · e2e **1517/0**；familybook_deploy.sh 加 v53 静态断言段（14 正向 + 1 反向） · 全流水线 **PUSH_RC=0**、部署 0 FAIL（含"第53批形态"） · 线上 8 文件 md5 逐字节一致；`anniversaries.year` 已由升级路径补上（nullable smallint）；线上实测 nthFor 4 用例全对（2018→第9个 / null→NULL / 2019→2 / 未来年→NULL）；诊断页已删并复验 404 ⚠️ 本轮踩坑（已写进 pitfalls.md / 工作日志）： · **`addColumn` 必须在同表的 CREATE TABLE 之后**（否则全新安装 `1146` ⇒ ensure() 抛异常）； · **探针里 `dispatchEvent(new Event('submit'))` 不会真的提交表单** （不导航、不发请求）⇒ 判"存没存上"必须真点提交按钮或 `requestSubmit()`； · **反向验证的 `restore()` 不能只是"再跑一遍 build_work()"**（指纹闸门会把它变空操作 ⇒ 第二轮基线是脏的，26/0 掉到 14/12）；恢复必须**无条件** copy2； · **注入锚点在源码里出现两次 ⇒ 打到别处 ⇒ 那条断言恒不红** （v53 给新增页也加了 `id="ptBlock"`，打偏了 v51 那条"编辑页标签块"的注入）； · **别把两个共用 fb_test 库的套件并行跑**（互相删播种行 ⇒ 看着像"整套功能坏了"）； · **部署静态断言的锚点引号/反斜杠必须与源码一字不差**：`\[` 在 bash 双引号里是 **字面反斜杠**、单双引号不能混、漏个 `(int)` 也搜不到 —— 一轮里连红 4 条全是这个。
2026-10-16 16:51:04 +08:00
parent ed122c034b
commit 26026c7250
8 changed files with 262 additions and 49 deletions
@@ -147,6 +147,14 @@ $backUrl = url('days');
          </span>
          <input type="hidden" id="an-month" name="month" value="<?= (int)$v('month', 1) ?>">
          <input type="hidden" id="an-day" name="day" value="<?= (int)$v('day', 1) ?>">
+          <?php /* 🔴 v53（用户 2026-10-16 第 1 条）：「纪念日需要记录年份，
+               这样才能知道**是第几个纪念日**。」
+               ⚠️ 日期控件本来就带年份（`<input type="date">` 是 YYYY-MM-DD），
+                  但下面那个拆分 JS 以前**只取 mm/dd、把年份丢了** ⇒ 库里没有年份。
+                  现在补一个 hidden `year`，由同一条 JS 一起写。
+               ⚠️ 留空 = 不记年份（`<input type="date">` 清空时 year 也清空）——
+                  页面就不显示"第 N 个"，不猜。 */ ?>
+          <input type="hidden" id="an-year" name="year" value="<?= (int)$v('year', 0) > 0 ? (int)$v('year', 0) : '' ?>">
        </div>
      </div>

@@ -268,12 +276,16 @@ $backUrl = url('days');
  var d = document.getElementById('an-date');
  var mo = document.getElementById('an-month');
  var dy = document.getElementById('an-day');
+  var yr = document.getElementById('an-year');
  if (!d || !mo || !dy) { return; }
  function split() {
    var m = (d.value || '').match(/^(\d{4})-(\d{2})-(\d{2})$/);
    if (!m) { return; }               // 空值不动（用户清空时保留原值，不至于变成 0）
    mo.value = String(parseInt(m[2], 10));
    dy.value = String(parseInt(m[3], 10));
+    /* 🔴 v53（第 1 条）：年份一起写进 hidden —— 它就是"第几个纪念日"的依据。
+       ⚠️ 以前这里**只取 mm/dd**，年份被丢掉 ⇒ 库里根本没年份，算不出第几个。 */
+    if (yr) { yr.value = m[1]; }
  }
  d.addEventListener('change', split);
  split();                            // 初始也同步一次（编辑回填）
@@ -87,6 +87,23 @@ $renderTable = function (array $rows, bool $editable) use ($canWrite, $kindBadge
              <td>
                <?= e((string)$r['title']) ?>
                <?php if (!empty($r['is_leap'])): ?><span class="small muted">（闰月）</span><?php endif; ?>
+                <?php /* 🔴 v53（用户 2026-10-16 第 1 条）：「纪念日需要记录年份，
+                     这样才能知道**是第几个纪念日**。」
+                     ⚠️ 这一列显示的是**用户填的起始年**与算出来的序号 ——
+                        只在填了年份时才有（NULL 就说"没记年份"，不猜、不显示序号）。
+                     ⚠️ 序号按**今天所在的年**算（"今年是第几个"）——
+                        用户要的是这个直觉；不去按"下一次发生的年份"算，
+                        否则一个 12 月的纪念日在 1 月看会显示成"第 N+1 个"，反而怪。 */ ?>
+                <?php if (($r['year'] ?? null) !== null): ?>
+                  <?php /* ⚠️ 序号走**同一把尺**（`Anniversary::nthFor`）——
+                       不要在模板里再写一遍 `date('Y') - 年 + 1`：
+                       两处各算一次，改一处忘一处就会让两个页面显示的序号对不上。 */ ?>
+                  <?php $nthNow = \App\Anniversary::nthFor((int)$r['year']); ?>
+                  <span class="small muted ann-year" title="起始年份"><?= (int)$r['year'] ?> 年起</span>
+                  <?php if ($nthNow !== null): ?>
+                    <span class="small muted ann-nth">第 <?= (int)$nthNow ?> 个</span>
+                  <?php endif; ?>
+                <?php endif; ?>
              </td>
              <td class="ann-people"><?= $peopleCell($r) ?></td>
              <td><?= $kindBadge($r) ?></td>
@@ -310,6 +327,13 @@ $renderTable = function (array $rows, bool $editable) use ($canWrite, $kindBadge
          <span class="ann-date"><?= e(substr((string)$u['date'], 5)) ?></span>
          <span class="ann-title"><?= e((string)$u['title']) ?></span>
          <?php if ($u['age'] !== null): ?><span class="small muted"><?= (int)$u['age'] ?> 岁</span><?php endif; ?>
+          <?php /* 🔴 v53（用户 2026-10-16 第 1 条）：「纪念日需要记录年份，
+               这样才能知道**是第几个纪念日**。」
+               ⚠️ 只在**用户填了起始年份**时才有 `nth`（派生的生日条目走"N 岁"那一套，
+                  不能两样都显示 —— 那会变成"30 岁 · 第 30 个"，重复且啰嗦）。 */ ?>
+          <?php if (($u['nth'] ?? null) !== null): ?>
+            <span class="small muted ann-nth">第 <?= (int)$u['nth'] ?> 个</span>
+          <?php endif; ?>
          <?= $kindBadge($u) ?>
        </li>
      <?php endforeach; ?>