Makefile

# ============================================================================
# Makefile for DaybydayCRM
# Unified Docker & Host Development Workflow
# ============================================================================
#
# This Makefile provides a unified interface for common development tasks,
# supporting both host and Docker container execution. It is designed for
# developer productivity, CI/CD, and onboarding ease.
#
# Usage:
#   - Run from project root: `make <target>`
#   - For Dockerized workflows, ensure containers are running (`make up`).
#
# Primary Targets:
#   dtest      Run PHPUnit tests inside Docker (optionally filter by name)
#   dfail      Run all tests, stop on first failure
#   e2e-install Install frontend deps for Playwright and download Chromium
#   e2e-test   Run the Playwright e2e suite
#   e2e-test-one Run a single Playwright spec file
#   e2e-fail   Run Playwright tests, stop on first failure
#   e2e-list   List discovered Playwright tests
#   dsh        Open a shell in the workspace container
#   dmfs       Fresh migrate and seed database inside Docker
#   dseed      Fresh migrate and seed with demo + dummy data inside Docker
#   install    Composer install (inside container)
#   mfs        Fresh migrate/seed (inside container)
#   seed       Fresh migrate/seed with demo + dummy data (inside container)
#   yarn-setup Install JS deps and build (inside container)
#   setup      Full setup: composer, migrate, yarn
#   clear      Clear Laravel caches (inside container)
#   phpunit    Run PHPUnit (inside container)
#   test-fail  Run PHPUnit, stop on failure (inside container)
#   test-filter Run PHPUnit with filter (inside container)
#   paratest   Run tests in parallel (inside container)
#   parafail   Parallel tests, stop on failure (inside container)
#   up         Start Docker containers
#   down       Stop and remove Docker containers
#   rebuild    Rebuild Docker containers
#   help       Show this help message
#
# See also: README.md for onboarding and troubleshooting.
#
# -----------------------------------------------------------------------------

# --- Configuration ---
CONTAINER_NAME := workspace
DOCKER_USER    := ivpldock
E2E_SPEC       ?=
E2E_ARGS       ?=
STOP_ON_FAILURE ?= false
# Dynamic container lookup for Laradock-style naming
DOCKER_EXEC    := docker exec -t --user=$(DOCKER_USER) $$(docker ps -aqf "name=$(CONTAINER_NAME)")

# --- Primary Entry Points (Host) ---

# Run a specific test from host: make dtest f=ProjectsControllerTest
dtest:
	@$(DOCKER_EXEC) vendor/bin/phpunit --exclude-group flaky --stop-on-failure $(if $(f),--filter $(f),)

# Run all tests until first failure: make dfail
dfail:
	@$(DOCKER_EXEC) vendor/bin/phpunit --exclude-group flaky --stop-on-failure

# Quick shell access: make dsh
dsh:
	docker exec -it --user=$(DOCKER_USER) $$(docker ps -aqf "name=$(CONTAINER_NAME)") bash

# Fresh migration and seed from host: make dmfs
dmfs:
	@$(DOCKER_EXEC) php artisan migrate:fresh --seed

# Seed database with demo and dummy data from host: make dseed
dseed:
	@$(DOCKER_EXEC) php artisan migrate:fresh --seed && $(DOCKER_EXEC) php artisan db:seed --class=DemoTableSeeder && $(DOCKER_EXEC) php artisan db:seed --class=DummyDatabaseSeeder

# --- Inside-Container Targets (Local PHP) ---

install:
	composer install

mfs:
	php artisan migrate:fresh --seed

seed:
	php artisan migrate:fresh --seed && php artisan db:seed --class=DemoTableSeeder && php artisan db:seed --class=DummyDatabaseSeeder

yarn-setup:
	yarn install && yarn run build

setup: install mfs yarn-setup

e2e-install:
	yarn install --frozen-lockfile
	yarn run e2e:install

e2e-test:
	@if [ "$(STOP_ON_FAILURE)" = "true" ]; then \
		yarn run test:e2e:stop-on-failure -- $(E2E_ARGS); \
	else \
		yarn run test:e2e -- $(E2E_ARGS); \
	fi

