laoyang/TripLog
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
13 Commits 1 Branch 0 Tags
a24099fc53259403c42b96887373a934520113b0
Commit Graph
9 Commits
Author SHA1 Message Date
laoyang a24099fc53 节点详情页：所有附件统一展示，不再把图片和其它附件分开列 
之前照片墙只显示图片，非图片附件只给一句「另有 N 个非图片附件」，要看得再进管理页。
现在全部附件同列在照片与附件区：图片仍是缩略图，视频 / PDF / Word 等按 MIME
显示类型图标（🎬 / 📄 / 📎），和缩略图一样占满 4:3 格子。

点击行为沿用批 7 的灯箱四态：图片 / 视频 / PDF 直接预览（视频可拖进度条、
PDF 内嵌阅读器），预览不了的（Word / ZIP 等）灯箱里给下载按钮。
页头与底部入口文案同步改为「附件 (N) / 管理附件（N）」，
最多展示 12 个，超出给「+N 个」入口进管理页。

已验证：本地全链 11 步全绿（渲染检查 316 项，新增图标格 / 四态标记 /
不再出现「另有」等 8 项断言）；远端 e2e 322 项 0 失败（新增详情页统一展示
专项断言 7 项）；部署后双 PHP 渲染逐字节一致、60 文件哈希一致。
 2026-09-23 17:36:58 +08:00
laoyang cbfdcb9d16 附件：支持视频 / 文档上传，可预览的浏览器直接看，预览不了的给下载 
之前节点附件只能传图片和 PDF（accept 过滤 + 20MB 上限），视频传不上来。
本批放开：MP4 / MOV / PDF / Word / Excel / ZIP 都能作为附件上传，
仍走同一份 Uploads::handleFiles（MIME 白名单三层识别不变），存进已配置的 OSS。

大小分级：照片仍走 photo_max_mb（管理员可调），视频与文档放宽到 40MB
（Uploads::MAX_FILE_BYTES，给线上 post_max_size=50M 留余量），先 detect 再按
is_image 选上限。前端 form.php / attachments.php 同步拦截并按类型细分暂存区图标。

预览走灯箱四类型视图：图片（img）/ 视频（<video>，配合 media/show 新增的
HTTP Range 单区间 206/416，进度条可拖、Safari 也能播）/ PDF（iframe 内嵌
阅读器）/ 其它（Word / ZIP 等浏览器预览不了 → 灯箱里给下载按钮）。
dl=1 下载不接 Range；多区间回退 200 全量。

已验证：本地全链 11 步全绿（渲染检查 308 项、表单交互 73 项）；
远端 e2e 0 失败（新增 mp4 上传落库 video/mp4、Range 206/416/后缀区间/
多区间回退/dl 不接 Range 专项断言）；部署后双 PHP 渲染逐字节一致。
 2026-09-23 16:22:01 +08:00
laoyang c50bc7de2b 活动页：每个节点卡片底部渲染参与人（头像 + 名字） 
之前节点卡片上只有「👥 N」计数，要看是谁参加得点进节点详情。
现在卡片底部直接列出参与人：头像（缺头像用首字母兜底）+ 名字，
有心情顺带一个小 emoji；点任一人跳到该节点的参与区。
数据侧 Members::forNodes() 一条 IN 查询带回全部节点的参与人
（与 attachCounts 同样的防 N+1 思路），计划列与执行列共用。
无参与人的节点不渲染这一行。

已验证：本地全链 11 步全绿（渲染检查 292 项、表单交互 73 项）；
远端 e2e 299 项 0 失败（新增活动页卡片参与人行专项断言）；
部署后双 PHP 渲染逐字节一致、60 文件哈希一致。
 2026-09-23 15:18:25 +08:00
laoyang 48237c8947 节点详情：照片灯箱浏览、参与人点击编辑、花销只记总计 
1) 照片与附件不再新开窗口看
   之前点缩略图直接 target=_blank 打开原始文件，看完还得切回来。
   现在统一走当前页灯箱（templates/_lightbox.php，详情页照片墙与
   照片管理页共用）：左右箭头 / 键盘 ←→ / 手机滑动切上一张下一张，
   Esc 或点背景关闭，带「第几张 / 共几张」计数并预加载相邻两张。
   非图片附件（PDF 等）仍保留直接打开与下载。

