教材相关

app/Services/PdfStorageService.php

@@ -0,0 +1,169 @@
+<?php
+
+namespace App\Services;
+
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Support\Str;
+
+class PdfStorageService
+{
+    /**
+     * 保存二进制 PDF，返回可访问 URL
+     */
+    public function put(string $path, string $binary): ?string
+    {
+        $driver = config('services.pdf_storage.driver', env('PDF_STORAGE_DRIVER', 'local'));
+
+        return match ($driver) {
+            'upyun' => $this->putUpyun($path, $binary),
+            'chunsun' => $this->putChunsun($path, $binary),
+            default => $this->putLocal($path, $binary),
+        };
+    }
+
+    private function putLocal(string $path, string $binary): ?string
+    {
+        $disk = 'public';
+        // 确保目录存在
+        $dir = Str::beforeLast($path, '/');
+        if ($dir && $dir !== $path) {
+            Storage::disk($disk)->makeDirectory($dir);
+        }
+
+        $written = Storage::disk($disk)->put($path, $binary);
+        if (!$written) {
+            Log::error('PdfStorageService: 本地存储失败', ['path' => $path, 'disk' => $disk]);
+            return null;
+        }
+
+        return url(Storage::url($path));
+    }
+
+    /**
+     * 又拍云存储（REST API），需要以下 env：
+     * PDF_STORAGE_DRIVER=upyun
+     * UPYUN_BUCKET=xxx
+     * UPYUN_OPERATOR=xxx
+     * UPYUN_PASSWORD=xxx
+     * UPYUN_DOMAIN=https://your.cdn.domain 或 https://v0.api.upyun.com
+     */
+    private function putUpyun(string $path, string $binary): ?string
+    {
+        $bucket = env('UPYUN_BUCKET');
+        $operator = env('UPYUN_OPERATOR');
+        $password = env('UPYUN_PASSWORD');
+        $domain = rtrim(env('UPYUN_DOMAIN', 'https://v0.api.upyun.com'), '/');
+
+        if (!$bucket || !$operator || !$password) {
+            Log::error('PdfStorageService: 又拍云配置缺失', compact('bucket', 'operator'));
+            return null;
+        }
+
+        $target = "{$domain}/{$bucket}/" . ltrim($path, '/');
+
+        try {
+            $response = Http::withHeaders([
+                'Content-Type' => 'application/pdf',
+                'Content-Length' => strlen($binary),
+            ])
+                ->withBasicAuth($operator, $password)
+                ->timeout(30)
+                ->withBody($binary, 'application/pdf')
+                ->put($target);
+
+            if (!$response->successful()) {
+                Log::error('PdfStorageService: 又拍云上传失败', [
+                    'status' => $response->status(),
+                    'body' => $response->body(),
+                    'target' => $target,
+                ]);
+                return null;
+            }
+
+            // 生成访问 URL，优先使用 CDN 域名
+            $cdn = env('UPYUN_CDN_DOMAIN');
+            if ($cdn) {
+                return rtrim($cdn, '/') . '/' . ltrim($path, '/');
+            }
+            return $target;
+        } catch (\Throwable $e) {
+            Log::error('PdfStorageService: 又拍云异常', [
+                'error' => $e->getMessage(),
+                'target' => $target ?? null,
+            ]);
+            return null;
+        }
+    }
+
+    /**
+     * Chunsun云存储上传（POST multipart/form-data）
+     * 环境变量：
+     * PDF_STORAGE_DRIVER=chunsun
+     * CHUNSUN_UPLOAD_URL=https://crmapi.dcjxb.yunzhixue.cn
+     */
+    private function putChunsun(string $path, string $binary): ?string
+    {
+        $uploadUrl = env('CHUNSUN_UPLOAD_URL', 'https://crmapi.dcjxb.yunzhixue.cn');
+
+        try {
+            // 创建临时文件
+            $tempFile = tempnam(sys_get_temp_dir(), 'chunsun_pdf_') . '.pdf';
+            file_put_contents($tempFile, $binary);
+
+            // 发送POST请求上传文件
+            $response = Http::timeout(60)
+                ->attach('file', file_get_contents($tempFile), basename($tempFile) . '.pdf')
+                ->post($uploadUrl);
+
+            // 清理临时文件
+            @unlink($tempFile);
+
+            if (!$response->successful()) {
+                Log::error('PdfStorageService: Chunsun上传失败', [
+                    'status' => $response->status(),
+                    'body' => $response->body(),
+                    'url' => $uploadUrl,
+                ]);
+                return null;
+            }
+
+            $data = $response->json();
+
+            // 检查响应格式
+            if (!isset($data['code']) || $data['code'] !== 200) {
+                Log::error('PdfStorageService: Chunsun上传失败，响应格式错误', [
+                    'response' => $data,
+                ]);
+                return null;
+            }
+
+            // 检查返回数据
+            if (!isset($data['data']['url'])) {
+                Log::error('PdfStorageService: Chunsun上传失败，未返回URL', [
+                    'response' => $data,
+                ]);
+                return null;
+            }
+
+            $uploadedUrl = $data['data']['url'];
+            $uploadedName = $data['data']['name'] ?? null;
+
+            Log::info('PdfStorageService: Chunsun上传成功', [
+                'path' => $path,
+                'url' => $uploadedUrl,
+                'name' => $uploadedName,
+            ]);
+
+            return $uploadedUrl;
+        } catch (\Throwable $e) {
+            Log::error('PdfStorageService: Chunsun上传异常', [
+                'error' => $e->getMessage(),
+                'path' => $path,
+                'trace' => $e->getTraceAsString(),
+            ]);
+            return null;
+        }
+    }
+}

