前置条件
本机软件
- Python 3.11+（建议 3.12，与 CI 一致）
- PostgreSQL（已创建空库和用户）
- Git
- 能访问 Google Cloud Console（配置 OAuth 客户端）
可选：Resend、R2、SFTPGo、Zoom。本地可以全部留空，邮件改 console backend。
Google OAuth 客户端
本地回调必须精确匹配：
http://127.0.0.1:8000/accounts/google/login/callback/
授权的 JavaScript 来源：http://127.0.0.1:8000
若同时测 localhost 与 127.0.0.1，Google Console 里要分别加回调。SITE_URL 与浏览器实际打开的 host 应一致，否则 setup_google_oauth 写入的 Site.domain 会对不上。
数据库
.env.example 默认：
| 变量 | 示例 |
|---|---|
DB_NAME | cssaportal_dev |
DB_USER | postgres |
DB_HOST | localhost |
DB_PORT | 5432 |
DB_SSLMODE | 本地留空 |
先建好库再 migrate。项目不提供 SQLite 回退。