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

数据库里早就建好了 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
parent 6c1345e202
commit a79956758b
49 changed files with 7059 additions and 0 deletions
@@ -0,0 +1,182 @@
+<?php
+declare(strict_types=1);
+
+namespace App\Controllers;
+
+use App\Access;
+use App\Auth;
+use App\Database;
+
+/**
+ * 角色标签库（司机 / 摄影担当 / 记账员 …）
+ * 节点参与人就是从这堆标签里挑
+ */
+class RoleTagController
+{
+    public function index(): void
+    {
+        Access::requireAdmin();
+
+        $db = Database::get();
+        $familyId = Access::familyId();
+
+        $stmt = $db->prepare('SELECT * FROM role_tags WHERE family_id = ? ORDER BY id ASC');
+        $stmt->execute([$familyId]);
+        $tags = $stmt->fetchAll();
+
+        // 每个标签被多少个节点的参与人引用（role_tag_ids 是 JSON 数组）
+        foreach ($tags as &$t) {
+            $s = $db->prepare('SELECT COUNT(*) FROM node_members
+                WHERE role_tag_ids IS NOT NULL AND JSON_CONTAINS(role_tag_ids, ?)');
+            $s->execute([(string)(int)$t['id']]);
+            $t['used_count'] = (int)$s->fetchColumn();
+        }
+        unset($t);
+
+        view('role_tags/index', [
+            'tags'      => $tags,
+            'pageTitle' => '角色标签管理',
+        ]);
+    }
+
+    public function create(): void
+    {
+        Access::requireAdmin();
+        view('role_tags/form', ['tag' => null, 'pageTitle' => '新增角色标签']);
+    }
+
+    public function store(): void
+    {
+        Access::requireAdmin();
+        csrf_check();
+
+        $db = Database::get();
+        $familyId = Access::familyId();
+
+        $name = trim($_POST['name'] ?? '');
+        $icon = trim($_POST['icon'] ?? '');
+
+        if ($name === '') {
+            flash('error', '名称不能为空');
+            redirect('role_tags/create');
+        }
+        if (mb_strlen($name) > 30) {
+            flash('error', '名称不能超过 30 个字符');
+            redirect('role_tags/create');
+        }
+        if ($icon !== '' && mb_strlen($icon) > 4) {
+            flash('error', '图标最多放一个表情');
+            redirect('role_tags/create');
+        }
+
+        $chk = $db->prepare('SELECT id FROM role_tags WHERE family_id = ? AND name = ? LIMIT 1');
+        $chk->execute([$familyId, $name]);
+        if ($chk->fetch()) {
+            flash('error', '该角色名称已存在');
+            redirect('role_tags/create');
+        }
+
+        $stmt = $db->prepare('INSERT INTO role_tags (family_id, name, icon) VALUES (?, ?, ?)');
+        $stmt->execute([$familyId, $name, $icon ?: null]);
+
+        flash('error', '创建成功');
+        redirect('role_tags/index');
+    }
+
+    public function edit(): void
+    {
+        Access::requireAdmin();
+        view('role_tags/form', [
+            'tag'       => $this->fetchTag((int)($_GET['id'] ?? 0)),
+            'pageTitle' => '编辑角色标签',
+        ]);
+    }
+
+    public function update(): void
+    {
+        Access::requireAdmin();
+        csrf_check();
+
+        $db = Database::get();
+        $familyId = Access::familyId();
+        $tag = $this->fetchTag((int)($_POST['id'] ?? 0));
+        $id = (int)$tag['id'];
+
+        $name = trim($_POST['name'] ?? '');
+        $icon = trim($_POST['icon'] ?? '');
+
+        if ($name === '') {
+            flash('error', '名称不能为空');
+            redirect('role_tags/edit', ['id' => $id]);
+        }
+        if (mb_strlen($name) > 30) {
+            flash('error', '名称不能超过 30 个字符');
+            redirect('role_tags/edit', ['id' => $id]);
+        }
+        if ($icon !== '' && mb_strlen($icon) > 4) {
+            flash('error', '图标最多放一个表情');
+            redirect('role_tags/edit', ['id' => $id]);
+        }
+
+        $chk = $db->prepare('SELECT id FROM role_tags WHERE family_id = ? AND name = ? AND id != ? LIMIT 1');
+        $chk->execute([$familyId, $name, $id]);
+        if ($chk->fetch()) {
+            flash('error', '该角色名称已被其他角色使用');
+            redirect('role_tags/edit', ['id' => $id]);
+        }
+
+        $stmt = $db->prepare('UPDATE role_tags SET name = ?, icon = ? WHERE id = ?');
+        $stmt->execute([$name, $icon ?: null, $id]);
+
+        flash('error', '保存成功');
+        redirect('role_tags/index');
+    }
+
+    /**
+     * 删除角色标签：被引用时不阻止，而是先把它从各节点参与人身上摘掉
+     * （角色标签是轻量配置，删不掉会让人很憋屈；节点参与人本身不受影响）
+     */
+    public function destroy(): void
+    {
+        Access::requireAdmin();
+        csrf_check();
+
+        $db = Database::get();
+        $tag = $this->fetchTag((int)($_POST['id'] ?? 0));
+        $id = (int)$tag['id'];
+
+        $stmt = $db->prepare('SELECT id, role_tag_ids FROM node_members
+            WHERE role_tag_ids IS NOT NULL AND JSON_CONTAINS(role_tag_ids, ?)');
+        $stmt->execute([(string)$id]);
+        $affected = $stmt->fetchAll();
+
+        $upd = $db->prepare('UPDATE node_members SET role_tag_ids = ? WHERE id = ?');
+        foreach ($affected as $row) {
+            $ids = json_decode((string)$row['role_tag_ids'], true);
+            $ids = is_array($ids) ? array_filter(array_map('intval', $ids), static fn($v) => $v !== $id) : [];
+            $upd->execute([$ids ? json_encode(array_values($ids)) : null, (int)$row['id']]);
+        }
+
+        $stmt = $db->prepare('DELETE FROM role_tags WHERE id = ? AND family_id = ?');
+        $stmt->execute([$id, Access::familyId()]);
+
+        $msg = '删除成功';
+        if ($affected) {
+            $msg .= '；已同时从 ' . count($affected) . ' 处参与人记录中移除该角色';
+        }
+        flash('error', $msg);
+        redirect('role_tags/index');
+    }
+
+    private function fetchTag(int $id): array
+    {
+        $stmt = Database::get()->prepare('SELECT * FROM role_tags WHERE id = ? AND family_id = ?');
+        $stmt->execute([$id, Access::familyId()]);
+        $tag = $stmt->fetch();
+        if (!$tag) {
+            http_response_code(404);
+            exit('角色标签不存在');
+        }
+        return $tag;
+    }
+}