Files
TripLog/src/Controllers/RoleTagController.php
T
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

183 lines
5.8 KiB
PHP

<?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;
}
}