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

routes/api.php

@@ -2,39 +2,53 @@
 
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Route;
-use App\Http\Controllers\Api\MemberController;
+use App\Http\Controllers\Api\V1\MemberController;
 
 /*
 |--------------------------------------------------------------------------
 | API Routes
 |--------------------------------------------------------------------------
 |
-| Here is where you can register API routes for your application. These
-| routes are loaded by the RouteServiceProvider and all of them will
-| be assigned to the "api" middleware group. Make something great!
+| 這裡註冊所有的 API 路由，預設套用 api middleware group。
+| 加入 v1 前綴與 throttle 進行速率限制防護。
 |
 */
 
-Route::middleware('auth:sanctum')->get('/user', function (Request $request) {
-    return $request->user();
-});
+Route::prefix('v1')->middleware(['throttle:api'])->group(function () {
+    
+    // 基本的使用者資料查詢
+    Route::middleware('auth:sanctum')->get('/user', function (Request $request) {
+        return $request->user();
+    });
 
-/*
-|--------------------------------------------------------------------------
-| 會員 API Routes
-|--------------------------------------------------------------------------
-*/
+    /*
+    |--------------------------------------------------------------------------
+    | 會員 API Routes
+    |--------------------------------------------------------------------------
+    */
+    
+    // 公開路由（無需認證）
+    Route::prefix('members')->group(function () {
+        Route::post('/register', [MemberController::class, 'register']);
+        Route::post('/login', [MemberController::class, 'login']);
+        Route::post('/social-login', [MemberController::class, 'socialLogin']);
+    });
 
-// 公開路由（無需認證）
-Route::prefix('members')->group(function () {
-    Route::post('/register', [MemberController::class, 'register']);
-    Route::post('/login', [MemberController::class, 'login']);
-    Route::post('/social-login', [MemberController::class, 'socialLogin']);
-});
+    // 需認證路由
+    Route::prefix('members')->middleware('auth:sanctum')->group(function () {
+        Route::get('/profile', [MemberController::class, 'profile']);
+        Route::put('/profile', [MemberController::class, 'updateProfile']);
+        Route::post('/logout', [MemberController::class, 'logout']);
+    });
+
+    /*
+    |--------------------------------------------------------------------------
+    | 機台 API Routes (IoT)
+    |--------------------------------------------------------------------------
+    | 專門用於機台通訊，頻率較高，建議搭配異步處理。
+    */
+    Route::prefix('machines')->group(function () {
+        Route::post('/{id}/logs', [\App\Http\Controllers\Api\V1\MachineController::class, 'storeLog']);
+    });
 
-// 需認證路由
-Route::prefix('members')->middleware('auth:sanctum')->group(function () {
-    Route::get('/profile', [MemberController::class, 'profile']);
-    Route::put('/profile', [MemberController::class, 'updateProfile']);
-    Route::post('/logout', [MemberController::class, 'logout']);
 });