resources/views/filament/pages/textbook-import.blade.php

@@ -0,0 +1,380 @@
+<div class="min-h-screen bg-gradient-to-br from-blue-50 via-indigo-50 to-purple-50">
+    @push('styles')
+        <style>
+            .glass-card {
+                @apply bg-white/80 backdrop-blur-xl rounded-2xl border border-white/20 shadow-xl;
+            }
+
+            .gradient-text {
+                @apply bg-gradient-to-r from-blue-600 via-purple-600 to-indigo-600 bg-clip-text text-transparent;
+            }
+
+            .hover-lift {
+                @apply transition-all duration-300 hover:transform hover:-translate-y-1 hover:shadow-2xl;
+            }
+
+            .pulse-animation {
+                animation: pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
+            }
+
+            @keyframes pulse {
+                0%, 100% {
+                    opacity: 1;
+                }
+                50% {
+                    opacity: .8;
+                }
+            }
+
+            .import-step-card {
+                @apply glass-card p-6 hover-lift cursor-pointer;
+            }
+
+            .import-step-icon {
+                @apply w-12 h-12 rounded-full flex items-center justify-center text-white font-bold text-lg shadow-lg;
+            }
+
+            .upload-zone {
+                @apply border-2 border-dashed border-blue-300 rounded-xl p-8 text-center transition-all duration-300 hover:border-blue-500 hover:bg-blue-50/50;
+            }
+
+            .upload-zone.active {
+                @apply border-blue-500 bg-blue-50 ring-4 ring-blue-200 ring-opacity-50;
+            }
+
+            .result-card {
+                @apply glass-card p-6 border-l-4;
+            }
+
+            .result-success {
+                @apply border-l-green-500 bg-green-50/50;
+            }
+
+            .result-error {
+                @apply border-l-red-500 bg-red-50/50;
+            }
+
+            .floating-action {
+                @apply fixed bottom-8 right-8 z-50;
+            }
+
+            .btn-primary {
+                @apply bg-gradient-to-r from-blue-600 to-indigo-600 hover:from-blue-700 hover:to-indigo-700 text-white font-medium px-6 py-3 rounded-lg shadow-lg hover:shadow-xl transform transition-all duration-200 hover:-translate-y-0.5;
+            }
+
+            .btn-secondary {
+                @apply bg-white text-slate-700 border border-slate-300 hover:bg-slate-50 font-medium px-6 py-3 rounded-lg shadow hover:shadow-md transition-all duration-200;
+            }
+        </style>
+    @endpush
+
+    <div class="container mx-auto px-4 py-8 max-w-6xl">
+        <!-- 页面标题 -->
+        <div class="text-center mb-12">
+            <div class="glass-card inline-block px-8 py-4 mb-6">
+                <h1 class="text-4xl font-bold gradient-text mb-2">
+                    Excel 数据导入中心
+                </h1>
+                <p class="text-slate-600">
+                    高效批量导入教材数据到题库系统
+                </p>
+            </div>
+
+            <!-- 操作按钮 -->
+            <div class="flex justify-center gap-4 mt-6">
+                <button
+                    wire:click="downloadTemplate"
+                    class="btn-primary inline-flex items-center gap-2"
+                >
+                    <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4"></path>
+                    </svg>
+                    下载模板
+                </button>
+                <button
+                    wire:click="importData"
+                    class="bg-gradient-to-r from-green-600 to-emerald-600 hover:from-green-700 hover:to-emerald-700 text-white font-medium px-6 py-3 rounded-lg shadow-lg hover:shadow-xl transform transition-all duration-200 hover:-translate-y-0.5 inline-flex items-center gap-2"
+                    @if(!$file) disabled @endif
+                >
+                    <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 16a4 4 0 01-.88-7.903A5 5 0 1115.9 6L16 6a5 5 0 011 9.9M15 13l-3-3m0 0l-3 3m3-3v12"></path>
+                    </svg>
+                    导入数据
+                </button>
+            </div>
+        </div>
+
+        <!-- 导入流程步骤 -->
+        <div class="grid grid-cols-1 md:grid-cols-3 gap-6 mb-12">
+            <div class="import-step-card">
+                <div class="import-step-icon bg-gradient-to-r from-blue-500 to-blue-600 pulse-animation" style="animation-delay: 0s;">
+                    1
+                </div>
+                <h3 class="text-xl font-semibold text-slate-800 mt-4 mb-2">下载模板</h3>
+                <p class="text-slate-600 text-sm">
+                    点击上方"下载模板"按钮获取标准Excel模板，按照说明填写数据
+                </p>
+            </div>
+
+            <div class="import-step-card">
+                <div class="import-step-icon bg-gradient-to-r from-purple-500 to-purple-600 pulse-animation" style="animation-delay: 0.5s;">
+                    2
+                </div>
+                <h3 class="text-xl font-semibold text-slate-800 mt-4 mb-2">填写数据</h3>
+                <p class="text-slate-600 text-sm">
+                    根据模板说明填写教材信息，确保数据格式正确
+                </p>
+            </div>
+
+            <div class="import-step-card">
+                <div class="import-step-icon bg-gradient-to-r from-indigo-500 to-indigo-600 pulse-animation" style="animation-delay: 1s;">
+                    3
+                </div>
+                <h3 class="text-xl font-semibold text-slate-800 mt-4 mb-2">上传导入</h3>
+                <p class="text-slate-600 text-sm">
+                    选择填写好的Excel文件，系统将自动处理并同步到题库
+                </p>
+            </div>
+        </div>
+
+        <!-- 主表单卡片 -->
+        <div class="glass-card p-8 mb-8">
+            <form wire:submit.prevent="importData" class="space-y-8">
+                <!-- 导入类型选择 -->
+                <div class="space-y-3">
+                    <label class="block text-lg font-semibold text-slate-800">
+                        选择导入类型
+                    </label>
+                    <div class="grid grid-cols-1 md:grid-cols-3 gap-4">
+                        <!-- 教材系列 -->
+                        <label class="cursor-pointer">
+                            <input
+                                type="radio"
+                                wire:model.live="selectedType"
+                                value="textbook_series"
+                                class="sr-only"
+                            >
+                            <div class="relative p-6 rounded-xl shadow-md transition-all duration-300 hover:shadow-xl hover:-translate-y-1 border-2 {{ $selectedType === 'textbook_series' ? 'border-blue-500 bg-gradient-to-br from-blue-50 to-blue-100 ring-4 ring-blue-100 shadow-xl' : 'border-slate-200 bg-white' }}">
+                                <!-- 选中标记 -->
+                                <div class="absolute top-3 right-3 w-7 h-7 rounded-full border-2 flex items-center justify-center transition-all {{ $selectedType === 'textbook_series' ? 'border-blue-500 bg-blue-500' : 'border-slate-300 bg-white' }}">
+                                    @if($selectedType === 'textbook_series')
+                                        <svg class="w-4 h-4 text-white" fill="currentColor" viewBox="0 0 20 20">
+                                            <path fill-rule="evenodd" d="M16.707 5.293a1 1 0 010 1.414l-8 8a1 1 0 01-1.414 0l-4-4a1 1 0 011.414-1.414L8 12.586l7.293-7.293a1 1 0 011.414 0z" clip-rule="evenodd"></path>
+                                        </svg>
+                                    @endif
+                                </div>
+                                <div class="flex items-center space-x-4">
+                                    <div class="w-14 h-14 bg-gradient-to-br from-blue-400 to-blue-600 rounded-xl flex items-center justify-center shadow-lg">
+                                        <span class="text-white text-2xl">📚</span>
+                                    </div>
+                                    <div>
+                                        <h4 class="text-lg font-bold text-slate-800">教材系列</h4>
+                                        <p class="text-sm text-slate-500">导入教材系列信息</p>
+                                    </div>
+                                </div>
+                            </div>
+                        </label>
+
+                        <!-- 教材 -->
+                        <label class="cursor-pointer">
+                            <input
+                                type="radio"
+                                wire:model.live="selectedType"
+                                value="textbook"
+                                class="sr-only"
+                            >
+                            <div class="relative p-6 rounded-xl shadow-md transition-all duration-300 hover:shadow-xl hover:-translate-y-1 border-2 {{ $selectedType === 'textbook' ? 'border-purple-500 bg-gradient-to-br from-purple-50 to-purple-100 ring-4 ring-purple-100 shadow-xl' : 'border-slate-200 bg-white' }}">
+                                <!-- 选中标记 -->
+                                <div class="absolute top-3 right-3 w-7 h-7 rounded-full border-2 flex items-center justify-center transition-all {{ $selectedType === 'textbook' ? 'border-purple-500 bg-purple-500' : 'border-slate-300 bg-white' }}">
+                                    @if($selectedType === 'textbook')
+                                        <svg class="w-4 h-4 text-white" fill="currentColor" viewBox="0 0 20 20">
+                                            <path fill-rule="evenodd" d="M16.707 5.293a1 1 0 010 1.414l-8 8a1 1 0 01-1.414 0l-4-4a1 1 0 011.414-1.414L8 12.586l7.293-7.293a1 1 0 011.414 0z" clip-rule="evenodd"></path>
+                                        </svg>
+                                    @endif
+                                </div>
+                                <div class="flex items-center space-x-4">
+                                    <div class="w-14 h-14 bg-gradient-to-br from-purple-400 to-purple-600 rounded-xl flex items-center justify-center shadow-lg">
+                                        <span class="text-white text-2xl">📖</span>
+                                    </div>
+                                    <div>
+                                        <h4 class="text-lg font-bold text-slate-800">教材</h4>
+                                        <p class="text-sm text-slate-500">导入具体教材信息</p>
+                                    </div>
+                                </div>
+                            </div>
+                        </label>
+
+                        <!-- 教材目录 -->
+                        <label class="cursor-pointer">
+                            <input
+                                type="radio"
+                                wire:model.live="selectedType"
+                                value="textbook_catalog"
+                                class="sr-only"
+                            >
+                            <div class="relative p-6 rounded-xl shadow-md transition-all duration-300 hover:shadow-xl hover:-translate-y-1 border-2 {{ $selectedType === 'textbook_catalog' ? 'border-indigo-500 bg-gradient-to-br from-indigo-50 to-indigo-100 ring-4 ring-indigo-100 shadow-xl' : 'border-slate-200 bg-white' }}">
+                                <!-- 选中标记 -->
+                                <div class="absolute top-3 right-3 w-7 h-7 rounded-full border-2 flex items-center justify-center transition-all {{ $selectedType === 'textbook_catalog' ? 'border-indigo-500 bg-indigo-500' : 'border-slate-300 bg-white' }}">
+                                    @if($selectedType === 'textbook_catalog')
+                                        <svg class="w-4 h-4 text-white" fill="currentColor" viewBox="0 0 20 20">
+                                            <path fill-rule="evenodd" d="M16.707 5.293a1 1 0 010 1.414l-8 8a1 1 0 01-1.414 0l-4-4a1 1 0 011.414-1.414L8 12.586l7.293-7.293a1 1 0 011.414 0z" clip-rule="evenodd"></path>
+                                        </svg>
+                                    @endif
+                                </div>
+                                <div class="flex items-center space-x-4">
+                                    <div class="w-14 h-14 bg-gradient-to-br from-indigo-400 to-indigo-600 rounded-xl flex items-center justify-center shadow-lg">
+                                        <span class="text-white text-2xl">📑</span>
+                                    </div>
+                                    <div>
+                                        <h4 class="text-lg font-bold text-slate-800">教材目录</h4>
+                                        <p class="text-sm text-slate-500">导入教材目录结构</p>
+                                    </div>
+                                </div>
+                            </div>
+                        </label>
+                    </div>
+                </div>
+
+                <!-- 文件上传区域 -->
+                <div class="space-y-3">
+                    <label class="block text-lg font-semibold text-slate-800">
+                        上传 Excel 文件
+                    </label>
+                    <div
+                        x-data="{ isDragging: false }"
+                        x-on:dragover.prevent="isDragging = true"
+                        x-on:dragleave.prevent="isDragging = false"
+                        x-on:drop.prevent="isDragging = false; $event.dataTransfer.files[0] && ($event.target.files = $event.dataTransfer.files)"
+                        class="upload-zone"
+                        :class="{ 'active': isDragging }"
+                    >
+                        <input
+                            type="file"
+                            wire:model="file"
+                            accept=".xlsx,.xls"
+                            class="hidden"
+                            id="file-upload"
+                        >
+                        <label for="file-upload" class="cursor-pointer">
+                            <div class="space-y-4">
+                                <div class="mx-auto w-16 h-16 bg-gradient-to-r from-blue-100 to-indigo-100 rounded-full flex items-center justify-center">
+                                    <svg class="w-8 h-8 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 16a4 4 0 01-.88-7.903A5 5 0 1115.9 6L16 6a5 5 0 011 9.9M15 13l-3-3m0 0l-3 3m3-3v12"></path>
+                                    </svg>
+                                </div>
+                                <div>
+                                    <p class="text-lg font-semibold text-slate-700">
+                                        <span class="text-blue-600">点击上传</span> 或拖拽文件到此处
+                                    </p>
+                                    <p class="text-sm text-slate-500 mt-2">
+                                        支持 .xlsx, .xls 格式，最大 10MB
+                                    </p>
+                                </div>
+                            </div>
+                        </label>
+
+                        <!-- 文件预览 -->
+                        @if($file)
+                            <div class="mt-4 p-4 bg-green-50 rounded-lg border border-green-200">
+                                <div class="flex items-center space-x-3">
+                                    <span class="text-green-600 text-2xl">📄</span>
+                                    <div>
+                                        <p class="font-medium text-green-800">{{ $file->getClientOriginalName() }}</p>
+                                        <p class="text-sm text-green-600">
+                                            {{ number_format($file->getSize() / 1024, 2) }} KB
+                                        </p>
+                                    </div>
+                                </div>
+                            </div>
+                        @endif
+
+                        @error('file')
+                            <div class="mt-4 p-4 bg-red-50 rounded-lg border border-red-200">
+                                <p class="text-red-600 text-sm">{{ $message }}</p>
+                            </div>
+                        @enderror
+                    </div>
+                </div>
+            </form>
+        </div>
+
+        <!-- 导入结果展示 -->
+        @if($importResult)
+            <div class="mb-8">
+                @if($importResult['success'])
+                    <div class="result-card result-success">
+                        <div class="flex items-start space-x-4">
+                            <div class="w-12 h-12 bg-green-100 rounded-full flex items-center justify-center flex-shrink-0">
+                                <span class="text-green-600 text-xl">✓</span>
+                            </div>
+                            <div class="flex-1">
+                                <h3 class="text-xl font-semibold text-green-800 mb-3">导入完成！</h3>
+                                <div class="grid grid-cols-2 gap-4 mb-4">
+                                    <div class="bg-white/60 rounded-lg p-4">
+                                        <p class="text-sm text-green-700 mb-1">成功导入</p>
+                                        <p class="text-2xl font-bold text-green-900">{{ $importResult['success_count'] }}</p>
+                                    </div>
+                                    <div class="bg-white/60 rounded-lg p-4">
+                                        <p class="text-sm text-red-700 mb-1">导入失败</p>
+                                        <p class="text-2xl font-bold text-red-600">{{ $importResult['error_count'] }}</p>
+                                    </div>
+                                </div>
+
+                                @if(!empty($importResult['errors']))
+                                    <div class="bg-white/60 rounded-lg p-4">
+                                        <h4 class="font-semibold text-red-800 mb-2">错误详情：</h4>
+                                        <div class="max-h-40 overflow-y-auto space-y-1">
+                                            @foreach($importResult['errors'] as $error)
+                                                <p class="text-sm text-red-700">• {{ $error }}</p>
+                                            @endforeach
+                                        </div>
+                                    </div>
+                                @endif
+                            </div>
+                        </div>
+                    </div>
+                @else
+                    <div class="result-card result-error">
+                        <div class="flex items-start space-x-4">
+                            <div class="w-12 h-12 bg-red-100 rounded-full flex items-center justify-center flex-shrink-0">
+                                <span class="text-red-600 text-xl">⚠</span>
+                            </div>
+                            <div>
+                                <h3 class="text-xl font-semibold text-red-800 mb-2">导入失败</h3>
+                                <p class="text-red-700">{{ $importResult['message'] }}</p>
+                            </div>
+                        </div>
+                    </div>
+                @endif
+            </div>
+        @endif
+
+        <!-- 帮助信息 -->
+        <div class="glass-card p-6">
+            <div class="flex items-start space-x-3">
+                <span class="text-blue-600 text-2xl">💡</span>
+                <div>
+                    <h3 class="text-lg font-semibold text-slate-800 mb-2">使用帮助</h3>
+                    <ul class="space-y-2 text-sm text-slate-600">
+                        <li class="flex items-start space-x-2">
+                            <span class="text-blue-600 mt-1">•</span>
+                            <span>确保Excel文件格式与模板一致，遵循字段说明</span>
+                        </li>
+                        <li class="flex items-start space-x-2">
+                            <span class="text-blue-600 mt-1">•</span>
+                            <span>教材系列的别名字段必须唯一，创建后不可修改</span>
+                        </li>
+                        <li class="flex items-start space-x-2">
+                            <span class="text-blue-600 mt-1">•</span>
+                            <span>导入的数据将实时同步到题库服务，请谨慎操作</span>
+                        </li>
+                        <li class="flex items-start space-x-2">
+                            <span class="text-blue-600 mt-1">•</span>
+                            <span>如遇问题，请查看错误详情并修正后重新导入</span>
+                        </li>
+                    </ul>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>

