feat: connect django admin smoke tests

apps/users/admin.py

@@ -1,3 +1,22 @@
 from django.contrib import admin
+from django.contrib.auth.admin import UserAdmin as DjangoUserAdmin
 
-# Register your models here.
+from .models import User
+
+
+@admin.register(User)
+class UserAdmin(DjangoUserAdmin):
+    fieldsets = DjangoUserAdmin.fieldsets + (
+        ("Cmhub", {"fields": ("payment_user_id", "status", "created_at")}),
+    )
+    readonly_fields = ("created_at",)
+    list_display = (
+        "username",
+        "email",
+        "status",
+        "is_staff",
+        "is_active",
+        "created_at",
+    )
+    list_filter = DjangoUserAdmin.list_filter + ("status",)
+    search_fields = ("username", "email", "payment_user_id")

apps/users/tests.py

@@ -1,3 +1,23 @@
+from django.contrib import admin
+from django.contrib.auth import get_user_model
 from django.test import TestCase
+from django.urls import reverse
 
-# Create your tests here.
+
+class AdminSmokeTests(TestCase):
+    def test_custom_user_is_registered_in_admin(self):
+        self.assertIn(get_user_model(), admin.site._registry)
+
+    def test_superuser_can_login_to_admin(self):
+        user_model = get_user_model()
+        user_model.objects.create_superuser(
+            username="admin",
+            email="admin@example.com",
+            password="test-password",
+        )
+
+        logged_in = self.client.login(username="admin", password="test-password")
+        self.assertTrue(logged_in)
+
+        response = self.client.get(reverse("admin:index"))
+        self.assertEqual(response.status_code, 200)

config/settings.py