2) 参与人可以直接改了
   之前加完只能移出重加。现在每个参与人旁有「编辑」，点开预填弹窗
   （角色标签 / 心情 / 签到时间），保存仍走 members/store ——
   Members::save() 本来就是 upsert（同节点同人一条），服务端零改动。
   失败回填按 user_id 精确匹配，只回填刚才没保存成的那个人。

3) 花销去掉预算，只记真实花费
   明细上移，底部一行「总计（N 笔）¥X」。表单不再有「预算」选项，
   查询一律 is_budget=0（历史预算行不再出现在列表与合计里）；
   活动页统计同步改成「共 N 笔 · 总计」。列保留在库里不删数据。

已验证：本地全链 11 步全绿（php -l / 渲染 286 项 / SQL / PDO / CSS /
Mime / amap / 内联 JS×11 / 布局几何 / 表单交互 73 项）；远端 e2e
296 项 0 失败（含灯箱、编辑弹窗、历史预算行排除的专项断言）；
部署后双 PHP 渲染逐字节一致、60 文件哈希一致，线上 style.css 含新规则。
 2026-09-23 14:59:02 +08:00
laoyang 86e0481a19 节点表单：24 小时制时间控件、附件可裁剪、保存失败不丢已填内容 
1) 时间选择不再出现「上午/下午」
   datetime-local 的显示格式由浏览器 UI 语言决定（中文环境渲染成
   「下午 03:30」），页面与元素的 lang 都压不住（截图实测）。
   拆成「原生 date 控件 + 时下拉(00-23) + 分下拉(00-59)」组合控件
   （templates/_datetime.php），24 小时制由控件本身决定，浏览器改不掉。
   服务端 read_dt_input() 把三段拼回 Y-m-d H:i:s 并校验，兼容旧单字段。
   节点起止时间与成员签到时间一并换掉。

2) 附件可裁剪，不想裁点「确定」就按原图上传
   裁剪弹窗抽成 templates/_crop_modal.php 与照片页共用；表单里选完图
   自动逐张进入裁剪，整图选框=没裁（保留原文件、不重新编码、省 base64
   流量），裁过的走 cropped 通道（隐藏域 JSON，原生表单提交也能带），
   没裁的留在 input.files，已裁卡片带角标，可随时重置重来。

3) 节点保存失败不再清空整页
   服务端：失败分支 flash_old($_POST)，重开的表单按 old()/old_array()/
   old_dt() 全字段回填（含勾选删除状态），渲染完即清（layout.php）。
   前端：sessionStorage 草稿兜底服务端拿不到 $_POST 的情况
   （post_max_size 超限、会话过期），恢复条件收窄到「页面有错误提示条」，
   避免陈旧草稿污染新表单。

已验证：本地 php -l 全量 0 错、模板渲染 275 项、表单交互（真实浏览器）
73 项——含真实裁剪一刀、草稿恢复、三段式时间选择；远端 e2e 289 项
0 失败（存储设置测试期间归一为 local，不再写用户真实 OSS 桶，收尾还原）；
部署后双 PHP 渲染逐字节一致、59 文件哈希校验一致。
 2026-09-23 09:11:42 +08:00
laoyang 44ffee6c92 节点表单：时间框整块可点、起点终点一键导航、可直接传多张附件 
三件事都是「界面上明明该有、但用起来不通」的地方：

1) 时间输入框只能点右侧那个小日历图标才弹选择器
   原生行为如此（而且各浏览器还不一致），用户会以为输入框是只读的。
   在全局脚本里给 datetime-local / date 挂 click → showPicker()，
   等于把整块输入区都当成那个图标；选择器已在显示时再调是空操作，
   不支持的浏览器静默跳过。顺带给可点光标。
   写在 layout.php 里，所以签到时间等其它时间框一并生效。

