v14: 观影/家谱/日程/旅程/资源/任务六模块统一，首页改 dashboard
用户 14 条需求一次交付（1-13 功能 + 14 工作方式）。 观影（1-4） - 返回文案全模块统一为「返回观影」（不再有「返回列表」「返回观影记录」三种叫法） - 观影人一律用彩色人物标签 person_chip：底色由头像主色算出来（上传时存库）， 瀑布流卡片也按人显示；五处观影模板全部改用它 - 人员显示统一走 person_name()（shown → 我给他起的称呼 → 姓名） - 影院管理页与年度报告页的上下两块用 .card + .card 统一给间距（原来紧贴成一整块） 家谱（5） - 树根从「我」换成**辈分最高的祖先**：库画的是"树根的祖先链+后代+树根的兄弟姐妹"， 根=我 时伯父/堂兄/嫂子/侄子一个都不画（12 人夹具只画出 8 人） - focusMap 按**代数**圈定三代（不再按步数），normalizeLinks 把子女对称挂到父母双方 —— 修掉"母亲登录看不到孩子" - 新增「看全部 / 回到我」两个按钮，放在画布外（画布整块被库接管了手势） 统一事件原语（6-9） - 旅程：TripLog 全量迁入（3 趟旅程 / 21 段行程 / 72 张照片 / 5 个人）。 复用 events(kind='trip') + trip_details + trip_nodes（计划/执行双轨保留） - 日程：每人可建日历本（自定义色）+ 共享只读/可写；观影与旅行是每人默认两本， 内容是**从各模块实时派生**的（不复制，所以改了观影日期日历立刻跟着变）； 没有具体时分 = 全天；月视图参照群晖 Calendar - 资源：挂在某人名下的附属信息（标题+正文+多附件），可共享给多人并设只读/读写， 默认折叠、可搜标题与正文 - 任务：看板三列 + 两级子任务 + 评论@人 + 共享 + 循环（完成时按原截止日推下一期） - 统一附件表：四个模块的附件共用一张，下载地址不落库、一律由 media.php 现算 模块化（10-11） - App\Module 是模块的唯一来源（加一行 = 导航条/主题色/个人设置三处自动出现） - 个人设置里可勾选要显示哪些模块、拖动排序（关掉的模块**不会**被兜底补回来） - 每个模块一套主题色（家庭级），只覆盖 --brand 三兄弟，不碰纸墨底色 其他（12-13） - 新增成员表单可选所属分组（编辑表单没有：分组是"我和他的关系"，只归我自己） - 首页改 dashboard：接下来的日子 / 未来七天 / 手头在做 / 往年今日。 家人卡片从首页撤走（看人去名册） 验证（全部通过） - e2e 542 条（新增 4 模块端到端 60+ 条） - 桌面几何 368 / 移动端几何 520 / 家谱 12 / 交互 97 / 老库升级 123 - SQL 列名静态校验 0 处可疑（对着真实表结构） - 反向验证 18 条新注入全部抓住 顺带修掉的既有问题 - 老库升级回填 SQL 按实际存在的列动态拼（缺列不再 1054 炸断升级） - 全新安装时 Schema::ensure 跑在"人还没建"之前 → 补建日历本三处齐备 - 窄屏导航横向溢出（模块从 4 个加到 8 个后顶栏撑破视口）
This commit is contained in:
@@ -0,0 +1,202 @@
|
||||
<?php
|
||||
/**
|
||||
* 资源（v12，用户 2026-10-01 第 8 条）：挂在**某个人名下**的附属信息。
|
||||
*
|
||||
* 形态：标题 + 一段文字 + 多个附件（证件扫描件、一寸照片、合同…）。
|
||||
* 访问：名下的人自己当然能看能改；另外可以**共享给多人**，各设只读 / 读写。
|
||||
*
|
||||
* 两条关键设计：
|
||||
* ① **共享表里不含 owner**（`resource_shares` 只记"额外被共享的人"）——
|
||||
* 不然同一个人在两张表里各有一条，权限要取并集，改一处忘一处就会
|
||||
* "本人反而看不了自己的东西"。
|
||||
* ② **默认折叠**：一屏列出几十条正文会很长，列表只露标题行，点开才看正文与附件。
|
||||
* 折叠用原生 <details>，没有 JS 也能开合（app.js 不依赖它）。
|
||||
*
|
||||
* ⚠️ 与「名册」的分工：名册记录的是**这个人是谁**（生日、电话、关系）；
|
||||
* 资源记录的是**这个人名下有什么东西**（证书、账号、照片）。不要混。
|
||||
*/
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace App;
|
||||
|
||||
final class Resource
|
||||
{
|
||||
/** 资源的宿主类型（附件表用） */
|
||||
public const ATTACH = 'resource';
|
||||
|
||||
/**
|
||||
* 我能看到的资源 = 我名下的 + 别人共享给我的。
|
||||
*
|
||||
* 返回的行里带 `perm`：'owner' / 'write' / 'read'（模板据此决定能不能改）。
|
||||
*
|
||||
* @param int $personId 看的人（决定"我能看什么"）
|
||||
* @param int $ownerId 0=不限归属；非 0=只看这个人（且必须是我能看到的）
|
||||
* @param string $keyword 标题 + 正文里搜
|
||||
*/
|
||||
public static function all(int $familyId, int $personId, int $ownerId = 0, string $keyword = ''): array
|
||||
{
|
||||
$sql = 'SELECT r.*, p.name AS owner_name, p.avatar, p.avatar_color,
|
||||
n.nickname AS owner_nick,
|
||||
CASE WHEN r.owner_id = ? THEN "owner"
|
||||
ELSE COALESCE((SELECT s.perm FROM resource_shares s
|
||||
WHERE s.resource_id = r.id AND s.person_id = ?), "read")
|
||||
END AS perm
|
||||
FROM resources r
|
||||
JOIN persons p ON p.id = r.owner_id
|
||||
LEFT JOIN nicknames n ON n.target_id = r.owner_id AND n.viewer_id = ?
|
||||
LEFT JOIN resource_shares sh ON sh.resource_id = r.id AND sh.person_id = ?
|
||||
WHERE r.family_id = ? AND (r.owner_id = ? OR sh.person_id IS NOT NULL)';
|
||||
$bind = [$personId, $personId, $personId, $personId, $familyId, $personId];
|
||||
if ($ownerId > 0) {
|
||||
$sql .= ' AND r.owner_id = ?';
|
||||
$bind[] = $ownerId;
|
||||
}
|
||||
$kw = trim($keyword);
|
||||
if ($kw !== '') {
|
||||
$sql .= ' AND (r.title LIKE ? OR r.content LIKE ?)';
|
||||
$like = '%' . $kw . '%';
|
||||
array_push($bind, $like, $like);
|
||||
}
|
||||
$sql .= ' ORDER BY r.updated_at DESC, r.id DESC';
|
||||
$st = Database::get()->prepare($sql);
|
||||
$st->execute($bind);
|
||||
return $st->fetchAll();
|
||||
}
|
||||
|
||||
/** 一条资源（带归属人与我对它的权限；看不到返回 null） */
|
||||
public static function find(int $familyId, int $id, int $personId): ?array
|
||||
{
|
||||
$st = Database::get()->prepare(
|
||||
'SELECT r.*, p.name AS owner_name, p.avatar, p.avatar_color,
|
||||
n.nickname AS owner_nick,
|
||||
CASE WHEN r.owner_id = ? THEN "owner"
|
||||
ELSE COALESCE((SELECT s.perm FROM resource_shares s
|
||||
WHERE s.resource_id = r.id AND s.person_id = ?), "read")
|
||||
END AS perm
|
||||
FROM resources r
|
||||
JOIN persons p ON p.id = r.owner_id
|
||||
LEFT JOIN nicknames n ON n.target_id = r.owner_id AND n.viewer_id = ?
|
||||
WHERE r.id = ? AND r.family_id = ?'
|
||||
);
|
||||
$st->execute([$personId, $personId, $personId, $id, $familyId]);
|
||||
$r = $st->fetch();
|
||||
if (!$r) {
|
||||
return null;
|
||||
}
|
||||
// ⚠️ 权限在**这一层**判死：调用方拿到记录就一定是能看的。
|
||||
// 曾经想让模板自己判，结果是每条列表都要重复一遍 CASE WHEN。
|
||||
$mine = (int)$r['owner_id'] === $personId
|
||||
|| self::isShared((int)$r['id'], $personId);
|
||||
if (!$mine) {
|
||||
return null;
|
||||
}
|
||||
return $r;
|
||||
}
|
||||
|
||||
public static function canWrite(array $r, int $personId): bool
|
||||
{
|
||||
if ((int)($r['owner_id'] ?? 0) === $personId) {
|
||||
return true;
|
||||
}
|
||||
return ($r['perm'] ?? '') === 'write';
|
||||
}
|
||||
|
||||
public static function isShared(int $resourceId, int $personId): bool
|
||||
{
|
||||
$st = Database::get()->prepare(
|
||||
'SELECT 1 FROM resource_shares WHERE resource_id = ? AND person_id = ?'
|
||||
);
|
||||
$st->execute([$resourceId, $personId]);
|
||||
return $st->fetchColumn() !== false;
|
||||
}
|
||||
|
||||
/** @return int 新资源 id */
|
||||
public static function create(int $familyId, int $ownerId, ?int $createdBy, array $d): int
|
||||
{
|
||||
$db = Database::get();
|
||||
$db->prepare(
|
||||
'INSERT INTO resources (family_id, owner_id, title, content, created_by) VALUES (?,?,?,?,?)'
|
||||
)->execute([
|
||||
$familyId, $ownerId,
|
||||
self::title($d['title'] ?? ''),
|
||||
self::textOrNull($d['content'] ?? ''),
|
||||
$createdBy ?: null,
|
||||
]);
|
||||
return (int)$db->lastInsertId();
|
||||
}
|
||||
|
||||
public static function update(int $familyId, int $id, array $d): void
|
||||
{
|
||||
Database::get()->prepare(
|
||||
'UPDATE resources SET title = ?, content = ? WHERE id = ? AND family_id = ?'
|
||||
)->execute([
|
||||
self::title($d['title'] ?? ''),
|
||||
self::textOrNull($d['content'] ?? ''),
|
||||
$id, $familyId,
|
||||
]);
|
||||
}
|
||||
|
||||
public static function destroy(int $familyId, int $id): void
|
||||
{
|
||||
// 附件表没有外键（target_type 表达不了），删宿主时自己清存储对象
|
||||
\App\Attachment::removeAll(self::ATTACH, $id);
|
||||
Database::get()->prepare('DELETE FROM resources WHERE id = ? AND family_id = ?')
|
||||
->execute([$id, $familyId]);
|
||||
}
|
||||
|
||||
// ---------------- 共享 ----------------
|
||||
|
||||
public static function shares(int $resourceId): array
|
||||
{
|
||||
$st = Database::get()->prepare(
|
||||
'SELECT s.person_id, s.perm, p.name, p.avatar, p.avatar_color
|
||||
FROM resource_shares s JOIN persons p ON p.id = s.person_id
|
||||
WHERE s.resource_id = ? ORDER BY p.id'
|
||||
);
|
||||
$st->execute([$resourceId]);
|
||||
return $st->fetchAll();
|
||||
}
|
||||
|
||||
/**
|
||||
* 设共享。
|
||||
*
|
||||
* ⚠️ owner 自己**不进**共享表 —— 他本来就有全部权限，
|
||||
* 记进去只是多一条要维护的行（还会让"共享给谁"的列表里冒出自己）。
|
||||
*/
|
||||
public static function setShare(int $resourceId, int $ownerId, int $personId, string $perm): void
|
||||
{
|
||||
if ($personId <= 0 || $personId === $ownerId) {
|
||||
self::dropShare($resourceId, $personId);
|
||||
return;
|
||||
}
|
||||
Database::get()->prepare(
|
||||
'INSERT INTO resource_shares (resource_id, person_id, perm) VALUES (?,?,?)
|
||||
ON DUPLICATE KEY UPDATE perm = VALUES(perm)'
|
||||
)->execute([$resourceId, $personId, $perm === 'write' ? 'write' : 'read']);
|
||||
}
|
||||
|
||||
public static function dropShare(int $resourceId, int $personId): void
|
||||
{
|
||||
Database::get()->prepare('DELETE FROM resource_shares WHERE resource_id = ? AND person_id = ?')
|
||||
->execute([$resourceId, $personId]);
|
||||
}
|
||||
|
||||
public static function permWord(string $perm): string
|
||||
{
|
||||
return $perm === 'owner' ? '本人' : ($perm === 'write' ? '可读写' : '只读');
|
||||
}
|
||||
|
||||
// ---------------- 小工具 ----------------
|
||||
|
||||
private static function title(string $v): string
|
||||
{
|
||||
return mb_substr(trim($v), 0, 120, 'UTF-8');
|
||||
}
|
||||
|
||||
private static function textOrNull(string $v): ?string
|
||||
{
|
||||
$v = trim($v);
|
||||
return $v !== '' ? $v : null;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user