Cams Biometric Integrator(PHP & Python スターターキット)

定型コードは不要です。Cams Biometric Integrator は、PHP と Python の両方で提供されるダウンロード可能なスターターバックエンドです。Cams デバイスからリアルタイムの打刻ログとユーザー更新を受信し、設定可能な日単位・シフト単位の勤怠ポリシーを適用して、MySQL、MariaDB、PostgreSQL、MSSQL、MongoDB に書き込みます。

はじめる開発者ドキュメント

概要

Cams デバイスの打刻を受信し、勤怠ポリシーを評価して、お好みのデータベースに保存する、すぐに動く PHP / Python のリファレンスバックエンドです。

Cams Biometric Web API との連携を素早く立ち上げる、柔軟なリファレンス実装です。コールバックサーバーのエントリポイント、日単位・シフト単位の勤怠評価ロジック、サーバーからデバイスへの操作用 REST クライアント、ユーザーとデバイスを管理する CLI テスターが付属しています。勤怠ルールは JSON 設定に、環境設定は設定ファイルと任意の .env に置き、データベース層は MySQL/MariaDB、PostgreSQL、MSSQL、MongoDB に対応する差し替え可能な構造です。PHP 版(PHP 7.4+、Composer)と Python 版(Python 3.8+、pip)が、そのまま使えるプロジェクトとして提供されます。

SDKHTTP コールバックサーバーREST クライアントCLIPHPPython

attendance-rules.json を設定してコールバックサーバーを実行

# PHP edition
composer install && php callback-server.php
# Python edition
pip install -r requirements.txt && python callback_server.py
# shift policy (JSON, no code)
{ "shift":"09:00-18:00", "grace_min":10, "db":"postgres" }

機能

できること

そのまま使えるコールバックサーバー

コールバックサーバーを展開すれば、すぐに打刻の受信を開始できます。

設定可能な勤怠ポリシー

コードに手を加えず、JSON で日とシフトのルールを定義できます。未指定の場合は既定値が適用されます。

あらゆるデータベース

差し替え可能なドライバー層により、一つのコードベースで MySQL、MariaDB、PostgreSQL、MSSQL、MongoDB に対応します。

CLI テスター

ターミナルから、ユーザーとデバイスを対話的に管理・テストできます。

特長

すべて含まれています

コールバックサーバーのエントリポイントによる、リアルタイムの打刻とユーザーデータの受信
JSON で設定可能な、日単位・シフト単位の勤怠ポリシーの評価
差し替え可能なデータベースバックエンド: MySQL、MariaDB、PostgreSQL、MSSQL、MongoDB
サーバーからデバイスへのユーザー・デバイス操作のための、組み込みの REST クライアント
ユーザー、デバイス、ポリシーを手動で管理するための、対話型の CLI テスター
勤怠データの整合性を保つための、データベーストランザクション
PHP(PHP 7.4+、Composer)と Python(3.8+、pip)の両方で利用可能