feat: 第五阶段办公协同/统计报表/知识库模块

- 新增3个migration(9张表): office(6表)/report(1表)/kb(2表) - 新增9个Model + 9个Controller - 新增43条API路由(总计305条) - 新增3个前端API模块 + 10个管理页面 - 迁移运行通过, vite build验证通过
2026-03-13 21:43:10 +08:00
parent fb5e0daf1a
commit 058ee507fa
34 changed files with 2595 additions and 0 deletions
@@ -0,0 +1,83 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Kb;
+
+use App\Http\Controllers\Controller;
+use App\Models\Kb\KbArticle;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class KbArticleController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = KbArticle::query()->with(['category', 'author']);
+        $query->when($request->category_id, fn($q, $v) => $q->where('category_id', $v));
+        $query->when($request->filled('status'), fn($q) => $q->where('status', $request->status));
+        $query->when($request->filled('visibility'), fn($q) => $q->where('visibility', $request->visibility));
+        $query->when($request->keyword, fn($q, $v) => $q->where('title', 'like', "%{$v}%"));
+
+        return $this->paginate($query->latest()->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'title' => 'required|string|max:255',
+            'content' => 'nullable|string',
+            'category_id' => 'nullable|exists:kb_categories,id',
+            'visibility' => 'nullable|integer|in:1,2',
+            'cover_image' => 'nullable|string|max:255',
+            'attachments' => 'nullable|array',
+        ]);
+        $validated['author_id'] = auth()->id();
+        $validated['status'] = 0;
+
+        $article = KbArticle::create($validated);
+        return $this->success($article->load(['category', 'author']));
+    }
+
+    public function show(KbArticle $kbArticle): JsonResponse
+    {
+        $kbArticle->increment('views');
+        return $this->success($kbArticle->load(['category', 'author']));
+    }
+
+    public function update(Request $request, KbArticle $kbArticle): JsonResponse
+    {
+        $validated = $request->validate([
+            'title' => 'sometimes|string|max:255',
+            'content' => 'nullable|string',
+            'category_id' => 'nullable|exists:kb_categories,id',
+            'visibility' => 'nullable|integer|in:1,2',
+            'cover_image' => 'nullable|string|max:255',
+            'attachments' => 'nullable|array',
+        ]);
+        $kbArticle->update($validated);
+        return $this->success($kbArticle);
+    }
+
+    public function destroy(KbArticle $kbArticle): JsonResponse
+    {
+        $kbArticle->delete();
+        return $this->success(null);
+    }
+
+    public function publish(KbArticle $kbArticle): JsonResponse
+    {
+        if ($kbArticle->status >= 2) {
+            return $this->error('当前状态不允许发布');
+        }
+        $kbArticle->update(['status' => 2, 'published_at' => now()]);
+        return $this->success($kbArticle);
+    }
+
+    public function offline(KbArticle $kbArticle): JsonResponse
+    {
+        if ($kbArticle->status !== 2) {
+            return $this->error('仅已发布文章可下架');
+        }
+        $kbArticle->update(['status' => 3]);
+        return $this->success($kbArticle);
+    }
+}
@@ -0,0 +1,63 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Kb;
+
+use App\Http\Controllers\Controller;
+use App\Models\Kb\KbCategory;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class KbCategoryController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = KbCategory::query()->with('children');
+        $query->when($request->filled('status'), fn($q) => $q->where('status', $request->status));
+        $query->where('parent_id', 0);
+
+        return $this->success($query->orderBy('sort')->orderBy('id')->get());
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:100',
+            'parent_id' => 'nullable|integer|min:0',
+            'sort' => 'nullable|integer',
+            'status' => 'nullable|integer|in:0,1',
+        ]);
+        $validated['parent_id'] = $validated['parent_id'] ?? 0;
+
+        $category = KbCategory::create($validated);
+        return $this->success($category);
+    }
+
+    public function show(KbCategory $kbCategory): JsonResponse
+    {
+        return $this->success($kbCategory->load('children'));
+    }
+
+    public function update(Request $request, KbCategory $kbCategory): JsonResponse
+    {
+        $validated = $request->validate([
+            'name' => 'sometimes|string|max:100',
+            'parent_id' => 'nullable|integer|min:0',
+            'sort' => 'nullable|integer',
+            'status' => 'nullable|integer|in:0,1',
+        ]);
+        $kbCategory->update($validated);
+        return $this->success($kbCategory);
+    }
+
+    public function destroy(KbCategory $kbCategory): JsonResponse
+    {
+        if ($kbCategory->children()->exists()) {
+            return $this->error('请先删除子分类');
+        }
+        if ($kbCategory->articles()->exists()) {
+            return $this->error('该分类下还有文章，无法删除');
+        }
+        $kbCategory->delete();
+        return $this->success(null);
+    }
+}