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

v24 第 15 批：活动 / 旅程两级语义（术语 · 派生时间城市 · 表单三项 · 题图可点）

Browse Source 
用户原话四条，逐条落地：

1. 「旅程模块，按钮是记一次活动，而不是记一趟旅程。旅程是活动里面的概念。」
   → 顶层一律改称**活动**：按钮「记一次活动」、页标题「活动」、`N 次` / `N 段旅程`；
     活动详情三组改叫「计划的旅程 / 走过的旅程 / 没成行的」；
     节点表单「这段旅程叫什么」「阶段」；flash 文案 17 处同步。
     （导航条仍叫「旅程」——用户就是这么称呼这个模块，列表页加副标题说清两级关系。）

2. 「活动不需要开始和结束时间，是根据活动中的旅程，最早的旅程开始时间，和最晚的
     旅程结束时间，计算出来的。目的地也不需要…去的城市，也是根据旅程，得到的。」
   → 活动**不再存**这三样，全部**读时算出来**：
     · Trip::derived()      最早开始 / 最晚结束 / 城市去重
     · Trip::cities()       按最早出现时间排（先后顺序本身是信息，不是字母序）
     · Trip::attachDerived() 列表页批量补（避免 N+1）
     · Trip::activitySpan()  没有旅程时说「还没有旅程」，不用「日期待补」
     create/update 不再写 events 的起止与地点（老值保留不动，页面不读）。
     列表排序/搜索、首页「最近去了」改走子查询。

3. 「题图那里，没有办法上传图片，点击哪里都没反应。」——**真 bug**
   「点图 = 开文件框」那句 JS 只写在 people/form.php 的内页脚本里（头像专用）；
   第 14 批加的旅程题图与图书封面照抄了同一套 DOM 却没有对应的 JS，
   于是图块有 cursor:pointer 与 hover 高亮（看着能点），点下去毫无反应。
   → 做成声明式通用绑定：图上写 data-pick-input="#fileInputId"，
     app.js 统一接管（一个页面多个也各绑各的），并删掉旧的那份专用实现。
     三处（头像 / 题图 / 图书封面）全挂上。

4. 「添加活动的页面，顺序是这样的：添加标题，上传并裁剪题图，然后一段简介，就可以了。」
   → 主区就这三项，顺序照原话；时间/城市不做输入项（只留一句说明它们从哪来，
     不说清用户会满页找"怎么没地方填时间"）。
     备注 / 公开 / 同行的人收进「更多设置」折叠区——功能一个没丢。

顺带修掉两处会炸的实现问题：
· ORDER BY 引用聚合别名（first_at）在 MariaDB/MySQL 报 1247，且只在运行时炸、
  php -l 看不出 → 改成 ORDER BY MIN(starts_at)，否则整个旅程模块 Fatal。
· e2e 里"详情页显示了派生时间"原本写成整页查找，下面每段旅程自己也渲染日期，
  于是把派生值塞成 null 也照样绿（借光假绿）→ 判据收进页头那一段。

