Files
FamilyBook/templates/people/import.php
T
laoyang b5725b449a v24 第 6 轮:名册导入 / 两种备注 / 多段工作经历 / 家谱卡片与首字母检索修正
用户 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 与本地一致、错误日志无新增。
2026-10-03 19:27:14 +08:00

95 lines
4.0 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?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; ?>