admin/dyncoll-dev
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

license: built full stack, test and documentation
Some checks failed
docs / build (push) Has been cancelled
Details
docs / deploy (push) Has been cancelled
Details

Browse Source
This commit is contained in:
Giuseppe Naponiello
2026-07-03 12:47:47 +02:00
parent f8206b5840
commit 271acacb1d
39 changed files with 4078 additions and 57 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
Makefile
View File

@@ -12,13 +12,17 @@ DC := docker compose
EXEC := $(DC) exec -u $(UID):$(GID) backend
.DEFAULT_GOAL := help
.PHONY: help up down build logs composer be-install be-update artisan migrate import tinker test fe-install fe-add fe-rebuild fe-dev fe-build fe-lint-css fe-lint-css-fix permissions
.PHONY: help up down build logs composer be-install be-update artisan migrate import tinker test fe-install fe-add fe-rebuild fe-dev fe-build fe-lint-css fe-lint-css-fix docs docs-check permissions
# Stessa versione pinnata nella CI (.github/workflows/docs.yml): allineare insieme.
MKDOCS_IMG := squidfunk/mkdocs-material:9.7.6
MKDOCS_VOL := -v $(CURDIR)/mkdocs.yml:/docs/mkdocs.yml:ro -v $(CURDIR)/docs:/docs/docs:ro
help: ## Mostra questo aiuto
@grep -hE '^[a-zA-Z_-]+:.*?## ' $(MAKEFILE_LIST) | awk 'BEGIN{FS=":.*?## "}{printf " \033[36m%-14s\033[0m %s\n",$$1,$$2}'
## --- Stack ---
up: ## Avvia l'intero stack dev: Vite HMR + backend(serve) + db + redis + docs + mailpit
up: ## Avvia l'intero stack dev: Vite HMR + backend(serve) + db + redis + mailpit
$(DC) up -d
down: ## Ferma lo stack
$(DC) down
@@ -76,6 +80,12 @@ fe-lint-css: ## Stylelint (check) nel container — gira anche nel pre-commit
$(DC) exec -T frontend npm run lint:css
fe-lint-css-fix: ## Stylelint con --fix (container come UID host: scrive sul bind-mount)
$(DC) exec -u $(UID):$(GID) -T frontend npm run lint:css:fix
## --- Documentazione (pubblicata da GitHub Pages, .github/workflows/docs.yml) ---
docs: ## Anteprima locale MkDocs con live reload su http://localhost:8001/adc/ (Ctrl+C per uscire; la 8000 è del backend)
docker run --rm -p 8001:8000 $(MKDOCS_VOL) $(MKDOCS_IMG) serve --dev-addr=0.0.0.0:8000
docs-check: ## Build --strict come in CI (fallisce su link rotti): da lanciare prima del push
docker run --rm $(MKDOCS_VOL) $(MKDOCS_IMG) build --strict --site-dir /tmp/site
## --- Manutenzione ---
permissions: ## Permessi storage scrivibili da php-fpm (www-data) — richiede sudo, una tantum
sudo chgrp -R www-data backend/storage backend/bootstrap/cache