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.