refactor: rename API and frontend projects to Vocero

Rename the project directories, Python distribution and import package, and npm package. Update launcher, Docker, tooling, tests, lockfiles, and documentation while preserving existing API contracts. Make AGENTS.md self-contained and remove external skill and workflow references.
2026-10-06 19:26:55 -03:00
parent e0304b2bdb
commit abd03ed07d
105 changed files with 353 additions and 312 deletions
@@ -0,0 +1,60 @@
+UV ?= uv
+UV_RUN = $(UV) run --locked
+
+.PHONY: help install lock lock-check format format-check lint lint-fix type-check test check dev hooks-install hooks-run test-launcher test-image
+
+help:
+	@printf '%s\n' \
+		'install        Sync the uv environment, including development tools' \
+		'lock           Resolve dependencies into uv.lock' \
+		'format         Apply Ruff fixes and formatting' \
+		'check          Check lock freshness, formatting, lint, types, and backend tests' \
+		'dev            Start the existing React/FastAPI development launcher' \
+		'hooks-install  Install optional local pre-commit checks' \
+		'test-launcher  Exercise the Bash supervisor with local fixture processes' \
+		'test-image     Build and smoke-test the backend Docker image'
+
+install:
+	$(UV) sync --locked
+
+lock:
+	$(UV) lock
+
+lock-check:
+	$(UV) lock --check
+
+format:
+	$(UV_RUN) ruff check --fix-only .
+	$(UV_RUN) ruff format .
+
+format-check:
+	$(UV_RUN) ruff format --check .
+
+lint:
+	$(UV_RUN) ruff check .
+
+lint-fix:
+	$(UV_RUN) ruff check --fix .
+
+type-check:
+	$(UV_RUN) mypy
+
+test:
+	$(UV_RUN) pytest
+
+check: lock-check format-check lint type-check test
+
+dev:
+	../start_ui.sh
+
+hooks-install:
+	$(UV_RUN) pre-commit install --install-hooks --config vocero-api/.pre-commit-config.yaml
+
+hooks-run:
+	$(UV_RUN) pre-commit run --all-files --config vocero-api/.pre-commit-config.yaml
+
+test-launcher:
+	npm --prefix ../vocero-frontend run test:launcher
+
+test-image:
+	bash scripts/test_docker_image.sh