feat: add ZKTeco connection testing wizard in branch form

app/Http/Controllers/BranchController.php

@@ -194,4 +194,40 @@ class BranchController extends Controller
             return redirect()->back()->with('error', __('Permission Denied.'));
         }
     }
+
+    public function testZktecoConnection(Request $request)
+    {
+        $request->validate([
+            'zkteco_ip' => 'required|ip',
+        ]);
+
+        try {
+            $zk = new \Rats\Zkteco\Lib\ZKTeco($request->zkteco_ip, 4370);
+            if ($zk->connect()) {
+                $deviceName = $zk->deviceName();
+                $serialNumber = $zk->serialNumber();
+                $version = $zk->version();
+                $zk->disconnect();
+
+                return response()->json([
+                    'success' => true,
+                    'message' => __('Connected successfully to ZKTeco device.'),
+                    'device' => [
+                        'name' => $deviceName,
+                        'serial' => $serialNumber,
+                        'version' => $version
+                    ]
+                ]);
+            }
+            return response()->json([
+                'success' => false,
+                'message' => __('Failed to connect to the specified IP.')
+            ], 400);
+        } catch (\Exception $e) {
+            return response()->json([
+                'success' => false,
+                'message' => __('Error: ') . $e->getMessage()
+            ], 400);
+        }
+    }
 }