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 与本地一致、错误日志无新增。
95 lines
4.0 KiB
PHP
95 lines
4.0 KiB
PHP
<?php
|
||
/**
|
||
* 名册导入（v24 用户 2026-10-03 第 1 条）。
|
||
*
|
||
* 页面就两件事：挑文件 → 看结果。所以做成**一页**（提交后同页出报告），
|
||
* 不跳到"导入历史"之类的第二页 —— 一次导入看完就该结束。
|
||
*
|
||
* @param array $groups 我能用的分组（导入进来的人可以先归到一组）
|
||
* @param array|null $report ContactImporter::run 的结果（null = 还没导入）
|
||
*/
|
||
$report = $report ?? null;
|
||
$canMove = \App\Auth::canWrite();
|
||
?>
|
||
<div class="page-head">
|
||
<h1>导入联系人</h1>
|
||
<span class="sub">从手机 / 邮箱导出的通讯录批量加进名册</span>
|
||
<div class="actions">
|
||
<a class="btn btn-ghost btn-sm" href="<?= e(url('people')) ?>">返回名册</a>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="card card-pad">
|
||
<h2 class="cinema-h2">选一份文件</h2>
|
||
<p class="small muted" style="margin:0 0 14px">
|
||
支持 <b>.vcf</b>（vCard，iPhone / 安卓 / 谷歌联系人 / Outlook 都能导出）与
|
||
<b>.csv / .txt</b>（表头里有「姓名 / 手机 / 邮箱」之类就能认，中英文表头都行）。
|
||
<br>
|
||
导入规则：<b>手机号或姓名已经在名册里的，不会重复建人</b>，
|
||
只把「他还没有的信息」补上去（已有的一律不动）；其余才新建。
|
||
</p>
|
||
|
||
<form method="post" action="<?= e(url('people/import')) ?>" enctype="multipart/form-data">
|
||
<?= csrf_field() ?>
|
||
<div class="form-grid">
|
||
<div class="field full">
|
||
<label for="imp-file">联系人文件 *</label>
|
||
<input class="input" type="file" id="imp-file" name="contacts"
|
||
accept=".vcf,.csv,.txt,text/vcard,text/csv,text/plain" required>
|
||
</div>
|
||
<div class="field">
|
||
<label for="imp-group">加进哪一组</label>
|
||
<select class="select" id="imp-group" name="group_id">
|
||
<option value="0">先不分类</option>
|
||
<?php foreach ($groups as $g): ?>
|
||
<option value="<?= (int)$g['id'] ?>"><?= e((string)$g['name']) ?></option>
|
||
<?php endforeach; ?>
|
||
</select>
|
||
<span class="tip">只影响<b>新建</b>的那些人；已有的人保持他原来的分组。</span>
|
||
</div>
|
||
</div>
|
||
<div class="btn-row">
|
||
<button class="btn" type="submit">开始导入</button>
|
||
</div>
|
||
</form>
|
||
</div>
|
||
|
||
<?php if ($report): ?>
|
||
<div class="card card-pad">
|
||
<h2 class="cinema-h2">
|
||
导入结果
|
||
<span class="hint">新增 <?= (int)$report['added'] ?> · 补充 <?= (int)$report['updated'] ?> · 无需改动 <?= (int)$report['skipped'] ?></span>
|
||
</h2>
|
||
<?php if (!$report['people']): ?>
|
||
<p class="empty-hint">文件里没有可导入的联系人。</p>
|
||
<?php else: ?>
|
||
<?php /* ⚠️ 报告的是"这条记录做了什么"，逐条列出来：
|
||
批量操作最怕"导完不知道改了什么"（尤其"补充"这一类会动到已有的人）。 */ ?>
|
||
<div class="table-wrap">
|
||
<table class="table">
|
||
<thead><tr><th>联系人</th><th>结果</th><th>补上了什么</th></tr></thead>
|
||
<tbody>
|
||
<?php foreach ($report['people'] as $row): ?>
|
||
<?php
|
||
$act = (string)$row['action'];
|
||
$word = $act === 'added' ? '新建' : ($act === 'updated' ? '补充信息' : '无需改动');
|
||
$cls = $act === 'added' ? 'led-asset' : ($act === 'updated' ? 'led-asset' : '');
|
||
?>
|
||
<tr>
|
||
<td><?= e((string)$row['name']) ?></td>
|
||
<td class="<?= $cls ?>"><?= e($word) ?></td>
|
||
<td class="small muted">
|
||
<?= $row['added'] ? e(implode('、', (array)$row['added'])) : '—' ?>
|
||
</td>
|
||
</tr>
|
||
<?php endforeach; ?>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
<?php endif; ?>
|
||
<div class="btn-row" style="margin-top:14px">
|
||
<a class="btn btn-ghost" href="<?= e(url('people')) ?>">去看名册</a>
|
||
<a class="btn btn-ghost" href="<?= e(url('people/import')) ?>">再导一份</a>
|
||
</div>
|
||
</div>
|
||
<?php endif; ?>
|