How mmd-rehan/adms-server-zkteco works
Project type and purpose
• This is a full-stack web application called “Access (Attendance Device Management System)” built on Laravel (PHP).
• Its primary purpose is to receive, process, and display biometric attendance data from ZKTeco SpeedFace-V5L-RFID devices, and to provide an admin UI for managing users, devices, employees, and attendance logs.
File structure
• Top-level folders:
• app/ (core PHP code: Controllers, Middleware, Models, Console commands, Helpers, Providers)
• config/ (application & service configuration)
• database/ (migrations, seeders, factories)
• public/ (index.php front controller, assets, .htaccess)
• resources/ (Blade views, CSS, JS, Sass)
• routes/ (web.php, api.php, console.php, channels.php)
• bootstrap/ (app bootstrap & cache)
• tests/ (unit & feature)
• Build tooling: package.json, vite.config.js for asset compilation.
• Deployment artifacts: .env.example, .htaccess, Apache collection for Postman.
README for additional insights
• Describes Ubuntu + Apache deployment with port 8080, Cloudflare routing, Basic Auth protection on /iclock/* routes.
• Lists PHP, Composer, Node, MySQL setup steps.
• Emphasizes three device-facing endpoints: /iclock/cdata, /iclock/test, /iclock/getrequest.