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:
+54
-5
@@ -79,6 +79,13 @@ final class Anniversary
|
||||
}
|
||||
$month = max(1, min(12, (int)($d['month'] ?? 1)));
|
||||
$day = max(1, min(31, (int)($d['day'] ?? 1)));
|
||||
/* 🔴 v53（用户 2026-10-16 第 1 条）：「纪念日需要记录年份，这样才能知道
|
||||
**是第几个纪念日**。」
|
||||
⇒ 年份是**可选**的：用户没填（或填了个不合理的）就存 NULL，
|
||||
页面只按月日过、不显示"第 N 个" —— 比猜一个年份诚实。
|
||||
⚠️ 合理区间 1900..2100：防手滑输入 0 / 999999 把"第 N 个"算成天文数字。 */
|
||||
$year = (int)($d['year'] ?? 0);
|
||||
$year = ($year >= 1900 && $year <= 2100) ? $year : null;
|
||||
$kind = mb_substr(trim((string)($d['kind'] ?? '')), 0, 40, 'UTF-8');
|
||||
$note = trim((string)($d['note'] ?? ''));
|
||||
$leap = !empty($d['leap']) ? 1 : 0;
|
||||
@@ -117,18 +124,18 @@ final class Anniversary
|
||||
|
||||
if ($id > 0) {
|
||||
$db->prepare(
|
||||
'UPDATE anniversaries SET title=?, repeat_type=?, month=?, day=?, is_leap=?,
|
||||
'UPDATE anniversaries SET title=?, repeat_type=?, year=?, month=?, day=?, is_leap=?,
|
||||
kind=?, note=?, person_id=? WHERE id=? AND family_id=?'
|
||||
)->execute([$title, $repeat, $month, $day, $leap, $kind !== '' ? $kind : null,
|
||||
)->execute([$title, $repeat, $year, $month, $day, $leap, $kind !== '' ? $kind : null,
|
||||
$note !== '' ? $note : null, $pid, $id, $familyId]);
|
||||
self::savePeople($id, $pids);
|
||||
return $id;
|
||||
}
|
||||
$db->prepare(
|
||||
'INSERT INTO anniversaries (family_id, title, repeat_type, month, day, is_leap,
|
||||
'INSERT INTO anniversaries (family_id, title, repeat_type, year, month, day, is_leap,
|
||||
kind, note, person_id)
|
||||
VALUES (?,?,?,?,?,?,?,?,?)'
|
||||
)->execute([$familyId, $title, $repeat, $month, $day, $leap,
|
||||
VALUES (?,?,?,?,?,?,?,?,?,?)'
|
||||
)->execute([$familyId, $title, $repeat, $year, $month, $day, $leap,
|
||||
$kind !== '' ? $kind : null, $note !== '' ? $note : null, $pid]);
|
||||
$newId = (int)$db->lastInsertId();
|
||||
self::savePeople($newId, $pids);
|
||||
@@ -448,6 +455,14 @@ final class Anniversary
|
||||
}
|
||||
$date = sprintf('%04d-%02d-%02d', $sol['year'], $sol['month'], $sol['day']);
|
||||
} else {
|
||||
/* 🔴 v53：`once`（只此一次）**有年份时只在那一年出现**。
|
||||
老行为是"落在公历分支 ⇒ 年年都冒出来"，与"只此一次"自相矛盾；
|
||||
以前没有年份，没法判"哪一年"，只能那样漂着。
|
||||
⚠️ 没有年份的 `once` 仍然保持老行为（不知道是哪一年，不能凭空丢掉）。 */
|
||||
$onceYear = (int)($a['year'] ?? 0);
|
||||
if ($repeat === 'once' && $onceYear > 0 && $onceYear !== $year) {
|
||||
continue;
|
||||
}
|
||||
// 公历（含"只此一次"）：2/29 落在平年时退到 2/28
|
||||
$dd = $d;
|
||||
if (!checkdate($m, $dd, $year)) {
|
||||
@@ -459,6 +474,16 @@ final class Anniversary
|
||||
if (($a['source'] ?? '') !== 'custom' && !empty($a['born'])) {
|
||||
$age = Birthday::ageOn((string)$a['born'], $date);
|
||||
}
|
||||
/* 🔴 v53（用户 2026-10-16 第 1 条）：算出**这是第几个纪念日**。
|
||||
规则：`nth = 本次年份 - 起始年份 + 1`（起始那年就是"第 1 个"）。
|
||||
⚠️ 只用**用户自己填的** `year`（`birthdays()` 派生的生日条目没有这一项，
|
||||
它们走 `age` 那套，别混）。没填年份 ⇒ null ⇒ 页面不显示序号。
|
||||
⚠️ `nth < 1` 不显示（年份填到了未来 ⇒ 这一年的这次还没到"第 1 个"）。 */
|
||||
$y0 = (int)($a['year'] ?? 0);
|
||||
// ⚠️ 派生的生日条目没有 year（它们走 age 那套），所以这里判 source
|
||||
$nth = (($a['source'] ?? 'custom') === 'custom')
|
||||
? self::nthFor($y0 > 0 ? $y0 : null, $year)
|
||||
: null;
|
||||
$out[] = [
|
||||
'date' => $date,
|
||||
'title' => (string)($a['title'] ?? ''),
|
||||
@@ -469,6 +494,8 @@ final class Anniversary
|
||||
'id' => (int)($a['id'] ?? 0),
|
||||
'age' => $age,
|
||||
'repeat' => $repeat,
|
||||
'year' => $y0 > 0 ? $y0 : null, // 用户填的起始年（没有则 null）
|
||||
'nth' => $nth, // 第几个（没有年份则 null）
|
||||
];
|
||||
}
|
||||
return $out;
|
||||
@@ -511,4 +538,26 @@ final class Anniversary
|
||||
{
|
||||
return self::REPEAT[$k] ?? $k;
|
||||
}
|
||||
|
||||
/**
|
||||
* 🔴 v53（用户 2026-10-16 第 1 条）：**这是第几个纪念日**。
|
||||
*
|
||||
* `nth = 年份 - 起始年 + 1`（起始那年就是"第 1 个"）；没有起始年（或算出来 < 1）返回 null。
|
||||
*
|
||||
* ⚠️ **单点来源**：`occurrences()`（临近区）与 `days/index.php`（我自己添加的那张表）
|
||||
* 都调它 —— 两处各写一遍 `date('Y') - $year + 1` 是本项目反复踩过的
|
||||
* "同一个概念两处计算"型坑（改一处忘一处 ⇒ 两个页面显示的序号能对不上）。
|
||||
* ⚠️ 用**今天所在的年**（"今年是第几个"）而不是"下一次发生的那年"——
|
||||
* 否则一个 12 月的纪念日在 1 月看会显示成"第 N+1 个"，反直觉。
|
||||
*/
|
||||
public static function nthFor(?int $startYear, ?int $inYear = null): ?int
|
||||
{
|
||||
$y0 = (int)($startYear ?? 0);
|
||||
if ($y0 <= 0) {
|
||||
return null;
|
||||
}
|
||||
$y = $inYear !== null ? (int)$inYear : (int)date('Y');
|
||||
$n = $y - $y0 + 1;
|
||||
return $n >= 1 ? $n : null;
|
||||
}
|
||||
}
|
||||
@@ -1837,6 +1837,8 @@ CREATE TABLE IF NOT EXISTS `anniversaries` (
|
||||
`title` VARCHAR(120) NOT NULL,
|
||||
`repeat_type` ENUM('solar','lunar','once') NOT NULL DEFAULT 'solar'
|
||||
COMMENT '重复方式：solar=每年阳历同月同日 / lunar=每年农历同月同日 / once=只此一次',
|
||||
`year` SMALLINT UNSIGNED DEFAULT NULL
|
||||
COMMENT '起始年份（v53：算"第几个纪念日"用；NULL=用户没填，只按月日过）',
|
||||
`month` TINYINT UNSIGNED NOT NULL,
|
||||
`day` TINYINT UNSIGNED NOT NULL,
|
||||
`is_leap` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '农历：该月是否为闰月',
|
||||
@@ -1852,6 +1854,20 @@ CREATE TABLE IF NOT EXISTS `anniversaries` (
|
||||
COMMENT='纪念日：用户自建（生日不在此表，由 persons 实时派生）'
|
||||
SQL);
|
||||
|
||||
// ---- 🔴 v53（用户 2026-10-16 第 1 条）：纪念日要有**年份** ----
|
||||
// 「纪念日需要记录年份，这样才能知道**是第几个纪念日**。」
|
||||
// ⇒ 加 `anniversaries.year`。新库由上面那条 CREATE TABLE 带上；
|
||||
// **老库**（表已在、但没有这一列）走这里补。
|
||||
// ⚠️ 调用点必须**紧跟在这张表的 CREATE TABLE 之后**：
|
||||
// `addColumn` 是 `ALTER TABLE`，表还不存在就会
|
||||
// `1146 Table ... doesn't exist` —— 整段 Schema::ensure 直接抛异常，
|
||||
// install 变成"安装失败"（本轮实测踩到过：放在 movie_details 那段里，
|
||||
// 而 anniversaries 的建表在那之后 ⇒ 全新安装直接挂）。
|
||||
// ⚠️ 可空、不给默认值：**老数据就是没有年份**，猜一个（比如按创建年）反而会
|
||||
// 让页面上算出一个错的"第 N 个"。NULL = 只按月日过、不显示序号 —— 诚实。
|
||||
self::addColumn($db, 'anniversaries', 'year',
|
||||
"ADD COLUMN `year` SMALLINT UNSIGNED DEFAULT NULL COMMENT '起始年份（算第几个纪念日）' AFTER `repeat_type`");
|
||||
|
||||
// ---- 财务 / 账本（版本 13，用户第 15 条）----
|
||||
// 两层：账本（可共享给人的一本总账）+ 账目（存款/基金/保险/房子/车子…）。
|
||||
// ⚠️ 金额一律存**分**（BIGINT），不存浮点：钱是最不能容忍
|
||||
|
||||
Reference in New Issue
Block a user