@@ -58,7 +58,7 @@ SECRET_KEY = os.environ.get("DJANGO_SECRET_KEY", "django-insecure-dev-only-chang
 # SECURITY WARNING: don't run with debug turned on in production!
 DEBUG = env_bool("DJANGO_DEBUG", True)
 
-ALLOWED_HOSTS = env_list("DJANGO_ALLOWED_HOSTS", "127.0.0.1,localhost")
+ALLOWED_HOSTS = env_list("DJANGO_ALLOWED_HOSTS", "127.0.0.1,localhost,testserver")
 
 
 # Application definition

docs/03-tech-stack.md

@@ -18,6 +18,7 @@
 | 图片结果存储 | 对象存储（S3 兼容 / 本地存储）返回 URL | 待定 | 同步响应默认返回 `image_url`，避免大 base64 进响应体 |
 | 配置变更审计 | django-admin LogEntry 或自建审计表 | 待定 | 模型/别名/密钥变更留痕，与「账目对得上」一致 |
 | 数据库 | MySQL 8.4 LTS（cmhub 专用独立实例） | 已定 | 满足 Django 5.2 的 MySQL ≥8.0.11；引擎 InnoDB + 字符集 utf8mb4；行锁 `select_for_update` / 条件更新保并发扣点。**不复用 VPS 已有的 MySQL 5.7**（跑不了 Django 5.2、无 CHECK 约束）。开发亦用 MySQL，勿用 SQLite（不支持 `select_for_update`） |
+| MySQL 驱动 | PyMySQL + cryptography | 已定 | PyMySQL 负责 Django 连接 MySQL；MySQL 8 默认 `caching_sha2_password` 认证需要 `cryptography` 支持 |
 | 对外鉴权 | API Key（DRF 自定义 Authentication，哈希存储比对） | 已定 | 用户自助生成 Key；**API 只认 Key、不挂 SessionAuthentication**，防浏览器 cookie 绕过计费 |
 | 用户端鉴权 | Django Session（+ allauth 注册登录邮箱验证） | 已定 | 用户端页面与 `recharge/create` 走 session + CSRF；后台账号也用 Session 登录 |
 | 充值对接 | 自助扫码：微信 V3 native + 支付宝当面付；下单取二维码 + 服务端回调（验签 + 幂等） | 已定 | 库 `wechatpayv3` / `python-alipay-sdk`；协议对齐同支付系统 PHP 实现（见 `api.md`）；仅商户密钥/证书待提供 |

docs/06-tasks.md

@@ -24,7 +24,7 @@
 | --- | --- | --- | --- | --- |
 | T-001 | 初始化 Django + DRF 项目骨架 | - | `manage.py` 可运行；`runserver` 起得来；用真实命令替换 `init.sh`/`init.ps1` 与 `00-ai-start-here.md`/`03-tech-stack.md`/`current-state.md` 的占位命令 | DONE |
 | T-002 | 建立 apps 目录、自定义 User 与配置 | T-001 | 按 `04-architecture.md` 建 `apps/users|portal|billing|ai|api`；**首次迁移前定义自定义 `User` 模型（设 `AUTH_USER_MODEL`）**；settings 用环境变量读密钥、配 MySQL(utf8mb4)，无明文密钥 | DONE |
-| T-003 | 接通 django-admin 与最小测试 | T-001 | `createsuperuser` 后能登录 `/admin/`；`manage.py test` 可运行（至少 1 条占位测试通过） | TODO |
+| T-003 | 接通 django-admin 与最小测试 | T-001 | `createsuperuser` 后能登录 `/admin/`；`manage.py test` 可运行（至少 1 条占位测试通过） | DONE |
 
 ## Phase 1 · 最高风险验证（AI 调用 + 可插拔供应商）
 

docs/current-state.md

@@ -12,16 +12,16 @@
 ## 当前快照
 
 - 日期：2026-07-02
-- 阶段：Phase 0 地基，T-002 已完成；下一步 T-003
-- 技术栈：系统 Python 3.12.3 + Django 5.2.15 + DRF 3.16.1 + PyMySQL 1.1.3 + django-admin；MySQL 8.4 已接入 settings；用户端(模板 SSR/Bootstrap/allauth) 后续任务落地；详见 `03-tech-stack.md`
-- 生产代码：已有最小 Django 工程骨架：`manage.py`、`config/`；T-002 已创建 `apps/users|portal|billing|ai|api`
-- 测试：`manage.py check` / `manage.py test` 通过；MySQL 迁移已成功
+- 阶段：Phase 0 地基已完成；下一步进入 Phase 1 的 T-101
+- 技术栈：系统 Python 3.12.3 + Django 5.2.15 + DRF 3.16.1 + PyMySQL 1.1.3 + cryptography 46.0.7 + django-admin；MySQL 8.4 已接入 settings；用户端(模板 SSR/Bootstrap/allauth) 后续任务落地；详见 `03-tech-stack.md`
+- 生产代码：已有最小 Django 工程骨架：`manage.py`、`config/`；T-002 已创建 `apps/users|portal|billing|ai|api`；T-003 已把自定义 `User` 注册进 django-admin
+- 测试：`manage.py check` 通过；`manage.py test` 通过（2 条 admin smoke tests）；`./init.ps1` 通过
 - 数据：AI 上游调用与模型配置参考 `D:\chengma\cmbot`（`src/services/ai_text_service.py`、`ai_image_service.py`、`config/ai_models.json`）
 - 标准启动路径：Windows 用 `./init.ps1`；Unix/WSL 用 `./init.sh`
 - 标准验证路径：Windows 用 `py -3.12 manage.py check` / `py -3.12 manage.py test`
 - 设计基线：**自助用户端 + 对外 API + 运营后台**三合一单体；用户模型 `User`(auth)/`UserWallet`(点数，锁 wallet 扣点)/`ApiKey`(1:N，哈希存储)；对外两接口 + **能力别名 + Provider 适配器**（可插拔供应商）；自助扫码充值；注册不送点数。详见 `04-architecture.md` 与 2026-06-29 / 2026-07-01 的 `progress.md` 决策
 - 配置基线：运行环境变量集中见 `docs/env.md`；真实密钥/支付凭证不得写入代码或文档样例。充值订单在创建时锁定汇率与预计点数，回调入账使用订单值，不按新汇率重算
-- 当前 blocker（已降级）：**支付协议已明确**（微信 V3 native + 支付宝当面付，见 `api.md` / `04` 4.2，参考同支付系统 PHP 实现）；**仅缺商户密钥/证书真实值**（微信 appid/mchid/apiv3_key/证书、支付宝 appid/公私钥、notify_url 域名）。不阻塞开发，T-304/T-305 可先 mock 联调，上线前填真实商户配置
+- 当前 blocker：无。支付商户密钥/证书仍缺真实值，但不阻塞当前 Phase 1，可在 T-304/T-305 先 mock 联调。
 
 ## 当前目录要点
 
@@ -31,9 +31,9 @@
 | `AGENTS.md` / `CLAUDE.md` | 已有 | 仓库级入口 |
 | `progress.md` | 已有 | 执行流水，已记录多轮文档决策；后续任务继续追加 |
 | `init.sh` / `init.ps1` | 已有 | 启动验证入口，已固定系统 Python 3.12 命令 |
-| `requirements.txt` | 已有 | Django 5.2 / DRF 3.16 依赖 |
+| `requirements.txt` | 已有 | Django 5.2 / DRF 3.16 / PyMySQL / cryptography 依赖 |
 | `config/`（Django 工程） | 已有 | T-001 创建，含 settings / urls / wsgi / asgi |
-| `apps/`（users/portal/billing/ai/api） | 已有 | T-002 创建；`apps/users` 已定义自定义 `User` |
+| `apps/`（users/portal/billing/ai/api） | 已有 | T-002 创建；`apps/users` 已定义自定义 `User`；T-003 已注册 admin 与 admin smoke test |
 | `manage.py` | 已有 | T-001 创建 |
 | `tests/` | 待建 | 随各任务补充 |
 
@@ -41,10 +41,10 @@
 
 任务状态以 [`06-tasks.md`](06-tasks.md) 为准，历史执行记录见 [`../progress.md`](../progress.md)。
 
-- 已完成：T-001 初始化 Django + DRF 项目骨架。
+- 已完成：T-001 初始化 Django + DRF 项目骨架；T-002 建立 apps 目录、自定义 User 与配置；T-003 接通 django-admin 与最小测试。
 - 正在进行：无。
 - 当前 blocker：无。
-- 下一个可领取任务：**T-003 接通 django-admin 与最小测试**。
+- 下一个可领取任务：**T-101 Provider 适配器层 + 移植 cmbot 调用**。
 
 ## 当前可运行内容
 
@@ -62,14 +62,14 @@ python3.12 manage.py test
 python3.12 manage.py runserver
 ```
 
-当前骨架可运行。T-002 已在首次迁移前创建自定义 User，并按 `env.md` 接入 MySQL 8.4 / utf8mb4；远程 MySQL 已完成 Django 初始迁移。
+当前骨架可运行。T-002 已在首次迁移前创建自定义 User，并按 `env.md` 接入 MySQL 8.4 / utf8mb4；远程 MySQL 已完成 Django 初始迁移。T-003 已接通 django-admin，标准测试可创建/销毁 `test_cmhub` 测试库并通过。
 
 ## 开始编码前检查
 
 1. 读仓库级 `AGENTS.md` / `CLAUDE.md`。
 2. 读 `docs/00-ai-start-here.md`。
 3. 读 `docs/05-coding-rules.md`（尤其第 8 节资金安全）。
-4. 在 `docs/06-tasks.md` 取第一个 `TODO` 且依赖均 `DONE` 的任务（当前为 T-003）。
+4. 在 `docs/06-tasks.md` 取第一个 `TODO` 且依赖均 `DONE` 的任务（当前为 T-101）。
 5. 将该任务状态改为 `DOING`。
 
 ## 维护规则

progress.md

@@ -195,3 +195,38 @@
 - 阻塞：已解除。曾因 MySQL 用户缺少 `ALTER/INDEX/DROP` 等迁移权限受阻。
 - 决策：使用 PyMySQL 作为 MySQL 驱动；T-002 只落 apps、自定义 User、settings 与 MySQL 初始迁移，不提前实现 UserWallet/ApiKey 等 T-201 内容。
 - 下一步：领取 T-003 接通 django-admin 与最小测试。
+
+## 2026-07-02 T-003 接通 django-admin 与最小测试
+
+- 状态：PARTIAL
+- 变更：
+  - `apps/users/admin.py`：用 `DjangoUserAdmin` 注册自定义 `User`，后台列表展示 `username/email/status/is_staff/is_active/created_at`，支持按 `status` 过滤、按 `username/email/payment_user_id` 搜索，`created_at` 只读。
+  - `apps/users/tests.py`：新增最小 admin smoke test，覆盖自定义 User 已注册到 admin、superuser 可登录 `/admin/`。
+  - `config/settings.py`：本地默认 `ALLOWED_HOSTS` 增加 `testserver`，匹配 Django test client。
+  - `docs/06-tasks.md` / `docs/current-state.md`：记录 T-003 当前权限阻塞。
+- 验证：
+  - `py -3.12 manage.py check`：通过，0 issues。
+  - 手工创建临时 superuser 并用 Django test client 登录 `/admin/`：登录成功，`GET /admin/` 返回 200；临时用户已清理。
+  - `py -3.12 manage.py test`：未通过，Django 在创建 `test_cmhub` 测试库时报 `(1044, "Access denied for user 'test'@'%' to database 'test_cmhub'")`。
+  - 进一步验证 `CREATE DATABASE IF NOT EXISTS test_cmhub ...` 同样返回 1044；当前授权仅覆盖 `cmhub.*`。
+- 阻塞：需要给 MySQL 用户增加测试库权限，建议优先只授权测试库范围：
+  - `GRANT ALL PRIVILEGES ON test_cmhub.* TO 'test'@'%';`
+  - `FLUSH PRIVILEGES;`
+- 决策：不把 Django 测试改跑到业务库 `cmhub`，避免测试清表/迁移影响真实开发数据；T-003 在标准 `manage.py test` 通过前不标 `DONE`。
+- 下一步：完成 MySQL 授权后重跑 `py -3.12 manage.py test`，再跑 `py -3.12 manage.py check` / `./init.ps1`，通过后把 T-003 标记 DONE。
+
+## 2026-07-02 T-003 接通 django-admin 与最小测试（完成验收）
+
+- 状态：DONE
+- 变更：
+  - `requirements.txt`：新增 `cryptography>=42,<47`，用于支持 PyMySQL 连接 MySQL 8 默认 `caching_sha2_password` 认证。
+  - `docs/06-tasks.md`：T-003 从 BLOCKED 改为 DONE。
+  - `docs/current-state.md` / `docs/03-tech-stack.md`：同步当前依赖、验证结果与下一步任务。
+- 验证：
+  - `py -3.12 -m pip install -r requirements.txt`：通过，安装 `cryptography 46.0.7`。
+  - `py -3.12 manage.py test`：通过，2 tests OK，测试库 `test_cmhub` 创建与销毁正常。
+  - `py -3.12 manage.py check`：通过，0 issues。
+  - `./init.ps1`：通过，依赖同步与基础检查正常。
+- 阻塞：无。
+- 决策：保留独立 `test_cmhub` 测试库路径，标准测试不使用业务库 `cmhub`。
+- 下一步：领取 T-101 Provider 适配器层 + 移植 cmbot 调用。

requirements.txt

@@ -1,3 +1,4 @@
 Django>=5.2,<5.3
 djangorestframework>=3.16,<3.17
 PyMySQL>=1.1,<1.2
+cryptography>=42,<47