这个php项目如何点评裁判的执法尺度？

wen PHP项目 2026-09-22 150

PHP 项目中实现“裁判执法尺度”点评功能的设计思路

你这个问题信息量比较少，我先分两种情况来理解,你可以对号入座：

这个php项目如何点评裁判的执法尺度？

你正在做一个体育/电竞类 PHP 项目,想加一个让用户点评裁判执法尺度的功能模块；
你在看某个 PHP 项目的代码，想从代码质量角度“点评”它（这里的“裁判”指代码审查者/评审）。

下面主要按第 1 种理解来展开,因为它更像一个真实的产品需求。

先明确“执法尺度”是什么

裁判执法尺度通常包含几个可量化的维度：

维度	说明	示例指标
判罚松紧	对同类犯规吹不吹	场均犯规数、黄牌数
一致性	前后判罚是否统一	同类型动作判罚方差
关键判罚	关键时刻是否敢吹	最后5分钟判罚数
争议度	引发争议的比例	争议判罚/总判罚
主场偏向	主客队判罚差异	主客队犯规比

点评系统要做的，就是把这些维度变成用户可打分、可评论、可统计的结构。

数据库设计（MySQL 示例）

-- 裁判表
CREATE TABLE referees (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(50),
    league VARCHAR(50),
    avatar VARCHAR(255)
);
-- 比赛表（关联裁判）
CREATE TABLE matches (
    id INT PRIMARY KEY AUTO_INCREMENT,
    referee_id INT,
    home_team VARCHAR(50),
    away_team VARCHAR(50),
    match_date DATETIME,
    home_fouls INT,
    away_fouls INT,
    home_cards INT,
    away_cards INT
);
-- 点评表（核心）
CREATE TABLE referee_ratings (
    id INT PRIMARY KEY AUTO_INCREMENT,
    referee_id INT,
    user_id INT,
    match_id INT,
    -- 各维度 1-5 分
    strictness TINYINT,      -- 判罚松紧
    consistency TINYINT,     -- 一致性
    courage TINYINT,         -- 关键判罚勇气
    fairness TINYINT,        -- 公平性
    -- 综合
    overall DECIMAL(2,1),
    comment TEXT,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    INDEX idx_referee (referee_id)
);

核心业务逻辑（PHP）

提交点评

public function submitRating(int $userId, int $refereeId, array $data): array
{
    // 1. 校验分数范围
    foreach (['strictness','consistency','courage','fairness'] as $field) {
        if (!isset($data[$field]) || $data[$field] < 1 || $data[$field] > 5) {
            throw new InvalidArgumentException("评分 {$field} 必须在 1-5 之间");
        }
    }
    // 2. 防刷：同一用户对同一场比赛只能评一次
    $exists = $this->db->fetchOne(
        "SELECT id FROM referee_ratings WHERE user_id=? AND match_id=?",
        [$userId, $data['match_id']]
    );
    if ($exists) {
        throw new RuntimeException('您已点评过本场比赛');
    }
    // 3. 计算综合分（可加权）
    $overall = round(
        $data['strictness'] * 0.3 +
        $data['consistency'] * 0.3 +
        $data['courage'] * 0.2 +
        $data['fairness'] * 0.2,
        1
    );
    // 4. 入库
    $this->db->insert('referee_ratings', [
        'referee_id' => $refereeId,
        'user_id'    => $userId,
        'match_id'   => $data['match_id'],
        'strictness' => $data['strictness'],
        'consistency'=> $data['consistency'],
        'courage'    => $data['courage'],
        'fairness'   => $data['fairness'],
        'overall'    => $overall,
        'comment'    => $data['comment'] ?? '',
    ]);
    return ['overall' => $overall];
}

聚合统计（裁判主页展示）

public function getRefereeStats(int $refereeId): array
{
    $sql = "SELECT 
                COUNT(*) AS total,
                AVG(strictness)  AS avg_strictness,
                AVG(consistency) AS avg_consistency,
                AVG(courage)     AS avg_courage,
                AVG(fairness)    AS avg_fairness,
                AVG(overall)     AS avg_overall,
                STDDEV(overall)  AS std_overall
            FROM referee_ratings
            WHERE referee_id = ?";
    $stats = $this->db->fetchOne($sql, [$refereeId]);
    // 标准差越大 = 用户分歧越大 = 争议越高
    $stats['controversy_level'] = $stats['std_overall'] > 1.2 ? '高' 
                                 : ($stats['std_overall'] > 0.7 ? '中' : '低');
    return $stats;
}