前置条件

本机软件

• 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 回退。