Imported from wwadde/inventario-dotacion (back/AGENTS.md). Install upstream with npx skills add wwadde/inventario-dotacion --skill back. Copyright stays with the author.

AGENTS - Backend Dotacion

Stack

Java 25
Spring Boot 4
Spring Data JPA
PostgreSQL
Flyway
Apache POI (Excel)
OpenPDF (certificados PDF)

Modulos implementados

employee: gestion de empleados
item: catalogo de implementos
requirement: asignacion de implementos requeridos por empleado
delivery: registro de entregas y certificado PDF
report: dashboard y cumplimiento (pendientes/al dia) + exportacion Excel
common: seguridad, CORS y manejo global de errores

API principal

/api/employees
/api/items
/api/requirements
/api/deliveries
/api/deliveries/{id}/certificate
/api/reports/compliance
/api/reports/compliance/export
/api/dashboard/summary

Reglas de negocio clave

Un requerimiento por empleado + implemento (unico).
El cumplimiento se calcula por fecha de ultima entrega + periodicidad.
Si la fecha de vencimiento es hoy o anterior, se marca pendiente.
Las entregas almacenan firma en base64 decodificada como imagen.

Variables de entorno

DB_URL
DB_USERNAME
DB_PASSWORD
CORS_ALLOWED_ORIGINS
COMPANY_NAME
SERVER_PORT

Flujo de build

Gradle task principal: ./gradlew clean bootJar
Imagen Docker: back/Dockerfile

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

Install back and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

back

About

AGENTS - Backend Dotacion

Stack

Modulos implementados

API principal

Reglas de negocio clave

Variables de entorno

Flujo de build

Use it

Install back and it becomes one more candidate the router can pick - when it fits.

Manifest

Reviews