Add document_translations table and migrate existing data

documents.{title,content,rendered_html} move to document_translations keyed by (document_id, locale). Existing rows are copied to a single translation in config('app.locale'). documents gains default_locale. Also guard the original FULLTEXT ALTER TABLE with a MySQL driver check so that the SQLite test environment can run all migrations cleanly.
2026-05-10 12:04:05 +09:00
parent e83bd6981d
commit f2bdb6a069
3 changed files with 185 additions and 1 deletions
@@ -2,6 +2,7 @@

 use Illuminate\Database\Migrations\Migration;
 use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Schema;

 return new class extends Migration
@@ -27,7 +28,9 @@ public function up(): void

        // FULLTEXT検索インデックス（MySQL 5.7以降）
        // ngramトークナイザーは日本語対応に必要だが、設定が必要
-        DB::statement('ALTER TABLE documents ADD FULLTEXT INDEX documents_search_index (title, content) WITH PARSER ngram');
+        if (DB::connection()->getDriverName() === 'mysql') {
+            DB::statement('ALTER TABLE documents ADD FULLTEXT INDEX documents_search_index (title, content) WITH PARSER ngram');
+        }

        // 検索パフォーマンス向上用インデックス
        Schema::table('documents', function (Blueprint $table) {
@@ -0,0 +1,106 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        // 1. Add default_locale to documents
+        Schema::table('documents', function (Blueprint $table) {
+            $table->string('default_locale', 10)
+                ->default(config('app.locale', 'en'))
+                ->after('slug');
+        });
+
+        // 2. Create document_translations
+        Schema::create('document_translations', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('document_id')->constrained('documents')->cascadeOnDelete();
+            $table->string('locale', 10);
+            $table->string('title');
+            $table->text('content');
+            $table->text('rendered_html')->nullable();
+            $table->foreignId('created_by')->nullable()->constrained('users')->nullOnDelete();
+            $table->foreignId('updated_by')->nullable()->constrained('users')->nullOnDelete();
+            $table->timestamps();
+
+            $table->unique(['document_id', 'locale']);
+            $table->index(['locale', 'title']);
+        });
+
+        if (DB::connection()->getDriverName() === 'mysql') {
+            DB::statement('ALTER TABLE document_translations ADD FULLTEXT INDEX document_translations_search_index (title, content) WITH PARSER ngram');
+        }
+
+        // 3. Migrate existing data
+        $defaultLocale = config('app.locale', 'en');
+        $now = now();
+        $rows = DB::table('documents')->get();
+        foreach ($rows as $row) {
+            DB::table('document_translations')->insert([
+                'document_id' => $row->id,
+                'locale' => $defaultLocale,
+                'title' => $row->title ?? '',
+                'content' => $row->content ?? '',
+                'rendered_html' => $row->rendered_html,
+                'created_by' => $row->created_by ?? null,
+                'updated_by' => $row->updated_by ?? null,
+                'created_at' => $row->created_at ?? $now,
+                'updated_at' => $row->updated_at ?? $now,
+            ]);
+            DB::table('documents')->where('id', $row->id)->update(['default_locale' => $defaultLocale]);
+        }
+
+        // 4. Drop the old FULLTEXT index on documents (MySQL only)
+        if (DB::connection()->getDriverName() === 'mysql') {
+            DB::statement('ALTER TABLE documents DROP INDEX documents_search_index');
+        }
+
+        // 5. Drop translatable columns from documents
+        // Drop the title index first (SQLite requires this before dropping the column)
+        Schema::table('documents', function (Blueprint $table) {
+            $table->dropIndex(['title']);
+            $table->dropColumn(['title', 'content', 'rendered_html']);
+        });
+    }
+
+    public function down(): void
+    {
+        // Re-add columns
+        Schema::table('documents', function (Blueprint $table) {
+            $table->string('title')->nullable()->after('default_locale');
+            $table->text('content')->nullable()->after('title');
+            $table->text('rendered_html')->nullable()->after('content');
+        });
+
+        // Restore data from default_locale translation
+        $rows = DB::table('document_translations as t')
+            ->join('documents as d', 'd.id', '=', 't.document_id')
+            ->whereColumn('t.locale', 'd.default_locale')
+            ->select('t.document_id', 't.title', 't.content', 't.rendered_html')
+            ->get();
+
+        foreach ($rows as $row) {
+            DB::table('documents')->where('id', $row->document_id)->update([
+                'title' => $row->title,
+                'content' => $row->content,
+                'rendered_html' => $row->rendered_html,
+            ]);
+        }
+
+        // Restore FULLTEXT on documents (MySQL only)
+        if (DB::connection()->getDriverName() === 'mysql') {
+            DB::statement('ALTER TABLE documents ADD FULLTEXT INDEX documents_search_index (title, content) WITH PARSER ngram');
+        }
+
+        Schema::dropIfExists('document_translations');
+
+        Schema::table('documents', function (Blueprint $table) {
+            $table->dropColumn('default_locale');
+        });
+    }
+};
@@ -0,0 +1,75 @@
+<?php
+
+namespace Tests\Feature;
+
+use Illuminate\Database\Migrations\Migrator;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+use Tests\TestCase;
+
+class DocumentMigrationTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function test_documents_table_has_default_locale_after_migration(): void
+    {
+        $this->assertTrue(Schema::hasColumn('documents', 'default_locale'));
+    }
+
+    public function test_documents_table_no_longer_has_translatable_columns(): void
+    {
+        $this->assertFalse(Schema::hasColumn('documents', 'title'));
+        $this->assertFalse(Schema::hasColumn('documents', 'content'));
+        $this->assertFalse(Schema::hasColumn('documents', 'rendered_html'));
+    }
+
+    public function test_document_translations_table_exists_with_required_columns(): void
+    {
+        $this->assertTrue(Schema::hasTable('document_translations'));
+
+        foreach (['document_id', 'locale', 'title', 'content', 'rendered_html', 'created_by', 'updated_by', 'created_at', 'updated_at'] as $col) {
+            $this->assertTrue(
+                Schema::hasColumn('document_translations', $col),
+                "document_translations missing column: $col"
+            );
+        }
+    }
+
+    public function test_document_translations_unique_document_locale(): void
+    {
+        DB::table('documents')->insert([
+            'path' => 'A.md',
+            'slug' => 'a',
+            'default_locale' => 'en',
+            'file_size' => 0,
+            'file_hash' => str_repeat('0', 64),
+            'file_modified_at' => now(),
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+        $docId = DB::table('documents')->where('slug', 'a')->value('id');
+
+        DB::table('document_translations')->insert([
+            'document_id' => $docId,
+            'locale' => 'en',
+            'title' => 'A',
+            'content' => '...',
+            'rendered_html' => '<p>...</p>',
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+
+        $this->expectException(\Illuminate\Database\QueryException::class);
+
+        DB::table('document_translations')->insert([
+            'document_id' => $docId,
+            'locale' => 'en',
+            'title' => 'duplicate',
+            'content' => '...',
+            'rendered_html' => '<p>...</p>',
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+    }
+}