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

数据库里早就建好了 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,190 @@
+<?php
+declare(strict_types=1);
+
+namespace App\Controllers;
+
+use App\Auth;
+use App\Database;
+
+class NodeTypeController
+{
+    public function index(): void
+    {
+        $this->requireAdmin();
+
+        $db = Database::get();
+        $familyId = Auth::familyId();
+
+        $stmt = $db->prepare('SELECT * FROM node_types WHERE family_id = ? ORDER BY is_system DESC, id ASC');
+        $stmt->execute([$familyId]);
+        $types = $stmt->fetchAll();
+
+        // 统计每个类型被引用的节点数
+        foreach ($types as &$t) {
+            $s = $db->prepare('SELECT COUNT(*) FROM trip_nodes WHERE node_type_id = ?');
+            $s->execute([$t['id']]);
+            $t['node_count'] = (int)$s->fetchColumn();
+        }
+        unset($t);
+
+        view('node_types/index', [
+            'types'     => $types,
+            'pageTitle' => '节点类型管理',
+        ]);
+    }
+
+    public function create(): void
+    {
+        $this->requireAdmin();
+        view('node_types/form', [
+            'type'      => null,
+            'pageTitle' => '新增节点类型',
+        ]);
+    }
+
+    public function store(): void
+    {
+        $this->requireAdmin();
+        csrf_check();
+
+        $db = Database::get();
+        $familyId = Auth::familyId();
+
+        $name = trim($_POST['name'] ?? '');
+        $icon = trim($_POST['icon'] ?? '');
+
+        if ($name === '') {
+            flash('error', '名称不能为空');
+            redirect('node_types/create');
+        }
+        if (mb_strlen($name) > 30) {
+            flash('error', '名称不能超过 30 个字符');
+            redirect('node_types/create');
+        }
+
+        // 唯一性校验
+        $chk = $db->prepare('SELECT id FROM node_types WHERE family_id = ? AND name = ? LIMIT 1');
+        $chk->execute([$familyId, $name]);
+        if ($chk->fetch()) {
+            flash('error', '该类型名称已存在');
+            redirect('node_types/create');
+        }
+
+        $stmt = $db->prepare('INSERT INTO node_types (family_id, name, icon, is_system) VALUES (?, ?, ?, FALSE)');
+        $stmt->execute([$familyId, $name, $icon ?: null]);
+
+        flash('error', '创建成功');
+        redirect('node_types/index');
+    }
+
+    public function edit(): void
+    {
+        $this->requireAdmin();
+
+        $id = (int)($_GET['id'] ?? 0);
+        $db = Database::get();
+
+        $stmt = $db->prepare('SELECT * FROM node_types WHERE id = ? AND family_id = ?');
+        $stmt->execute([$id, Auth::familyId()]);
+        $type = $stmt->fetch();
+        if (!$type) {
+            http_response_code(404);
+            exit('节点类型不存在');
+        }
+
+        view('node_types/form', [
+            'type'      => $type,
+            'pageTitle' => '编辑节点类型',
+        ]);
+    }
+
+    public function update(): void
+    {
+        $this->requireAdmin();
+        csrf_check();
+
+        $db = Database::get();
+        $familyId = Auth::familyId();
+        $id = (int)($_POST['id'] ?? 0);
+
+        $stmt = $db->prepare('SELECT * FROM node_types WHERE id = ? AND family_id = ?');
+        $stmt->execute([$id, $familyId]);
+        $type = $stmt->fetch();
+        if (!$type) {
+            http_response_code(404);
+            exit('节点类型不存在');
+        }
+
+        $name = trim($_POST['name'] ?? '');
+        $icon = trim($_POST['icon'] ?? '');
+
+        if ($name === '') {
+            flash('error', '名称不能为空');
+            redirect('node_types/edit', ['id' => $id]);
+        }
+        if (mb_strlen($name) > 30) {
+            flash('error', '名称不能超过 30 个字符');
+            redirect('node_types/edit', ['id' => $id]);
+        }
+
+        // 唯一性检查（排除自身）
+        $chk = $db->prepare('SELECT id FROM node_types WHERE family_id = ? AND name = ? AND id != ? LIMIT 1');
+        $chk->execute([$familyId, $name, $id]);
+        if ($chk->fetch()) {
+            flash('error', '该类型名称已被其他类型使用');
+            redirect('node_types/edit', ['id' => $id]);
+        }
+
+        $stmt = $db->prepare('UPDATE node_types SET name = ?, icon = ? WHERE id = ?');
+        $stmt->execute([$name, $icon ?: null, $id]);
+
+        flash('error', '保存成功');
+        redirect('node_types/index');
+    }
+
+    public function destroy(): void
+    {
+        $this->requireAdmin();
+        csrf_check();
+
+        $db = Database::get();
+        $id = (int)($_POST['id'] ?? 0);
+
+        $stmt = $db->prepare('SELECT * FROM node_types WHERE id = ? AND family_id = ?');
+        $stmt->execute([$id, Auth::familyId()]);
+        $type = $stmt->fetch();
+        if (!$type) {
+            flash('error', '节点类型不存在');
+            redirect('node_types/index');
+        }
+
+        if ((int)$type['is_system'] === 1) {
+            flash('error', '系统内置类型不能删除');
+            redirect('node_types/index');
+        }
+
+        // 检查是否被引用
+        $cnt = $db->prepare('SELECT COUNT(*) FROM trip_nodes WHERE node_type_id = ?');
+        $cnt->execute([$id]);
+        $usedCount = (int)$cnt->fetchColumn();
+
+        if ($usedCount > 0) {
+            flash('error', "该类型已被 {$usedCount} 个节点使用，无法删除");
+            redirect('node_types/index');
+        }
+
+        $stmt = $db->prepare('DELETE FROM node_types WHERE id = ?');
+        $stmt->execute([$id]);
+
+        flash('error', '删除成功');
+        redirect('node_types/index');
+    }
+
+    private function requireAdmin(): void
+    {
+        if (!Auth::isAdmin()) {
+            http_response_code(403);
+            exit('仅管理员可访问此页面');
+        }
+    }
+}