feat: 實作機台日誌核心功能與 IoT 高併發處理架構

app/Http/Controllers/Admin/AdminController.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace App\Http\Controllers\Admin;
+
+use App\Http\Controllers\Controller;
+
+abstract class AdminController extends Controller
+{
+    // Admin 相關的共用邏輯可寫於此
+}

app/Http/Controllers/Admin/MachineController.php

@@ -2,142 +2,36 @@
 
 namespace App\Http\Controllers\Admin;
 
-use App\Http\Controllers\Controller;
-use App\Models\Machine;
+use App\Models\Machine\Machine;
 use Illuminate\Http\Request;
+use Illuminate\View\View;
 
-class MachineController extends Controller
+class MachineController extends AdminController
 {
     /**
-     * Display a listing of the resource.
+     * 顯示所有機台列表
      */
-    public function index()
+    public function index(Request $request): View
     {
-        $machines = Machine::latest()->paginate(10);
+        $machines = Machine::query()
+            ->when($request->status, function ($query, $status) {
+                return $query->where('status', $status);
+            })
+            ->latest()
+            ->paginate(10);
+
         return view('admin.machines.index', compact('machines'));
     }
 
     /**
-     * Show the form for creating a new resource.
+     * 顯示特定機台的日誌與詳細資訊
      */
-    public function create()
+    public function show(int $id): View
     {
-        return view('admin.machines.create');
-    }
+        $machine = Machine::with(['logs' => function ($query) {
+            $query->latest()->limit(50);
+        }])->findOrFail($id);
 
-    /**
-     * Store a newly created resource in storage.
-     */
-    public function store(Request $request)
-    {
-        $validated = $request->validate([
-            'name' => 'required|string|max:255',
-            'location' => 'nullable|string|max:255',
-            'status' => 'required|in:online,offline,error',
-            'temperature' => 'nullable|numeric',
-            'firmware_version' => 'nullable|string|max:50',
-        ]);
-
-        Machine::create($validated);
-
-        return redirect()->route('admin.machines.index')
-            ->with('success', '機台建立成功');
-    }
-
-    /**
-     * Display the specified resource.
-     */
-    public function show(Machine $machine)
-    {
         return view('admin.machines.show', compact('machine'));
     }
-
-    /**
-     * Show the form for editing the specified resource.
-     */
-    public function edit(Machine $machine)
-    {
-        return view('admin.machines.edit', compact('machine'));
-    }
-
-    /**
-     * Update the specified resource in storage.
-     */
-    public function update(Request $request, Machine $machine)
-    {
-        $validated = $request->validate([
-            'name' => 'required|string|max:255',
-            'location' => 'nullable|string|max:255',
-            'status' => 'required|in:online,offline,error',
-            'temperature' => 'nullable|numeric',
-            'firmware_version' => 'nullable|string|max:50',
-        ]);
-
-        $machine->update($validated);
-
-        return redirect()->route('admin.machines.index')
-            ->with('success', '機台更新成功');
-    }
-
-    /**
-     * Remove the specified resource from storage.
-     */
-    public function destroy(Machine $machine)
-    {
-        $machine->delete();
-
-        return redirect()->route('admin.machines.index')
-            ->with('success', '機台已刪除');
-    }
-
-    // 機台日誌
-    public function logs()
-    {
-        return view('admin.placeholder', [
-            'title' => '機台日誌',
-            'description' => '機台操作歷史紀錄回溯',
-            'features' => [
-                '操作時間戳記',
-                '事件類型分類',
-                '操作人員記錄',
-                '詳細描述查詢',
-            ]
-        ]);
-    }
-
-    // 機台權限
-    public function permissions()
-    {
-        return view('admin.placeholder', [
-            'title' => '機台權限',
-            'description' => '機台存取權限控管',
-        ]);
-    }
-
-    // 機台稼動率
-    public function utilization()
-    {
-        return view('admin.placeholder', [
-            'title' => '機台稼動率',
-            'description' => '機台運行效率分析',
-        ]);
-    }
-
-    // 效期管理
-    public function expiry()
-    {
-        return view('admin.placeholder', [
-            'title' => '效期管理',
-            'description' => '商品效期與貨道出貨控制',
-        ]);
-    }
-
-    // 維修管理單
-    public function maintenance()
-    {
-        return view('admin.placeholder', [
-            'title' => '維修管理單',
-            'description' => '機台維修工單系統',
-        ]);
-    }
 }

app/Http/Controllers/Api/V1/ApiController.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Http\Controllers\Controller;
+use App\Traits\ApiResponse;
+
+abstract class ApiController extends Controller
+{
+    use ApiResponse;
+}

app/Http/Controllers/Api/V1/MachineController.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Jobs\Machine\ProcessMachineLog;
+use App\Models\Machine\Machine;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Validator;
+
+class MachineController extends ApiController
+{
+    /**
+     * 接收機台回傳的日誌 (IoT Endpoint)
+     * 採用異步處理 (Queue)
+     */
+    public function storeLog(Request $request, int $id): JsonResponse
+    {
+        $validator = Validator::make($request->all(), [
+            'level' => 'required|string|in:info,warning,error',
+            'message' => 'required|string',
+            'context' => 'nullable|array',
+        ]);
+
+        if ($validator->fails()) {
+            return $this->errorResponse('Validation error', 422, $validator->errors());
+        }
+
+        // 檢查機台是否存在
+        if (!Machine::where('id', $id)->exists()) {
+            return $this->errorResponse('Machine not found', 404);
+        }
+
+        // 丟入隊列進行異步處理，回傳 202 Accepted
+        ProcessMachineLog::dispatch($id, $request->only(['level', 'message', 'context']));
+
+        return $this->successResponse([], 'Log accepted. Processing asynchronously.', 202);
+    }
+}

app/Http/Controllers/Auth/RegisteredUserController.php

@@ -3,7 +3,7 @@
 namespace App\Http\Controllers\Auth;
 
 use App\Http\Controllers\Controller;
-use App\Models\User;
+use App\Models\System\User;
 use App\Providers\RouteServiceProvider;
 use Illuminate\Auth\Events\Registered;
 use Illuminate\Http\RedirectResponse;