# nasserelbacha2002/dinamic-localizador architecture

> Architecture diagram of the GitHub repository nasserelbacha2002/dinamic-localizador, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nasserelbacha2002/dinamic-localizador
- Repository: https://github.com/nasserelbacha2002/dinamic-localizador

## Overview

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: [`backend/src/app.ts`](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/app.ts) (Backend API), [`backend/src/services/absence/absence-operational-impact-query.service.ts`](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/services/absence/absence-operational-impact-query.service.ts) (Operational impact), [`frontend/src`](https://github.com/nasserelbacha2002/dinamic-localizador/tree/main/frontend/src) (Admin panel), [`backend/src/database/connection.ts`](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/database/connection.ts) (SQL Server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Administration and API"]
  node_frontend["Admin panel"]
  node_api["Backend API<br/>[app.ts]"]
end

subgraph group_workforce["Workforce Operations"]
  node_employees["Employee management"]
  node_stores["Stores and locations"]
  node_operations["Inventory operations"]
  node_assignments["Employee assignments"]
  node_attendance["Attendance check-in"]
  node_attendance_review["Attendance review"]
  node_imports["Data imports<br/>[orchestrator.ts]"]
end

subgraph group_messaging["WhatsApp and Payroll"]
  node_whatsapp["WhatsApp webhook"]
  node_bot["WhatsApp bot"]
  node_payroll["Payroll receipts"]
  node_payroll_reconcile["Delivery reconciliation"]
  node_costs["Message cost reporting"]
end

subgraph group_absence["Absence Management"]
  node_absence["Absence management"]
  node_absence_impact["Operational impact"]
end

subgraph group_persistence["Persistence"]
  node_database[("SQL Server<br/>[connection.ts]")]
  node_absence_repo["Absence requests"]
  node_company_settings["Company settings"]
  node_workdays["Employee workdays"]
  node_payroll_repo["Payroll records"]
  node_delivery_repo["Payroll deliveries"]
  node_cost_repo["Message cost ledger"]
  node_audit["Audit logging"]
end

node_admin_actor(("Administrator"))
node_employee_actor(("Employee"))

node_admin_actor -->|"manages operations"| node_frontend
node_frontend -->|"calls REST API"| node_api
node_api -->|"reads and writes"| node_database
node_employee_actor -->|"sends check-in"| node_whatsapp
node_whatsapp -->|"posts webhook"| node_api
node_api -->|"validates check-in"| node_attendance
node_attendance -->|"records result"| node_database
node_api -->|"returns results"| node_frontend
node_api -.->|"queries impact"| node_absence_impact
node_absence_impact -->|"queries requests"| node_absence_repo
node_absence_impact -->|"reads timezone"| node_company_settings
node_absence_impact -->|"checks coverage"| node_workdays
node_payroll -->|"reads receipts"| node_payroll_repo
node_payroll -->|"claims delivery"| node_delivery_repo
node_payroll_reconcile -->|"resolves deliveries"| node_delivery_repo
node_payroll_reconcile -->|"logs resolution"| node_audit
node_costs -->|"queries ledger"| node_cost_repo
node_cost_repo -->|"queries SQL"| node_database

click node_frontend "https://github.com/nasserelbacha2002/dinamic-localizador/tree/main/frontend/src"
click node_api "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/app.ts"
click node_employees "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/controllers/employee.controller.ts"
click node_stores "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/controllers/client.controller.ts"
click node_operations "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/controllers/operation.controller.ts"
click node_assignments "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/controllers/operation-assignment.controller.ts"
click node_attendance "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/controllers/attendance.controller.ts"
click node_attendance_review "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/controllers/attendance.controller.ts"
click node_absence "https://github.com/nasserelbacha2002/dinamic-localizador/tree/main/backend/src/services/absence"
click node_absence_impact "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/services/absence/absence-operational-impact-query.service.ts"
click node_imports "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/imports/orchestrator.ts"
click node_whatsapp "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/controllers/twilio-webhook.controller.ts"
click node_bot "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/services/bot/bot-session.service.ts"
click node_payroll "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/services/payroll/payroll-receipt-period-query.service.ts"
click node_payroll_reconcile "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/services/payroll/payroll-query-reconciliation.service.ts"
click node_costs "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/services/whatsapp/whatsapp-message-cost-query.service.ts"
click node_database "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/database/connection.ts"
click node_absence_repo "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/repositories/absence/absence-request.repository.ts"
click node_company_settings "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/repositories/companies/company-settings.repository.ts"
click node_workdays "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/repositories/workdays/employee-workday.repository.ts"
click node_payroll_repo "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/repositories/payroll/payroll-receipt.repository.ts"
click node_delivery_repo "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/repositories/payroll/payroll-receipt-query-delivery.repository.ts"
click node_cost_repo "https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/repositories/whatsapp/whatsapp-message-cost-ledger-query.repository.ts"
click node_audit "https://github.com/nasserelbacha2002/dinamic-localizador/tree/main/backend/src/services"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend,node_api toneBlue
class node_employees,node_stores,node_operations,node_assignments,node_attendance,node_attendance_review,node_imports toneAmber
class node_whatsapp,node_bot,node_payroll,node_payroll_reconcile,node_costs toneMint
class node_absence,node_absence_impact toneRose
class node_database,node_absence_repo,node_company_settings,node_workdays,node_payroll_repo,node_delivery_repo,node_cost_repo,node_audit,node_admin_actor,node_employee_actor toneIndigo
```

## Components

### Administration and API

- [Admin panel](https://github.com/nasserelbacha2002/dinamic-localizador/tree/main/frontend/src): `frontend/src`
- [Backend API](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/app.ts): `backend/src/app.ts`

### Workforce Operations

- [Employee management](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/controllers/employee.controller.ts): `backend/src/controllers/employee.controller.ts`
- [Stores and locations](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/controllers/client.controller.ts): `backend/src/controllers/client.controller.ts`
- [Inventory operations](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/controllers/operation.controller.ts): `backend/src/controllers/operation.controller.ts`
- [Employee assignments](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/controllers/operation-assignment.controller.ts): `backend/src/controllers/operation-assignment.controller.ts`
- [Attendance check-in](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/controllers/attendance.controller.ts): `backend/src/controllers/attendance.controller.ts`
- [Attendance review](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/controllers/attendance.controller.ts): `backend/src/controllers/attendance.controller.ts`
- [Data imports](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/imports/orchestrator.ts): `backend/src/imports/orchestrator.ts`

### WhatsApp and Payroll

- [WhatsApp webhook](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/controllers/twilio-webhook.controller.ts): `backend/src/controllers/twilio-webhook.controller.ts`
- [WhatsApp bot](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/services/bot/bot-session.service.ts): `backend/src/services/bot/bot-session.service.ts`
- [Payroll receipts](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/services/payroll/payroll-receipt-period-query.service.ts): `backend/src/services/payroll/payroll-receipt-period-query.service.ts`
- [Delivery reconciliation](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/services/payroll/payroll-query-reconciliation.service.ts): `backend/src/services/payroll/payroll-query-reconciliation.service.ts`
- [Message cost reporting](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/services/whatsapp/whatsapp-message-cost-query.service.ts): `backend/src/services/whatsapp/whatsapp-message-cost-query.service.ts`

### Absence Management

- [Absence management](https://github.com/nasserelbacha2002/dinamic-localizador/tree/main/backend/src/services/absence): `backend/src/services/absence`
- [Operational impact](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/services/absence/absence-operational-impact-query.service.ts): `backend/src/services/absence/absence-operational-impact-query.service.ts`

### Persistence

- [SQL Server](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/database/connection.ts): `backend/src/database/connection.ts`
- [Absence requests](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/repositories/absence/absence-request.repository.ts): `backend/src/repositories/absence/absence-request.repository.ts`
- [Company settings](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/repositories/companies/company-settings.repository.ts): `backend/src/repositories/companies/company-settings.repository.ts`
- [Employee workdays](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/repositories/workdays/employee-workday.repository.ts): `backend/src/repositories/workdays/employee-workday.repository.ts`
- [Payroll records](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/repositories/payroll/payroll-receipt.repository.ts): `backend/src/repositories/payroll/payroll-receipt.repository.ts`
- [Payroll deliveries](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/repositories/payroll/payroll-receipt-query-delivery.repository.ts): `backend/src/repositories/payroll/payroll-receipt-query-delivery.repository.ts`
- [Message cost ledger](https://github.com/nasserelbacha2002/dinamic-localizador/blob/main/backend/src/repositories/whatsapp/whatsapp-message-cost-ledger-query.repository.ts): `backend/src/repositories/whatsapp/whatsapp-message-cost-ledger-query.repository.ts`
- [Audit logging](https://github.com/nasserelbacha2002/dinamic-localizador/tree/main/backend/src/services): `backend/src/services`

### Other components

- **Administrator**
- **Employee**

## Connections

- Administrator → Admin panel: manages operations (evidence: `README.md`)
- Admin panel → Backend API: calls REST API (evidence: `README.md`)
- Backend API → SQL Server: reads and writes (evidence: `README.md`)
- Employee → WhatsApp webhook: sends check-in (evidence: `README.md`)
- WhatsApp webhook → Backend API: posts webhook (evidence: `README.md`)
- Backend API → Attendance check-in: validates check-in (evidence: `README.md`)
- Attendance check-in → SQL Server: records result (evidence: `README.md`)
- Backend API → Admin panel: returns results (evidence: `README.md`)
- Backend API → Operational impact: queries impact
- Operational impact → Absence requests: queries requests (evidence: `backend/src/services/absence/absence-operational-impact-query.service.ts`)
- Operational impact → Company settings: reads timezone (evidence: `backend/src/services/absence/absence-operational-impact-query.service.ts`)
- Operational impact → Employee workdays: checks coverage (evidence: `backend/src/services/absence/absence-operational-impact-query.service.ts`)
- Payroll receipts → Payroll records: reads receipts (evidence: `backend/src/services/payroll/payroll-receipt-period-query.service.ts`)
- Payroll receipts → Payroll deliveries: claims delivery (evidence: `backend/src/services/payroll/payroll-receipt-period-query.service.ts`)
- Delivery reconciliation → Payroll deliveries: resolves deliveries (evidence: `backend/src/services/payroll/payroll-query-reconciliation.service.ts`)
- Delivery reconciliation → Audit logging: logs resolution (evidence: `backend/src/services/payroll/payroll-query-reconciliation.service.ts`)
- Message cost reporting → Message cost ledger: queries ledger (evidence: `backend/src/services/whatsapp/whatsapp-message-cost-query.service.ts`)
- Message cost ledger → SQL Server: queries SQL (evidence: `backend/src/repositories/whatsapp/whatsapp-message-cost-ledger-query.repository.ts`)
