How nasserelbacha2002/dinamic-localizador works
Dinamic Attendance is a workforce operations platform centered on planning store inventories and recording auditable employee attendance. Its principal workflow runs from administrator setup and employee assignment through a Twilio/WhatsApp check-in, backend validation, SQL persistence, and administrative review. The repository tree also shows broader operations, absence, payroll, import, and messaging capabilities. The README documents the attendance flow; sampled source confirms selected database, absence-impact, payroll, and messaging-cost relationships. Other unsampled links are left unasserted.
Main entry points: app.ts Backend API · absence-operational-impact-query.service.ts Operational impact · src Admin panel · connection.ts SQL Server
Components 26
Administration and API
- Admin panel
frontend/src - Backend API
backend/src/app.ts
Workforce Operations
- Employee management
backend/src/controllers/employee.controller.ts - Stores and locations
backend/src/controllers/client.controller.ts - Inventory operations
backend/src/controllers/operation.controller.ts - Employee assignments
backend/src/controllers/operation-assignment.controller.ts - Attendance check-in
backend/src/controllers/attendance.controller.ts - Attendance review
backend/src/controllers/attendance.controller.ts - Data imports
backend/src/imports/orchestrator.ts
WhatsApp and Payroll
- WhatsApp webhook
backend/src/controllers/twilio-webhook.controller.ts - WhatsApp bot
backend/src/services/bot/bot-session.service.ts - Payroll receipts
backend/src/services/payroll/payroll-receipt-period-query.service.ts - Delivery reconciliation
backend/src/services/payroll/payroll-query-reconciliation.service.ts - Message cost reporting
backend/src/services/whatsapp/whatsapp-message-cost-query.service.ts
Absence Management
- Absence management
backend/src/services/absence - Operational impact
backend/src/services/absence/absence-operational-impact-query.service.ts
Persistence
- SQL Server
backend/src/database/connection.ts - Absence requests
backend/src/repositories/absence/absence-request.repository.ts - Company settings
backend/src/repositories/companies/company-settings.repository.ts - Employee workdays
backend/src/repositories/workdays/employee-workday.repository.ts - Payroll records
backend/src/repositories/payroll/payroll-receipt.repository.ts - Payroll deliveries
backend/src/repositories/payroll/payroll-receipt-query-delivery.repository.ts - Message cost ledger
backend/src/repositories/whatsapp/whatsapp-message-cost-ledger-query.repository.ts - Audit logging
backend/src/services
Other components
- Administrator
- Employee
Connections 18
- Administrator → Admin panel: manages operations
README.md - Admin panel → Backend API: calls REST API
README.md - Backend API → SQL Server: reads and writes
README.md - Employee → WhatsApp webhook: sends check-in
README.md - WhatsApp webhook → Backend API: posts webhook
README.md - Backend API → Attendance check-in: validates check-in
README.md - Attendance check-in → SQL Server: records result
README.md - Backend API → Admin panel: returns results
README.md - Backend API → Operational impact: queries impact
- Operational impact → Absence requests: queries requests
backend/src/services/absence/absence-operational-impact-query.service.ts - Operational impact → Company settings: reads timezone
backend/src/services/absence/absence-operational-impact-query.service.ts - Operational impact → Employee workdays: checks coverage
backend/src/services/absence/absence-operational-impact-query.service.ts - Payroll receipts → Payroll records: reads receipts
backend/src/services/payroll/payroll-receipt-period-query.service.ts - Payroll receipts → Payroll deliveries: claims delivery
backend/src/services/payroll/payroll-receipt-period-query.service.ts - Delivery reconciliation → Payroll deliveries: resolves deliveries
backend/src/services/payroll/payroll-query-reconciliation.service.ts - Delivery reconciliation → Audit logging: logs resolution
backend/src/services/payroll/payroll-query-reconciliation.service.ts - Message cost reporting → Message cost ledger: queries ledger
backend/src/services/whatsapp/whatsapp-message-cost-query.service.ts - Message cost ledger → SQL Server: queries SQL
backend/src/repositories/whatsapp/whatsapp-message-cost-ledger-query.repository.ts