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 条全是这个。
This commit is contained in:
2026-10-16 16:51:04 +08:00
parent ed122c034b
commit 26026c7250
8 changed files with 262 additions and 49 deletions
+67 -15
View File
@@ -860,18 +860,26 @@ switch ($r) {
$soon = array_values(array_filter($soon, static function (array $e): bool {
return (string)($e['kind'] ?? '') !== 'lunar';
}));
// 进行中的任务 + 已经过期的待办(**只有这些才值得占首页**;
// 没截止日期的待办放任务看板里看,堆到首页会变成一张长长的清单)
// 进行中的任务 + 待办(用户 2026-10-16 v53 第 2 条)
//
// ⚠️ v24 第 14 批 用户第 2 条:**按状态取,不看板取**。
// 原话:「首页上显示的任务,是和任务的状态有关,而不是和它在那个看板有关」。
// 原来调的是 Task::board() —— 它只取**默认看板**,于是建在别的看板上的
// 「进行中」永远上不了首页(用户看到的就是"我明明在做,首页却没有")。
//
// 🔴🔴 v53(用户 2026-10-16 第 2 条):「首页的近期任务,**把待办也放进来吧,
// 放在进行中的下面**。」
// ⇒ 原来只收「进行中 + **已逾期**的待办」(当年怕"待办一多首页变成一张长清单")。
// 现在用户明确要待办也进来,那就**全部**收进来,并按**状态分组**:
// 进行中在前、待办在后 —— "放在进行中的下面"就是这个意思,
// 而不是"混在一起按截止时间排"(那样进行中的会被一堆待办淹掉)。
// ⚠️ 两组**各自内部**仍按截止时间升序(byStatus 的 ORDER BY 已经排好),
// 所以"马上要做的"在各自那一段里仍然靠前。
// ⚠️ 逾期仍是**红色整行**(状态语义,见模板),它落在"待办"那一段里 ——
// 与原来"逾期待办会进清单"的行为一致,只是现在**没逾期的待办也在**。
$tasks = Task::byStatus($familyId, $me, 'doing');
foreach (Task::byStatus($familyId, $me, 'todo') as $t) {
if (Task::isOverdue($t['due_at'] ?? null)) {
$tasks[] = $t;
}
$tasks[] = $t;
}
$memories = home_memories($familyId);
@@ -1931,6 +1939,11 @@ switch ($r) {
// 工作经历先给一行空白(第 4 条),省得还要点「再加一段」
'jobRows' => [[]],
'myNote' => '',
// 🔴 v53(第 4/5 条):新增页也要能打标签 + 填「我对他的称呼 / 备注」。
// 标签候选与编辑页同一个来源(我名下用过的全部标签)。
'myTags' => [],
'tagChoices' => array_column(PersonTag::cloud((int)Auth::familyId(), (int)Auth::personId()), 'tag'),
'myNick' => '',
], 'people');
break;
@@ -2004,6 +2017,11 @@ switch ($r) {
'contacts' => $contacts,
'jobRows' => (array)($d['jobs'] ?? []),
'myNote' => trim((string)($_POST['my_note'] ?? '')),
// 🔴 v53:新增页新加的这三样也要**原样回显**,否则一撞名/一报错
// 用户刚打的标签、刚写的称呼与备注就全没了(重填一遍)。
'myTags' => PersonTag::clean((string)($_POST['tags'] ?? '')),
'tagChoices' => array_column(PersonTag::cloud((int)Auth::familyId(), (int)Auth::personId()), 'tag'),
'myNick' => trim((string)($_POST['my_nick'] ?? '')),
'confirmHit' => $hit,
'confirmWhy' => (string)($hit['_match'] ?? 'name'),
], 'people');
@@ -2055,6 +2073,9 @@ switch ($r) {
// 私备注同理(第 5 条)—— 别让他重填一遍。
'jobRows' => (array)($d['jobs'] ?? []),
'myNote' => trim((string)($_POST['my_note'] ?? '')),
'myTags' => PersonTag::clean((string)($_POST['tags'] ?? '')),
'tagChoices' => array_column(PersonTag::cloud($familyId, (int)Auth::personId()), 'tag'),
'myNick' => trim((string)($_POST['my_nick'] ?? '')),
], 'people');
exit;
}
@@ -2082,23 +2103,41 @@ switch ($r) {
// 私备注同理(第 5 条)—— 别让他重填一遍。
'jobRows' => (array)($d['jobs'] ?? []),
'myNote' => trim((string)($_POST['my_note'] ?? '')),
'myTags' => PersonTag::clean((string)($_POST['tags'] ?? '')),
'tagChoices' => array_column(PersonTag::cloud($familyId, (int)Auth::personId()), 'tag'),
'myNick' => trim((string)($_POST['my_nick'] ?? '')),
], 'people');
exit;
}
// 我加的人,自动进**我的**名册(名册是每人一份的,v5 起)。
// 分组:表单里选了就用它(用户第 12 条「增加名册时可选择所属分组」);
// ⚠️ 只认**我自己**的分组列表里的 id —— 表单可以改,不能凭它把人塞进
// 别人私有的分组、或根本不存在的分组里。
$gid = (int)($_POST['group_id'] ?? 0);
$okGids = array_map('intval', array_column(
PersonGroup::orderFor($familyId, (int)Auth::personId()), 'id'));
if ($gid > 0 && !in_array($gid, $okGids, true)) {
$gid = 0;
}
PersonRoster::ensure($familyId, (int)Auth::personId(), $id, $gid > 0 ? $gid : null, 'self');
// 🔴 v53(用户 2026-10-16 第 4 条):「添加成员时**不是选择分组,而是打标签**,
// 现在已经没有分组的概念了,只有标签的概念。」
// ⇒ 新增表单不再给 group_id 下拉(改成标签输入)。这里硬写 null:
// · 名册里"未分组"本来就合法(拖到哪栏都能再归);
// · 列表页还有「调整分组」那套(拖动归档),需要时再用。
// ⚠️ 表结构 `person_roster.group_id` **保留不动**(拖动归档还在用它,
// 历史数据也在)—— 只是**新增入口不再要求人选**。
PersonRoster::ensure($familyId, (int)Auth::personId(), $id, null, 'self');
Person::replaceContacts($id, $contacts);
// 工作经历:整组替换(第 4 条)。空的那组会把这段经历清空 —— 与联系人同一口径。
PersonJob::replace($id, (array)($d['jobs'] ?? []));
// 🔴 v53(用户 2026-10-16 第 5 条):新增页也要能一次填完「我对他的称呼」与
// 「我对他的备注」,否则用户还得"先添加 → 再回他的名册 → 再填这两样"。
// ⚠️ 两者都挂在**我**名下(别人写的互不影响):
// · 称呼 → nicknames(viewer=我, target=他);
// · 备注 → person_notes(owner=我, person=他)。
// ⚠️ 判"表单里有没有这一栏"用 `array_key_exists`(而不是判值是否为空)——
// 与编辑路径同一个口径:空串是明确的"清空"语义(`Nickname::set('')` 会删行)。
if (array_key_exists('my_nick', $_POST)) {
Nickname::set($familyId, (int)Auth::personId(), $id, (string)$_POST['my_nick']);
}
if (array_key_exists('my_note', $_POST)) {
PersonNote::set($id, (int)Auth::personId(), (string)$_POST['my_note']);
}
// 标签(v53 第 4 条):与"编辑成员"页同一个入口、同一把尺(owner 永远是"我")。
if (array_key_exists('tags', $_POST)) {
PersonTag::setFor($familyId, (int)Auth::personId(), $id, (string)$_POST['tags']);
}
clear_old();
if ($avatarWarn !== '') {
flash('ok', '已把「' . $d['name'] . '」加进名册。头像没有保存:' . $avatarWarn);
@@ -2158,6 +2197,9 @@ switch ($r) {
(名册页那颗标签按钮也只在 `$canMove` 时出现)。 */
'myTags' => $isSelf ? [] : PersonTag::of((int)Auth::personId(), $id),
'tagChoices' => $isSelf ? [] : array_column(PersonTag::cloud((int)Auth::familyId(), (int)Auth::personId()), 'tag'),
// 🔴 v53(第 5 条):编辑页也要回显「我对他的称呼」(与新增页同一个字段名),
// 否则在新增页填了称呼、到编辑页却看不见(会以为没存上)。
'myNick' => $isSelf ? '' : Nickname::get((int)Auth::personId(), $id),
], 'people');
break;
@@ -2292,6 +2334,13 @@ switch ($r) {
if ((int)$id !== (int)Auth::personId() && array_key_exists('my_note', $_POST)) {
PersonNote::set($id, (int)Auth::personId(), (string)$_POST['my_note']);
}
// 🔴 v53(用户 2026-10-16 第 5 条):**我对他的称呼** —— 与上面那条同一把尺,
// 新增页与编辑页都会提交 `my_nick`(同一个字段名,一处处理)。
// ⚠️ 空串 = **清空**("留空就用他自己的名字"是明确语义,与"没这个字段"不同)——
// 所以这里用 `array_key_exists` 判"表单里有没有这一栏",而不是判"值是不是空"。
if ((int)$id !== (int)Auth::personId() && array_key_exists('my_nick', $_POST)) {
Nickname::set($familyId, (int)Auth::personId(), $id, (string)$_POST['my_nick']);
}
if ((int)$p['id'] === (int)Auth::personId()) {
Auth::refreshAvatar((string)$d['avatar']);
// 姓名也可能改了 —— 不同步会话的话顶栏还是旧名字
@@ -4675,6 +4724,9 @@ $want = array_keys($want);
'repeat_type' => (string)($_POST['repeat_type'] ?? 'solar'),
'month' => (int)($_POST['month'] ?? 1),
'day' => (int)($_POST['day'] ?? 1),
// 🔴 v53(用户 2026-10-16 第 1 条):年份 —— 用来算"第几个纪念日"。
// 留空就是 0/空串 ⇒ Anniversary::save 里落成 NULL(不猜年份)。
'year' => (int)($_POST['year'] ?? 0),
'is_leap' => !empty($_POST['is_leap']),
'kind' => (string)($_POST['kind'] ?? ''),
'note' => (string)($_POST['note'] ?? ''),