laoyang/FamilyBook
1
0
Fork 0
Code Issues 29 Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
用户 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:
laoyang
2026-10-03 15:01:38 +08:00
parent dbcf0c1bcd
commit e0562b8627
31 changed files with 2891 additions and 505 deletions
Download Patch File Download Diff File Expand all files Collapse all files
templates/people/index.php
+101 -54
View File
@@ -42,10 +42,33 @@ $renderGrid = function (array $list) use ($meId, $canMove, $groups): void {
// ⚠️ 一律走 person_name()：它按 shown → my_nickname → name 的顺序取，
// 这里自己拼一次迟早漏掉 my_nickname（v14 前就是漏的，于是设了称呼也不显示）。
$pshow = person_name($p);
// 用户 2026-10-03 第 3 条：「如果有昵称，就不要显示真实姓名了」。
// 所以这里只在**没有昵称/称呼**、显示名就是本名时，本名才等于 $pshow（不重复画）。
$pNick = (string)($p['my_nickname'] ?? '');
$pReal = (string)$p['name'];
$pid = (int)$p['id'];
// 用户第 3 条：行高要矮。姓名行右边的徽标只留最必要的几个，
// 「已开通 / 访客 / 家谱 / 待确认」这些收成小徽标（有就显示，没有就不占位）。
// ⚠️「家谱」那枚必须带 title 说明来历 —— 不然"我没加过他，他怎么在我名册里"
// 会让人以为数据坏了（v7 加它就是为了回答这个问题，别在改版时弄丢）。
$metaBits = [];
if ($pid === (int)$meId) { $metaBits[] = ['我', '']; }
$r = $p['account_role'] ?? '';
if ($r === 'admin' && ($p['account_status'] ?? '') === 'active') {
$metaBits[] = ['管理员', ''];
} elseif ($r === 'guest') {
$metaBits[] = ['访客', ''];
} elseif (!empty($p['account_id'])) {
$metaBits[] = ['已开通', ''];
}
if (($p['roster_source'] ?? '') === 'kin') {
$metaBits[] = ['家谱', '他在你的家谱树上（配偶/父母/子女/祖孙…），自动加入你的名册'];
}
if (!empty($p['is_placeholder'])) { $metaBits[] = ['待确认', '']; }
?>
<div class="person" data-person="<?= $pid ?>" <?= $canMove ? 'draggable="true"' : '' ?>>
<div class="person" data-person="<?= $pid ?>" <?= $canMove ? 'draggable="true"' : '' ?>
data-search="<?= e($pshow . ' ' . $pReal . ' ' . (string)($p['email'] ?? '') . ' ' . (string)($p['org'] ?? '') . ' ' . (string)($p['phone_plain'] ?? '')) ?>"
data-initials="<?= e(\App\Pinyin::initials($pReal . ' ' . $pNick)) ?>">
<?php if ($canMove): ?>
<span class="drag-handle" title="拖到我想要的位置 / 那一栏" aria-hidden="true">⠿</span>
<?php endif; ?>
@@ -55,49 +78,48 @@ $renderGrid = function (array $list) use ($meId, $canMove, $groups): void {
<div class="ph"><img src="<?= e(avatar_url($p['avatar'])) ?>" alt="" draggable="false"></div>
<div class="pb">
<div class="pname">
<?php /* ⚠️ 姓名必须是 .pname 里的**第一段裸文本**，不要包 <span>。
① 现有的 e2e 断言就是按这个形状读「这一行显示的是谁」
（person_names()：只认 <div class="pname"> 内的第一段文本）——
包一层 span 会让它读到空串，6 条断言齐刷刷变红，
而页面看着完全正常（这种"改样式把测试打挂"最难查）；
② 包起来也没有任何用处：.pname 本身已经带字重与字号，
下面的关系标签/徽标都在姓名**之后**，不需要靠 span 定位。 */ ?>
<?= e($pshow) ?>
<?php if ($pid === (int)$meId): ?><span class="badge badge-me">我</span><?php endif; ?>
<?php if (!empty($p['is_placeholder'])): ?><span class="badge">待确认</span><?php endif; ?>
<?php /* 用户第 4 条：与我的关系放姓名右边（列表里一眼能看到） */ ?>
<?php if (!empty($p['label']) && $p['label'] !== '我'): ?>
<span class="rel-label"><?= e($p['label']) ?></span>
<?php endif; ?>
<?php foreach ($metaBits as [$b, $bTitle]): ?>
<span class="badge<?= $b === '我' ? ' badge-me' : ($b === '已开通' ? ' badge-open' : '') ?>"
<?= $bTitle !== '' ? 'title="' . e($bTitle) . '"' : '' ?>><?= e($b) ?></span>
<?php endforeach; ?>
</div>
<?php /* 用户第 4 条：中间显示几个重要信息 —— 手机号 / 生日。
关系标签已挪到姓名行，这里只放"事实性"的两项。 */ ?>
<div class="pfacts">
<?php if (($p['phone_plain'] ?? '') !== ''): ?>
<span class="pfact" title="手机号">
<span class="pfact-k">手机</span><?= e((string)$p['phone_plain']) ?>
</span>
<?php endif; ?>
<?php if (($p['birthday_show'] ?? '') !== ''): ?>
<span class="pfact" title="<?= e((string)$p['birthday_kind']) ?>生日">
<span class="pfact-k"><?= e((string)$p['birthday_kind']) ?></span><?= e((string)$p['birthday_show']) ?>
</span>
<?php endif; ?>
</div>
<div class="pmeta">
<?php
$r = $p['account_role'] ?? '';
if ($r === 'admin' && ($p['account_status'] ?? '') === 'active') {
echo '<span class="badge badge-admin">管理员</span>';
} elseif ($r === 'guest') {
echo '<span class="badge">访客</span>';
} elseif (!empty($p['account_id'])) {
echo '<span class="badge badge-open">已开通</span>';
}
// 我叫他别的名字时，把本名再用小字附上，免得自己都认不出这人是谁
if ($pNick !== '' && $pNick !== (string)$p['name']) {
echo ' · <span class="muted">' . e((string)$p['name']) . '</span>';
}
// v7：因家谱关系自动进名册的人，标出来历 ——
// 不然"我没加过他，他怎么在我名册里"会让人怀疑数据坏了
if (($p['roster_source'] ?? '') === 'kin') {
echo ' <span class="badge" title="他在你的家谱树上（配偶/父母/子女/祖孙…），自动加入你的名册">家谱</span>';
}
?>
</div>
<?php
// 用户第 3 条：一行放齐「手机号 / 阴历+阳历生日（带年份）/ 邮箱 / 工作单位」。
// 没填的项**整个 <span> 都不画** —— 留一个空标签只会让每行都长一截。
// 生日优先阳历、其次农历，用 [阳历]/[农历] 小字标明是哪一个。
$facts = [];
if (($p['phone_plain'] ?? '') !== '') {
$facts[] = ['手机', (string)$p['phone_plain']];
}
if (($p['birthday_show'] ?? '') !== '') {
$facts[] = [(string)$p['birthday_kind'], (string)$p['birthday_show']];
}
if (trim((string)($p['email'] ?? '')) !== '') {
$facts[] = ['邮箱', (string)$p['email']];
}
if (trim((string)($p['org'] ?? '')) !== '') {
$facts[] = ['单位', (string)$p['org']];
}
?>
<?php if ($facts): ?>
<div class="pfacts">
<?php foreach ($facts as [$k, $v]): ?>
<span class="pfact"><span class="pfact-k"><?= e($k) ?></span><?= e($v) ?></span>
<?php endforeach; ?>
</div>
<?php endif; ?>
</div>
</a>
<?php if ($canMove): ?>
@@ -138,7 +160,7 @@ $renderGrid = function (array $list) use ($meId, $canMove, $groups): void {
/** 一栏（含空栏）。空栏平时收起来，拖动时由 JS 加 is-dragging 露出来当落点。 */
$renderBlock = function (int $gid, string $name, array $list) use ($renderGrid): void {
?>
<section class="group-block<?= $list ? '' : ' is-empty' ?>" data-group="<?= $gid ?>">
<section class="group-block<?= $list ? '' : ' is-empty' ?>" data-group="<?= $gid ?>" data-filter-group>
<h2 class="group-head">
<span class="group-title"><?= e($name) ?></span>
<span class="group-n"><span class="n"><?= count($list) ?></span> 人</span>
@@ -170,18 +192,22 @@ $renderBlock = function (int $gid, string $name, array $list) use ($renderGrid):
<?php /* 用户第 4 条：这句拖动提示**去掉**（用户直接点名要删）。
功能本身不变，只是不再占版面。 */ ?>
<form class="search" method="get" action="index.php">
<?php /* 用户 2026-10-03 第 2 条：**输入即筛选**，不需要按回车。
第 3 条：搜索后的「清除」按钮要与搜索保持一致（同款 .btn 尺寸、同一行）。
⚠️ 这里仍然是个 form（没有 JS 时按回车照样能搜）——有 JS 时 filter.js 会把
提交拦下来，改成即时筛，避免整页刷新把焦点弹走。 */ ?>
<form class="search" method="get" action="index.php" data-roster-search>
<input type="hidden" name="r" value="people">
<?php /* 用户第 4 条：除了姓名/称呼/邮箱的模糊搜索，还支持**姓名首字母**
（yyq / yy / y 都能搜到「杨永全」）。后端在 Person::roster 里按
"汉字转首字母后再比对"实现，所以这里只要说清楚用法。 */ ?>
<input class="input" name="q" value="<?= e($q) ?>"
<input class="input" name="q" id="rosterSearch" data-filter="#rosterBox"
data-filter-empty="#rosterEmpty" data-filter-clear=".js-roster-clear"
value="<?= e($q) ?>" autocomplete="off"
placeholder="姓名 / 称呼 / 邮箱 / 手机号，或姓名首字母（如 yyq）">
<button class="btn btn-ghost btn-sm" type="submit">搜索</button>
<?php if ($q !== ''): ?>
<a class="link-quiet" href="<?= e(url('people')) ?>">清除</a>
<?php endif; ?>
<button class="btn btn-ghost btn-sm js-roster-clear<?= $q === '' ? ' is-hidden' : '' ?>"
type="button" data-href="<?= e(url('people')) ?>">清除</button>
</form>
<p class="small muted search-count" id="rosterCount" style="margin:-8px 0 10px"></p>
<p class="small muted" id="rosterEmpty" hidden>没有匹配的人。</p>
<?php if (!$people): ?>
<div class="empty">
@@ -209,14 +235,12 @@ $renderBlock = function (int $gid, string $name, array $list) use ($renderGrid):
<?php endif; ?>
<?php endif; ?>
</div>
<?php elseif ($q !== ''): ?>
<?php /* 搜索时按"命中的人"平铺 —— 分栏会把一次搜索拆成一堆只有一两个人的碎块，反而更难看 */ ?>
<p class="small muted" style="margin:0 0 12px">
找到 <?= count($people) ?> 个匹配「<?= e($q) ?>」的人（搜索时不分组）。
</p>
<?php $renderGrid($people); ?>
<?php else: ?>
<div class="roster<?= $canMove ? ' is-droppable' : '' ?>"
<?php /* ⚠️ 搜索与否**都走同一张列表**（v24 用户第 2 条之后）。
原来搜索时会把分组拆掉、平铺成一堆卡片，看着"搜的时候样式变了"；
现在一律按分组呈现，filter.js 会把没命中的行藏起来，
整栏都不剩人时连栏一起收 —— 搜索结果与平时长得一样，只少了不匹配的。 */ ?>
<div class="roster<?= $canMove ? ' is-droppable' : '' ?>" id="rosterBox"
data-reorder="<?= e(url('people/reorder')) ?>"
data-csrf="<?= e(csrf_token()) ?>">
<?php foreach ($groups as $g): ?>
@@ -238,3 +262,26 @@ $renderBlock = function (int $gid, string $name, array $list) use ($renderGrid):
<?php endif; ?>
</div>
<?php endif; ?>
<?php if ($q !== '' || $canMove): ?>
<script>
(function () {
/* 「清除」按钮：有 JS 时不动页面、只清空输入并立刻重筛
（data-href 是没有 JS 时的兜底：直接跳回不带 q 的名册）。 */
var btn = document.querySelector('.js-roster-clear');
var input = document.getElementById('rosterSearch');
if (!btn || !input) { return; }
function syncClear() {
btn.classList.toggle('is-hidden', (input.value || '').trim() === '');
}
input.addEventListener('input', syncClear);
btn.addEventListener('click', function () {
// filter.js 里已经挂了"点它就清空重筛"，这里只负责同步按钮显隐；
// 没有 filter.js（极老浏览器）时退化成跳转。
if (!window.__fbFilterLoaded) { window.location.href = btn.getAttribute('data-href'); }
setTimeout(syncClear, 0);
});
syncClear();
})();
</script>
<?php endif; ?>