[DOCS] 現代化 IoT API (B010) 通訊協議與文件中心 UI/UX 重整

app/Http/Controllers/Admin/MachineController.php

@@ -30,7 +30,7 @@ class MachineController extends AdminController
             $machines = $query->when($request->status, function ($query, $status) {
                     return $query->where('status', $status);
                 })
-                ->latest()
+                ->orderBy("last_heartbeat_at", "desc")->orderBy("id", "desc")
                 ->paginate($per_page)
                 ->withQueryString();
 
@@ -47,7 +47,7 @@ class MachineController extends AdminController
                 ->withCount(['slots as warning_count' => function ($q) {
                     $q->whereBetween('expiry_date', [now()->toDateString(), now()->addDays(7)->toDateString()]);
                 }])
-                ->latest()
+                ->orderBy("last_heartbeat_at", "desc")->orderBy("id", "desc")
                 ->paginate($per_page)
                 ->withQueryString();
 

app/Http/Controllers/ApiDocsController.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use Illuminate\Http\Request;
+
+class ApiDocsController extends Controller
+{
+    /**
+     * Display the API documentation page.
+     */
+    public function index()
+    {
+        $docs = config('api-docs');
+        
+        return view('docs.api-docs', compact('docs'));
+    }
+}

app/Services/Machine/MachineService.php

@@ -21,12 +21,12 @@ class MachineService
         return DB::transaction(function () use ($serialNo, $data) {
             $machine = Machine::where('serial_no', $serialNo)->firstOrFail();
 
-            // 參數相容性處理 (Mapping legacy fields to new fields)
+            // 採用現代化語意命名 (Modern semantic naming)
             $temperature = $data['temperature'] ?? $machine->temperature;
-            $currentPage = $data['current_page'] ?? $data['M_Stus2'] ?? $machine->current_page;
-            $doorStatus = $data['door_status'] ?? $data['door'] ?? $machine->door_status;
-            $firmwareVersion = $data['firmware_version'] ?? $data['M_Ver'] ?? $machine->firmware_version;
-            $model = $data['model'] ?? $data['M_Stus'] ?? $machine->model;
+            $currentPage = $data['current_page'] ?? $machine->current_page;
+            $doorStatus = $data['door_status'] ?? $machine->door_status;
+            $firmwareVersion = $data['firmware_version'] ?? $machine->firmware_version;
+            $model = $data['model'] ?? $machine->model;
 
             $updateData = [
                 'status' => 'online',