8082a9f968
Run backend and web with a shared configurable port, add local webhook and secret-generation helpers with tests, and document current app-auth and fixture workflows.
57 lines
2.6 KiB
Makefile
57 lines
2.6 KiB
Makefile
SHELL := /bin/sh
|
|
.DEFAULT_GOAL := help
|
|
|
|
# Parse only the shared port; importing .env as Make syntax would misread secrets and JSON.
|
|
BACKEND_PORT ?= $(shell uv run --no-sync python -c 'from dotenv import dotenv_values; print(dotenv_values(".env").get("BACKEND_PORT") or "8000")')
|
|
|
|
.PHONY: help install dev db-up db-down migrate backend-dev web-dev contract check-fast check test build
|
|
|
|
help: ## List repository commands
|
|
@grep -E '^[a-zA-Z_-]+:.*## ' $(MAKEFILE_LIST) | sort | awk -F ':.*## ' '{printf "%-16s %s\n", $$1, $$2}'
|
|
|
|
install: ## Sync project-local dependencies from both lockfiles
|
|
uv sync --locked --all-groups
|
|
cd apps/web && bun install --frozen-lockfile
|
|
|
|
dev: ## Start PostgreSQL and run the native backend and web together
|
|
$(MAKE) --jobs=2 backend-dev web-dev
|
|
|
|
db-up: ## Start local PostgreSQL and wait until ready
|
|
docker compose up -d --wait postgres
|
|
|
|
db-down: ## Stop local services without deleting the database
|
|
docker compose down
|
|
|
|
migrate: ## Apply migrations to the configured database
|
|
uv run --no-sync alembic upgrade head
|
|
|
|
backend-dev: db-up ## Ensure PostgreSQL is ready, then run backend on the shared port
|
|
uv run --no-sync uvicorn ai_platform.main:app --reload --host 127.0.0.1 --port $(BACKEND_PORT)
|
|
|
|
web-dev: ## Run SvelteKit with the shared backend address
|
|
cd apps/web && BACKEND_INTERNAL_URL=http://127.0.0.1:$(BACKEND_PORT) bun run dev -- --host 127.0.0.1
|
|
|
|
contract: ## Generate the backend OpenAPI consumed by Admin Web
|
|
uv run --no-sync ai-platform export-openapi contracts/lead-scoring/v2/openapi.json
|
|
uv run --no-sync python scripts/export_contract_fixtures.py
|
|
|
|
check-fast: ## Check staged/all tracked source with opt-in pre-commit rules
|
|
uv run --no-sync pre-commit run --all-files
|
|
|
|
test: ## Run backend tests only on the isolated test database
|
|
@set -a; if [ -f .env.test ] && [ -z "$$CI" ]; then . ./.env.test; fi; set +a; \
|
|
python -c 'from urllib.parse import urlsplit; import os,sys; url=os.environ.get("AI_PLATFORM_DATABASE_URL", ""); sys.exit(urlsplit(url).path.rstrip("/").split("/")[-1] != "ai_platform_test")' || { echo "Test URL must end in /ai_platform_test." >&2; exit 2; }; \
|
|
uv run --no-sync pytest
|
|
|
|
check: check-fast contract ## Run backend and web checks used by CI
|
|
uv run --no-sync ruff check src tests
|
|
uv run --no-sync ruff format --check src tests
|
|
uv run --no-sync pyright
|
|
uv run --no-sync lint-imports
|
|
$(MAKE) test
|
|
cd apps/web && bun run format:check && bun run check && bun run test && bun run build
|
|
|
|
build: ## Build both images; does not deploy them
|
|
docker build -f Dockerfile.backend -t ai-platform-backend:local .
|
|
docker build -f apps/web/Dockerfile -t ai-platform-web:local .
|