2) 起点/终点的精确位置此前只存在页面上，没有落库
   高德选点回调里拿到的 lng/lat 现在随节点一起存库，节点详情页和
   表单页都生成高德导航链接，点一下就能直接导航过去（手机端会尝试
   唤起高德 App）。链接只给 to 不给 from，让移动端自动用当前位置当起点。
   ⚠️ 高德 URI API 的坐标顺序是「经度,纬度」，写反了不报错、只会安静地
   导到地球另一边，所以单独写了单元测试守住顺序。
   手工改地名时会清掉旧坐标，退化成关键字搜索，避免「名字改了位置没改」。

3) 节点处不能上传图片附件
   节点表单改成 multipart，加拖放区 + 多选 + 本地预览 + 逐个移除，
   编辑态可勾选删除已有附件（逐条校验归属，防止改 id 删到别人家的文件）。
   上传逻辑从 AttachmentController 抽到 src/Uploads.php，两处共用一份：
   MIME 白名单、大小上限、孤儿回滚各抄一份迟早走偏。
   请求体超过 post_max_size 时 PHP 会静默丢掉 $_POST 与 $_FILES，紧随的
   CSRF 校验必然失败、报「请求已过期」——这是最难排查的一类问题。
   现在按 CONTENT_LENGTH 提前识别并给出人话提示，且该守卫必须排在
   csrf_check() 之前（只读长度、不改状态，所以顺序上是安全的）。

已验证：本地 php -l 全量、模板渲染 255 项、amap_nav_url 单测 18 项、
真实浏览器交互 47 项（时间框三处点击都弹、多选/移除后 input.files 真被
改写、超限被前端拦下、导航链接随选点刷新、勾选删除变红、三视口无溢出）、
打包 57 文件、远端 e2e 267 项，全部通过；部署后双 PHP 渲染逐字节一致。
 2026-09-23 07:53:20 +08:00
laoyang a43dd06d1f 修版心双重内缩与预览图溢出：宽屏整页错位、头像盖住表单 
线上反馈「界面更乱了、全都错位、导航条头像非常大、下拉菜单乱七八糟」。
用无头浏览器实测出三处硬伤，都不是样式文件坏了，是布局算式写错。

一、版心被推两次 → 宽屏正文列塌陷（「全都错位」的根）

  .topbar 与 .container 各自用了同一份「把内容推到居中」的 padding，
  而 .container 本来就已经有 max-width + margin:auto。于是内容被推两次：

    1280px  顶栏品牌 x=89   正文 x=178     差 89px
    1920px  顶栏品牌 x=409  正文 x=818     差 409px，正文列只剩 262px
    2560px  正文列宽度 = 0                内容完全挤没

  改法：抽一个 --shell-pad（= max(--gutter, (100% - --container) / 2)），
  顶栏与正文共用它，并且 .container 不再设 max-width —— 正文列宽度由 padding
  反推，宽屏下正好等于 --container，两边用的是同一个公式，左边缘必然对齐。
  用 100% 而非 100vw，避免滚动条让两者差半格。

二、预览容器把图片尺寸写在了外层 div 上 → 400×400 头像盖住整个表单

  .avatar-preview / .cover-preview 把 width/height/object-fit 写在**容器**上，
  里面的 <img> 完全不受约束，按原始尺寸铺出来：
  头像 400×400、封面 1920×1080，直接把下面的表单项盖住。
  （对照：.card-cover img / .activity-cover img 是写对的。）

  改法：容器只负责「框」（定尺寸、overflow:hidden 裁圆角），
  尺寸与 object-fit 一律落到 > img 上，且用绝对定位铺满 ——
  不用 `display:grid + width:100%`，那种写法列宽会反过来依赖元素自身宽度，
  形成循环，浏览器只能把图算成 0 宽（实测踩到过）。

三、上传区被当成小圆框 → 按钮和提示文字压进头像里

  .avatar-upload 被套上 84×84 圆形尺寸，而模板把预览、按钮、提示文字都放在
  它内部，三样东西全挤在那个小圆里互相重叠。改法：上传容器只做排列
  （头像横排、封面竖排），虚线圆框与圆角归预览块，按钮自成一行。

