feat: initialize Django DRF skeleton

docs/current-state.md

@@ -12,13 +12,13 @@
 ## 当前快照
 
 - 日期：2026-07-01
-- 阶段：MVP 起步（仅文档，无代码）
-- 技术栈：Django 5.2 LTS + Python 3.12 + DRF + django-admin + 用户端(模板 SSR/Bootstrap/allauth) + MySQL 8.4(独立实例)（计划，未落地）；详见 `03-tech-stack.md`
-- 生产代码：尚无。`cmhub/` 目前只有 `docs/` 与根级入口文档
-- 测试：尚无
+- 阶段：Phase 0 地基，T-001 已完成；下一步 T-002
+- 技术栈：系统 Python 3.12.3 + Django 5.2.15 + DRF 3.16.1 + django-admin；用户端(模板 SSR/Bootstrap/allauth) 与 MySQL 8.4 接入在后续任务落地；详见 `03-tech-stack.md`
+- 生产代码：已有最小 Django 工程骨架：`manage.py`、`config/`
+- 测试：Django test runner 可运行，当前 0 tests
 - 数据：AI 上游调用与模型配置参考 `D:\chengma\cmbot`（`src/services/ai_text_service.py`、`ai_image_service.py`、`config/ai_models.json`）
-- 标准启动路径：`./init.sh`（待 T-001 填入真实命令后生效）
-- 标准验证路径：`python manage.py test`（待骨架落地后生效）
+- 标准启动路径：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 联调，上线前填真实商户配置
@@ -30,40 +30,45 @@
 | `docs/` | 已有 | 全套 harness 文档 |
 | `AGENTS.md` / `CLAUDE.md` | 已有 | 仓库级入口 |
 | `progress.md` | 已有 | 执行流水，已记录多轮文档决策；后续任务继续追加 |
-| `init.sh` / `init.ps1` | 已有 | 启动验证入口（三命令占位待 T-001 替换） |
-| `config/`（Django 工程） | 待建 | T-001 创建 |
+| `init.sh` / `init.ps1` | 已有 | 启动验证入口，已固定系统 Python 3.12 命令 |
+| `requirements.txt` | 已有 | Django 5.2 / DRF 3.16 依赖 |
+| `config/`（Django 工程） | 已有 | T-001 创建，含 settings / urls / wsgi / asgi |
 | `apps/`（users/portal/billing/ai/api） | 待建 | T-002 创建（含自定义 User，首迁移前定） |
-| `manage.py` | 待建 | T-001 创建 |
+| `manage.py` | 已有 | T-001 创建 |
 | `tests/` | 待建 | 随各任务补充 |
 
 ## 任务看板状态
 
 任务状态以 [`06-tasks.md`](06-tasks.md) 为准，历史执行记录见 [`../progress.md`](../progress.md)。
 
-- 已完成：无。
+- 已完成：T-001 初始化 Django + DRF 项目骨架。
 - 正在进行：无。
-- 下一个可领取任务：**T-001 初始化 Django + DRF 项目骨架**。
+- 下一个可领取任务：**T-002 建立 apps 目录、自定义 User 与配置**。
 
 ## 当前可运行内容
 
 ```bash
-# 骨架未建，以下命令在 T-001 完成后才可用：
-# 本地开发
-python manage.py runserver
-# 测试
-python manage.py test
-# 迁移
-python manage.py makemigrations && python manage.py migrate
+# Windows PowerShell
+py -3.12 -m pip install -r requirements.txt
+py -3.12 manage.py check
+py -3.12 manage.py test
+py -3.12 manage.py runserver
+
+# Unix / WSL
+python3.12 -m pip install -r requirements.txt
+python3.12 manage.py check
+python3.12 manage.py test
+python3.12 manage.py runserver
 ```
 
-当前仓库尚无可运行代码，只有文档。
+当前骨架可运行。T-001 暂保留 Django 默认 SQLite 配置用于框架启动检查；T-002 必须在首次迁移前创建自定义 User，并按 `env.md` 接入 MySQL 8.4 / utf8mb4。
 
 ## 开始编码前检查
 
 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-001）。
+4. 在 `docs/06-tasks.md` 取第一个 `TODO` 且依赖均 `DONE` 的任务（当前为 T-002）。
 5. 将该任务状态改为 `DOING`。
 
 ## 维护规则