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

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
+99
View File
@@ -0,0 +1,99 @@
<?php
/**
* 本地磁盘驱动 —— 也是云端失败时的**回退目标**。
* 绝不因为云配置出问题就让用户丢文件。
*/
declare(strict_types=1);
namespace App\Storage;
final class LocalDriver implements StorageDriver
{
private string $root;
public function __construct(string $root)
{
$this->root = rtrim($root, '/');
}
public function id(): string
{
return 'local';
}
public function validateConfig(): string
{
return is_dir($this->root) || @mkdir($this->root, 0755, true)
? ''
: '本地存储目录不可写';
}
private function abs(string $key): string
{
// 挡目录穿越:.. 一律拒绝
$key = ltrim(str_replace('\\', '/', $key), '/');
if (strpos($key, '..') !== false) {
return $this->root . '/__invalid__';
}
return $this->root . '/' . $key;
}
public function putFile(string $srcPath, string $key, ?string $mime = null): array
{
$dst = $this->abs($key);
$dir = dirname($dst);
if (!is_dir($dir) && !@mkdir($dir, 0755, true)) {
return ['ok' => false, 'error' => '建不了目录:' . $dir];
}
if (!@copy($srcPath, $dst)) {
return ['ok' => false, 'error' => '复制文件失败'];
}
@chmod($dst, 0644);
return ['ok' => true, 'error' => ''];
}
public function putContents(string $binary, string $key, ?string $mime = null): array
{
$dst = $this->abs($key);
$dir = dirname($dst);
if (!is_dir($dir) && !@mkdir($dir, 0755, true)) {
return ['ok' => false, 'error' => '建不了目录:' . $dir];
}
if (@file_put_contents($dst, $binary) === false) {
return ['ok' => false, 'error' => '写入文件失败'];
}
@chmod($dst, 0644);
return ['ok' => true, 'error' => ''];
}
public function delete(string $key): array
{
$p = $this->abs($key);
if (is_file($p) && !@unlink($p)) {
return ['ok' => false, 'error' => '删不掉:' . $key];
}
return ['ok' => true, 'error' => ''];
}
public function get(string $key, array $extra = []): array
{
$p = $this->abs($key);
if (!is_file($p)) {
return ['ok' => false, 'status' => 404, 'headers' => [], 'body' => '', 'error' => '文件不存在'];
}
$body = (string)@file_get_contents($p);
return ['ok' => true, 'status' => 200, 'headers' => [], 'body' => $body, 'error' => ''];
}
public function exists(string $key): bool
{
return is_file($this->abs($key));
}
/** 本地文件返回站点相对路径(相对站点根,前面带 /) */
public function url(string $key): string
{
return '/' . ltrim(str_replace('\\', '/', $key), '/');
}
}