顺带
  · 下拉面板加 max-height + overflow，13 个菜单项在矮屏不再顶出屏幕底部；
    宽度 max-content 且不换行，并限制不超过视口。
  · 头像地址一律先过 media_avatar() 再判断：外站地址（https://…）会被拒，
    以前按原始值判断非空 → 渲染出 <img src="">，用户管理列表里两个用户
    就是破图。现在退回首字母色块。头像隐藏域仍保留原始值，避免单纯保存就抹掉数据。
  · CSS 结构体检报告不再写在被检查文件旁边（assets/style.css.syntax.txt
    曾被当成站点文件打进部署包）；打包排除规则改为「根目录 _ 开头 +
    任意层级的工具报告/日志」，并且不再误伤 templates/ 下 _ 前缀的局部模板。

配套的检查能力（本次之前的检查全绿、页面却视觉上是坏的，所以补这一层）
  · _tooling/_snapshot3.py   按登录态渲染线上页面 + 抓静态资源到本地
  · _tooling/_layout_check.py  无头浏览器测量真实几何并断言：顶栏/正文左右边缘
    对齐、正文列宽度、无横向溢出、头像恒 26px、预览图不溢出且铺满、预览图
    确实加载成功、下拉面板不出屏。6 个页面 × 7 档宽度 = 392 项。
    先用线上那份坏样式跑证明它抓得到（89 项失败），再用修复后的跑（0 失败）。
  · _tooling/css_syntax_check.py  词法级 CSS 结构体检（跳过注释与字符串后数括号），
    比 grep 数大括号可靠 —— 配平不等于合法。
  · 部署脚本新增 7 条静态哨兵，锁住上面三个根因。

验证
  本地：php -l 55 文件 0 失败；模板渲染 234 项；SQL 15 表无未知列；PDO 0 问题；
        CSS 202 类全有定义；CSS 结构体检通过；Mime 27 项；内联 JS 9 个文件；
        布局几何 392 项全通过。
  线上：部署 10 步 EXIT=0（80 项静态断言全 OK / 0 FAIL，含 7 条新哨兵），
        双 PHP 渲染 14 条路由字节数完全一致，26 项内容断言全通过
        （含照片代理 69/69 字节逐字节一致）；
        对已部署状态重抓渲染再测布局几何 392 项 0 失败；
        端到端 239 项通过 / 0 项失败。
        用户管理列表里 example.com 外链出现次数由 2 降为 0。
 2026-09-23 00:01:05 +08:00
laoyang f9a624ef4b 交通字段简化 + 照片多图/裁剪/双存储后端 + 界面重构 
交通字段
- 飞机只记航班号、火车只记车次，不再收座位号 / 线路 / 承运人 / 登机口
  （多人同乘一趟时座位号本来就无意义）
- trip_nodes 的历史列保留但不再写入也不再渲染，编辑一次即被显式清成 NULL
- 节点表单按出行方式切换号码标签（航班号 / 车次 / 班次 / 线路 / 航次）

照片
- 一个节点可传多张照片，前端支持逐张裁剪（Cropper.js，只把裁过的走 base64）
- MIME 由自建的 src/Mime.php 按内容识别：getimagesize → 魔数嗅探 → 扩展名映射，
  刻意不依赖 fileinfo —— 线上同时装着 PHP 7.4（没装该扩展）与 8.1
- 单张体积上限、可传张数在设置页可调

双存储后端
- 本站 uploads/ 或阿里云 OSS，在「存储设置」页配 endpoint / 桶名 / 前缀 / 内网开关；
  OSS 配置不完整时静默回退本地，避免管理员填错就把上传整个弄挂
- OSS 鉴权支持 ECS 实例 RAM 角色换 STS 临时凭证（临时凭证缓存在 /tmp，不落 Web 目录），
  也支持直接填 AccessKey
- OSS V1 签名手写实现，不引 SDK（本项目无 composer / 无 autoload）

媒体代理
- 照片与活动封面一律经 media/show、media/cover 代理输出，先校验家庭归属再吐字节
- 页面里不出现 OSS 域名，也不出现本地真实路径；桶保持私有
- 响应带 nosniff，并关闭 display_errors，免得 PHP 报错混进图片正文把图弄坏

数据库
- 新增迁移机制（src/Migrate.php + tools/migrate.php，仅 CLI 可跑）
- 建 app_settings 表；attachments 增加 storage / object_key / mime_type / size_bytes /
  width / height / is_image 与 idx_storage