验证：e2e 845/0（+15 条本批断言）· 升级 134/0 · 桌面几何 428/0 · 移动几何 688/0 ·
交互 92/0 · 题图真机点击 4/0 · 读书窄屏 15/0 · 家谱 34/0 + 10/0 + 反向 3/3 ·
观影按钮 60/0 + 反向 3/3 · 本批反向验证 4/4（题图绑定抽掉→红、派生值不挂→红、
城市退回读 location→红、时间字段加回表单→红）· 部署静态断言新增两组（含"活动不许
再写起止时间/目的地"与"ORDER BY 不许引用聚合别名"的反退化防线）。
部署后服务器自检 19/19，五个关键文件 md5 与线上逐一核对一致。
This commit is contained in:
laoyang
2026-10-05 10:58:17 +08:00
parent 89b956205d
commit 7138314dc7
30 changed files with 4177 additions and 290 deletions
Download Patch File Download Diff File Expand all files Collapse all files
templates/books/notes_import.php
+138
View File
@@ -0,0 +1,138 @@
<?php
/**
* 导入读书笔记（v24 第 14 批 用户第 5 条：「可以导入微信读书等各种读书软件的读书笔记」）。
*
* 三步：**粘贴 → 预览 → 落库**。
* 中间那步不能省（原因见 index.php 的 books/notes_import 注释）：解析是宽容的，
* 认错了会造出"未命名的一本"，让人看见再点确认，比事后删书体面得多。
*
* @param string $raw 上一次粘贴的原文（预览时回显）
* @param array $parsed BookNoteImport::parse() 的结果
* @param string $source 来源标记（weread / douban / other）
*/
$parsed = $parsed ?? [];
$raw = (string)($raw ?? '');
$source = (string)($source ?? 'weread');
$step = $parsed ? 'preview' : 'paste';
$total = 0;
foreach ($parsed as $b) {
$total += count($b['notes'] ?? []);
}
?>
<div class="page-head">
<h1>导入读书笔记</h1>
<span class="sub">从微信读书、豆瓣等 App 复制出来的，直接粘进来</span>
<div class="actions">
<a class="btn btn-ghost" href="<?= e(url('books')) ?>">返回书架</a>
<?php $bkSetCurrent = 'import'; require __DIR__ . '/_settings_menu.php'; ?>
</div>
</div>
<?php if ($step === 'paste'): ?>
<div class="card card-pad">
<form method="post" action="<?= e(url('books/notes_import')) ?>">
<?= csrf_field() ?>
<div class="field full">
<label for="imp-raw">把笔记粘在这里</label>
<textarea class="input" id="imp-raw" name="raw" rows="16" required
placeholder="## 活着（余华）&#10;◆ 第一章&#10;> 人是为活着本身而活着的。&#10;>> 这一段我读了三遍。"><?= e($raw) ?></textarea>
<span class="tip">
认得这些写法：书名用 <code>## 书名</code> 或 <code>《书名》</code>；
章节用 <code>◆</code>／<code>●</code> 开头；划线用 <code>&gt;</code> 开头；
想法用 <code>&gt;&gt;</code> 开头；作者可以写 <code>作者：余华</code>。
认不出的行会按上下文归类 —— 宁可归类得不完美，也不丢字。
</span>
</div>
<div class="field">
<label for="imp-src">这些笔记来自</label>
<select class="select" id="imp-src" name="source">
<?php foreach (['weread' => '微信读书', 'douban' => '豆瓣读书', 'other' => '其它 App'] as $k => $v): ?>
<option value="<?= e($k) ?>" <?= $source === $k ? 'selected' : '' ?>><?= e($v) ?></option>
<?php endforeach; ?>
</select>
<span class="tip">只是个标记，笔记旁边会写"来自哪里"。</span>
</div>
<div class="btn-row">
<button class="btn" type="submit">先看看认出了什么</button>
<a class="btn btn-ghost" href="<?= e(url('books')) ?>">取消</a>
</div>
</form>
</div>
<div class="card card-pad">
<h2 class="cinema-h2">怎么从 App 里复制出来</h2>
<ul class="imp-how">
<li><b>微信读书</b>：书里点右上角「…」→「笔记」→ 长按选中 / 全选 → 复制，粘到这里。</li>
<li><b>豆瓣读书</b>：我读过的书 → 某本书的"读书笔记"页 → 选中复制。</li>
<li><b>其它</b>：只要文本里有书名行，大多能认出来；认错了下面会先给你看。</li>
</ul>
<p class="small muted">
导入时按书名匹配书架上已有的书 —— 匹配上就挂到那本书下面，
匹配不上才新建一本（并标成"读完"）。
</p>
</div>
<?php else: ?>
<?php /* ==================== 预览：让用户在落库之前看见结果 ==================== */ ?>
<div class="card card-pad">
<h2 class="cinema-h2">
认出了 <?= count($parsed) ?> 本书、<?= $total ?> 条笔记
<span class="hint">看一眼再导，别急着确认</span>
</h2>
<?php if ($total === 0): ?>
<p class="empty-hint">
一段笔记都没认出来。多半是没贴到内容，或者全贴成了空行 —— 退回去重新粘一次。
</p>
<div class="btn-row"><a class="btn btn-ghost" href="<?= e(url('books/notes_import')) ?>">重新粘贴</a></div>
<?php else: ?>
<ul class="imp-list">
<?php foreach ($parsed as $i => $b): ?>
<?php $ns = $b['notes'] ?? []; ?>
<li class="imp-book">
<div class="imp-bh">
<span class="imp-t"><?= e((string)$b['title']) ?></span>
<?php if (!empty($b['author'])): ?>
<span class="small muted"><?= e((string)$b['author']) ?></span>
<?php endif; ?>
<span class="imp-n"><?= count($ns) ?> 条</span>
</div>
<?php if ($ns): ?>
<ul class="imp-notes">
<?php foreach (array_slice($ns, 0, 3) as $n): ?>
<li class="is-<?= e((string)($n['kind'] ?? 'note')) ?>">
<span class="bn-kind"><?= e(\App\Book::kindWord((string)($n['kind'] ?? 'note'))) ?></span>
<?php if (!empty($n['chapter'])): ?>
<span class="bn-ch"><?= e((string)$n['chapter']) ?></span>
<?php endif; ?>
<span class="imp-txt"><?= e(mb_substr((string)$n['content'], 0, 120, 'UTF-8')) ?></span>
</li>
<?php endforeach; ?>
</ul>
<?php if (count($ns) > 3): ?>
<p class="small muted">…还有 <?= count($ns) - 3 ?> 条，导入时一起进。</p>
<?php endif; ?>
<?php else: ?>
<p class="small muted">这本书下面没认到笔记，导入时会跳过。</p>
<?php endif; ?>
</li>
<?php endforeach; ?>
</ul>
<?php /* ⚠️ 这里回传的是**原文**，不是解析结果 —— 落库那一步会重新解析一遍
（表单可以改，信"解析结果"就是让人往库里塞任意结构）。 */ ?>
<form method="post" action="<?= e(url('books/notes_import_save')) ?>" class="imp-confirm">
<?= csrf_field() ?>
<input type="hidden" name="raw" value="<?= e($raw) ?>">
<input type="hidden" name="source" value="<?= e($source) ?>">
<div class="btn-row">
<button class="btn" type="submit">就按这个导入</button>
<a class="btn btn-ghost" href="<?= e(url('books/notes_import')) ?>">重新粘贴</a>
</div>
</form>
<?php endif; ?>
</div>
<?php endif; ?>