63 lines
3.0 KiB
Markdown
63 lines
3.0 KiB
Markdown
# time-server-test-adapter
|
|
|
|
Test harness mínimo para probar el adapter `kumare-adapter-spring-visma-time` vía REST, sin base de datos.
|
|
|
|
## Qué hace
|
|
|
|
Expone 7 endpoints que son passthroughs directos al API de VismaTime (GeoVictoria), usados
|
|
para ejercitar el adapter durante desarrollo:
|
|
|
|
| Método | Path | Acción |
|
|
|--------|------------------------------------------|-------------------------------|
|
|
| GET | `/time/api/clientele/clients/employee` | Lista empleados |
|
|
| POST | `/time/api/clientele/clients/punch/list` | Lista marcaciones |
|
|
| POST | `/time/api/clientele/clients/punch/page` | Lista marcaciones (paginado) |
|
|
| POST | `/time/api/clientele/clients/punch/add` | Agrega una marcación |
|
|
| POST | `/time/api/clientele/clients/punch/delete`| Borra una marcación |
|
|
| POST | `/time/api/clientele/clients/punch/multiple` | Agrega varias marcaciones |
|
|
| POST | `/time/api/clientele/clients/attendance/book` | Libro de asistencia (rango de fechas + usuarios) |
|
|
|
|
La colección Postman está en [`postman/visma-time.postman_collection.json`](postman/visma-time.postman_collection.json).
|
|
Una traza de ejemplo (credenciales/tokens redactados) está en [`traces/visma-endpoints-trace.log`](traces/visma-endpoints-trace.log).
|
|
|
|
## Correr
|
|
|
|
```bash
|
|
mvn spring-boot:run
|
|
```
|
|
|
|
Clase main: `io.kumare.iqr.TimeApplication`.
|
|
|
|
No requiere Postgres ni ninguna otra base de datos — el autoconfig de JPA/DataSource está
|
|
excluido explícitamente en `TimeApplication` porque `kumare-base-server-spring` trae
|
|
`spring-boot-starter-data-jpa` transitivamente aunque no haya entidades locales.
|
|
|
|
Credenciales de Visma (`visma.server`, `visma.user`, `visma.password`) en
|
|
`src/main/resources/application.properties`, sobreescribibles con las variables de entorno
|
|
`VISMA_SERVER`, `VISMA_USER`, `VISMA_PASSWORD`.
|
|
|
|
## Trazas
|
|
|
|
Con `logging.level.io.kumare=DEBUG` (ya configurado) se ven en el log:
|
|
- Cada request entrante y su respuesta (`RequestTraceInterceptor`): método, path, status, duración.
|
|
- Cada llamada saliente al API de Visma (`LoggingInterceptor` de kumare-base-server-spring):
|
|
URL, headers (sanitizados), body, status, duración.
|
|
|
|
## Estructura
|
|
|
|
Este proyecto se clonó de otra app IQR y se recortó a lo mínimo: solo queda el módulo `visma`
|
|
(`io.kumare.iqr.mod.visma`, antes `clientele`) con las acciones y endpoints de VismaTime, más
|
|
el framework base (`io.kumare.iqr.app.*`). Los módulos de negocio originales (authentication,
|
|
biz, loyalty, pocket, taxonomy) y el CRUD local de Client/ClientRelation se eliminaron por no
|
|
tener relación con probar el adapter.
|
|
|
|
```
|
|
io.kumare.iqr.mod.visma/
|
|
VismaConstants.java, VismaModule.java, VismaController.java
|
|
action/ — GvTime, PunchType, y las 7 acciones Visma*Action/Argument
|
|
endpoint/rest/ — AbstractVismaRest, VismaRest
|
|
```
|
|
|
|
Nota: los paths REST (`/clientele/clients/...`) se dejaron igual — solo se renombraron las
|
|
clases y el paquete Java — para no romper la colección Postman ni la traza ya compartidas.
|