v24 第 5 轮:十条清单(天气填城市 / 输入即筛选 / 看板列=看板 / 账本盘点折线图 / 纪念日分类)

用户 2026-10-03 的十条,逐条落点:

1. 天气改为**个人设置里填城市**(每人一份):新增 app/Geo.php,内置 197 个
   地级市坐标(离线、逐条核对,生成脚本 _tooling/_fb_geo_gen.py)。填坐标仍
   作为内置表没有时的出口;老的家庭级坐标保留为兜底,升级当天天气不会凭空消失。
2. 所有"找个人"的地方**输入即筛选**:新增 assets/js/filter.js(纯前端显隐,
   不发请求、回车不刷新)+ app/PersonQuery.php 把服务端判据收敛成一份
   (名册 / 挑人 / 高级搜索共用,避免三处实现漂移)。
3. 名册列表:有昵称就不重复显示本名、行变矮、补齐手机/阴历阳历生日(带年份)/
   邮箱/工作单位;「清除」与「搜索」同款同尺寸。
4/5. 日程:撤掉左侧日历本栏改满宽,功能(显隐/颜色/导入/默认视图)全收进
   右侧 ☰;**色块高度改为按起止时长**(旧实现一律 30 分钟,三小时的会跟
   十五分钟的同高);点日历空白处即建日程,开始时间=点的那一格。
6/10. 资源:搜索提到最上;按"最近改动/最新新增"排序,默认只显示最新 10 条并
   给「显示全部」出口。
7. 任务:看板的**列=用户自定义的看板**(不再是写死的待办/进行中),
   拖动/左右键=换看板(改 board_id,不动 status)。
8. 财务:概览在上账目在下、记一笔改右侧按钮、账本设置(共享/改名/新建/删除)
   收进 ☰、默认账本名「xxx的账本」、"挂在谁名下"默认自己且用标准选人框;
   **新增盘点**(新增 ledger_entry_snapshots 只增不改的历史表,旧值不被清空)
   + 上面画金额变化折线图(app/chart.php 服务端画 SVG,零依赖)。
9. 纪念日:手动添加的与名册生日派生的**分两块**、手动的在上;右侧设置可增删
   分类(家庭级,删分类不强改已用的历史)。

本轮另外修掉/加固的四类问题(都由新增的静态或运行时守卫兜住):
- index.php 少写 2 个 use 导入(Pinyin / UserSetting)→ 名册与个人设置
  返回 200 但正文是 Fatal;顺带修了一处早已存在的 Attachment 未导入。
  → 新增 _fb_import_check.py(1f 段)。
- 一次不精确替换弄丢了 app/Calendar.php 开头的 `<?php`,整份源码被当 HTML
  吐给浏览器,而 `php -l` 报"无语法错误"(纯文本输出确实合法)。
  → 新增 _fb_php_open_check.py(1e 段)。
- 模板片段 unset 了宿主模板的变量(账本片段 unset($canWrite))→ 正文里一片
  Undefined variable 而 HTTP 仍 200。同 _datetime.php 早年 $t 的坑。
  → 新增 _fb_fragment_scope_check.py(1g 段)+ _fb_batch_e.py 的 26 页无告警巡检。
- 窄屏下页头动作区不换行 → 周视图横向溢出且按钮被挤成三种高度(用户提过三次
  "按钮要同高")→ .page-head .actions 加 flex-wrap。

验证战绩(全绿):
  e2e 773/0 · 第 5 轮专项 91/0 · 结构升级 126/0 · 几何 428/0 · 移动端 684/0 ·
  交互 97/0 · 家谱 26/0 · 按钮 60/0;三轮反向验证各 3/3 抓到,还原后复绿。
线上:schema v14、指纹一致(9df6c9fccc6796db)、snapshots 表已建、197 城、
  8 个关键文件 md5 与本地逐字节一致、app/ 403 无源码泄漏、错误日志无新增。
