How wesleysamuvel/smart-mangement-system works
Smart Attendance Management System is a role-based attendance, workforce, and payroll application with AI-assisted analysis. Users enter through the web app, use role dashboards and management screens, and perform attendance, employee, payroll, and analytics tasks; documented AI tools add chat, predictions, insights, and payroll optimization. The source evidence confirms biometric routes invoke AI and Firestore, and several API routes use the shared database layer. Many UI-to-API connections and unsampled feature implementations are documented only at the README level, so they are represented without asserting unverified calls.
Main entry points: db.ts Application database · dashboard Role dashboards · deepseek.ts AI model client · route.ts Biometric verification
Components 25
Access and dashboards
- Web application
src/app/page.tsx - Role dashboards
src/components/dashboard - Authentication
src/contexts/AuthContext.tsx
Workforce operations
- Employee management
src/app/api/employees/route.ts - Attendance tracking
src/app/api/attendance/route.ts - Biometric verification
src/app/api/biometric/route.ts - Face and voice scans
src/app/api/face/route.ts - Geofence and location
src/app/api/location/route.ts - Payroll management
src/components/payroll/PayrollManagement.tsx - Payroll calculations
src/app/api/payroll/route.ts - Timetable management
src/components/timetable/TimetableManager.tsx - PDF reports
src/app/api/pdf/editor/route.ts
AI and analytics
- Assistant and commands
src/app/api/ai/chat/route.ts - Natural-language commands
src/app/api/ai/command/route.ts - AI model client
src/lib/ai/deepseek.ts - Analytics and insights
src/app/api/analytics/route.ts - Predictions and optimization
src/app/api/ai
Runtime services
- Application database
src/lib/db.ts - Firestore client
src/lib/firebase-admin.ts - Security services
src/lib/auth/jwt.ts
Realtime
- Realtime service
src/lib/realtime/socket.ts - Realtime hook
src/hooks/useRealtime.ts - Socket server
server.ts
Other components
- Workforce user
- OpenRouter service
Connections 25
- Workforce user → Web application: opens
README.md - Web application → Role dashboards: presents
- Role dashboards → Authentication: uses access
- Role dashboards → Employee management: manages staff
- Role dashboards → Attendance tracking: records attendance
- Role dashboards → Payroll management: manages payroll
- Role dashboards → Analytics and insights: views metrics
- Attendance tracking → Application database: reads and writes
src/app/api/attendance/route.ts - Biometric verification → Application database: reads and writes
src/app/api/biometric/route.ts - Biometric verification → AI model client: verifies with
src/app/api/biometric/route.ts - Face and voice scans → Application database: reads and writes
src/app/api/face/route.ts - Face and voice scans → AI model client: analyzes scans
src/app/api/face/route.ts - Geofence and location → Application database: reads and writes
src/app/api/location/route.ts - Payroll calculations → Application database: reads and writes
src/app/api/payroll/route.ts - Analytics and insights → Application database: queries metrics
src/app/api/analytics/route.ts - Assistant and commands → Application database: queries records
src/app/api/ai/chat/route.ts - Natural-language commands → Application database: queries records
src/app/api/ai/command/route.ts - Natural-language commands → AI model client: dispatches prompts
src/app/api/ai/command/route.ts - AI model client → OpenRouter service: sends requests
src/lib/ai/deepseek.ts - Payroll management → Payroll calculations: manages via
- Predictions and optimization → Application database: uses data
src/app/api/ai/command/route.ts - PDF reports → Workforce user: provides reports
- Realtime hook → Realtime service: subscribes
src/hooks/useRealtime.ts - Socket server → Realtime service: serves realtime
- Application database → Firestore client: delegates Firestore
src/lib/db.ts