No description
- TypeScript 76.3%
- PowerShell 21.5%
- Dockerfile 1.1%
- JavaScript 0.6%
- CSS 0.4%
- Other 0.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
All checks were successful
build-and-deploy / build-and-deploy (push) Successful in 58s
Let operators browse the full api_logs history instead of a fixed slice. - Support q/method/page/pageSize on GET /api/dashboard - Add debounced search, method filter, page size and prev/next controls in the panel |
||
| .forgejo/workflows | ||
| app | ||
| components/dashboard | ||
| deploy | ||
| docs | ||
| lib | ||
| prisma | ||
| scripts | ||
| server | ||
| tests | ||
| .dockerignore | ||
| .env.example | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| AGENTS.md | ||
| CHANGELOG.md | ||
| Dockerfile | ||
| gerAPI.code-workspace | ||
| next.config.mjs | ||
| package-lock.json | ||
| package.json | ||
| PENDING_COMMIT.example.md | ||
| playwright.config.ts | ||
| postcss.config.js | ||
| README.md | ||
| run.ps1 | ||
| tailwind.config.js | ||
| tsconfig.json | ||
| vitest.config.ts | ||
| vitest.setup.ts | ||
gerAPI
API REST para la gestión de nóminas, empleados, conceptos y horas extras. Integrada con el ERP (Softland/Exactus) vía Prisma y SQL Server.
Quick Start
npm install- Copiar
.env.examplea.envy configurar credenciales de SQL Server y API - Ejecutar
npm run db:generatepara generar el Prisma Client npm run dev(levanta en puerto 3010)
Features
- API REST documentada con OpenAPI 3.1 y UI Scalar en
/api/reference - Autenticación básica (Basic Auth) para todos los endpoints
- Gestión de nóminas: empleados, conceptos, horas extras, nóminas periódicas
- Integración ERP: lectura directa a tablas del ERP vía Prisma (
erpPrisma) - Auditoría API: tabla
api_logsy panel de control en/(Basic Auth) - Tests: unitarios con Vitest (jsdom) y E2E con Playwright (Chromium, Firefox, WebKit)
- Deploy automatizado: scripts PowerShell para 1Panel con Docker
Tech Stack
- Next.js 16 (output standalone)
- React 19 + TypeScript
- Prisma 5 + SQL Server
- Hono + Zod OpenAPI
- Tailwind CSS v4
- Vitest + Playwright
Documentation
- 01 - Contexto del proyecto
- 02 - Arquitectura
- 03 - Instalación y desarrollo
- 04 - Despliegue
- 05 - API e interfaces
- 06 - Base de datos
- 07 - Troubleshooting
Scripts principales
| Comando | Descripción |
|---|---|
npm run dev |
Next.js dev server en puerto 3010 |
npm run build |
Build de producción (standalone) |
npm run test |
Tests unitarios con Vitest |
npm run test:e2e |
Tests E2E con Playwright |
npm run db:studio |
Prisma Studio para inspeccionar datos |
npm run db:migrate |
Ejecutar migraciones Prisma |
.\run.ps1 |
Menú: dev, tests, commit (PENDING_COMMIT.md), deploy Forgejo |
npm run deploy:forgejo |
Push a main → build/deploy en Forgejo (https://gerapi.ae360.pro) |