docs(settings): 文档化 AUTH_USER_MODEL 不可行决策（core.User 非 AbstractBaseUser，改设需重建 auth 框架）

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='')