# eliansimanca/control-de-asistencia architecture

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

- Interactive diagram: https://gitdiagram.com/eliansimanca/control-de-asistencia
- Repository: https://github.com/eliansimanca/control-de-asistencia

## Overview

This is a Spring-based employee attendance API. Its main workflow accepts a card UID, validates the card and employee, determines entry versus exit from the latest attendance record, and saves a timestamped record. Separate API controllers manage employees and cards and query attendance by employee or date. The repositories provide the persistence access layer; the supplied files show JPA entities and repository interfaces, but do not identify a configured database. Relationships below are limited to calls, routes, and entity associations visible in the excerpts.

Main entry points: [`src/main/java/com/asistencia/controller/AttendanceController.java`](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/controller/AttendanceController.java) (Attendance intake), [`src/main/java/com/asistencia/entity/Marcacion.java`](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/entity/Marcacion.java) (Attendance record), [`src/main/java/com/asistencia/repository/EmpleadoRepository.java`](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/repository/EmpleadoRepository.java) (Employee repository), [`src/main/java/com/asistencia/controller/MarcacionController.java`](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/controller/MarcacionController.java) (Attendance queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_attendance_api["Attendance intake"]
  node_attendance_query["Attendance queries"]
  node_employee_api["Employee management"]
  node_card_api["Card management"]
end

subgraph group_attendance["Attendance"]
  node_attendance_request["Scan request"]
  node_attendance_record["Attendance record<br/>[Marcacion.java]"]
  node_attendance_type["Entry or exit<br/>[TipoMarcacion.java]"]
end

subgraph group_people["Employees and Cards"]
  node_employee["Employee<br/>[Empleado.java]"]
  node_card["Access card<br/>[Tarjeta.java]"]
end

subgraph group_persistence["Persistence Layer"]
  node_employee_repo["Employee repository"]
  node_card_repo["Card repository"]
  node_attendance_repo["Attendance repository"]
end

node_client(("API client"))

node_client -->|"submits scan"| node_attendance_api
node_client -->|"queries records"| node_attendance_query
node_client -->|"manages employees"| node_employee_api
node_client -->|"manages cards"| node_card_api
node_attendance_api -->|"accepts"| node_attendance_request
node_attendance_api -->|"looks up card"| node_card_repo
node_attendance_api -->|"reads and saves"| node_attendance_repo
node_attendance_api -->|"creates"| node_attendance_record
node_attendance_api -->|"sets type"| node_attendance_type
node_attendance_query -->|"looks up employee"| node_employee_repo
node_attendance_query -->|"queries records"| node_attendance_repo
node_employee_api -->|"manages records"| node_employee_repo
node_card_api -->|"looks up employee"| node_employee_repo
node_card_api -->|"manages records"| node_card_repo
node_employee_repo -->|"persists"| node_employee
node_card_repo -->|"persists"| node_card
node_attendance_repo -->|"persists"| node_attendance_record
node_attendance_record -->|"references"| node_employee
node_attendance_record -->|"uses"| node_attendance_type
node_card -->|"assigned to"| node_employee

click node_attendance_api "https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/controller/AttendanceController.java"
click node_attendance_query "https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/controller/MarcacionController.java"
click node_employee_api "https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/controller/EmpleadoController.java"
click node_card_api "https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/controller/TarjetaController.java"
click node_attendance_request "https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/dto/AttendanceRequest.java"
click node_attendance_record "https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/entity/Marcacion.java"
click node_attendance_type "https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/entity/TipoMarcacion.java"
click node_employee "https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/entity/Empleado.java"
click node_card "https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/entity/Tarjeta.java"
click node_employee_repo "https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/repository/EmpleadoRepository.java"
click node_card_repo "https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/repository/TarjetaRepository.java"
click node_attendance_repo "https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/repository/MarcacionRepository.java"

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_attendance_api,node_attendance_query,node_employee_api,node_card_api,node_client toneBlue
class node_attendance_request,node_attendance_record,node_attendance_type toneAmber
class node_employee,node_card toneMint
class node_employee_repo,node_card_repo,node_attendance_repo toneRose
```

## Components

### HTTP API

- [Attendance intake](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/controller/AttendanceController.java): `src/main/java/com/asistencia/controller/AttendanceController.java`
- [Attendance queries](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/controller/MarcacionController.java): `src/main/java/com/asistencia/controller/MarcacionController.java`
- [Employee management](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/controller/EmpleadoController.java): `src/main/java/com/asistencia/controller/EmpleadoController.java`
- [Card management](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/controller/TarjetaController.java): `src/main/java/com/asistencia/controller/TarjetaController.java`

### Attendance

- [Scan request](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/dto/AttendanceRequest.java): `src/main/java/com/asistencia/dto/AttendanceRequest.java`
- [Attendance record](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/entity/Marcacion.java): `src/main/java/com/asistencia/entity/Marcacion.java`
- [Entry or exit](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/entity/TipoMarcacion.java): `src/main/java/com/asistencia/entity/TipoMarcacion.java`

### Employees and Cards

- [Employee](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/entity/Empleado.java): `src/main/java/com/asistencia/entity/Empleado.java`
- [Access card](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/entity/Tarjeta.java): `src/main/java/com/asistencia/entity/Tarjeta.java`

### Persistence Layer

- [Employee repository](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/repository/EmpleadoRepository.java): `src/main/java/com/asistencia/repository/EmpleadoRepository.java`
- [Card repository](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/repository/TarjetaRepository.java): `src/main/java/com/asistencia/repository/TarjetaRepository.java`
- [Attendance repository](https://github.com/eliansimanca/control-de-asistencia/blob/main/src/main/java/com/asistencia/repository/MarcacionRepository.java): `src/main/java/com/asistencia/repository/MarcacionRepository.java`

### Other components

- **API client**

## Connections

- API client → Attendance intake: submits scan (evidence: `src/main/java/com/asistencia/controller/AttendanceController.java`)
- API client → Attendance queries: queries records (evidence: `src/main/java/com/asistencia/controller/MarcacionController.java`)
- API client → Employee management: manages employees (evidence: `src/main/java/com/asistencia/controller/EmpleadoController.java`)
- API client → Card management: manages cards (evidence: `src/main/java/com/asistencia/controller/TarjetaController.java`)
- Attendance intake → Scan request: accepts (evidence: `src/main/java/com/asistencia/controller/AttendanceController.java`)
- Attendance intake → Card repository: looks up card (evidence: `src/main/java/com/asistencia/controller/AttendanceController.java`)
- Attendance intake → Attendance repository: reads and saves (evidence: `src/main/java/com/asistencia/controller/AttendanceController.java`)
- Attendance intake → Attendance record: creates (evidence: `src/main/java/com/asistencia/controller/AttendanceController.java`)
- Attendance intake → Entry or exit: sets type (evidence: `src/main/java/com/asistencia/controller/AttendanceController.java`)
- Attendance queries → Employee repository: looks up employee (evidence: `src/main/java/com/asistencia/controller/MarcacionController.java`)
- Attendance queries → Attendance repository: queries records (evidence: `src/main/java/com/asistencia/controller/MarcacionController.java`)
- Employee management → Employee repository: manages records (evidence: `src/main/java/com/asistencia/controller/EmpleadoController.java`)
- Card management → Employee repository: looks up employee (evidence: `src/main/java/com/asistencia/controller/TarjetaController.java`)
- Card management → Card repository: manages records (evidence: `src/main/java/com/asistencia/controller/TarjetaController.java`)
- Employee repository → Employee: persists (evidence: `src/main/java/com/asistencia/repository/EmpleadoRepository.java`)
- Card repository → Access card: persists (evidence: `src/main/java/com/asistencia/repository/TarjetaRepository.java`)
- Attendance repository → Attendance record: persists (evidence: `src/main/java/com/asistencia/repository/MarcacionRepository.java`)
- Attendance record → Employee: references (evidence: `src/main/java/com/asistencia/entity/Marcacion.java`)
- Attendance record → Entry or exit: uses (evidence: `src/main/java/com/asistencia/entity/Marcacion.java`)
- Access card → Employee: assigned to (evidence: `src/main/java/com/asistencia/entity/Tarjeta.java`)
