图片可裁剪 · 名册按关系分组 · 个人设置独立 · 顶栏下拉菜单

① 上传图片一律可裁剪,比例由图位决定
   新增 app/ImageSlot.php 统一配置(头像 1:1/512×512;题图 16:9 只留注释,
   将来启用只加一行)。前端只挑区域、写回归一化矩形 "x,y,w,h",真正裁剪在服务端
   Upload::fitRegion():夹回图内 → 在框内居中收缩到目标比例(不外扩)→ 钉住 sx+sw ≤ w。
   比例解析单独写 parseRatioAttr():parseFloat('16:9') 得 16,会把题图裁成细长条且不报错。

② 名册按关系分组,顺序每人可自定
   分类全家共用(person_groups,另一个人可以自己加分类);「自己的」只体现在顺序上
   (user_settings.group_order,每人一份)。persons.group_id 故意不加外键(老库只能
   ADD COLUMN),完整性由 PersonGroup 保证:删分类把人置回未分类,人不会从名册消失。

③ 设置分两级:系统设置 / 个人设置
   个人设置拆成 templates/settings/me.php + _profile.php + _nicknames.php,
   取代 templates/people/me.php(旧路由与旧表单仍兼容)。

④ 右上角「姓名/头像 + 下拉菜单」
   原来是两个裸链接,窄屏会被 CSS 藏掉导致改密码/退出不可达;改成 <details> 零 JS 菜单
   (app.js 只补「点外面 / Esc」)。菜单项:个人设置 / 系统设置(管理员)/ 修改密码 / 退出登录。

Schema 版本 3 → 4;安装与老库升级共用 PersonGroup::backfillMissing() 一条回填路径。

验证:php -l 全量;e2e 202/0(新增「关系分组」与「图片裁剪」两节);老库升级 49/0;
桌面几何 108/0;移动端几何 192/0(360/375/390/414);交互 76/0;
反向验证 31/31(逐条把修复改回旧写法,指定的目标断言必须变红);
部署后本地↔线上 72 个文件 sha256 逐字节一致。
This commit is contained in:
2026-09-30 11:06:22 +08:00
parent 7e9b4520c0
commit 1c460a0e83
18 changed files with 1637 additions and 182 deletions
+41
View File
@@ -0,0 +1,41 @@
<?php
/**
* 「我自己的」设置 —— 键值对,挂在 person 上而不是 family 上。
*
* 为什么要有它(而不是复用 settings 表加个 person_id 列):
* `settings` 是**家庭级**的(系统 slogan、附件存储这些,改一次全家变),
* `user_settings` 是**个人级**的(我的分组顺序、以后可能还有我的界面偏好),
* 两者的作用范围完全不同。分开存,"改一个人的偏好"就不可能误伤到全家 ——
* 混在一张表里迟早有人忘了带 family 条件。
*
* 与 App\Setting 的关系:同构(都是 k/v),只是作用域不同。
*/
declare(strict_types=1);
namespace App;
final class UserSetting
{
public static function get(int $personId, string $key, $default = null)
{
if ($personId <= 0) {
return $default;
}
$st = Database::get()->prepare('SELECT v FROM user_settings WHERE person_id = ? AND k = ?');
$st->execute([$personId, $key]);
$v = $st->fetchColumn();
return $v === false ? $default : $v;
}
public static function set(int $personId, string $key, string $value): void
{
if ($personId <= 0) {
return;
}
Database::get()->prepare(
'INSERT INTO user_settings (person_id, k, v) VALUES (?, ?, ?)
ON DUPLICATE KEY UPDATE v = VALUES(v)'
)->execute([$personId, $key, $value]);
}
}