Inicio rápido — aps-common

El texto proviene del README de registro del repositorio, incluido al momento de compilar el sitio.

Inicio rápido de desarrollo

  1. Clonar el repositorio como hermano de las copias de trabajo de las aplicaciones: sus objetivos de sincronización resuelven el paquete en ../aps-common.

  2. Verificar la batería propia en verde con el objetivo test del Makefile (un contenedor PHP básico, igual que las aplicaciones; no requiere APS Conecta Gestión). La mitad JS se prueba con node --test js/*.test.js; su corpus de conformidad lo comparten las baterías vitest de las aplicaciones. La integración continua (.github/workflows/ci.yml) ejecuta ambas en cada pull request.

Para consumirlo desde una aplicación: un repositorio de tipo ruta de Composer que apunte a la copia hermana, un require de aps/common, y el subárbol vendor/aps/common/src confirmado en la aplicación (justificación en el ADR 0001). vendor/autoload.php no se confirma: el Application.php de cada aplicación registra un pequeño cargador PSR-4 para APS\Common\. El piso es PHP ^8.1, porque territorio fija config.platform.php 8.1 y un piso mayor haría el paquete no instalable allí.

Tras editar el paquete, ejecutar el objetivo aps-sync de cada aplicación (copia src/ a vendor/aps/common/src/, el stub a tests/stubs/ y js/ a src/aps/) y luego su objetivo aps-drift, que prueba que el subárbol confirmado es igual al paquete.

Licencia