laoyang
b5725b449a
用户 2026-10-03 第二批（8 条）。逐条落点：
1. **名册导入**（新）：支持 **vCard 3.0/4.0（.vcf）** 与 **CSV/TSV**（中英文表头都认）。
新增 `app/ContactImport.php`（纯解析）+ `app/ContactImporter.php`（判重+落库）。
判重按 **手机号（哈希，精确）→ 姓名（大小写无关）**；命中已有的人**只补空字段，
绝不覆盖**（批量覆盖没法回退）。
解析上要处理的三件事都处理了：**折行接回**（长名字/地址会被按字节折断）、
转义还原（`\,` `\;` `\n`）、多值收全（TEL/EMAIL/ADR 可能出现多次）。
UTF-16/GBK 的 vcf 也认（手机导出的常见编码）。
2. 成员详情页：右上角「移除」→ **「返回」**（回名册）；「删除」移到页面**最下方**
（在「开通登录账号」下面），并改成 `<details>` 两步确认 + 写清会连带删掉什么。
3. 编辑资料里的「这个人的一句话」**去掉** —— 那句话只能**本人**改。
⚠️ 落法是「这一栏只在改自己时出现」：用户要的是"别人不能替他写"，
而不是"这句没人能填"；服务端也只在 `$isSelf` 时读表单，否则管理员一编辑就把它清空。
4. **工作单位 / 职务 / 职称可以有多段**（新表 `person_jobs`）：表单是一组"经历行"
（单位/职务/职称/起止年月/备注，可 ＋/×），详情页按"现在 + 历史"列出。
`persons.org/title` 保留，语义变成"当前那段的快照"（列表页等只要"现在在哪儿"），
升级时把老的 org/title 回填成一段经历。
5/备注分两种：「自我介绍」（`persons.note`，他本人写的、别人看得到）与
**「我对他的私人备注」**（新表 `person_notes`，每人每对象一条，**只有写的人自己看得到**）。
详情页有独立的一块；表单里只在"编辑别人"时出现。
6. 成员表单：**头像放到最前**、去掉「选择文件」按钮（点那张默认头像即选文件）；
表单标签统一 15px/600（原来 13–14px，和 12px 的灰字提示分不出层级）。
7. 名册列表：⋯ 前面加**「编辑」**按钮（改资料是高频动作，藏进 ⋯ 要点两下）。
8. 家谱：
· **首字母检索 bug**：输入 `yy` 会搜出「岳父/洪勇」。根因是前端把
**姓名与称呼的首字母拼成一串**再判子序列 —— 洪勇的称呼是"岳父" → `hy`+`yf`=`hyyf`
→ `yy` 跨字段命中。改成**逐字段独立判**（服务端本来就是逐字段判的，两边现在同口径）。
· **卡片仍比头像宽**：头像是 **1:1（正方形）** 槽位，卡片里却写成 96×72 的长方形 +
`object-fit: contain` → 照片被缩到 72 宽、左右各留 12px 白 → 看着"框比头像宽"。
改成**正方形头像区 + `object-fit: cover`**（90×128 卡片，88×88 头像区）。
· 右上角加**「我的家谱」**按钮（只在看别人的家谱时出现 —— 看自己的时候点它没意义）。
**测试新增**（都能变红，且做过反向验证）：
- `_fb_import_test.py` 21 条：新人新建 / 手机号命中不重复建人 / **已有字段一个都不被覆盖** /
缺的字段被补上 / 反复导入幂等 / 只给姓名也能命中 / 认不出的文件被明确拒绝，
外加 ⑱ **"有单位但没有经历行"的人**（最容易漏的覆盖路径）。
- `_fb_roster_filter_test.js`（jsdom，用真实渲染出的 HTML）8 条：直击
「输 yy 不该命中 岳父/洪勇」；反向验证时把实现改回拼接写法 → ① 立刻红。
- 改动过程中被测试抓出**两个真 bug**并已修：
① 导入时给"已有单位的人"也插经历 → `PersonJob::syncCurrent()` 回写把这人的单位**覆盖**了；
② `syncCurrent()` 在经历表为空时会把 `persons.org/title` **清空** ——
而它被"编辑资料"这类常规路径调用一次就触发，属于**随手一保存就丢数据**。
现在空表直接 return（"经历表不是唯一的一份"）。
**战绩**：e2e **775/0** · 导入 21/0 · 第 5 轮专项 91/0 · 家谱 34/0 · 几何 428/0 ·
移动端 688/0 · 交互 97/0 · 升级 126/0。
线上：schema **v15**、指纹一致、`person_jobs`/`person_notes` 已建、
6 条老的"工作单位"全部回填成经历、13 个文件 md5 与本地一致、错误日志无新增。
306 lines
17 KiB
PHP
306 lines
17 KiB
PHP
<?php
|
||
/**
|
||
* 家庭名册 —— 按「关系分组」分栏显示，卡片可以拖动。
|
||
*
|
||
* 三处刻意的设计：
|
||
* ① **名册是每人一份的**（v5 起，见 App\PersonRoster）：这里只显示"我加的人 +
|
||
* 别人分享给我的"，归到哪一组、排第几也都只影响我自己。所以"改分组"不再是
|
||
* 改全家的信息，而是改我自己那份 —— 于是顺手就能做成拖动。
|
||
* ② **拖动改分组、拖动改顺序**（需求原话：「拖动一个人的卡片进行排序…通过拖动
|
||
* 改变分组」）：拖动本身是 JS，但**每个分组栏也是空的时候照样存在**，
|
||
* 拖动时统一露出来当落点，否则"想拖到一个现在没人的分组里"就没地方放。
|
||
* ③ **没有 JS 也完全能用**：卡片上的 `<details>调整分组</details>` 还在，
|
||
* 而且手机上的 HTML5 拖放本来就不生效，那套表单就是窄屏的正路。
|
||
*
|
||
* ⚠️ 卡片结构是 div > a + details，**不能写成 a > form**：
|
||
* 表单套在链接里是非法 HTML，浏览器会把 DOM 拆开，表单里那个「移动」按钮
|
||
* 可能连提交机会都没有（或者把整张卡片点成跳转）。
|
||
*/
|
||
$canMove = \App\Auth::canWrite();
|
||
$pickable = $pickable ?? 0;
|
||
$total = 0;
|
||
foreach ($grouped as $list) {
|
||
$total += count($list);
|
||
}
|
||
|
||
/**
|
||
* 画一栏人。用闭包是因为"分好组的各栏"和"未分类"两处要画同一套卡片，
|
||
* 复制一遍迟早会改漏一处。
|
||
*
|
||
* ⚠️ `$groups` 必须写进 `use (...)`：卡片里的「调整分组」下拉要列出我能用的分组。
|
||
* 漏掉它的后果**不会报错**（PHP 8 只 warning 一句"未定义变量"，
|
||
* 而 foreach 拿到 null 就是零次循环）—— 于是每张卡片的那个下拉里
|
||
* 只剩「未分类」一项，看着像"分组功能没做"，其实是变量没传进来。
|
||
*/
|
||
$renderGrid = function (array $list) use ($meId, $canMove, $groups): void {
|
||
?>
|
||
<div class="people-grid">
|
||
<?php foreach ($list as $p): ?>
|
||
<?php
|
||
// 显示名走「我怎么称呼他」：同一个孩子，爸爸看到"儿子"、妈妈看到"小宝"。
|
||
// ⚠️ 不要再读 $p['nickname'] —— 那是已废弃的旧列（全家共用一个小名）。
|
||
// ⚠️ 一律走 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"' : '' ?>
|
||
data-search="<?= e($pshow . ' ' . $pReal . ' ' . (string)($p['email'] ?? '') . ' ' . (string)($p['org'] ?? '') . ' ' . (string)($p['phone_plain'] ?? '')) ?>"
|
||
<?php /* ⚠️ 首字母**分字段**、用空格隔开（前端逐段独立判子序列）。
|
||
把"姓名+称呼"拼成一串会造出跨字段巧合：用户实测「输 yy 搜出岳父」
|
||
—— 洪勇的称呼是"岳父" → hy + yf = hyyf → yy 跨边界命中。
|
||
服务端 Pinyin::matches 本来就是逐字段判的，这样两边口径一致。 */ ?>
|
||
data-initials="<?= e(trim(\App\Pinyin::initials($pReal) . ' ' . \App\Pinyin::initials($pNick))) ?>">
|
||
<?php if ($canMove): ?>
|
||
<span class="drag-handle" title="拖到我想要的位置 / 那一栏" aria-hidden="true">⠿</span>
|
||
<?php endif; ?>
|
||
<?php /* draggable="false" 很重要：链接与图片浏览器默认就是可拖的，
|
||
不关掉的话拖起来会变成"拖一个网址"，父卡片反而拿不到这次拖动。 */ ?>
|
||
<a class="person-main" href="<?= e(url('people/show', ['id' => $pid])) ?>" draggable="false">
|
||
<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 /* 用户第 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
|
||
// 用户第 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 /* 用户 2026-10-03 第 7 条：在 ⋯ 前面加一个「编辑」按钮，快速进这个人的编辑页。
|
||
为什么不做进 ⋯ 菜单里：改资料是**高频**操作（补生日、补电话），
|
||
藏进 ⋯ 里要点两下；而 ⋯ 里放的是"调整分组/移出名册"这类低频动作。
|
||
⚠️ 它是 <a>，且必须在 person-main 这个 <a> **外面**
|
||
—— a 套 a 是非法 HTML，浏览器会把 DOM 拆开。 */ ?>
|
||
<a class="btn btn-ghost btn-sm person-edit" data-no-drag
|
||
href="<?= e(url('people/edit', ['id' => $pid])) ?>"
|
||
title="编辑 <?= e($pshow) ?> 的资料">编辑</a>
|
||
<?php if ($canMove): ?>
|
||
<details class="person-more" data-no-drag>
|
||
<summary aria-label="调整分组">⋯</summary>
|
||
<form method="post" action="<?= e(url('people/group')) ?>" class="person-move">
|
||
<?= csrf_field() ?>
|
||
<input type="hidden" name="person_id" value="<?= $pid ?>">
|
||
<label class="sr-only" for="pg<?= $pid ?>">分组</label>
|
||
<select class="select" id="pg<?= $pid ?>" name="group_id" data-no-drag>
|
||
<option value="">未分类</option>
|
||
<?php foreach ($groups as $g): $gid = (int)$g['id']; ?>
|
||
<option value="<?= $gid ?>"
|
||
<?= (int)($p['group_id'] ?? 0) === $gid ? 'selected' : '' ?>>
|
||
<?= e((string)$g['name']) ?>
|
||
</option>
|
||
<?php endforeach; ?>
|
||
</select>
|
||
<button class="btn btn-ghost btn-sm" type="submit" data-no-drag>移动</button>
|
||
</form>
|
||
<?php if (($p['roster_source'] ?? '') === 'kin'): ?>
|
||
<p class="small muted person-move" style="margin:4px 0 0">因家谱关系自动加入；解除关系后自动移出。</p>
|
||
<?php else: ?>
|
||
<form method="post" action="<?= e(url('people/forget')) ?>" class="person-move">
|
||
<?= csrf_field() ?>
|
||
<input type="hidden" name="person_id" value="<?= $pid ?>">
|
||
<button class="btn btn-ghost btn-sm" type="submit" data-no-drag>从我的名册移走</button>
|
||
</form>
|
||
<?php endif; ?>
|
||
</details>
|
||
<?php endif; ?>
|
||
</div>
|
||
<?php endforeach; ?>
|
||
</div>
|
||
<?php
|
||
};
|
||
|
||
/** 一栏（含空栏）。空栏平时收起来，拖动时由 JS 加 is-dragging 露出来当落点。 */
|
||
$renderBlock = function (int $gid, string $name, array $list) use ($renderGrid): void {
|
||
?>
|
||
<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>
|
||
<span class="group-drop-hint">放到这里</span>
|
||
</h2>
|
||
<?php $renderGrid($list); ?>
|
||
</section>
|
||
<?php
|
||
};
|
||
?>
|
||
|
||
<div class="page-head">
|
||
<h1>家庭名册</h1>
|
||
<span class="sub">
|
||
共 <?= $total ?> 人<?= $groups && $q === '' ? '，分 ' . count($groups) . ' 个关系分组' : '' ?>
|
||
</span>
|
||
<div class="actions">
|
||
<?php if ($canMove && $pickable > 0): ?>
|
||
<a class="btn btn-ghost btn-sm" href="<?= e(url('people/pick')) ?>">
|
||
从家里已有的人里挑（<?= $pickable ?>）
|
||
</a>
|
||
<?php endif; ?>
|
||
<?php if ($canMove): ?>
|
||
<?php /* 用户 2026-10-03 第 1 条：名册导入入口。
|
||
⚠️ 放在「添加成员」**左边**（次要动作在左、主要动作在右）——
|
||
日常还是一个个加，导入是换手机/换号时的一次性动作。 */ ?>
|
||
<a class="btn btn-ghost btn-sm" href="<?= e(url('people/import')) ?>">导入联系人</a>
|
||
<?php endif; ?>
|
||
<?php if (\App\Auth::isAdmin()): ?>
|
||
<a class="btn btn-sm" href="<?= e(url('people/new')) ?>">添加成员</a>
|
||
<?php endif; ?>
|
||
</div>
|
||
</div>
|
||
|
||
<?php /* 用户第 4 条：这句拖动提示**去掉**（用户直接点名要删）。
|
||
功能本身不变，只是不再占版面。 */ ?>
|
||
|
||
<?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">
|
||
<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>
|
||
<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">
|
||
<?php if ($q !== ''): ?>
|
||
<b>没有匹配的人</b>
|
||
换个词试试。
|
||
<?php elseif ($pickable > 0): ?>
|
||
<b>你的名册还是空的</b>
|
||
家里已经有 <?= (int)$pickable ?> 个人了 —— 直接挑过来就行，不用重新录一遍。
|
||
<div class="btn-row" style="justify-content:center;margin-top:14px">
|
||
<a class="btn" href="<?= e(url('people/pick')) ?>">从家里已有的人里挑</a>
|
||
<?php if (\App\Auth::isAdmin()): ?>
|
||
<a class="btn btn-ghost" href="<?= e(url('people/new')) ?>">添加一个新人</a>
|
||
<?php endif; ?>
|
||
</div>
|
||
<?php else: ?>
|
||
<b>名册还是空的</b>
|
||
<?php if (\App\Auth::isAdmin()): ?>
|
||
把家里人加进来，之后观影、旅行的同行人就可以直接从名册里选。
|
||
<div class="btn-row" style="justify-content:center;margin-top:14px">
|
||
<a class="btn" href="<?= e(url('people/new')) ?>">添加成员</a>
|
||
</div>
|
||
<?php else: ?>
|
||
等家里人把你加进来，或者让管理员给你开个账号。
|
||
<?php endif; ?>
|
||
<?php endif; ?>
|
||
</div>
|
||
<?php else: ?>
|
||
<?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): ?>
|
||
<?php $gid = (int)$g['id']; ?>
|
||
<?php $renderBlock($gid, (string)$g['name'], $grouped[$gid] ?? []); ?>
|
||
<?php endforeach; ?>
|
||
|
||
<?php
|
||
// 「未分类」栏永远画出来（哪怕是空的）—— 它是把卡片从某个分组里拖出来的落点。
|
||
// 提示语按需求删掉了（用户原话：「这些人还没归到任何分组里…这些提示，都去掉」）。
|
||
$renderBlock(0, '未分类', $grouped[0] ?? []);
|
||
?>
|
||
|
||
<?php if (!$groups): ?>
|
||
<p class="small muted" style="margin:0">
|
||
还没有任何分组。管理员可以在「系统设置 → 公共分组」里建一套全家共用的，
|
||
你也可以在「个人设置 → 我的分组」里加只给自己看的。
|
||
</p>
|
||
<?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; ?>
|