v81：首页卡片「新增电影」「新建纪念日」弹框（不离开首页就把事办了）

用户 2026-10-22：
「首页上的其他卡片也应该有这些基本功能。比如电影观影，它有一个"新增电影"的功能；
  如果是纪念日，就有一个"新增纪念日"。实际上，就是把原来模块里弹的那个框，现在拿到
  这边来。目的就是为了在首页上就能快速完成一定工作，而不用进到模块里面。」

做法：复用模块页**同一份**表单，不另写。
- app/HomeCards.php：TYPES 每张卡多登记 add（按钮文案）/ add_modal（弹框容器 id）。
- templates/home.php：按登记表挂 data-fb-add-open="#<id>"（没登记的仍用 v78 的
  data-tk-add-open，两种写法并存但各有唯一来源）；页尾 require 模块的表单模板。
- assets/js/add_modal.js（新）：通用开关，只认 [data-fb-add-modal] /
  data-fb-add-open / data-fb-add-close；幂等闸门；Esc 先让 antd 收面板；
  打开那一刻才 boot 日期控件（hidden 时尺寸为 0，antd 会定位到屏幕左上角）。
- templates/{movies,days}/form.php：只在首页内嵌时（$fbAddModalAttr）挂通用属性
  并输出 back=home，模块页行为一字不变。
- index.php：days/save 与 movies/create 加 back=home 白名单（取 POST 再比字面量，
  不把 POST 当跳转地址）。

过程中修掉两个真问题：
- 登记表第一版写 anAddCard，而 days/form.php 实际是 anNewCard ⇒ 按钮属性写对了、
  DOM 也不报错，点下去毫无反应。已加「按钮指向的容器真的存在」判据与部署静态
  断言里的交叉校验（拿登记表 id 去 templates/ 里逐个找 id="..."）。
- 探针判「提交后回首页」原本读 pg.url，而 wait_for_load_state(networkidle) 在
  点击那一刻本就 idle 时立刻返回 ⇒ 读到提交前的地址，恒绿。改成拦那次 POST 的
  响应看 (状态码, Location)，拆成 ⑭a 提交真发生 / ⑭b 302 指向 home / ⑭c 浏览器停在 home。

验证：正向探针 23/0 · 反向验证 14/0（七注入各自变红）· e2e 1572/0 · 几何 428/0。

templates/home.php

@@ -122,14 +122,29 @@
             <?php endif; ?>
             <?php /* 🔴 v78（用户 2026-10-22）：「在全部任务旁边，放一个新建任务的功能，
                    其实就是把任务中的新建和编辑功能，搬过来，用弹出框来处理。」
-                   ⇒ 卡片登记表里登记了 `add` 的（目前只有「近期任务」）就在
-                      「全部任务」**右边**再多一颗 —— 同一套 `.hd-more` 配色，
-                      所以它是任务模块的主题色，不会跟旁边那颗抢眼。
-                   ⚠️ 按钮本身只带 `data-tk-add-open`：开关逻辑在 `assets/js/task_add.js`，
-                      那张弹框的 HTML 在页面末尾（`tasks/_add_modal.php`）。 */ ?>
-            <?php if ((string)($hcDef['add'] ?? '') !== '' && \App\Auth::canWrite()): ?>
+                   ⇒ 卡片登记表里登记了 `add` 的，就在「更多」**右边**再多一颗 ——
+                      同一套 `.hd-more` 配色，所以它是那个模块的主题色，不会抢眼。
+
+                   🔴 v81（用户同日）：「首页上的其他卡片也应该有这些基本功能。
+                      比如电影观影，它有一个"新增电影"的功能；如果是纪念日，就有一个
+                      "新增纪念日"。实际上，就是把原来模块里弹的那个框，现在拿到这边来。」
+                   ⇒ 属性改成**通用**的 `data-fb-add-open="#<弹框容器 id>"`（v81 的
+                      `assets/js/add_modal.js` 认这个），弹框 id 由登记表 `add_modal` 给出。
+                   ⚠️ 任务的弹框仍由老脚本 `task_add.js` + `data-tk-add-open` 管
+                      （v78 已上线，不动它以免回归）；所以这里**按登记表决定挂哪个属性**，
+                      不是一刀切换掉 —— 两种写法并存但各自有唯一来源。 */ ?>
+            <?php
+            $hcAdd      = (string)($hcDef['add'] ?? '');
+            $hcAddModal = (string)($hcDef['add_modal'] ?? '');
+            ?>
+            <?php if ($hcAdd !== '' && \App\Auth::canWrite()): ?>
               <button type="button" class="btn btn-sm hd-more<?= $hcColor === '' ? ' btn-ghost' : '' ?>"
