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 条全是这个。

app/Anniversary.php

@@ -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 (?,?,?,?,?,?,?,?,?)'
+             VALUES (?,?,?,?,?,?,?,?,?,?)'
-        )->execute([$familyId, $title, $repeat, $month, $day, $leap,
+        )->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;
+    }
 }

app/Schema.php

@@ -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），不存浮点：钱是最不能容忍

assets/css/app.css

@@ -5385,6 +5385,22 @@ h5.md-h, h6.md-h { font-size: 14px; }
    ⚠️ `> .mv-lb` 而**不是** `.mv-row label`：后者会把同行人那排 checkbox 的
       小标签一起卷进来（它们不是"字段标签"）。 */
 .mv-grid { display: flex; flex-direction: column; gap: 12px; }
+/* 🔴🔴 v53（用户 2026-10-16 第 3 条）：「点击一个日程，弹出简介，点击编辑，
+   新的编辑框，**只有左侧有内容，右侧是空白的，好像分栏了一样**。这个样式不太对。」
+
+   真根因：日程编辑页（`templates/calendar/event.php`）里，`.mv-grid`（观影式的**纵向**列表）
+   被嵌在**两列**的 `.form-grid` 里：
+     `<div class="form-grid">`  ← `grid-template-columns: 1fr 1fr`
+       `<div class="mv-grid">`  ← 一个 grid 项，**只占第一列**
+   在整页形态下不明显（页面宽，两列各 ~700px 还能看）；但**浮层里面板只有 620px**
+   ⇒ 两列各 286px，而所有字段都挤在左边那一列 286px 里，右边整列空着 —— 就是用户看到的"分栏"。
+   （实测：panel 620 / form-grid 588 / cols="286px 286px" / mv-grid w=286。）
+
+   ⇒ 让 `.mv-grid` **跨满整行**（`grid-column: 1 / -1`）。
+      它本身是 `<div>` 包着**纵向堆叠**的 `.mv-row`，语义上就是"一整块、占满宽度"，
+      天生不该被塞进半列。这样两种形态（整页 / 浮层）都正确，
+      而且不必去改 `event.php` 里"整页保留两列"的结构判断（那条注释说明整页形态是有意保留的）。 */
+.form-grid > .mv-grid { grid-column: 1 / -1; }
 .mv-row { display: flex; align-items: flex-start; gap: 10px; min-width: 0; }
 .mv-row > .mv-lb {
   flex: 0 0 62px; width: 62px;              /* 固定宽 = 对齐的基准 */

index.php

@@ -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 条「增加名册时可选择所属分组」）；
+        // 🔴 v53（用户 2026-10-16 第 4 条）：「添加成员时**不是选择分组，而是打标签**，
-        // ⚠️ 只认**我自己**的分组列表里的 id —— 表单可以改，不能凭它把人塞进
+        //    现在已经没有分组的概念了，只有标签的概念。」
-        //    别人私有的分组、或根本不存在的分组里。
+        //    ⇒ 新增表单不再给 group_id 下拉（改成标签输入）。这里硬写 null：
-        $gid = (int)($_POST['group_id'] ?? 0);
+        //        · 名册里"未分组"本来就合法（拖到哪栏都能再归）；
-        $okGids = array_map('intval', array_column(
+        //        · 列表页还有「调整分组」那套（拖动归档），需要时再用。
-            PersonGroup::orderFor($familyId, (int)Auth::personId()), 'id'));
+        //    ⚠️ 表结构 `person_roster.group_id` **保留不动**（拖动归档还在用它，
-        if ($gid > 0 && !in_array($gid, $okGids, true)) {
+        //       历史数据也在）—— 只是**新增入口不再要求人选**。
-            $gid = 0;
+        PersonRoster::ensure($familyId, (int)Auth::personId(), $id, null, 'self');
-        }
-        PersonRoster::ensure($familyId, (int)Auth::personId(), $id, $gid > 0 ? $gid : 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'] ?? ''),

templates/days/form.php

@@ -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();                            // 初始也同步一次（编辑回填）

templates/days/index.php

@@ -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; ?>

templates/home.php

@@ -140,20 +140,27 @@ $todayMarks = $todayMarks ?? ['tags' => [], 'line' => ''];
            用户刚在看板上拖成「进行中」的那件任务于是**不计入**，数字就显示 0。
            两个口径不同源，数字和列表当场对不上。
 
-           ⇒ 现在这个数字与右侧列表**同源**：`doing + 已逾期的 todo`
+           ⇒ 现在这个数字与右侧列表**同源**（与 index.php 传给本页的**同一个数组**）。
-             （也就是 `count($tasks)`，与 index.php 传给本页的那个数组完全一致）。
+
-             文案也说清是什么：「件在做」，而不是含糊的「件待办」。
+           🔴 v53（用户 2026-10-16 第 2 条）：右侧列表现在**也含待办**了（放在进行中下面）
+             ⇒ 「件在做」不能再数整个数组（那会把待办也算成"在做"）。
+                改成**按状态拆开数**：进行中 →「件在做」，待办 →「件待办」。
+                ⚠️ 两个数字相加 = 右侧列表的行数（列表也是这两段拼起来的），仍然同源。
 
            ⚠️ 「已经动手」与「排队等着」是两件事（用户第 6 条要求说清区别）：
               首页要回答的是"我手头在做什么"，所以主数字用「在做」的口径；
               排队的那些（todo）另给一个小字，不必让人点进任务页才知道还有多少。 */ ?>
+        <?php $nDoing = 0; $nTodo = 0;
+              foreach (($tasks ?? []) as $__t) {
+                  if ((string)($__t['status'] ?? 'todo') === 'doing') { $nDoing++; } else { $nTodo++; }
+              } ?>
         <a class="hbs" href="<?= e(url('tasks')) ?>"
-           title="近期任务（进行中 + 已逾期的待办）">
+           title="近期任务（进行中）">
-          <b><?= count($tasks ?? []) ?></b> 件在做
+          <b><?= $nDoing ?></b> 件在做
         </a>
-        <?php if ((int)($stat7['todos'] ?? 0) > 0): ?>
+        <?php if ($nTodo > 0): ?>
           <a class="hbs" href="<?= e(url('tasks')) ?>" title="记下来了、还没动手的那些">
-            <b><?= (int)$stat7['todos'] ?></b> 件待办
+            <b><?= $nTodo ?></b> 件待办
           </a>
         <?php endif; ?>
         <?php if ((int)($stat7['overdue'] ?? 0) > 0): ?>
@@ -428,7 +435,7 @@ unset($evRef);
                  所以每行前面也有复选框，点了就地完成（AJAX，不跳页）。
                  表单与 JS 在页面末尾各一份（见 home.php 的 taskDoneForm 段）。 */ ?>
         <?php if (!$tasks): ?>
-          <p class="empty-hint">没有进行中的任务。</p>
+          <p class="empty-hint">没有进行中的任务，也没有待办。</p>
         <?php else: ?>
           <ul class="dash-list tk-list">
             <?php foreach ($tasks as $t): ?>

templates/people/form.php

@@ -194,25 +194,36 @@ $ctHints = [
 
       <?php /* ⚠️ 这里**没有**「排序号」（已彻底取消，用户原话：「排序号，不要让用户填写」），
                名册里的先后靠**拖动卡片**调。
-               ⚠️「所属分组」**只在新增时出现**（$isEdit 为假）：
+
-                 分组是"我和他的关系"，写在我自己的名册条目上 ——
+               🔴🔴 v53（用户 2026-10-16 第 4 条）：「名册中添加成员时，**不是选择分组，
-                 · 新增时这个人还不存在，别人名册里不可能有他，这里选了只影响我自己，
+               而是打标签**。现在已经没有分组的概念了，**只有标签的概念**。」
-                   正是用户要的「增加名册时可选择所属分组」；
+               ⇒ 原来这里是一个「所属分组」下拉（group_id）。现在改成**标签输入**，
-                 · 编辑时**不能**在这里给：我把他归成"同事"不该把妈妈那边的归类也改掉 ——
+                  与「编辑成员」页那个 #ptBlock 同一套（候选勾选 + 自由输入，文本框是唯一提交源）。
-                   改分组走名册里拖动，或那张卡片的「调整分组」。 */ ?>
+               ⚠️ 只在**新增**时出现在这个位置（编辑时上面那个 #ptBlock 已经在管标签了，
+                  同一张表单里出现两块"标签"会让人以为要填两遍）。
+               ⚠️ 分组（person_roster.group_id）**表结构保留不动** —— 名册里还靠它
+                  做"拖动归档"的容器，历史数据也在。只是**新增入口不再要求人选它**。 */ ?>
       <?php if (!$isEdit): ?>
-        <div class="field">
+        <div class="field full" id="ptBlock">
-          <label for="group_id">所属分组</label>
+          <label for="pfTags">标签</label>
-          <select class="select" id="group_id" name="group_id">
+          <?php if (!empty($tagChoices)): ?>
-            <option value="0">先不分类</option>
+            <div class="pt-picks pf-picks">
-            <?php foreach (\App\PersonGroup::orderFor((int)\App\Auth::familyId(), (int)\App\Auth::personId()) as $g): ?>
+              <?php foreach ($tagChoices as $tg): ?>
-              <option value="<?= (int)$g['id'] ?>"
+                <label class="pt-pick">
-                <?= (int)old('group_id', 0) === (int)$g['id'] ? 'selected' : '' ?>>
+                  <input type="checkbox" value="<?= e((string)$tg) ?>"
-                <?= e((string)$g['name']) ?><?= (int)$g['owner_id'] === 0 ? '（公共）' : '' ?>
+                         <?= in_array((string)$tg, array_map('strval', (array)($myTags ?? [])), true) ? 'checked' : '' ?>>
-              </option>
+                  <span>#<?= e((string)$tg) ?></span>
-            <?php endforeach; ?>
+                </label>
-          </select>
+              <?php endforeach; ?>
-          <span class="tip">加进来之后也能改：在名册里把他拖到那一栏就行。</span>
+            </div>
+          <?php endif; ?>
+          <input class="input" id="pfTags" name="tags" maxlength="300"
+                 value="<?= e(implode(' ', (array)($myTags ?? []))) ?>"
+                 placeholder="如：亲戚 球友 同事（用空格分开）" autocomplete="off">
+          <span class="tip">
+            一个人可以有多个标签 —— 既是亲戚又是球友，两个都打上就行。<br>
+            <b>标签是你自己名册里的</b>：你给他打「球友」不会让全家的名册都多出这个词。
+          </span>
         </div>
       <?php endif; ?>
 
@@ -394,10 +405,17 @@ $ctHints = [
       <?php /* 用户第 5 条：**我对他的私人备注** —— 只有我自己看得到（存在 person_notes 里）。
                只在"编辑别人"时出现（自己看自己不需要"我对我的备注"）。
                ⚠️ 它是独立的出口（自己的路由 + 自己的表），不与上面那份混在一起：
-                  「他愿意公开说的」与「我对他的私下记录」是两件事、两种可见性。 */ ?>
+                  「他愿意公开说的」与「我对他的私下记录」是两件事、两种可见性。
-      <?php if ($isEdit && !$isSelf): ?>
+
+               🔴🔴 v53（用户 2026-10-16 第 5 条）：「我在添加一个成员的时候，是不是可以
+               直接在添加成员的页面里填写**我对他的称呼**以及**我对他的备注**，
+               **一次就解决**？要不然的话，我还得先添加，然后再返回这个人的名册，
+               再去填写我对他的备注和称呼。这样其实有点麻烦。」
+               ⇒ 「新增」时也要出现（原来只在"编辑别人"时才有）——
+                  与下面的「我对他的称呼」一起，新增页一次填完。 */ ?>
+      <?php if (!$isSelf): ?>
       <div class="field full">
-        <label for="myNote">我对 <?= e((string)$person['name']) ?> 的备注（只有我自己看得到）</label>
+        <label for="myNote">我对 <?= $isEdit ? e((string)$person['name']) : '他' ?> 的备注（只有我自己看得到）</label>
         <textarea class="input" id="myNote" name="my_note" rows="2"
                   placeholder="怎么认识的、要注意什么、上次见面聊了什么……"><?= e((string)($myNote ?? '')) ?></textarea>
         <span class="tip">
@@ -407,6 +425,25 @@ $ctHints = [
       </div>
       <?php endif; ?>
 
+      <?php /* 🔴 v53（用户 2026-10-16 第 5 条）：**我对他的称呼**。
+             称呼是**视角属性**（妈妈叫"明明"、姐姐叫"小弟"），存在 nicknames 表里、
+             按 (看的人, 被看的人) 一对一条 —— 所以它天然是"我的"称呼，不会改到别人。
+             ⚠️ 与上面「我对他的备注」并排放在一起：用户把这两件事当成"添加时一次填完"
+                的一组（他原话把「称呼」和「备注」并列）。
+             ⚠️ 新增时也给（此时 $person 还不存在，标题用"他"）。 */ ?>
+      <?php if (!$isSelf): ?>
+      <div class="field full">
+        <label for="pfNick">我对 <?= $isEdit ? e((string)$person['name']) : '他' ?> 的称呼</label>
+        <input class="input" id="pfNick" name="my_nick" maxlength="40"
+               value="<?= e(old('my_nick', (string)($myNick ?? ''))) ?>"
+               placeholder="如：大哥、明明、王老师（只有我自己看到）" autocomplete="off">
+        <span class="tip">
+          你在他名册里看到的名字会变成这个称呼 —— 妈妈叫「明明」、姐姐叫「小弟」互不影响。<br>
+          留空就用他自己的名字。
+        </span>
+      </div>
+      <?php endif; ?>
+
       <?php /* 🔴🔴 v51（用户 2026-10-15 第 4 条）：「名册这个功能里面，当我编辑资料的时候，
            在这个页面竟然**没有办法选择它的标签**。按道理讲，名册编辑成员这个地方
            应该能编辑这一个人的**所有信息**才对。」