- MySQL 8 不支持「加列时带 IF NOT EXISTS」，迁移一律先查 information_schema

界面
- 顶栏只留品牌与「新建活动」，其余入口收进右上角下拉菜单（details/summary，零 JS 可开合）
- 新增「存储设置」页：当前生效存储、数据库结构版本、是否 ECS 运行环境三张状态卡，
  外加测试连接与角色探测
- 样式表整体重写

验证
- 模板渲染检查 234 项、SQL 列名静态检查、模板到 CSS 的类覆盖检查、内联 JS 语法检查全通过
- 已部署到 trip.yangyq.net 并完成线上验证：双 PHP（8.1 / 7.4）14 条路由渲染字节数完全一致、
  26 项内容断言全部通过、照片代理取件与磁盘原件逐字节一致（69/69 字节）
 2026-09-22 23:09:37 +08:00
laoyang a79956758b 补齐未接入代码的功能域：参与人 / 评论 / 花销与分摊 
数据库里早就建好了 comments、node_members + role_tags、expenses +
expense_splits 三组表，但一直没有代码接入。本次把这三块连上业务，
并新增「节点详情页」作为聚合入口。

新增
- src/Access.php          统一归属校验。此前每个控制器各写各的 family_id
                          条件，容易漏；现在 activity()/node()/target() 一处收敛，
                          requireAdmin() 统一管理员判断。
- src/Comments.php        两级平铺：parent_id 只允许指向顶层，写「回复的回复」
                          时规范化回顶层；删顶层会连同回复一起删。
- src/Members.php         参与人 + 角色标签 + 情绪 + 签到。情绪目录 17 项，
                          全部选用 Emoji 11.0（2018）及以前的码位，避免旧系统
                          字体缺字形显示成空白方块。
- src/Expenses.php        花销与分摊。分摊按「分」为单位 intdiv 平均，
                          余数归最后一人，保证 SUM(share_amount) = total_amount。
- templates/nodes/show.php 节点详情页：基本信息 + 参与人 + 花销 + 讨论 + 附件入口。
- 角色标签管理、评论区、参与人区、花销区各自的模板与控制器。

修复
- 越权：往别人活动的节点上插节点、把别家用户加成参与人，都只校验了
  「节点存在」，没校验「用户与节点同家庭」。现统一走 Access。
- 删活动时节点附件文件删不掉：附件在 /uploads/attachments/ 下，却调了
  只认 /uploads/covers/ 的删除函数，判定不通过 → 文件永久残留。改为
  统一的 deleteUploadFile()，两个目录都认。
- 删有引用记录的用户会 500（activities.created_by / attachments.uploader_id /
  comments.author_id / expenses.payer_user_id 这几处没有级联，也没做前置检查）。

其他
- 活动/节点列表补上附件、评论、参与人、花销四个计数（一次 GROUP BY 查完）。
- 首页布局新增一条迁移易踩的规避：新列上的索引必须排在 ALTER TABLE 之后。
- 新增 .gitignore：config.php（含数据库口令）与 uploads/ 下用户上传的
  头像封面不入库，只保留 uploads/.htaccess 那条禁止执行脚本的规则。
- 新增 config.example.php 作为新环境的配置模板。

本批不改数据库结构，不需要任何数据迁移。

本地与线上验证
- php -l 全绿（PHP 8.4 本地 / 线上 7.4.30 与 8.1.7 双版本）。
- 模板渲染检查 180 项全通过。
- 线上端到端 153 项全通过：登录、活动增删改查、节点流转、
  参与人/角色标签/情绪/签到、评论、花销与分摊、权限、级联清理、
  全站页面无 PHP 报错泄漏、跑完基线逐表核对且既有 id 集合逐字未变。
- 顺带写了 trip_sql_column_check.py：拿真实库表结构静态校验全项目 SQL 的
  列名引用。本次就是靠它之外的 e2e 抓到 travel_modes 并没有 line_name
  （该列属于 trip_nodes），一个列名写错导致节点详情页整页 Fatal。
 2026-09-22 22:03:08 +08:00