五项家庭化改造:以个人为中心 · 家谱 · 三种角色 · 附件存储可配置 · 独立页样式

1. 独立页(登录/安装/错误)套上 HTML 骨架 —— 修「首页为什么没有样式」:
   新增 templates/layout-bare.php,View::render 对独立页也走完整 <head> + CSS。
2. 以个人为中心:Kinship::label() 现算称呼、Auth::homeTitle() 出「X的家书」;
   同一批人在不同登录者眼里自动变成公公婆婆 / 岳父岳母(不存一次性称谓)。
3. 附件存储可配置:Storage 门面(local / 阿里云 OSS),库里只存相对键,
   云端失败自动回退本地;设置页可选驱动并填 OSS 参数(照 MovieLog 的方案)。
4. 三种角色:admin / member / guest,访客只读、写操作一律 403;
   accounts.role 枚举扩容,老库靠 Schema::ensure() 自动升级。
5. 家谱:只存相邻两代的边(parent / spouse),其余称呼全部推导 ——
   兄弟姐妹不存边(共同父母 + birth_rank 排行推长子/次女、哥哥/妹妹),
   认不清的人用虚拟人物 is_placeholder 占位,关系天然双向。

顺带修掉本地 e2e 挖出的 8 个线上级 bug(性别写死、长幼方向反、关系方向静默写反、
birth_rank 不从表单取回、隐式可空参数致响应头失效、无文件字段被误判为上传失败、
layout 变量撞车覆盖 $me、世代 0 显示成「下 0 代」)。

验证:kinship 单测 37/0 · HTTP e2e 81/0 · 老库升级专测 14/0 ·
反向验证 11/11(把每个修复改回旧写法,对应断言都会变红)。
This commit is contained in:
2026-09-30 08:13:07 +08:00
parent 8eb19267bc
commit 1669ab48d0
30 changed files with 3034 additions and 161 deletions
+84
View File
@@ -0,0 +1,84 @@
<?php
/**
* 我的家谱:以我为中心,向上向下各三代。
*
* 只做「呈现 + 说清楚推导规则」两件事 —— 关系的录入在成员详情页,
* 因为那里有具体的人,比在一张图上点来点去更好理解。
*/
$gens = $tree['generations'];
$nodes = $tree['nodes'];
$me = $nodes[$meId] ?? null;
// 代数 → 人类说法
$genWord = function (int $level): string {
if ($level === 0) {
return '我这一辈'; // ⚠️ 必须先判 0:它既不 <0 也不在 $down 里,
// 漏判就会显示成「下 0 代」这种没人看得懂的东西
}
if ($level < 0) {
$up = [-3 => '曾祖辈', -2 => '祖辈', -1 => '父母辈'];
return $up[$level] ?? '上 ' . abs($level) . ' 代';
}
$down = [1 => '子女辈', 2 => '孙辈', 3 => '曾孙辈'];
return $down[$level] ?? '下 ' . $level . ' 代';
};
?>
<div class="page-head">
<h1>我的家谱</h1>
<span class="sub">以 <?= e(\App\Auth::name()) ?> 为中心 · 上下各三代</span>
</div>
<?php if (!$nodes || count($nodes) <= 1): ?>
<div class="empty">
<b>还没连上任何亲属关系</b>
到「<?= e($me['name'] ?? '自己') ?>」的资料页,把父母、配偶、子女填进去,
这张家谱就会自动长出来。兄弟姐妹不用单独填 —— 只要你们有同一对父母,就会自动认出来。
</div>
<?php else: ?>
<div class="tree">
<?php foreach ($gens as $level => $ids): ?>
<div class="tree-gen">
<div class="tree-gen-label">
<span class="gname"><?= e($genWord((int)$level)) ?></span>
<span class="gtag"><?= (int)$level === 0 ? '中心' : ((int)$level < 0 ? '上 ' . abs((int)$level) . ' 代' : '下 ' . (int)$level . ' 代') ?></span>
</div>
<div class="tree-row">
<?php foreach ($ids as $id): $n = $nodes[$id]; ?>
<a class="tnode <?= (int)$id === $meId ? 'is-me' : '' ?> <?= $n['ph'] ? 'is-placeholder' : '' ?>"
href="<?= e(url('people/show', ['id' => $n['id']])) ?>"
title="<?= e($n['name'] . ' · ' . $n['label']) ?>">
<span class="tph"><img src="<?= e(avatar_url($n['avatar'])) ?>" alt=""></span>
<span class="tname"><?= e($n['name']) ?></span>
<span class="tlabel"><?= e($n['label']) ?></span>
<?php if ($n['ph']): ?><span class="tph-mark">待确认</span><?php endif; ?>
</a>
<?php endforeach; ?>
</div>
</div>
<?php if ((int)$level !== (int)array_key_last($gens)): ?>
<div class="tree-link"></div>
<?php endif; ?>
<?php endforeach; ?>
</div>
<div class="card card-pad" style="margin-top:24px">
<h2 class="section-title">这张图是怎么来的 <span class="hint">只存两代,其余推导</span></h2>
<p class="small muted" style="margin:0 0 10px">
系统里只记录**相邻两代之间**的关系:谁是谁的父母、谁和谁是配偶。
至于「奶奶是谁」,是顺着「我的父亲 → 我父亲的母亲」两级边推出来的。
这样每条关系只需维护一次,同一个人在每个人眼里还会自动变成不同的称呼。
</p>
<p class="small muted" style="margin:0">
兄弟姐妹也不单独存档 —— 只要你们有同一对父母,系统就会把你们认成一家人,
并按排行显示成哥哥/姐姐/弟弟/妹妹、长子/次女。
</p>
</div>
<div class="btn-row">
<a class="btn btn-ghost" href="<?= e(url('people/show', ['id' => $meId])) ?>">补充我的亲属关系</a>
<a class="btn btn-ghost" href="<?= e(url('people')) ?>">看整个名册</a>
</div>
<?php endif; ?>