签入版本

2026-09-12 19:09:28 +08:00
commit 4eae62bc17
803 changed files with 105034 additions and 0 deletions
@@ -0,0 +1,74 @@
+# ============================================================
+# DjangoAdmin Flask 常用命令集
+# 用法：make help / make lint / make test / ...
+# ============================================================
+
+PYTHON ?= python
+PIP ?= $(PYTHON) -m pip
+FLASK ?= $(PYTHON) -m flask
+
+# 说明：.env 中 FLASK_VERSION=v3.0.0 会被 Flask CLI 误解析为 --version 布尔标志，
+# 导致 flask db 系列命令报错。故 db-* 目标显式跳过 CLI 自动加载 .env
+# （config/__init__.py 会自行加载 .env，应用配置不受影响）。
+FLASK_ENV_PREFIX := FLASK_SKIP_DOTENV=1 FLASK_APP=app.py
+
+.PHONY: help install install-dev dev lint format type-check test test-cov \
+        db-migrate db-upgrade db-downgrade docker-up docker-down clean
+
+help:                 ## 显示全部命令帮助
+	@grep -E '^[a-zA-Z_-]+:.*?## ' $(MAKEFILE_LIST) | sort | \
+	  awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-15s\033[0m %s\n", $$1, $$2}'
+
+# ---- 依赖 ----
+install:              ## 安装生产依赖
+	$(PIP) install -r requirements.txt
+
+install-dev:          ## 安装开发依赖（含生产依赖 + 测试/规范工具）
+	$(PIP) install -r requirements-dev.txt
+
+# ---- 运行 ----
+dev:                  ## 启动开发服务器（127.0.0.1:8021）
+	$(PYTHON) app.py
+
+# ---- 代码质量 ----
+lint:                 ## 静态检查（flake8 + black + isort）
+	flake8 src config tests scripts
+	black --check --line-length 120 src config tests scripts
+	isort --check-only src config tests scripts
+
+format:               ## 自动格式化（black + isort）
+	black --line-length 120 src config tests scripts
+	isort src config tests scripts
+
+type-check:           ## 类型检查（mypy）
+	mypy src
+
+# ---- 测试 ----
+test:                 ## 运行全部测试
+	pytest
+
+test-cov:             ## 带覆盖率运行测试
+	pytest --cov=src --cov-report=term-missing
+
+# ---- 数据库迁移 ----
+db-migrate:           ## 生成迁移脚本（模型变更后）
+	$(FLASK_ENV_PREFIX) $(FLASK) db migrate
+
+db-upgrade:           ## 应用迁移到最新
+	$(FLASK_ENV_PREFIX) $(FLASK) db upgrade
+
+db-downgrade:         ## 回滚一次迁移
+	$(FLASK_ENV_PREFIX) $(FLASK) db downgrade
+
+# ---- Docker ----
+docker-up:            ## 启动 Docker 服务
+	cd docker && docker-compose up -d
+
+docker-down:          ## 停止 Docker 服务
+	cd docker && docker-compose down
+
+# ---- 清理 ----
+clean:                ## 清理缓存与临时文件
+	find . -type d -name __pycache__ -not -path "*/ui/*" -exec rm -rf {} +
+	find . -type f -name "*.pyc" -not -path "*/ui/*" -delete
+	rm -rf .pytest_cache .mypy_cache