From 67c4d03597812bdaa28e112b3fe1666681aa10be Mon Sep 17 00:00:00 2001 From: TermiNexus Date: Thu, 13 Aug 2026 17:52:34 +0800 Subject: [PATCH] =?UTF-8?q?docs(settings):=20=E6=96=87=E6=A1=A3=E5=8C=96?= =?UTF-8?q?=20AUTH=5FUSER=5FMODEL=20=E4=B8=8D=E5=8F=AF=E8=A1=8C=E5=86=B3?= =?UTF-8?q?=E7=AD=96=EF=BC=88core.User=20=E9=9D=9E=20AbstractBaseUser?= =?UTF-8?q?=EF=BC=8C=E6=94=B9=E8=AE=BE=E9=9C=80=E9=87=8D=E5=BB=BA=20auth?= =?UTF-8?q?=20=E6=A1=86=E6=9E=B6=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- gvsds/settings.py | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/gvsds/settings.py b/gvsds/settings.py index 1aac38a0..64476eb5 100644 --- a/gvsds/settings.py +++ b/gvsds/settings.py @@ -106,6 +106,19 @@ TEMPLATES = [ WSGI_APPLICATION = _app_get('server', 'WSGI_APPLICATION', fallback='gvsds.wsgi.application') +# --------------------------------------------------------------------------- +# 用户模型（AUTH_USER_MODEL）——架构决策说明 +# 业务用户模型为 gvsds.apps.core.models.User（db_table='User'，主键 UserUUID， +# bcrypt 密码 UserPassword）。**不设置 AUTH_USER_MODEL**，原因： +# 1. core.User 继承 QModel 而非 Django AbstractBaseUser，无 USERNAME_FIELD 等 +# 框架必需接口，设置后 Django SystemCheckError 启动失败； +# 2. 改 AUTH_USER_MODEL 要求重建 contenttypes/auth_permission 框架， +# 现有 MySQL 业务库无法承受（非新建项目）； +# 3. 认证链路已收敛：CustomJWTAuthentication 显式绑定 core.User +# （gvsds/auth.py），admin/session 依赖的 auth_user 表未被业务使用。 +# 若未来要接入 Django auth 框架，需先重构 core.User 为 AbstractBaseUser 子类。 +# --------------------------------------------------------------------------- + SQL_IP = _secret_get('database', 'HOST', fallback='127.0.0.1') DB_USER = _secret_get('database', 'USER', fallback='root') DB_PASS = _secret_get('database', 'PASSWORD', fallback='')