This commit is contained in:
2026-10-03 15:01:38 +08:00
parent dbcf0c1bcd
commit e0562b8627
31 changed files with 2891 additions and 505 deletions
+37 -46
View File
@@ -35,29 +35,30 @@ final class Person
$args[] = $familyId;
$args[] = $kind;
if ($q !== '') {
// ⚠️ 纯字母/数字的查询词**不能**交给 SQL 的 LIKE 过滤:
// 它是"姓名首字母"(如 yyq),SQL 里根本没法把汉字转拼音,
// 一 LIKE 就把结果筛成空 —— 后面的 PHP 精筛也就没东西可筛了,
// 表现为"搜 yyq 一个人都没有"(功能像没做)。
// 所以这种查询词直接跳过 SQL 条件,全量取回来之后在 PHP 里筛
// (名册是个人小列表,几十条,全取完全没问题)。
//
// ⚠️ **也不能**用 SQL 过滤纯数字(手机号):手机号是**加密存的**,
// 库里只有密文,SQL 的 LIKE 永远匹配不到明文数字。
// 数字查询同样交给 PHP 精筛(那里会解密后再比)。
$needSql = (bool)preg_match('/[^A-Za-z0-9]/u', $q);
if ($needSql) {
$sql .= ' AND (p.name LIKE ? OR p.email LIKE ? OR n.nickname LIKE ?)';
$like = '%' . $q . '%';
$args[] = $like;
$args[] = $like;
$args[] = $like;
// ⚠️ 纯字母/数字的查询词**不能**交给 SQL 的 LIKE 过滤 —— 判据见 PersonQuery。
// 这里与 roster() 用的是**同一个** PersonQuery::needsSql /
// PersonQuery::refine,所以"找个人"在两处的结果一定一致。
if (PersonQuery::needsSql($q)) {
$sql .= PersonQuery::SQL_WHERE;
foreach (PersonQuery::likeArgs($q) as $a) {
$args[] = $a;
}
}
}
$sql .= ' ORDER BY p.id ASC';
$st = Database::get()->prepare($sql);
$st->execute($args);
return $st->fetchAll();
$rows = $st->fetchAll();
if ($q !== '') {
foreach ($rows as &$r) {
if (!array_key_exists('phone_plain', $r)) {
$r['phone_plain'] = PersonQuery::phonePlain($r);
}
}
unset($r);
$rows = PersonQuery::refine($rows, $q);
}
return $rows;
}
/**
@@ -88,20 +89,17 @@ final class Person
$args[] = $viewerId;
$args[] = $kind;
if ($q !== '') {
// ⚠️ SQL 只在**能帮忙**时才粗筛,两个反例:
// · 纯字母(yyq)—— 那是"姓名首字母",SQL 里没法把汉字转拼音,
// 一旦 LIKE 就把结果筛成空,后面的 PHP 精筛也就没东西可筛了;
// · 纯数字(手机号)—— 手机号是**加密存的**,库里只有密文,
// LIKE 永远匹配不到明文数字。
// ⚠️ SQL 只在**能帮忙**时才粗筛 —— 判据在 PersonQuery::needsSql(**唯一一处**):
// · 纯字母(yyq)是"姓名首字母",SQL 里没法把汉字转拼音,一 LIKE 就筛成空;
// · 纯数字(手机号)是**加密存的**,库里只有密文,LIKE 永远匹配不到明文。
// 这两类都交给下面的 PHP 精筛(它会解密、会算首字母)。
// 只含中文/邮箱这类"库里有明文可比"的查询词才加 SQL 条件。
$needSql = (bool)preg_match('/[^A-Za-z0-9]/u', $q);
if ($needSql) {
$sql .= ' AND (p.name LIKE ? OR p.email LIKE ? OR n.nickname LIKE ?)';
$like = '%' . $q . '%';
$args[] = $like;
$args[] = $like;
$args[] = $like;
// 这条判断以前在 roster() 和 all() 里各写了一遍,改的时候踩过"只改了一处",
// 所以抽成了 PersonQuery::needsSql。
if (PersonQuery::needsSql($q)) {
$sql .= PersonQuery::SQL_WHERE;
foreach (PersonQuery::likeArgs($q) as $a) {
$args[] = $a;
}
}
}
$sql .= ' ORDER BY r.sort_order ASC, p.id ASC';
@@ -110,23 +108,16 @@ final class Person
$rows = $st->fetchAll();
// 用户 2026-10-03 第 4 条:再加**姓名首字母**检索(y / yy / yyq 都命中「杨永全」)。
// ⚠️ 不在 SQL 里做:SQL 侧没法把汉字转拼音(线上也没有现成的函数),
// 硬塞进 SQL 只能靠一堆 LIKE OR,既慢又不可能穷尽。
// 名册是**一个人自己的**小列表(几十条),在 PHP 里过滤完全够快。
// 做法:SQL 只在能帮忙时粗筛(中文/邮箱这类),然后**一律**走这里精筛一次。
// 精筛覆盖:姓名 / 称呼 / 邮箱 / **解密后的手机号** / 姓名首字母。
// 精筛一律走 PersonQuery::refine —— 覆盖:姓名 / 称呼 / 邮箱 /
// **解密后的手机号** / 姓名首字母。见该类的类注释(判据必须与挑人页一致)。
if ($q !== '') {
$rows = array_values(array_filter($rows, static function (array $r) use ($q): bool {
// 手机号是加密的,Pinyin::matches 认 phone_plain;这里把它带上再判一次
if (!empty($r['phone_encrypted'])) {
try {
$r['phone_plain'] = Crypto::decrypt((string)$r['phone_encrypted']);
} catch (\Throwable $e) {
// 解不开就当没填(不影响其它字段的匹配)
}
foreach ($rows as &$r) {
if (!array_key_exists('phone_plain', $r)) {
$r['phone_plain'] = PersonQuery::phonePlain($r);
}
return Pinyin::matches($r, $q);
}));
}
unset($r);
$rows = PersonQuery::refine($rows, $q);
}
return $rows;
}