-                      data-tk-add-open<?= $hcColor !== '' ? ' style="--hd-c: ' . e($hcColor) . ';"' : '' ?>><?= e((string)$hcDef['add']) ?></button>
+                      <?php if ($hcAddModal !== ''): ?>
+                      data-fb-add-open="#<?= e($hcAddModal) ?>" aria-haspopup="dialog" aria-expanded="false"
+                      <?php else: ?>
+                      data-tk-add-open
+                      <?php endif; ?>
+                      <?= $hcColor !== '' ? ' style="--hd-c: ' . e($hcColor) . ';"' : '' ?>><?= e($hcAdd) ?></button>
             <?php endif; ?>
           </div>
           <?php require $hcTpl; ?>
@@ -230,3 +245,49 @@
   unset($tkAddBack, $tkAddBoards, $tkAddCats, $tkAddPeople, $tkAdd);
   ?>
 <?php endif; ?>
+
+<?php /* ==================== 「新增电影」「新建纪念日」弹框（v81 用户 2026-10-22）============
+   用户原话：「首页上的其他卡片也应该有这些基本功能。比如电影观影，它有一个"新增电影"
+   的功能；如果是纪念日，就有一个"新增纪念日"。实际上，就是把原来模块里弹的那个框，
+   现在拿到这边来。目的就是为了在首页上就能快速完成一定工作，而不用进到模块里面。」
+
+   ⚠️ 与模块页**共用同一份模板**（`movies/form.php` / `days/form.php`），不另写表单：
+      字段、校验、服务端契约、附件上传全部同一套，永远不会不同步。
+   ⚠️ 三件事必须一起给，否则这张弹框"长出来了但用不了"：
+      ① `$fbAddModalAttr = true` —— 让模板挂 `data-fb-add-modal`（通用开关认它）；
+      ② 模板需要的**数据**（名册 / 影院 / 分类）由路由按"卡片在不在"准备，见 index.php；
+      ③ 表单里的 `back=home`（模板按 `$fbAddModalAttr` 自动输出）—— 提交完回首页。
+   ⚠️ 只在对应卡片**真的摆在首页**且账号可写时才渲染：卡片被关掉就没有入口，
+      不该白跑 People::roster / Cinema::all 这些查询。 */ ?>
+<?php if (!empty($homeAddModals) && \App\Auth::canWrite()): ?>
+  <?php foreach ((array)$homeAddModals as $hcAddKey => $hcAddData): ?>
+    <?php
+    $fbAddModalAttr = true;                 // 通用开关属性（见上面第 ① 条）
+    /* 每个片段自己兜底变量：模板片段不许偷宿主的变量（本项目重复踩过的坑）。 */
+    $m = null; $errors = [];
+    if ($hcAddKey === 'movies') {
+        $people  = (array)($hcAddData['people'] ?? []);
+        $cinemas = (array)($hcAddData['cinemas'] ?? []);
+        $mvModalOnly = true;                // 不输出 page-head / 设置菜单
+        $mvModalForce = true;               // 强制弹框壳（新增态本来就是，写明更稳）
+        $mvOpen = false;                    // 初始关闭，点卡片按钮才开
+        require __DIR__ . '/movies/form.php';
+        unset($mvModalOnly, $mvModalForce, $mvOpen, $people, $cinemas, $m, $errors);
+    } elseif ($hcAddKey === 'days') {
+        $anModalOnly = true; $anOpen = false; $anModal = true;
+        $anEmbed = false; $anShell = true;
+        /* ⚠️ 这三个必须逐个显式给：`days/form.php` 自己会 `$kindsFull ?? 查库` 兜底，
+           但**兜底会多跑一次查询**，而且与模块页那份不一定同源。
+           这里直接给它容器已经查好的那份（路由里按"卡片在不在"准备）。 */
+        $editing    = null;
+        $people     = (array)($hcAddData['people'] ?? []);
+        $kindsFull  = (array)($hcAddData['kindsFull'] ?? []);
+        $kinds      = array_column($kindsFull, 'name');
+        require __DIR__ . '/days/form.php';
+        unset($anModalOnly, $anOpen, $anModal, $anEmbed, $anShell,
+              $editing, $people, $kindsFull, $kinds);
+    }
+    unset($fbAddModalAttr);
+    ?>
+  <?php endforeach; ?>
+<?php endif; ?>