Add headless CMS for official site content management

Integrate article and page management into the Laravel admin dashboard
to serve as a headless CMS for the Next.js frontend (usher-site).

Backend:
- 7 migrations: article_categories, article_tags, articles, pivots, attachments, pages
- 5 models with relationships: Article, ArticleCategory, ArticleTag, ArticleAttachment, Page
- 4 admin controllers: articles (with publish/archive/pin), categories, tags, pages
- Admin views with EasyMDE markdown editor, multi-select categories/tags
- Navigation section "官網管理" in admin sidebar

API (v1):
- GET /api/v1/articles (filtered by type, category, tag, search; paginated)
- GET /api/v1/articles/{slug} (with related articles)
- GET /api/v1/categories
- GET /api/v1/pages/{slug} (with children)
- GET /api/v1/homepage (aggregated homepage data)
- Attachment download endpoint
- CORS configured for usher.org.tw, vercel.app, localhost:3000

Content migration:
- ImportHugoContent command: imports Hugo markdown files as articles/pages
- Successfully imported 27 articles, 17 categories, 11 tags, 9 pages

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

routes/api.php

@@ -1,5 +1,8 @@
 <?php
 
+use App\Http\Controllers\Api\ArticleController;
+use App\Http\Controllers\Api\HomepageController;
+use App\Http\Controllers\Api\PageController;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Route;
 
@@ -17,3 +20,28 @@ use Illuminate\Support\Facades\Route;
 Route::middleware('auth:sanctum')->get('/user', function (Request $request) {
     return $request->user();
 });
+
+// Public API v1
+Route::prefix('v1')->group(function () {
+    // Articles
+    Route::get('/articles', [ArticleController::class, 'index']);
+    Route::get('/articles/{slug}', [ArticleController::class, 'show']);
+    Route::get('/articles/{slug}/attachments/{id}/download', [ArticleController::class, 'downloadAttachment']);
+
+    // Categories
+    Route::get('/categories', function () {
+        $categories = \App\Models\ArticleCategory::withCount(['articles' => function ($q) {
+            $q->active()->forAccessLevel();
+        }])
+            ->orderBy('sort_order')
+            ->get();
+
+        return \App\Http\Resources\CategoryResource::collection($categories);
+    });
+
+    // Pages
+    Route::get('/pages/{slug}', [PageController::class, 'show']);
+
+    // Homepage
+    Route::get('/homepage', [HomepageController::class, 'index']);
+});

routes/web.php

@@ -23,6 +23,10 @@ use App\Http\Controllers\PublicDocumentController;
 use App\Http\Controllers\Admin\DocumentController;
 use App\Http\Controllers\Admin\DocumentCategoryController;
 use App\Http\Controllers\Admin\AnnouncementController;
+use App\Http\Controllers\Admin\ArticleController;
+use App\Http\Controllers\Admin\ArticleCategoryController;
+use App\Http\Controllers\Admin\ArticleTagController;
+use App\Http\Controllers\Admin\PageController;
 use App\Http\Controllers\PublicBugReportController;
 use App\Http\Controllers\IncomeController;
 use Illuminate\Support\Facades\Route;
@@ -314,6 +318,51 @@ Route::middleware(['auth', 'admin'])->prefix('admin')->name('admin.')->group(fun
     Route::post('/announcements/{announcement}/pin', [AnnouncementController::class, 'pin'])->name('announcements.pin');
     Route::post('/announcements/{announcement}/unpin', [AnnouncementController::class, 'unpin'])->name('announcements.unpin');
 
+    // Article Management (官網文章管理)
+    Route::get('/articles', [ArticleController::class, 'index'])->name('articles.index');
+    Route::get('/articles/create', [ArticleController::class, 'create'])->name('articles.create');
+    Route::post('/articles', [ArticleController::class, 'store'])->name('articles.store');
+    Route::get('/articles/{article}', [ArticleController::class, 'show'])->name('articles.show');
+    Route::get('/articles/{article}/edit', [ArticleController::class, 'edit'])->name('articles.edit');
+    Route::patch('/articles/{article}', [ArticleController::class, 'update'])->name('articles.update');
+    Route::delete('/articles/{article}', [ArticleController::class, 'destroy'])->name('articles.destroy');
+
+    // Article Actions
+    Route::post('/articles/{article}/publish', [ArticleController::class, 'publish'])->name('articles.publish');
+    Route::post('/articles/{article}/archive', [ArticleController::class, 'archive'])->name('articles.archive');
+    Route::post('/articles/{article}/pin', [ArticleController::class, 'pin'])->name('articles.pin');
+    Route::post('/articles/{article}/unpin', [ArticleController::class, 'unpin'])->name('articles.unpin');
+
+    // Article Attachments
+    Route::post('/articles/{article}/attachments', [ArticleController::class, 'uploadAttachment'])->name('articles.attachments.store');
+    Route::delete('/articles/{article}/attachments/{attachment}', [ArticleController::class, 'deleteAttachment'])->name('articles.attachments.destroy');
+
+    // Article Categories Management
+    Route::get('/article-categories', [ArticleCategoryController::class, 'index'])->name('article-categories.index');
+    Route::get('/article-categories/create', [ArticleCategoryController::class, 'create'])->name('article-categories.create');
+    Route::post('/article-categories', [ArticleCategoryController::class, 'store'])->name('article-categories.store');
+    Route::get('/article-categories/{articleCategory}/edit', [ArticleCategoryController::class, 'edit'])->name('article-categories.edit');
+    Route::patch('/article-categories/{articleCategory}', [ArticleCategoryController::class, 'update'])->name('article-categories.update');
+    Route::delete('/article-categories/{articleCategory}', [ArticleCategoryController::class, 'destroy'])->name('article-categories.destroy');
+
+    // Article Tags Management
+    Route::get('/article-tags', [ArticleTagController::class, 'index'])->name('article-tags.index');
+    Route::get('/article-tags/create', [ArticleTagController::class, 'create'])->name('article-tags.create');
+    Route::post('/article-tags', [ArticleTagController::class, 'store'])->name('article-tags.store');
+    Route::get('/article-tags/{articleTag}/edit', [ArticleTagController::class, 'edit'])->name('article-tags.edit');
+    Route::patch('/article-tags/{articleTag}', [ArticleTagController::class, 'update'])->name('article-tags.update');
+    Route::delete('/article-tags/{articleTag}', [ArticleTagController::class, 'destroy'])->name('article-tags.destroy');
+
+    // Page Management (官網頁面管理)
+    Route::get('/pages', [PageController::class, 'index'])->name('pages.index');
+    Route::get('/pages/create', [PageController::class, 'create'])->name('pages.create');
+    Route::post('/pages', [PageController::class, 'store'])->name('pages.store');
+    Route::get('/pages/{page}', [PageController::class, 'show'])->name('pages.show');
+    Route::get('/pages/{page}/edit', [PageController::class, 'edit'])->name('pages.edit');
+    Route::patch('/pages/{page}', [PageController::class, 'update'])->name('pages.update');
+    Route::delete('/pages/{page}', [PageController::class, 'destroy'])->name('pages.destroy');
+    Route::post('/pages/{page}/publish', [PageController::class, 'publish'])->name('pages.publish');
+
     // System Settings (requires manage_system_settings permission)
     Route::middleware('can:manage_system_settings')->prefix('settings')->name('settings.')->group(function () {
         Route::get('/', [\App\Http\Controllers\Admin\SystemSettingsController::class, 'index'])->name('index');