Spaces:
Sleeping
Sleeping
| # SolverForge Hospital Makefile | |
| # Rust + frontend + Space-oriented local build system | |
| # | |
| # This app is primarily validated for local development and Docker-based | |
| # Hugging Face Space deployment. `ci-local` therefore simulates the checks we | |
| # expect before updating a Space, rather than mirroring a GitHub Actions file. | |
| SHELL := /bin/sh | |
| .SHELLFLAGS := -eu -c | |
| unexport BASH_FUNC_mc%% | |
| # ============== Colors & Symbols ============== | |
| GREEN := \033[92m | |
| EMERALD := \033[38;2;16;185;129m | |
| CYAN := \033[96m | |
| YELLOW := \033[93m | |
| MAGENTA := \033[95m | |
| RED := \033[91m | |
| GRAY := \033[90m | |
| BOLD := \033[1m | |
| RESET := \033[0m | |
| CHECK := ✓ | |
| CROSS := ✗ | |
| ARROW := ▸ | |
| PROGRESS := → | |
| # ============== Project Metadata ============== | |
| APP_NAME := solverforge-hospital | |
| PACKAGE_NAME := solverforge-hospital | |
| VERSION := $(shell sed -n 's/^version = "\(.*\)"/\1/p' Cargo.toml | head -n1) | |
| RELEASE_TAG := $(PACKAGE_NAME)@$(VERSION) | |
| RUST_VERSION := 1.95+ | |
| PORT ?= 7860 | |
| DOCKER_IMAGE ?= $(APP_NAME) | |
| DOCKER_CONTEXT ?= . | |
| DOCKERFILE_PATH := Dockerfile | |
| PLAYWRIGHT ?= ../node_modules/.bin/playwright | |
| # ============== Phony Targets ============== | |
| .PHONY: banner help doctor build build-release run run-release test test-rust \ | |
| test-frontend-syntax test-frontend test-e2e test-slow test-one lint fmt fmt-check \ | |
| clippy check ci-local space-ci space-build space-run docker-build \ | |
| docker-run pre-release release-ci release-info version clean watch require-node require-docker \ | |
| # ============== Default Target ============== | |
| .DEFAULT_GOAL := help | |
| # ============== Banner ============== | |
| banner: | |
| @printf "$(EMERALD)$(BOLD) ____ _ _____\n" | |
| @printf " / ___| ___ | |_ _____ _ __| ___|__ _ __ __ _ ___\n" | |
| @printf " \\___ \\\\ / _ \\\\| \\\\ \\\\ / / _ \\\\ '__| |_ / _ \\\\| '__/ _\` |/ _ \\\\\n" | |
| @printf " ___) | (_) | |\\\\ V / __/ | | _| (_) | | | (_| | __/\n" | |
| @printf " |____/ \\\\___/|_| \\_/ \\___|_| |_| \\___/|_| \\__, |\\___|\n" | |
| @printf " |___/$(RESET)\n" | |
| @printf " $(GRAY)v$(VERSION)$(RESET) $(EMERALD)Hospital demo build system$(RESET)\n\n" | |
| # ============== Environment Checks ============== | |
| require-node: | |
| @command -v node >/dev/null 2>&1 || (printf "$(RED)$(CROSS) node is required for frontend validation$(RESET)\n" && exit 1) | |
| require-docker: | |
| @command -v docker >/dev/null 2>&1 || (printf "$(RED)$(CROSS) docker is required for Space/Docker targets$(RESET)\n" && exit 1) | |
| doctor: banner | |
| @printf "$(CYAN)$(BOLD)╔══════════════════════════════════════╗$(RESET)\n" | |
| @printf "$(CYAN)$(BOLD)║ Environment Check ║$(RESET)\n" | |
| @printf "$(CYAN)$(BOLD)╚══════════════════════════════════════╝$(RESET)\n\n" | |
| @missing=0; \ | |
| if command -v cargo >/dev/null 2>&1; then \ | |
| printf "$(GREEN)$(CHECK) cargo: $$(cargo --version)$(RESET)\n"; \ | |
| else \ | |
| printf "$(RED)$(CROSS) cargo not found$(RESET)\n"; \ | |
| missing=1; \ | |
| fi; \ | |
| if command -v rustc >/dev/null 2>&1; then \ | |
| printf "$(GREEN)$(CHECK) rustc: $$(rustc --version)$(RESET)\n"; \ | |
| else \ | |
| printf "$(RED)$(CROSS) rustc not found$(RESET)\n"; \ | |
| missing=1; \ | |
| fi; \ | |
| if command -v node >/dev/null 2>&1; then \ | |
| printf "$(GREEN)$(CHECK) node: $$(node --version)$(RESET)\n"; \ | |
| else \ | |
| printf "$(RED)$(CROSS) node not found$(RESET)\n"; \ | |
| missing=1; \ | |
| fi; \ | |
| if command -v docker >/dev/null 2>&1; then \ | |
| printf "$(GREEN)$(CHECK) docker: $$(docker --version)$(RESET)\n"; \ | |
| else \ | |
| printf "$(YELLOW)! docker not found; Space/Docker targets will be unavailable$(RESET)\n"; \ | |
| fi; \ | |
| printf "$(GRAY)Docker build context: $(DOCKER_CONTEXT)$(RESET)\n"; \ | |
| printf "$(GRAY)Default app port: $(PORT)$(RESET)\n"; \ | |
| if [ $$missing -ne 0 ]; then exit 1; fi | |
| @printf "\n" | |
| # ============== Build & Run ============== | |
| build: banner | |
| @printf "$(CYAN)$(BOLD)╔══════════════════════════════════════╗$(RESET)\n" | |
| @printf "$(CYAN)$(BOLD)║ Debug Build ║$(RESET)\n" | |
| @printf "$(CYAN)$(BOLD)╚══════════════════════════════════════╝$(RESET)\n\n" | |
| @printf "$(ARROW) $(BOLD)Building $(APP_NAME)...$(RESET)\n" | |
| @cargo build --bin $(APP_NAME) && \ | |
| printf "$(GREEN)$(CHECK) Debug build successful$(RESET)\n\n" || \ | |
| (printf "$(RED)$(CROSS) Debug build failed$(RESET)\n\n" && exit 1) | |
| build-release: banner | |
| @printf "$(CYAN)$(BOLD)╔══════════════════════════════════════╗$(RESET)\n" | |
| @printf "$(CYAN)$(BOLD)║ Release Build ║$(RESET)\n" | |
| @printf "$(CYAN)$(BOLD)╚══════════════════════════════════════╝$(RESET)\n\n" | |
| @printf "$(ARROW) $(BOLD)Building release binary...$(RESET)\n" | |
| @cargo build --release --bin $(APP_NAME) && \ | |
| printf "$(GREEN)$(CHECK) Release build successful$(RESET)\n\n" || \ | |
| (printf "$(RED)$(CROSS) Release build failed$(RESET)\n\n" && exit 1) | |
| run: | |
| @printf "$(ARROW) Running $(APP_NAME) on port $(PORT)...\n" | |
| @PORT=$(PORT) cargo run --bin $(APP_NAME) | |
| run-release: | |
| @printf "$(ARROW) Running release build on port $(PORT)...\n" | |
| @PORT=$(PORT) cargo run --release --bin $(APP_NAME) | |
| # ============== Test Targets ============== | |
| test: test-rust test-frontend test-e2e | |
| @printf "\n$(GREEN)$(BOLD)$(CHECK) Standard validation passed$(RESET)\n\n" | |
| test-rust: banner | |
| @printf "$(CYAN)$(BOLD)╔══════════════════════════════════════╗$(RESET)\n" | |
| @printf "$(CYAN)$(BOLD)║ Rust Test Suite ║$(RESET)\n" | |
| @printf "$(CYAN)$(BOLD)╚══════════════════════════════════════╝$(RESET)\n\n" | |
| @printf "$(ARROW) $(BOLD)Running cargo test --quiet...$(RESET)\n" | |
| @cargo test --quiet && \ | |
| printf "\n$(GREEN)$(CHECK) Rust tests passed$(RESET)\n\n" || \ | |
| (printf "\n$(RED)$(CROSS) Rust tests failed$(RESET)\n\n" && exit 1) | |
| test-frontend-syntax: require-node | |
| @printf "$(PROGRESS) Checking frontend module syntax...\n" | |
| @find static/app -name '*.mjs' -print0 | xargs -0 -n1 node --check && \ | |
| printf "$(GREEN)$(CHECK) Frontend syntax checks passed$(RESET)\n" || \ | |
| (printf "$(RED)$(CROSS) Frontend syntax checks failed$(RESET)\n" && exit 1) | |
| test-frontend: test-frontend-syntax | |
| @printf "$(PROGRESS) Running frontend tests...\n" | |
| @node --test tests/frontend/*.test.js && \ | |
| printf "$(GREEN)$(CHECK) Frontend tests passed$(RESET)\n" || \ | |
| (printf "$(RED)$(CROSS) Frontend tests failed$(RESET)\n" && exit 1) | |
| test-e2e: build-release require-node | |
| @printf "$(PROGRESS) Running Playwright browser tests...\n" | |
| @$(PLAYWRIGHT) test --config tests/e2e/playwright.config.js && \ | |
| printf "$(GREEN)$(CHECK) Playwright browser tests passed$(RESET)\n" || \ | |
| (printf "$(RED)$(CROSS) Playwright browser tests failed$(RESET)\n" && exit 1) | |
| test-slow: banner | |
| @printf "$(CYAN)$(BOLD)╔══════════════════════════════════════╗$(RESET)\n" | |
| @printf "$(CYAN)$(BOLD)║ Slow Acceptance Solve ║$(RESET)\n" | |
| @printf "$(CYAN)$(BOLD)╚══════════════════════════════════════╝$(RESET)\n\n" | |
| @printf "$(ARROW) $(BOLD)Running large demo acceptance solve...$(RESET)\n" | |
| @cargo test large_demo_solves_to_feasible_terminal_state -- --ignored --nocapture && \ | |
| printf "\n$(GREEN)$(CHECK) Slow acceptance solve passed$(RESET)\n\n" || \ | |
| (printf "\n$(RED)$(CROSS) Slow acceptance solve failed$(RESET)\n\n" && exit 1) | |
| test-one: | |
| @printf "$(PROGRESS) Running test: $(YELLOW)$(TEST)$(RESET)\n" | |
| @RUST_LOG=info cargo test $(TEST) -- --nocapture | |
| # ============== Lint & Format ============== | |
| fmt: | |
| @printf "$(PROGRESS) Formatting code...\n" | |
| @find src tests -name '*.rs' -print0 | xargs -0 rustfmt --edition 2021 | |
| @printf "$(GREEN)$(CHECK) Code formatted$(RESET)\n" | |
| fmt-check: | |
| @printf "$(PROGRESS) Checking formatting...\n" | |
| @find src tests -name '*.rs' -print0 | xargs -0 rustfmt --edition 2021 --check && \ | |
| printf "$(GREEN)$(CHECK) Formatting valid$(RESET)\n" || \ | |
| (printf "$(RED)$(CROSS) Formatting issues found$(RESET)\n" && exit 1) | |
| clippy: | |
| @printf "$(PROGRESS) Running clippy...\n" | |
| @cargo clippy --all-targets -- -D warnings && \ | |
| printf "$(GREEN)$(CHECK) Clippy passed$(RESET)\n" || \ | |
| (printf "$(RED)$(CROSS) Clippy warnings found$(RESET)\n" && exit 1) | |
| lint: fmt-check clippy test-frontend-syntax | |
| @printf "\n$(GREEN)$(BOLD)$(CHECK) Lint checks passed$(RESET)\n\n" | |
| check: lint test | |
| # ============== Space & Docker ============== | |
| docker-build: require-docker | |
| @printf "$(PROGRESS) Building Docker image $(DOCKER_IMAGE)...\n" | |
| @docker build -f "$(DOCKERFILE_PATH)" -t "$(DOCKER_IMAGE)" "$(DOCKER_CONTEXT)" && \ | |
| printf "$(GREEN)$(CHECK) Docker image built$(RESET)\n" || \ | |
| (printf "$(RED)$(CROSS) Docker build failed$(RESET)\n" && exit 1) | |
| docker-run: require-docker | |
| @printf "$(ARROW) Running $(DOCKER_IMAGE) on port $(PORT)...\n" | |
| @docker run --rm -it -e PORT=$(PORT) -p $(PORT):$(PORT) "$(DOCKER_IMAGE)" | |
| space-build: docker-build | |
| space-run: space-build | |
| @printf "$(GREEN)$(CHECK) Starting local container that mirrors the Space image$(RESET)\n" | |
| @$(MAKE) docker-run --no-print-directory PORT=$(PORT) DOCKER_IMAGE=$(DOCKER_IMAGE) | |
| space-ci: ci-local | |
| # ============== CI & Release Validation ============== | |
| ci-local: banner | |
| @printf "$(CYAN)$(BOLD)╔══════════════════════════════════════════════════════════╗$(RESET)\n" | |
| @printf "$(CYAN)$(BOLD)║ Local Space Validation Pipeline ║$(RESET)\n" | |
| @printf "$(CYAN)$(BOLD)╚══════════════════════════════════════════════════════════╝$(RESET)\n\n" | |
| @printf "$(ARROW) $(BOLD)Simulating the checks we want green before a Space update...$(RESET)\n\n" | |
| @printf "$(PROGRESS) Step 1/5: Format check...\n" | |
| @$(MAKE) fmt-check --no-print-directory | |
| @printf "$(PROGRESS) Step 2/5: Clippy...\n" | |
| @$(MAKE) clippy --no-print-directory | |
| @printf "$(PROGRESS) Step 3/5: Release build...\n" | |
| @$(MAKE) build-release --no-print-directory | |
| @printf "$(PROGRESS) Step 4/5: Standard test surface...\n" | |
| @$(MAKE) test --no-print-directory | |
| @printf "$(PROGRESS) Step 5/5: Docker/Space image build...\n" | |
| @$(MAKE) space-build --no-print-directory | |
| @printf "\n$(GREEN)$(BOLD)╔══════════════════════════════════════════════════════════╗$(RESET)\n" | |
| @printf "$(GREEN)$(BOLD)║ $(CHECK) SPACE VALIDATION PASSED ║$(RESET)\n" | |
| @printf "$(GREEN)$(BOLD)╚══════════════════════════════════════════════════════════╝$(RESET)\n\n" | |
| pre-release: banner | |
| @printf "$(CYAN)$(BOLD)╔══════════════════════════════════════════════════════════╗$(RESET)\n" | |
| @printf "$(CYAN)$(BOLD)║ Pre-Release Validation v$(VERSION) ║$(RESET)\n" | |
| @printf "$(CYAN)$(BOLD)╚══════════════════════════════════════════════════════════╝$(RESET)\n\n" | |
| @$(MAKE) ci-local --no-print-directory | |
| @printf "$(PROGRESS) Final step: slow acceptance solve...\n" | |
| @$(MAKE) test-slow --no-print-directory | |
| @printf "$(GREEN)$(BOLD)$(CHECK) Ready for a Space update$(RESET)\n\n" | |
| release-ci: ci-local | |
| @printf "$(GREEN)$(BOLD)$(CHECK) Release CI passed for $(RELEASE_TAG)$(RESET)\n\n" | |
| release-info: | |
| @printf "$(CYAN)Package:$(RESET) $(YELLOW)$(BOLD)$(PACKAGE_NAME)$(RESET)\n" | |
| @printf "$(CYAN)Version:$(RESET) $(YELLOW)$(BOLD)$(VERSION)$(RESET)\n" | |
| @printf "$(CYAN)Release tag:$(RESET) $(YELLOW)$(BOLD)$(RELEASE_TAG)$(RESET)\n" | |
| # ============== Metadata & Cleanup ============== | |
| version: | |
| @printf "$(CYAN)Current version:$(RESET) $(YELLOW)$(BOLD)$(VERSION)$(RESET)\n" | |
| @printf "$(CYAN)Release tag:$(RESET) $(YELLOW)$(BOLD)$(RELEASE_TAG)$(RESET)\n" | |
| @printf "$(CYAN)Default port:$(RESET) $(YELLOW)$(BOLD)$(PORT)$(RESET)\n" | |
| clean: | |
| @printf "$(ARROW) Cleaning build artifacts...\n" | |
| @cargo clean | |
| @printf "$(GREEN)$(CHECK) Clean complete$(RESET)\n" | |
| watch: | |
| @printf "$(ARROW) Watching and rerunning the app on port $(PORT)...\n" | |
| @cargo watch --version >/dev/null 2>&1 || \ | |
| (printf "$(RED)$(CROSS) cargo-watch is required for make watch$(RESET)\n" && exit 1) | |
| @cargo watch -x "run --bin $(APP_NAME)" | |
| # ============== Help ============== | |
| help: banner | |
| @/bin/echo -e "$(CYAN)$(BOLD)Environment:$(RESET)" | |
| @/bin/echo -e " $(GREEN)make doctor$(RESET) - Check toolchain and Docker readiness" | |
| @/bin/echo -e "" | |
| @/bin/echo -e "$(CYAN)$(BOLD)Build & Run:$(RESET)" | |
| @/bin/echo -e " $(GREEN)make build$(RESET) - Build the app in debug mode" | |
| @/bin/echo -e " $(GREEN)make build-release$(RESET) - Build the app in release mode" | |
| @/bin/echo -e " $(GREEN)make run$(RESET) - Run the app locally on port $(PORT)" | |
| @/bin/echo -e " $(GREEN)make run-release$(RESET) - Run the release build locally on port $(PORT)" | |
| @/bin/echo -e "" | |
| @/bin/echo -e "$(CYAN)$(BOLD)Tests & Validation:$(RESET)" | |
| @/bin/echo -e " $(GREEN)make test$(RESET) - Run the standard Rust, frontend, and Playwright test surface" | |
| @/bin/echo -e " $(GREEN)make test-rust$(RESET) - Run Rust tests only" | |
| @/bin/echo -e " $(GREEN)make test-frontend$(RESET) - Run frontend syntax checks and tests" | |
| @/bin/echo -e " $(GREEN)make test-e2e$(RESET) - Run Playwright browser tests" | |
| @/bin/echo -e " $(GREEN)make test-slow$(RESET) - Run the ignored large-demo acceptance solve" | |
| @/bin/echo -e " $(GREEN)make test-one TEST=name$(RESET) - Run a specific Rust test with output" | |
| @/bin/echo -e " $(GREEN)make lint$(RESET) - Run fmt-check, clippy, and frontend syntax checks" | |
| @/bin/echo -e " $(GREEN)make check$(RESET) - Run lint plus the standard test surface" | |
| @/bin/echo -e " $(GREEN)make release-ci$(RESET) - Run the tag-publish CI gate for this app" | |
| @/bin/echo -e "" | |
| @/bin/echo -e "$(CYAN)$(BOLD)Space & Docker:$(RESET)" | |
| @/bin/echo -e " $(GREEN)make space-build$(RESET) - Build the Docker image used for Space-style deployment" | |
| @/bin/echo -e " $(GREEN)make space-run$(RESET) - Build and run that image locally on port $(PORT)" | |
| @/bin/echo -e " $(GREEN)make ci-local$(RESET) - Simulate the pre-push validation for a Hugging Face Space" | |
| @/bin/echo -e " $(GREEN)make pre-release$(RESET) - Run ci-local plus the slow acceptance solve" | |
| @/bin/echo -e "" | |
| @/bin/echo -e "$(CYAN)$(BOLD)Other:$(RESET)" | |
| @/bin/echo -e " $(GREEN)make fmt$(RESET) - Format Rust code" | |
| @/bin/echo -e " $(GREEN)make release-info$(RESET) - Show package version and app-scoped release tag" | |
| @/bin/echo -e " $(GREEN)make version$(RESET) - Show version and default port" | |
| @/bin/echo -e " $(GREEN)make clean$(RESET) - Clean build artifacts" | |
| @/bin/echo -e " $(GREEN)make watch$(RESET) - Watch source files and rerun the app" | |
| @/bin/echo -e " $(GREEN)make help$(RESET) - Show this help message" | |
| @/bin/echo -e "" | |
| @/bin/echo -e "$(GRAY)Rust version required: $(RUST_VERSION)$(RESET)" | |
| @/bin/echo -e "$(GRAY)Current version: v$(VERSION)$(RESET)" | |
| @/bin/echo -e "$(GRAY)Release tag: $(RELEASE_TAG)$(RESET)" | |
| @/bin/echo -e "$(GRAY)Default port: $(PORT)$(RESET)" | |
| @/bin/echo -e "" | |