补齐未接入代码的功能域:参与人 / 评论 / 花销与分摊

数据库里早就建好了 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。
This commit is contained in:
2026-09-22 22:03:08 +08:00
parent 6c1345e202
commit a79956758b
49 changed files with 7059 additions and 0 deletions
+64
View File
@@ -0,0 +1,64 @@
<?php
declare(strict_types=1);
namespace App\Controllers;
use App\Access;
use App\Auth;
use App\Members;
/**
* 节点参与人:加人 / 改角色情绪 / 移出 / 一键把全家加进来
*/
class MemberController
{
public function store(): void
{
csrf_check();
$nodeId = (int)($_POST['node_id'] ?? 0);
Access::node($nodeId); // 归属校验,非本家庭一律 404
$roleTagIds = $_POST['role_tag_ids'] ?? [];
if (!is_array($roleTagIds)) {
$roleTagIds = [$roleTagIds];
}
$result = Members::save(
$nodeId,
(int)($_POST['user_id'] ?? 0),
array_map('intval', $roleTagIds),
trim((string)($_POST['emotion'] ?? '')),
(string)($_POST['check_in_time'] ?? '')
);
flash('error', $result['ok'] ? '已保存参与人' : $result['error']);
redirect('nodes/show', ['id' => $nodeId], 'members');
}
public function destroy(): void
{
csrf_check();
$nodeId = (int)($_POST['node_id'] ?? 0);
Access::node($nodeId);
Members::remove($nodeId, (int)($_POST['user_id'] ?? 0));
flash('error', '已移出该参与人');
redirect('nodes/show', ['id' => $nodeId], 'members');
}
/** 把家庭里的成员一次性全部加入这个节点(已存在的会被更新,不会重复) */
public function addAll(): void
{
csrf_check();
$nodeId = (int)($_POST['node_id'] ?? 0);
$node = Access::node($nodeId);
$users = Members::familyUsers((int)$node['family_id']);
$ids = array_map(static fn($u) => (int)$u['id'], $users);
Members::addMany($nodeId, $ids);
flash('error', '已把 ' . count($ids) . ' 位家庭成员加入本节点');
redirect('nodes/show', ['id' => $nodeId], 'members');
}
}