laoyang
a5e559b2b3
名册点击看详情拖动才排序 / 任务复选框与状态 / 财务标签多选 / 微信读书同步与统计 /
导航线上数据与图标
用户本轮 9 条需求（原话见 templates/ 与 app/ 内的逐条注释）：
1. 名册：列表里给某人分组改为 AJAX 就地挪卡片（不再整页刷新）。
2. 纪念日：关联人改**多选**（复用 _person_picker，字段 person_ids[]）；
自建纪念日的按钮与其它模块统一（改=蓝 .btn、删=黄 .btn-warn）；
列表新增「关联人」列并给人名前加头像。
3. 首页：日程/任务两块**完全等高**（align-items:stretch + 固定总高 + flex 子项
min-height:0）；修「0 件待办」——数字与右侧列表同源（原来各算各的）。
4. 🔴 名册里被移出的人过一阵又回来：根因是 PersonRoster::seedFromPersons()
**每次 Schema::ensure() 都无条件重灌**（线上实测每跑一次 +1 行）。
修：给它加自守卫（只有在 persons 还留着 group_id/sort_order 的**老库**才跑）。
5. 名册：点击=看详情、**只有拖 ⠿ 手柄**才是排序（原来整行既能点又能拖，语义混乱）。
6. 任务：所有任务前加复选框，任何位置点勾即完成；
状态语义照业界整理为 To Do / Doing / Done 并写出说明（用户要求参考别人的做法）。
7. 财务：类别标签改**多选非互斥**（再点一次取消该类别），上下两图 + 图例 + 表格
全部按同一个集合联动；高亮条刻意不给「合计」（多选下各类金额不能相加）。
8. 微信读书：新增**懒同步**（访问时顺手做，6h TTL，只补空字段不覆盖用户填的）、
封面图**拉下来存本站存储**（原来只存外链 → 看不到）、接官方 /readdata/detail 统计。
9. 导航：线上数据只搬了一半（5 板块 29 站 → 7 板块 67 站 + 67 图标）、
展示页头像不显示 / 搜索按钮错位 / 点登录 404。三个真根因：
· 相对地址在 /nav/ 下全 404 → 新增 Nav::abs()；
· 搜索容器丢了 id="search"（CSS 是 #search button.submit 绝对定位）；
· Nav::iconKey() 与 SimpleNav 的 icon_key() **算法不一致**（少一次 md5 归一化）
→ 搬来的图标文件名对不上；且 uploads/ 整目录 Require all denied。
新增两个**免登录公开出口** nav_icon.php / nav_avatar.php。
顺带修掉一个「数据损坏级」的真 bug（做第 4 条线上反证时发现的，之前一直没人注意）：
app/Region.php 三处用中文标点当 trim/ltrim 的 charlist，而 PHP 的 charlist 是
**按字节**匹配的 —— 「。」= E3 80 **82** → 字节 82 进了可剥集合 →
「层」= E5 B1 **82** 被切掉尾字节 → 非法 UTF-8 → backfillAddress 的 UPDATE 报
`1366 Incorrect string value` → **地址拆分升级从上线起一直在失败被跳过**（每请求报一次）。
改成字符级 preg_replace('/…/u')；线上实测 ensure() 现在无报错、待拆行数真的在下降。
验证战绩：
- e2e 1289/0（新增 Region 字节级用例等）
- 真机探针：选人 19/0 · 首页/导航 24/0 · 导航模块 34/0 · b18 暂存+确定 10/0 ·
第23批 52/0
- 桌面几何 428/0 · 移动端几何 680/0 · 交互 92/0 · 窄屏 24/0
- 老库升级 153/0（含 anniversary_people 迁移 + 「再跑 ensure() 名册行数不变」）
- 部署静态断言 180 OK / 0 FAIL · 反向验证 3/3 + Region 三变体各被两条断言同时抓住
- 线上 26 个文件与本地**逐字节一致**；展示页 200、图标 66/66 200、登录 200、
越权/不存在均 404、签发短语后 ensure() 不再报错。
51 lines
2.8 KiB
PHP
51 lines
2.8 KiB
PHP
<?php
|
||
/**
|
||
* 任务「完成」复选框（v24 第 25 批 用户第 6 条）—— 全站唯一画法。
|
||
*
|
||
* 用户原话：「任务相关的模块，所有的任务，前面都带一个复选框，在任何地方，
|
||
* 点这个复选框，这个任务就完成了。」
|
||
*
|
||
* 所以它出现在**每一个**列出任务的地方：任务看板、首页「手头在做」、任务详情、
|
||
* 子任务列表。抄四份必然走样（改一处忘三处），所以抽成这一个片段。
|
||
*
|
||
* 用法（在模板里先准备好变量再 include）：
|
||
* $tkId 任务的 id（必填）
|
||
* $tkStatus 当前状态（'todo' / 'doing' / 'done'）
|
||
* $tkBack 改完之后回哪儿：'tasks'（默认）或 'show'（详情页里点的时候）
|
||
* $tkLabel 可选，无障碍用的说明（默认「标记完成」）
|
||
* $tkStatic 可选，true = 只读账号 → 渲染成**不可点**的静态方块（不是按钮）
|
||
*
|
||
* ⚠️ 三件必须做对的事：
|
||
* ① **它是 button 不是 input[type=checkbox]** ——
|
||
* 它要发一个带 CSRF 的表单（或者被 JS 接管），
|
||
* `input` 的 `checked` 是浏览器自己管的，会被"点了没提交成功但看着已勾上"骗到。
|
||
* 用 button + `aria-pressed` 表达状态，页面上的"勾没勾"始终由**服务端状态**说了算。
|
||
* ② 表单**全页只渲染一份**（`#taskDoneForm`，见下面的说明）：几十张卡就是几十份 form，
|
||
* 那是名册页被密码管理器拖垮的同一个坑（2369 个 form 的实测记录在 people/index.php）。
|
||
* 所以卡片上只放 `data-tk-done="<id>"`，真正的表单在页面末尾。
|
||
* ③ **不写 `checked` 属性、不写 `onsubmit`**：状态由服务端渲染的 class 决定，
|
||
* 点击由 app.js 统一接管（有 JS → AJAX 就地改；无 JS → 表单提交回 302）。
|
||
*/
|
||
$tkId = (int)($tkId ?? 0);
|
||
$tkStatus = (string)($tkStatus ?? 'todo');
|
||
$tkBack = (string)($tkBack ?? 'tasks');
|
||
$tkLabel = (string)($tkLabel ?? '标记完成');
|
||
$tkStatic = !empty($tkStatic);
|
||
$tkIsDone = $tkStatus === 'done';
|
||
if ($tkId <= 0) {
|
||
return;
|
||
}
|
||
?>
|
||
<?php if ($tkStatic): ?>
|
||
<span class="tk-check is-static<?= $tkIsDone ? ' is-done' : '' ?>"
|
||
aria-hidden="true" title="<?= e(\App\Task::statusWord($tkStatus)) ?>"></span>
|
||
<?php else: ?>
|
||
<button type="button" class="tk-check<?= $tkIsDone ? ' is-done' : '' ?>"
|
||
data-tk-done="<?= $tkId ?>"
|
||
data-tk-status="<?= e($tkStatus) ?>"
|
||
data-tk-back="<?= e($tkBack) ?>"
|
||
aria-pressed="<?= $tkIsDone ? 'true' : 'false' ?>"
|
||
title="<?= $tkIsDone ? '已完成（再点一下取消）' : '点一下标记完成' ?>">
|
||
<span class="visually-hidden"><?= e($tkLabel) ?>：<?= e(\App\Task::statusWord($tkStatus)) ?></span>
|
||
</button>
|
||
<?php endif; ?>
|