使用 Nextjs 和 FACEIO 建立具有人臉辨識的考勤系統

執行摘要

在數位轉型時代，傳統的考勤追蹤正在迅速過時。我們的尖端解決方案利用先進的臉部辨識技術Next.js，創造一個複雜、安全、智慧的考勤管理生態系統。

介紹

對組織來說，考勤管理歷來是一項耗時且容易出錯的任務。 FACEIO 的創新系統透過引入先進的臉部辨識技術改變了這種模式，提供了可提高安全性和使用者體驗的簡化流程。

採用 FACEIO 的現代考勤系統

由 FACEIO 提供支援的現代考勤系統標誌著組織利用最先進的臉部辨識技術追蹤考勤方式的變革。這種先進的系統以無縫、安全、高效的非接觸式解決方案取代了手動登記和基於卡片的系統等傳統方法。 FACEIO 優先考慮精確性、預防詐欺和用戶隱私，使其成為考勤管理領域的遊戲規則改變者。

專案結構

安裝包

環境配置

Next.js 配置

提供者設定

面對 IO 上下文

// src/context/FaceIOContext.tsx
'use client';

import React, { 
  createContext, 
  useState, 
  useContext, 
  useEffect, 
  ReactNode 
} from 'react';
import faceIO from '@faceio/fiojs';

interface FaceIOContextType {
  faceioInstance: any;
  error: Error | null;
}

const FaceIOContext = createContext<FaceIOContextType>({
  faceioInstance: null,
  error: null,
});

export const FaceIOProvider = ({ children }: { children: ReactNode }) => {
  const [faceioInstance, setFaceioInstance] = useState<any>(null);
  const [error, setError] = useState<Error | null>(null);

  useEffect(() => {
    const initializeFaceIO = async () => {
      try {
        if (process.env.NEXT_PUBLIC_FACEIO_PUBLIC_KEY) {
          const instance = new faceIO(process.env.NEXT_PUBLIC_FACEIO_PUBLIC_KEY);
          setFaceioInstance(instance);
        } else {
          throw new Error('FACEIO Public Key is not configured');
        }
      } catch (err) {
        console.error('Face Recognition Initialization Failed', err);
        setError(err instanceof Error ? err : new Error('Initialization failed'));
      }
    };

    initializeFaceIO();
  }, []);

  return (
    <FaceIOContext.Provider value={{ faceioInstance, error }}>
      {children}
    </FaceIOContext.Provider>
  );
};

export const useFaceIO = () => useContext(FaceIOContext);

人臉辨識掛鉤

// src/hooks/useFaceRecognition.ts
'use client';

import { useState } from 'react';
import { useFaceIO } from '../context/FaceIOContext';

export function useFaceRecognition() {
  const { faceioInstance } = useFaceIO();
  const [isLoading, setIsLoading] = useState(false);
  const [error, setError] = useState<Error | null>(null);

  const enrollUser = async (userMetadata: Record<string, any>) => {
    if (!faceioInstance) {
      throw new Error('FaceIO not initialized');
    }

    setIsLoading(true);
    setError(null);

    try {
      const enrollResult = await faceioInstance.enroll({
        locale: "auto",
        payload: {
          ...userMetadata,
          enrollmentTimestamp: new Date().toISOString()
        }
      });

      setIsLoading(false);
      return {
        facialId: enrollResult.facialId,
        metadata: enrollResult
      };
    } catch (err) {
      setIsLoading(false);
      setError(err instanceof Error ? err : new Error('Enrollment failed'));
      throw err;
    }
  };

  const authenticateUser = async () => {
    if (!faceioInstance) {
      throw new Error('FaceIO not initialized');
    }

    setIsLoading(true);
    setError(null);

    try {
      const authResult = await faceioInstance.authenticate({
        locale: "auto"
      });

      setIsLoading(false);
      return {
        facialId: authResult.facialId,
        payload: authResult.payload
      };
    } catch (err) {
      setIsLoading(false);
      setError(err instanceof Error ? err : new Error('Authentication failed'));
      throw err;
    }
  };

  return { 
    enrollUser, 
    authenticateUser, 
    isLoading, 
    error 
  };
}

人臉辨識組件

// src/components/FaceRecognition.tsx
'use client';

import { useState } from 'react';
import { useFaceRecognition } from '../hooks/useFaceRecognition';

export function FaceRecognitionComponent() {
  const { enrollUser, authenticateUser, isLoading, error } = useFaceRecognition();
  const [userData, setUserData] = useState(null);

  const handleEnroll = async () => {
    try {
      const result = await enrollUser({
        username: 'example_user',
        email: 'user@example.com'
      });
      setUserData(result);
    } catch (err) {
      console.error('Enrollment error', err);
    }
  };

  const handleAuthenticate = async () => {
    try {
      const result = await authenticateUser();
      setUserData(result);
    } catch (err) {
      console.error('Authentication error', err);
    }
  };

  return (
    <div>
      {isLoading && <p>Processing...</p>}
      {error && <p>Error: {error.message}</p>}
      <button onClick={handleEnroll}>Enroll</button>
      <button onClick={handleAuthenticate}>Authenticate</button>
      {userData && <pre class="brush:php;toolbar:false">{JSON.stringify(userData, null, 2)}

}