Sgshelper

三国杀武将/技能检索网站（Django SSR）。需求与设计见：

• REQUIREMENTS.md
• DESIGN.md

开发环境

• Python: 3.12+
• Poetry: 1.8+

本项目使用 Poetry 管理依赖与虚拟环境（.venv/ 在项目目录内）。

快速开始

# 1) 安装依赖并创建虚拟环境
make install

# 2) 复制环境变量
cp .env.example .env

# 3) 初始化 Django（首次创建项目骨架后才可执行 migrate/run）
# make migrate
# make run

常用命令

make fmt
make lint
make test
make run
make migrate

Git / 贡献约定（建议）

• 默认分支建议：main
• 建议使用 Conventional Commits（可选）：
  • feat: ... / fix: ... / chore: ... / docs: ...

代码质量

• Ruff：lint + import 排序
• pre-commit：提交前自动执行基础检查

安装 hooks：

make precommit