cmhub/docs/current-state.md

当前实现状态

本文是可覆盖的当前快照，记录代码与任务看板的现实状态，帮助 AI coding agent 避免只看计划而忽略仓库现状。 历史执行流水追加到 ../progress.md，不要在本文重复维护完整执行日志。

职责边界

• 06-tasks.md：任务看板，维护任务状态、依赖和验收要点。
• ../progress.md：执行流水，只追加记录每轮执行、验证、阻塞和决策。
• current-state.md：当前快照，可覆盖更新当前目录、当前命令、已完成摘要和下一步。

当前快照

• 日期：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/ 与根级入口文档
• 测试：尚无
• 数据：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（待骨架落地后生效）
• 设计基线：自助用户端 + 对外 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 联调，上线前填真实商户配置

当前目录要点

路径	状态	说明
docs/	已有	全套 harness 文档
AGENTS.md / CLAUDE.md	已有	仓库级入口
progress.md	已有	执行流水，已记录多轮文档决策；后续任务继续追加
init.sh / init.ps1	已有	启动验证入口（三命令占位待 T-001 替换）
config/（Django 工程）	待建	T-001 创建
apps/（users/portal/billing/ai/api）	待建	T-002 创建（含自定义 User，首迁移前定）
manage.py	待建	T-001 创建
tests/	待建	随各任务补充

任务看板状态

任务状态以 06-tasks.md 为准，历史执行记录见 ../progress.md。

• 已完成：无。
• 正在进行：无。
• 下一个可领取任务：T-001 初始化 Django + DRF 项目骨架。

当前可运行内容

# 骨架未建，以下命令在 T-001 完成后才可用：
# 本地开发
python manage.py runserver
# 测试
python manage.py test
# 迁移
python manage.py makemigrations && python manage.py migrate

当前仓库尚无可运行代码，只有文档。

开始编码前检查

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）。
5. 将该任务状态改为 DOING。

维护规则

代码状态变化时同步更新本文：新增/移动入口文件、初始化框架或模块、任务状态变化、新增可运行命令、发现文档与代码不一致。

• 任务状态变化同步 06-tasks.md。
• 每轮执行记录、验证命令、阻塞、决策追加到 ../progress.md。
• 本文件只保留当前快照，不保留完整历史。