laoyang/FamilyBook
1
0
Fork 0
Code Issues 29 Pull Requests Actions Packages Projects Releases Wiki Activity

v14: 观影/家谱/日程/旅程/资源/任务六模块统一，首页改 dashboard

Browse Source 
用户 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:
laoyang
2026-10-02 09:28:07 +08:00
parent 7f00d3e553
commit 71a7ec35a0
42 changed files with 6770 additions and 201 deletions
Download Patch File Download Diff File Expand all files Collapse all files
templates/home.php
+115 -90
View File
@@ -1,35 +1,22 @@
<?php
/**
* 首页 —— 以「我」为中心。
* 首页 —— 一块 dashboard（用户 2026-10-01 第 13 条）。
*
* 同一份数据，爸爸登进来看到的是「我的父亲/我的儿子」，
* 爱人登进来看到的是同一批人，称呼却变成「公公/婆婆」。
* 称呼全部由 Kinship 现算、由 Nickname 决定"我叫他什么"，库里不存任何一次性称谓。
* 现在首页只回答三个问题：**最近有什么事**、**手头在做什么**、**往年这时候我们在干嘛**。
* · 接下来的日子（两个月内的生日）
* · 未来七天的日程（自定义 + 观影 + 旅行 + 有截止时间的任务，一次汇总）
* · 进行中的任务（含已过期的待办）
* · 往年今日（往年的这一天看过的电影 / 走过的旅程）
*
* ⚠️ 标题下的那句个人口号已按用户要求撤掉（v8）：
* hero 区只留标题与三个统计，不再读 slogan / motto。
* ⚠️ **家人卡片已经不在首页了**（用户明确要求）：看人去「名册」、看关系去「家谱」，
* 首页留给"今天该关心什么"。统计数字仍在，因为那是唯一的全局概览。
*
* ⚠️ 标题下的那句个人口号已按用户要求撤掉（v8）：hero 区只留标题与三个统计。
*/
$kinCount = count($kin);
$hasRel = $relCount > 0;
// 显示名一律走「我怎么称呼他」：同一个孩子，爸爸看到"儿子"、妈妈看到"小宝"。
// ⚠️ 用**已经取好的那张表**（target_id => 我叫他什么）做本地查表，
// 不要再对每个人调一次 Nickname::display() —— 那是每人一条 SQL。
// 没有称呼的人回落到姓名，所以永远不会出现空白名字。
$shownOf = function (array $row) use ($myNicknames): string {
$nk = (string)($myNicknames[(int)($row['id'] ?? 0)] ?? '');
return $nk !== '' ? $nk : (string)($row['name'] ?? '');
};
// 有亲属关系 → 只显示家人；还没建 → 退回显示全名册，别让首页空着
$list = $hasRel ? $kin : [];
if (!$list) {
foreach (\App\Person::all((int)\App\Auth::familyId(), '', 'member', (int)$meId) as $p) {
$p['label'] = '';
$list[(int)$p['id']] = $p;
}
}
// 生日事件上用简称，卡片才不会一行塞不下；长名字在详情页里出
$shortKind = ['id' => '身份证生日', 'solar' => '阳历生日', 'lunar' => '农历生日'];
$today = date('Y-m-d');
?>
<section class="hero">
<img class="hero-logo" src="<?= e(asset('/assets/icons/icon-192.png')) ?>" alt="">
@@ -41,11 +28,26 @@ $shortKind = ['id' => '身份证生日', 'solar' => '阳历生日', 'lunar' => '
<div class="stat"><b><?= (int)$allCount ?></b><span>名册总数</span></div>
<div class="stat"><b><?= (int)$relCount ?></b><span>亲属连线</span></div>
</div>
<?php /* ⚠️ 这两个链接必须带上真实的 person id：曾经 layout.php 里写
`$me = Auth::check()` 把模板里的 $me 覆盖成布尔值，链接就变成 id=0
（"补充亲属关系"点进去是空白页）。所以这里显式用 $meId。 */ ?>
<div class="hero-actions">
<a class="btn btn-ghost btn-sm" href="<?= e(url('people/show', ['id' => (int)$meId])) ?>">我的资料</a>
<a class="btn btn-ghost btn-sm" href="<?= e(url('kin')) ?>">我的家谱</a>
<a class="btn btn-ghost btn-sm" href="<?= e(url('people')) ?>">名册</a>
</div>
</section>
<?php if ($birthdays): ?>
<section class="section">
<?php /* ==================== 接下来的日子 ==================== */
/* ⚠️ 即使近两个月没人过生日，这一块也**照常渲染**（给空态），只是内容为空。
理由：dashboard 的四块是"每天要看的东西"，某一块忽然整块消失会让人以为
功能坏了 / 数据丢了（旧版就是 `if ($birthdays)` 一省略了之）。
空态还能顺带告诉用户"系统在盯着生日，只是最近没有"。 */ ?>
<section class="section">
<h2 class="section-title">接下来的日子 <span class="hint">两个月内</span></h2>
<?php if (!$birthdays): ?>
<div class="card card-pad empty"><b>近两个月没有人过生日</b>等到了月份，这里会自动冒出来。</div>
<?php else: ?>
<div class="bdays">
<?php foreach ($birthdays as $b): ?>
<?php
@@ -85,79 +87,102 @@ $shortKind = ['id' => '身份证生日', 'solar' => '阳历生日', 'lunar' => '
</a>
<?php endforeach; ?>
</div>
<?php endif; ?>
</section>
<?php endif; ?>
<?php /* ==================== 日程（未来七天） ==================== */ ?>
<section class="section">
<div class="page-head" style="margin-bottom:12px">
<h1 style="font-size:15px"><?= $hasRel ? '我的家人' : '家庭成员' ?></h1>
<h1 style="font-size:15px">未来七天 <span class="sub">日程 · 观影 · 旅行 · 到期任务</span></h1>
<div class="actions">
<a class="btn btn-ghost btn-sm" href="<?= e(url('kin')) ?>">我的家谱</a>
<?php if ($me): ?>
<a class="btn btn-ghost btn-sm" href="<?= e(url('people/show', ['id' => (int)$me['id']])) ?>">补充亲属关系</a>
<?php endif; ?>
<a class="btn btn-ghost btn-sm" href="<?= e(url('calendar')) ?>">看整月</a>
</div>
</div>
<?php if (!$hasRel): ?>
<div class="empty">
<b>先把家人连起来</b>
目前还没有任何亲属关系，所以下面显示的是整个名册。<br>
到自己的资料页填上「谁是我的父母、配偶、子女」，之后这一页就只显示跟你有关的人，
每个人的称呼也会按你的视角来算。
<?php if ($me): ?>
<div class="btn-row" style="justify-content:center">
<a class="btn" href="<?= e(url('people/show', ['id' => (int)$me['id']])) ?>">开始连关系</a>
</div>
<?php endif; ?>
</div>
<?php endif; ?>
<?php if (!$list): ?>
<div class="empty">
<b>名册还是空的</b>
先把家里人加进来，之后他们就能出现在每一条记录里。
<div class="btn-row" style="justify-content:center">
<a class="btn" href="<?= e(url('people/new')) ?>">添加成员</a>
</div>
</div>
<?php if (!$soon): ?>
<div class="card card-pad empty"><b>这七天还没有安排</b>有事先记一笔，日后再翻才有得看。</div>
<?php else: ?>
<div class="people-grid">
<?php foreach ($list as $p): ?>
<?php
// ⚠️ 这里必须用「我给他起的称呼」，不能直接用姓名：
// 同一个「杨父」，儿媳妇看到的是"公公大人"、儿子看到的是"爸"。
$pshow = $shownOf($p);
$pIsMe = (int)$p['id'] === (int)$meId;
?>
<a class="person" href="<?= e(url('people/show', ['id' => (int)$p['id']])) ?>">
<div class="ph"><img src="<?= e(avatar_url($p['avatar'] ?? '')) ?>" alt=""></div>
<div class="pb">
<div class="pname">
<?= e($pshow) ?>
<?php if ($pIsMe): ?><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'])): ?>
<span class="rel-label"><?= e($p['label']) ?></span>
<div class="card card-pad">
<ul class="dash-list">
<?php foreach ($soon as $ev): ?>
<li class="dash-row">
<span class="dash-dot" style="background: <?= e((string)$ev['color']) ?>;"></span>
<span class="dash-when">
<?= e((string)$ev['date'] === $today ? '今天' : substr((string)$ev['date'], 5)) ?>
<?php if (($ev['time'] ?? '') !== ''): ?><b><?= e((string)$ev['time']) ?></b><?php endif; ?>
</span>
<a class="dash-what" href="<?= e((string)$ev['href']) ?>"><?= e((string)$ev['title']) ?></a>
<span class="dash-tag"><?= e((string)$ev['calname']) ?></span>
</li>
<?php endforeach; ?>
</ul>
</div>
<?php endif; ?>
</section>
<?php /* ==================== 进行中的任务 ==================== */ ?>
<section class="section">
<div class="page-head" style="margin-bottom:12px">
<h1 style="font-size:15px">手头在做 <span class="sub">进行中 · 已逾期</span></h1>
<div class="actions">
<a class="btn btn-ghost btn-sm" href="<?= e(url('tasks')) ?>">任务看板</a>
</div>
</div>
<?php if (!$tasks): ?>
<div class="card card-pad empty"><b>没有进行中的任务</b>也没有逾期的事，挺好。</div>
<?php else: ?>
<div class="card card-pad">
<ul class="dash-list">
<?php foreach ($tasks as $t): ?>
<?php $late = \App\Task::isOverdue($t['due_at'] ?? null); ?>
<li class="dash-row">
<span class="dash-dot" style="background: <?= e($late ? 'var(--red)' : 'var(--brand)') ?>;"></span>
<span class="dash-when">
<?php if (($t['due_at'] ?? '') !== ''): ?>
<?= e(\App\Task::dueWord($t['due_at'] ?? null)) ?>
<?php else: ?>
进行中
<?php endif; ?>
<?php
$role = $p['account_role'] ?? '';
if ($role === 'admin' && ($p['account_status'] ?? '') === 'active') {
echo '<span class="badge badge-admin">管理员</span>';
} elseif ($role === 'guest') {
echo '<span class="badge">访客</span>';
} elseif (!empty($p['account_id'])) {
echo '<span class="badge badge-open">已开通</span>';
}
$age = age_from(\App\Birthday::solarOf($p));
if ($age !== null) { echo ' · ' . (int)$age . ' 岁'; }
?>
</div>
</div>
</a>
<?php endforeach; ?>
</span>
<a class="dash-what" href="<?= e(url('tasks/show', ['id' => (int)$t['id']])) ?>">
<?= e((string)$t['title']) ?>
</a>
<?php if ((int)($t['child_total'] ?? 0) > 0): ?>
<span class="dash-tag"><?= (int)$t['child_done'] ?>/<?= (int)$t['child_total'] ?></span>
<?php endif; ?>
</li>
<?php endforeach; ?>
</ul>
</div>
<?php endif; ?>
</section>
<?php /* ==================== 往年今日 ==================== */ ?>
<section class="section">
<div class="page-head" style="margin-bottom:12px">
<h1 style="font-size:15px">
<?= !empty($memories['exact']) ? '往年今日' : '往年这个月' ?>
<span class="sub"><?= e(date('n 月 j 日')) ?></span>
</h1>
</div>
<?php if (empty($memories['rows'])): ?>
<div class="card card-pad empty">
<b><?= !empty($memories['exact']) ? '往年的这一天还没有记录' : '往年的这个月还没有记录' ?></b>
日子还长，等有了第一次，明年这时候就会自己冒出来。
</div>
<?php else: ?>
<div class="card card-pad">
<ul class="dash-list">
<?php foreach ($memories['rows'] as $mm): ?>
<li class="dash-row">
<span class="dash-dot" style="background: <?= $mm['kind'] === 'trip' ? '#3F7D5A' : '#7A4E8C' ?>;"></span>
<span class="dash-when"><?= (int)$mm['years_ago'] ?> 年前</span>
<a class="dash-what" href="<?= e((string)$mm['href']) ?>">
<?= $mm['kind'] === 'trip' ? '🧳 ' : '🎬 ' ?><?= e((string)$mm['title']) ?>
</a>
<span class="dash-tag"><?= e(substr((string)$mm['starts_at'], 0, 10)) ?></span>
</li>
<?php endforeach; ?>
</ul>
</div>
<?php endif; ?>
</section>