laoyang
809443d429
用户反馈：我把一个人设成配偶、又设了我们的孩子，配偶登录后首页能看到
孩子、家谱也能看到，名册里却看不到——没分享的人却在家谱上看得到，
口径打架。
口径由用户拍板：**以每个人为中心上下三代那棵家谱树（= 首页「我的家人」
同一棵）里的人，自动进他名册（source=kin，默认归公共「家人」组）；
树外的人三处都不可见。**
- PersonRoster::syncKinForFamily()：整树同步（补缺、撤多余；已存在的
self/shared/seeded 行绝不碰，用户改过的分组/顺序保留）。幂等。
- 同步挂在事件上：建边 / 解边 / 开通账号 / 结构升级回填。
- Relations::addParent/addSpouse 建边后同步；remove/detach 解边后同步。
- 名册不许单独移走 kin 来源的人（服务端拦截 + 人话提示 + 卡片隐藏
移走按钮改提示语）：他在首页/家谱照样看得见，单藏名册只会回到口径
打架；想不再看到他，解除关系即自动移出。
- 名册卡片给 kin 来源标「家谱」徽标（来历可辨）。
- Schema v7：widenRosterSourceEnum（⚠️ CREATE TABLE IF NOT EXISTS 不会
更新已存在表的枚举，v6 老库不扩宽则 strict 模式下插 kin 整条被拒、
且被容错吞掉——e2e 的 v6 旧库当场抓出）+ 按已有关系回填 kin 条目。
验证：e2e 309/0、升级专测 82/0、部署静态空跑 78/0、桌面几何 0 失败、
交互 97/0、移动几何 180/0；线上探针 ver=7、enum 含 kin、无升级告警。
227 lines
11 KiB
PHP
227 lines
11 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'] —— 那是已废弃的旧列（全家共用一个小名）。
|
||
$pshow = (string)($p['shown'] ?? '');
|
||
if ($pshow === '') {
|
||
$pshow = (string)$p['name'];
|
||
}
|
||
$pNick = (string)($p['my_nickname'] ?? '');
|
||
$pid = (int)$p['id'];
|
||
?>
|
||
<div class="person" data-person="<?= $pid ?>" <?= $canMove ? 'draggable="true"' : '' ?>>
|
||
<?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">
|
||
<?= 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; ?>
|
||
</div>
|
||
<div class="pmeta">
|
||
<?php if (!empty($p['label']) && $p['label'] !== '我'): ?>
|
||
<span class="rel-label"><?= e($p['label']) ?></span>
|
||
<?php endif; ?>
|
||
<?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>
|
||
</div>
|
||
</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 ?>">
|
||
<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 (\App\Auth::isAdmin()): ?>
|
||
<a class="btn btn-sm" href="<?= e(url('people/new')) ?>">添加成员</a>
|
||
<?php endif; ?>
|
||
</div>
|
||
</div>
|
||
|
||
<?php if ($canMove && $q === '' && $total > 0): ?>
|
||
<p class="small muted roster-tip" style="margin:0 0 12px">
|
||
拖动卡片（左边那个 <span class="drag-handle-inline">⠿</span>）就能改顺序，
|
||
拖到别的一栏里就是改分组。改的是<b>你自己那份名册</b>，不影响家里其他人。
|
||
</p>
|
||
<?php endif; ?>
|
||
|
||
<form class="search" method="get" action="index.php">
|
||
<input type="hidden" name="r" value="people">
|
||
<input class="input" name="q" value="<?= e($q) ?>" placeholder="按姓名、称呼或邮箱搜索">
|
||
<button class="btn btn-ghost btn-sm" type="submit">搜索</button>
|
||
<?php if ($q !== ''): ?>
|
||
<a class="link-quiet" href="<?= e(url('people')) ?>">清除</a>
|
||
<?php endif; ?>
|
||
</form>
|
||
|
||
<?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 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' : '' ?>"
|
||
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; ?>
|