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,70 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Office;
+
+use App\Http\Controllers\Controller;
+use App\Models\Office\Announcement;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class AnnouncementController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = Announcement::query()->with('author');
+        $query->when($request->type, fn($q, $v) => $q->where('type', $v));
+        $query->when($request->has('publish_status'), fn($q) => $q->where('publish_status', $request->publish_status));
+
+        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' => 'required|string',
+            'type' => 'sometimes|integer|in:1,2,3',
+            'is_top' => 'sometimes|boolean',
+        ]);
+        $validated['author_id'] = auth()->id();
+
+        return $this->success(Announcement::create($validated));
+    }
+
+    public function show(Announcement $announcement): JsonResponse
+    {
+        return $this->success($announcement->load('author'));
+    }
+
+    public function update(Request $request, Announcement $announcement): JsonResponse
+    {
+        $validated = $request->validate([
+            'title' => 'sometimes|string|max:255',
+            'content' => 'sometimes|string',
+            'type' => 'sometimes|integer|in:1,2,3',
+            'is_top' => 'sometimes|boolean',
+        ]);
+        $announcement->update($validated);
+
+        return $this->success($announcement);
+    }
+
+    public function destroy(Announcement $announcement): JsonResponse
+    {
+        $announcement->delete();
+        return $this->success(null);
+    }
+
+    public function publish(Announcement $announcement): JsonResponse
+    {
+        if ($announcement->publish_status === 1) {
+            return $this->error('该公告已发布', 40001);
+        }
+        $announcement->update([
+            'publish_status' => 1,
+            'published_at' => now(),
+        ]);
+
+        return $this->success($announcement);
+    }
+}
@@ -0,0 +1,127 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Office;
+
+use App\Http\Controllers\Controller;
+use App\Models\Office\Approval;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class ApprovalController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = Approval::query()->with(['template', 'applicant']);
+        $query->when($request->has('status'), fn($q) => $q->where('status', $request->status));
+        $query->when($request->applicant_id, fn($q, $v) => $q->where('applicant_id', $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',
+            'template_id' => 'nullable|exists:approval_templates,id',
+            'form_data' => 'nullable|array',
+            'related_type' => 'nullable|string|max:50',
+            'related_id' => 'nullable|integer',
+        ]);
+        $validated['applicant_id'] = auth()->id();
+        $validated['status'] = 0;
+
+        return $this->success(Approval::create($validated));
+    }
+
+    public function show(Approval $approval): JsonResponse
+    {
+        return $this->success($approval->load(['template', 'applicant', 'nodes.approver']));
+    }
+
+    public function update(Request $request, Approval $approval): JsonResponse
+    {
+        if ($approval->status > 1) {
+            return $this->error('该审批已完结，无法修改', 40001);
+        }
+        $validated = $request->validate([
+            'title' => 'sometimes|string|max:255',
+            'form_data' => 'nullable|array',
+        ]);
+        $approval->update($validated);
+
+        return $this->success($approval);
+    }
+
+    public function destroy(Approval $approval): JsonResponse
+    {
+        if ($approval->status > 1) {
+            return $this->error('该审批已完结，无法删除', 40001);
+        }
+        $approval->delete();
+
+        return $this->success(null);
+    }
+
+    public function approve(Approval $approval): JsonResponse
+    {
+        $node = $approval->nodes()
+            ->where('approver_id', auth()->id())
+            ->where('action', 0)
+            ->where('node_order', $approval->current_node)
+            ->first();
+
+        if (!$node) {
+            return $this->error('无待处理的审批节点', 40001);
+        }
+
+        $node->update(['action' => 1, 'acted_at' => now()]);
+
+        $pendingNodes = $approval->nodes()->where('action', 0)->exists();
+        if (!$pendingNodes) {
+            $approval->update(['status' => 2]);
+        } else {
+            $approval->update([
+                'status' => 1,
+                'current_node' => $approval->current_node + 1,
+            ]);
+        }
+
+        return $this->success($approval->load('nodes'));
+    }
+
+    public function reject(Request $request, Approval $approval): JsonResponse
+    {
+        $node = $approval->nodes()
+            ->where('approver_id', auth()->id())
+            ->where('action', 0)
+            ->where('node_order', $approval->current_node)
+            ->first();
+
+        if (!$node) {
+            return $this->error('无待处理的审批节点', 40001);
+        }
+
+        $validated = $request->validate([
+            'comment' => 'nullable|string|max:255',
+        ]);
+
+        $node->update([
+            'action' => 2,
+            'comment' => $validated['comment'] ?? null,
+            'acted_at' => now(),
+        ]);
+        $approval->update(['status' => 3]);
+
+        return $this->success($approval->load('nodes'));
+    }
+
+    public function withdraw(Approval $approval): JsonResponse
+    {
+        if ($approval->status > 1) {
+            return $this->error('该审批已完结，无法撤回', 40001);
+        }
+        $approval->update(['status' => 4]);
+
+        return $this->success($approval);
+    }
+}
@@ -0,0 +1,60 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Office;
+
+use App\Http\Controllers\Controller;
+use App\Models\Office\ApprovalTemplate;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class ApprovalTemplateController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = ApprovalTemplate::query();
+        $query->when($request->type, fn($q, $v) => $q->where('type', $v));
+        $query->when($request->has('status'), fn($q) => $q->where('status', $request->status));
+
+        return $this->paginate($query->orderBy('sort')->latest()->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:100',
+            'type' => 'required|integer|in:1,2,3,4,5',
+            'form_fields' => 'nullable|array',
+            'flow_nodes' => 'nullable|array',
+            'status' => 'sometimes|integer|in:0,1',
+            'sort' => 'sometimes|integer',
+        ]);
+
+        return $this->success(ApprovalTemplate::create($validated));
+    }
+
+    public function show(ApprovalTemplate $approvalTemplate): JsonResponse
+    {
+        return $this->success($approvalTemplate);
+    }
+
+    public function update(Request $request, ApprovalTemplate $approvalTemplate): JsonResponse
+    {
+        $validated = $request->validate([
+            'name' => 'sometimes|string|max:100',
+            'type' => 'sometimes|integer|in:1,2,3,4,5',
+            'form_fields' => 'nullable|array',
+            'flow_nodes' => 'nullable|array',
+            'status' => 'sometimes|integer|in:0,1',
+            'sort' => 'sometimes|integer',
+        ]);
+        $approvalTemplate->update($validated);
+
+        return $this->success($approvalTemplate);
+    }
+
+    public function destroy(ApprovalTemplate $approvalTemplate): JsonResponse
+    {
+        $approvalTemplate->delete();
+        return $this->success(null);
+    }
+}
@@ -0,0 +1,52 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Office;
+
+use App\Http\Controllers\Controller;
+use App\Models\Office\Handover;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class HandoverController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = Handover::query()->with(['handoverUser', 'receiverUser']);
+        $query->when($request->shift_date, fn($q, $v) => $q->where('shift_date', $v));
+        $query->when($request->shift_type, fn($q, $v) => $q->where('shift_type', $v));
+
+        return $this->paginate($query->latest('created_at')->paginate($request->input('per_page', 15)));
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'shift_date' => 'required|date',
+            'shift_type' => 'required|integer|in:1,2,3,4',
+            'content' => 'required|string',
+            'issues' => 'nullable|string',
+        ]);
+        $validated['handover_user_id'] = auth()->id();
+
+        return $this->success(Handover::create($validated));
+    }
+
+    public function show(Handover $handover): JsonResponse
+    {
+        return $this->success($handover->load(['handoverUser', 'receiverUser']));
+    }
+
+    public function confirm(Handover $handover): JsonResponse
+    {
+        if ($handover->status === 1) {
+            return $this->error('该交接班已确认', 40001);
+        }
+        $handover->update([
+            'receiver_user_id' => auth()->id(),
+            'status' => 1,
+            'confirmed_at' => now(),
+        ]);
+
+        return $this->success($handover);
+    }
+}
@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Office;
+
+use App\Http\Controllers\Controller;
+use App\Models\Office\Notification;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class NotificationController extends Controller
+{
+    public function index(Request $request): JsonResponse
+    {
+        $query = Notification::query()->where('user_id', auth()->id());
+        $query->when($request->type, fn($q, $v) => $q->where('type', $v));
+        $query->when($request->has('is_read'), fn($q) => $q->where('is_read', $request->boolean('is_read')));
+
+        return $this->paginate($query->latest('created_at')->paginate($request->input('per_page', 15)));
+    }
+
+    public function markRead(Notification $notification): JsonResponse
+    {
+        if ($notification->user_id !== auth()->id()) {
+            return $this->error('无权操作', 40003, 403);
+        }
+        $notification->update(['is_read' => true, 'read_at' => now()]);
+
+        return $this->success($notification);
+    }
+
+    public function markAllRead(): JsonResponse
+    {
+        Notification::query()
+            ->where('user_id', auth()->id())
+            ->where('is_read', false)
+            ->update(['is_read' => true, 'read_at' => now()]);
+
+        return $this->success(null);
+    }
+}