# Usage: make e2e-test-one E2E_SPEC=tests/e2e/auth/auth.spec.js
# Usage: make e2e-test-one E2E_SPEC=tests/e2e/auth/auth.spec.js STOP_ON_FAILURE=true
e2e-test-one:
e2e-test-one:
	`@test` -n "$(E2E_SPEC)" || { echo "Usage: make e2e-test-one E2E_SPEC=tests/e2e/auth/auth.spec.js E2E_ARGS='--project=chromium'"; exit 1; }
	`@if` [ "$(STOP_ON_FAILURE)" = "true" ]; then \
		yarn run test:e2e:stop-on-failure -- $(E2E_SPEC) $(E2E_ARGS); \
		yarn run test:e2e:stop-on-failure -- $(E2E_SPEC) $(E2E_ARGS); \
	else \
		yarn run test:e2e:file -- $(E2E_SPEC) $(E2E_ARGS); \
	fi
# Run Playwright tests, stop on first failure: make e2e-fail
e2e-fail:
	yarn run test:e2e:stop-on-failure -- $(E2E_ARGS)

e2e-list:
	yarn run test:e2e:list

clear:
	php artisan config:clear && php artisan cache:clear && php artisan route:clear && php artisan view:clear

# --- Standard Testing ---

phpunit:
	vendor/bin/phpunit

test:
	APP_ENV=testing vendor/bin/phpunit --exclude-group flaky --stop-on-failure --stop-on-error

test-fail:
	APP_ENV=testing vendor/bin/phpunit --exclude-group flaky --stop-on-failure

# Usage: make test-filter f=SomeTest
test-filter:
	APP_ENV=testing vendor/bin/phpunit --exclude-group flaky --filter $(f) --stop-on-failure --stop-on-error

# --- Parallel Testing (Inside Container) ---

paratest:
	APP_ENV=testing vendor/bin/paratest --exclude-group flaky -p16 > phpunit-testdox.log 2>&1 || (cat phpunit-testdox.log >&2; exit 1)

parafail:
	APP_ENV=testing vendor/bin/paratest --exclude-group flaky -p16 --stop-on-failure > phpunit-testdox.log 2>&1 || (cat phpunit-testdox.log >&2; exit 1)

# --- Docker Compose (Host Level) ---

up:
	docker-compose up -d

down:
	docker-compose down -v

rebuild:
	docker-compose down -v && docker-compose build --no-cache && docker-compose up -d

# --- Help ---

help:
	@echo "======================================================================"
	@echo "HOST COMMANDS (Run these from your terminal):"
	@echo "  make dtest f=<name>  : Run specific test (e.g., make dtest f=ProjectsControllerTest)"
	@echo "  make dfail           : Run all tests, stop on first error"
	@echo "  make dsh             : Enter the workspace container as $(DOCKER_USER)"
	@echo "  make dmfs            : Fresh migrate/seed inside container"
	@echo "  make dseed           : Fresh migrate + demo + dummy seed inside container"
	@echo "  make up / make down  : Manage docker-compose"
	@echo ""
	@echo "CONTAINER COMMANDS (Run these inside 'make dsh'):"
	@echo "  make setup           : Install composer/yarn and migrate"
	@echo "  make seed            : Fresh migrate + demo + dummy seed"
	@echo "  make test-fail       : Run phpunit until failure"
	@echo "  make e2e-install     : Install npm deps for Playwright and download Chromium"
	@echo "  make e2e-test        : Run all Playwright e2e tests"
	@echo "  make e2e-test-one    : Run one Playwright spec (set E2E_SPEC=tests/e2e/auth/auth.spec.js)"
	@echo "  make e2e-fail        : Run Playwright tests, stop on first failure"
	@echo "  make e2e-list        : List discovered Playwright tests"
	@echo "  make paratest        : Run tests in parallel"
	@echo ""
	@echo "E2E OPTIONS:"
	@echo "  STOP_ON_FAILURE=true : Stop on first failure (use with e2e-test or e2e-test-one)"
	@echo "  E2E_ARGS='...'       : Pass additional arguments to Playwright"
	@echo "  E2E_SPEC=path        : Specify test file for e2e-test-one"
	@echo ""
	@echo "EXAMPLES:"
	@echo "  make e2e-test STOP_ON_FAILURE=true"
	@echo "  make e2e-test-one E2E_SPEC=tests/e2e/auth/auth.spec.js STOP_ON_FAILURE=true"
	@echo "======================================================================"

.DEFAULT_GOAL := help