TimeApp
TimeApp es una aplicación web monolítica PHP para gestión de tiempos y control de obra con API, backend admin y PWA móvil. Incluye gestión de vacaciones, estornos (cutover) y firmas digitales.
Ficha actualizada 25 sept 2026, 7:52 · upstream 25 sept 2026, 7:38 · release sin release detectada
Qué es TimeApp
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
TimeApp es una solución integral para la captura de tiempos en obra y gestión administrativa, construida sobre PHP 8.2 y MariaDB 10.11. La arquitectura separa el backend administrativo (`/admin`), la aplicación móvil PWA (`/app`) y la API REST (`/api/v1`). El proyecto opera bajo licencia GPL-2.0-or-later, permitiendo uso comercial con soporte separado.
El despliegue soporta entornos Docker locales y producción mediante `docker-compose.prod.yml`, incluyendo un scheduler para tareas programadas. La gestión de datos cuenta con migraciones Phinx y seeders idempotentes. Los backups se exportan a ZIP validados, pero el restore no es automático por seguridad, requiriendo intervención manual o scripts específicos.
Para la configuración inicial, se requiere crear variables de entorno en `.env` antes del arranque. Las actualizaciones en producción se gestionan mediante scripts (`update-prod.sh`) que aplican migraciones y seeders sin interrumpir el servicio, verificando integridad del esquema tras cada cambio.
- Registro de horas para personal de obra vía PWA móvil
- Gestión administrativa de saldos de tiempo y vacaciones con estornos (cutover)
- Validación documental con firmas digitales y gestión de archivos adjuntos
- Configuración de calendarios legales por región y estados de documentos
- Exportación de backups completos para auditoría o migración entre servidores
- Arquitectura modular separando API, Admin y App móvil en el mismo stack
- Actualizaciones idempotentes con scripts dedicados para producción y nativo
- Gestión segura de backups que validan integridad sin ejecutar restore automático
- Soporte completo para Docker Compose con volumes persistentes definidos
- Cumplimiento legal local integrado (feudos, PDFs de privacidad y términos)
- Requiere configuración manual inicial de variables de entorno antes del arranque
- El restore de backups no es automático para evitar riesgos de sobrescritura de datos
- Dependencia estricta de PHP 8.2 y extensiones específicas como gd y zip
- Las migraciones requieren Phinx instalado previamente en el entorno
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue inicial con `docker compose build` y variables `.env`. En producción usar `docker-compose.prod.yml` o scripts nativos `update-native.sh`. Asegurar TLS en reverse proxy y no exponer puerto DB público. Validar backups antes de restaurar.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.