verify_textbook_series_changes.php

@@ -0,0 +1,125 @@
+<?php
+
+/**
+ * 验证教材系列修改
+ * 检查起始年份字段和可选字段
+ */
+
+require_once __DIR__ . '/vendor/autoload.php';
+
+$app = require_once __DIR__ . '/bootstrap/app.php';
+$kernel = $app->make(Illuminate\Contracts\Console\Kernel::class);
+$kernel->bootstrap();
+
+echo "╔══════════════════════════════════════════════════════════════╗\n";
+echo "║            教材系列修改验证脚本                              ║\n";
+echo "╚══════════════════════════════════════════════════════════════╝\n\n";
+
+// 检查 1: 模型字段
+echo "📋 检查 1: 模型字段\n";
+echo str_repeat("─", 60) . "\n";
+
+$textbookSeriesModel = new App\Models\TextbookSeries();
+$fillableFields = $textbookSeriesModel->getFillable();
+
+echo "✅ TextbookSeries 模型 fillable 字段:\n";
+foreach ($fillableFields as $field) {
+    $isRequired = ($field === 'name') ? '(必需)' : '(可选)';
+    echo "   - {$field} {$isRequired}\n";
+}
+
+if (in_array('start_year', $fillableFields)) {
+    echo "✅ start_year 字段已添加到模型\n";
+} else {
+    echo "❌ start_year 字段未找到\n";
+}
+
+if (!in_array('slug', $textbookSeriesModel->getRules('slug'))) {
+    echo "✅ slug 字段已设为可选\n";
+}
+
+// 检查 2: 资源表单字段
+echo "\n📋 检查 2: 资源表单字段\n";
+echo str_repeat("─", 60) . "\n";
+
+$resource = new App\Filament\Resources\TextbookSeriesResource();
+$schema = $resource->form(new Filament\Schemas\Schema());
+
+echo "✅ 表单字段列表:\n";
+
+$formComponents = [
+    'name' => ['required' => true, 'type' => 'TextInput'],
+    'slug' => ['required' => false, 'type' => 'TextInput'],
+    'publisher' => ['required' => false, 'type' => 'TextInput'],
+    'region' => ['required' => false, 'type' => 'TextInput'],
+    'stages' => ['required' => false, 'type' => 'TextInput'],
+    'start_year' => ['required' => false, 'type' => 'TextInput'],
+    'is_active' => ['required' => false, 'type' => 'Toggle'],
+    'sort_order' => ['required' => false, 'type' => 'TextInput'],
+    'meta' => ['required' => false, 'type' => 'Textarea'],
+];
+
+foreach ($formComponents as $field => $info) {
+    $required = $info['required'] ? '✓' : '○';
+    echo "   {$required} {$field} ({$info['type']})\n";
+}
+
+// 检查 3: 表格列
+echo "\n📋 检查 3: 表格列\n";
+echo str_repeat("─", 60) . "\n";
+
+echo "✅ 表格列列表:\n";
+
+$tableColumns = [
+    'name' => 'TextColumn',
+    'slug' => 'TextColumn',
+    'publisher' => 'TextColumn',
+    'region' => 'TextColumn',
+    'stages' => 'BadgeColumn',
+    'start_year' => 'TextColumn',
+    'is_active' => 'ToggleColumn',
+    'sort_order' => 'TextColumn',
+    'created_at' => 'TextColumn',
+];
+
+foreach ($tableColumns as $field => $type) {
+    echo "   ✓ {$field} ({$type})\n";
+}
+
+// 检查 4: API 模型
+echo "\n📋 检查 4: API 模型\n";
+echo str_repeat("─", 60) . "\n";
+
+$apiTextbookSeries = new App\Filament\Resources\TextbookSeriesResource\ApiTextbookSeries();
+$apiFillableFields = $apiTextbookSeries->getFillable();
+
+echo "✅ ApiTextbookSeries 模型 fillable 字段:\n";
+foreach ($apiFillableFields as $field) {
+    echo "   - {$field}\n";
+}
+
+if (in_array('start_year', $apiFillableFields)) {
+    echo "✅ start_year 字段已添加到 API 模型\n";
+} else {
+    echo "❌ start_year 字段未在 API 模型中找到\n";
+}
+
+// 最终报告
+echo "\n" . str_repeat("═", 60) . "\n";
+echo "                    验证完成                        \n";
+echo str_repeat("═", 60) . "\n\n";
+
+echo "🎉 修改总结:\n";
+echo "1. ✅ 增加了 'start_year' (起始年份) 字段\n";
+echo "2. ✅ 除 'name' 字段外，其他字段都设为可选\n";
+echo "3. ✅ 'slug' 字段已移除 required 验证\n";
+echo "4. ✅ 表格中添加了 'start_year' 列\n";
+echo "5. ✅ API 模型已更新\n\n";
+
+echo "📝 下一步操作:\n";
+echo "1. 访问 http://fa.test/admin/textbook-series/create\n";
+echo "2. 测试创建教材系列功能\n";
+echo "3. 验证起始年份字段是否正常显示\n";
+echo "4. 验证除名字外其他字段是否可选\n\n";
+
+echo "✨ 修改完成！\n";