100 lines
4.3 KiB
PHP
100 lines
4.3 KiB
PHP
<?php
|
||
|
||
/**
|
||
* 文件功能：用户反馈相关表迁移
|
||
* 包含三张关联表：
|
||
* - feedback_items：反馈主表（Bug报告/功能建议）
|
||
* - feedback_votes：赞同记录（每人每条唯一，支持取消）
|
||
* - feedback_replies：补充评论（支持管理员官方回复标记）
|
||
*
|
||
* @author ChatRoom Laravel
|
||
*
|
||
* @version 1.0.0
|
||
*/
|
||
|
||
use Illuminate\Database\Migrations\Migration;
|
||
use Illuminate\Database\Schema\Blueprint;
|
||
use Illuminate\Support\Facades\Schema;
|
||
|
||
return new class extends Migration
|
||
{
|
||
/**
|
||
* 创建用户反馈相关三张表
|
||
*/
|
||
public function up(): void
|
||
{
|
||
// ——— 表1：反馈主表 ———
|
||
Schema::create('feedback_items', function (Blueprint $table): void {
|
||
$table->id();
|
||
// 提交人信息（冗余 username，防止用户改名后记录混乱）
|
||
$table->unsignedBigInteger('user_id')->comment('提交人 ID');
|
||
$table->string('username', 50)->comment('提交人用户名（提交时快照）');
|
||
// 反馈类型
|
||
$table->enum('type', ['bug', 'suggestion'])
|
||
->comment('类型: bug=缺陷报告 suggestion=功能建议');
|
||
// 反馈内容
|
||
$table->string('title', 200)->comment('反馈标题（一句话概括）');
|
||
$table->text('content')->comment('详细描述内容');
|
||
// 处理状态（7种）
|
||
$table->enum('status', [
|
||
'pending', // 待处理（默认）
|
||
'accepted', // 已接受（纳入计划）
|
||
'in_progress', // 开发中/修复中
|
||
'fixed', // Bug已修复
|
||
'done', // 建议已实现
|
||
'rejected', // 暂不同意
|
||
'shelved', // 已搁置
|
||
])->default('pending')->comment('处理状态');
|
||
// 管理员回复（前台显示为特殊"开发者回复"区块）
|
||
$table->text('admin_remark')->nullable()->comment('管理员官方回复（公开显示）');
|
||
// 冗余计数字段，配合排序（避免每次 COUNT JOIN）
|
||
$table->unsignedInteger('votes_count')->default(0)->comment('赞同人数（冗余，方便排序）');
|
||
$table->unsignedInteger('replies_count')->default(0)->comment('补充评论数（冗余）');
|
||
$table->timestamps();
|
||
|
||
// 索引：按类型+状态筛选、按赞同数排序
|
||
$table->index(['type', 'status'], 'idx_type_status');
|
||
$table->index('user_id', 'idx_user_id');
|
||
$table->index('votes_count', 'idx_votes');
|
||
});
|
||
|
||
// ——— 表2：赞同记录 ———
|
||
Schema::create('feedback_votes', function (Blueprint $table): void {
|
||
$table->id();
|
||
$table->unsignedBigInteger('feedback_id')->comment('对应反馈 ID');
|
||
$table->unsignedBigInteger('user_id')->comment('赞同用户 ID');
|
||
$table->timestamp('created_at')->nullable();
|
||
|
||
// 联合唯一索引：每个用户每条反馈只能赞同一次
|
||
$table->unique(['feedback_id', 'user_id'], 'uq_vote');
|
||
$table->index('feedback_id');
|
||
});
|
||
|
||
// ——— 表3：补充评论 ———
|
||
Schema::create('feedback_replies', function (Blueprint $table): void {
|
||
$table->id();
|
||
$table->unsignedBigInteger('feedback_id')->comment('对应反馈 ID');
|
||
// 回复人信息（冗余 username）
|
||
$table->unsignedBigInteger('user_id')->comment('回复人 ID');
|
||
$table->string('username', 50)->comment('回复人用户名（快照）');
|
||
// 评论内容（纯文本，不支持 Markdown，防止滥用）
|
||
$table->text('content')->comment('补充内容（纯文本）');
|
||
// 管理员官方回复标记（前台特殊高亮展示）
|
||
$table->boolean('is_admin')->default(false)->comment('是否为 id=1 管理员的官方回复');
|
||
$table->timestamps();
|
||
|
||
$table->index('feedback_id');
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 回滚：删除用户反馈相关三张表
|
||
*/
|
||
public function down(): void
|
||
{
|
||
Schema::dropIfExists('feedback_replies');
|
||
Schema::dropIfExists('feedback_votes');
|
||
Schema::dropIfExists('feedback_items');
|
||
}
|
||
};
|