Skip to content

Make targets

A generated project’s Makefile is its command line. make help lists the targets of that project; this page lists them all, read from the Makefiles of every combination of puerto nuevo flags that puerto 0.21.0 generates.

Target Does In
make setup Instala las herramientas de desarrollo (una vez, tras clonar) every project
make run Arranca el servidor de la API (http://localhost:8080) every project
make test Ejecuta todos los tests every project
make test/dominio Ejecuta los tests de cada crate de dominio (dominio_*) every project
make test/aplicacion Ejecuta los tests de cada crate de aplicación (aplicacion_*) every project
make test/infraestructura Ejecuta los tests de cada crate de infraestructura (infra_*; con –db, necesita la base de datos) every project
make lint Clippy con -D warnings every project
make format Comprueba el formato del código every project
make format/fix Corrige el formato del código every project
make check Comprobación rápida de compilación (sin binario) every project
make clean Borra lo compilado every project
make clean/incremental Borra las cachés incrementales (crecen deprisa con un crate por contexto) every project
make audit Audita la seguridad de las dependencias every project
make audit/fix Muestra los arreglos de seguridad sin aplicarlos (dry-run) every project
make generar/entidad Genera una entidad DDD nueva — make generar/entidad NOMBRE=Producto every project
make generar/caso-de-uso Añade un caso de uso a una entidad — make generar/caso-de-uso ENTIDAD=Producto ACCION=publicar_producto every project
make generar/bootstrap Regenera el cableado (cableado, bootstrap.rs) desde puerto.toml every project
make web/install Instala las dependencias del frontend (necesita Bun) every project
make web/dev Arranca el servidor de desarrollo del frontend (http://localhost:5173, /api va a :8080) every project
make web/test Ejecuta los tests del frontend every project
make web/lint Comprueba tipos, lint y la regla de dependencias del frontend every project
make web/sync Tras un scaffold o un cambio de DTO: exporta la spec OpenAPI y regenera los tipos del frontend every project
make docker-compose/up Arranca los contenedores --db or --auth oidc
make docker-compose/down Para los contenedores --db or --auth oidc
make auth/ui La consola de Keycloak: usuarios, roles, sesiones --auth oidc
make auth/token Un token de acceso de desarrollo: make -s auth/token [EMAIL=user@tienda.localhost] --auth oidc
make db/arrancar Arranca los contenedores de la base de datos --db
make db/parar Para los contenedores de la base de datos --db
make db/reiniciar Vacía la base de datos y vuelve a aplicar las migraciones (DESTRUCTIVO) --db
make sqlx/online Pasa SQLx a modo ONLINE (comprueba contra la base de datos en marcha) --db
make sqlx/offline Pasa SQLx a modo OFFLINE (usa la caché guardada) --db
make sqlx/migrate Aplica las migraciones pendientes --db
make sqlx/prepare Regenera la caché offline de SQLx (necesita la base de datos en marcha) --db
make sqlx/check Comprueba que la caché de SQLx coincide con las consultas actuales --db
make generar/migracion Crea una migración SQLx nueva — make generar/migracion NOMBRE=anadir_usuarios --db
make auth/conceder Concede un rol a una cuenta: make auth/conceder EMAIL=ada@example.com ROL=admin --auth local
make worker Arranca el worker: hace de relay del outbox y ejecuta los consumidores (health en :8081) --eventos
make eventos/descartados Lista los 20 eventos descartados más recientes --eventos
make correo/ui Dónde llegan los correos enviados en desarrollo (Mailpit) after puerto generar correo

Targets that need a service (sqlx/migrate, worker, test/infraestructura…) start docker compose first. make test and make lint include web/ whenever the directory exists.