Files
skelet/docs/current-state.md
T

3.7 KiB
Raw Blame History

当前实现状态

本文是可覆盖的当前快照,记录代码与任务看板的现实状态,帮助 AI coding agent 避免只看计划而忽略仓库现状。

职责边界

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

当前快照

  • 日期:2026-07-06
  • 阶段:T-001 已完成,Wagtail 7.4.2 + Django 6.0.6 项目已初始化;生产代码可运行
  • 开发环境:MSYS2/MinGW Python 3.12.12,venv 使用 --system-site-packages(Pillow 由 MSYS2 预编译包提供)
  • git:分支 ds;.gitignore 已生效(.venv/、db.sqlite3、media/ 等被忽略)
  • 技术栈:Wagtail 7.4.2 + Django 6.0.6 + Python 3.12 + SQLite;第一版英文单语言站点
  • 生产代码:已初始化,manage.py、skelet/、home/、search/、core/ 已建
  • 测试:home/tests.py 含 5 个测试(含 smoke 测试 test_homepage_returns_200),全部通过;manage.py test 可运行
  • 数据:已创建 superuser admin;尚未建立 seed 数据
  • 标准启动路径:init.sh 已配置 pip install / manage.py check / manage.py runserver 命令
  • 标准验证路径:.venv/bin/python3.12 manage.py check 通过(3 个 treebeard 兼容警告非阻塞)
  • 当前 blocker:无;下一步执行 T-101

当前目录要点

路径 状态 说明
docs/ 已有 harness coding 文档和项目需求 / 方案。
AGENTS.md 已有 AI agent 仓库入口。
CLAUDE.md 已有 Claude Code 薄入口。
progress.md 已有 只追加执行流水。
business/ 已有 商业计划、内容策略、变现、竞品分析。
deploy/ 已有,不入库 本机部署凭证(SSH 私钥等),被 .gitignore 整目录忽略。
.gitignore / .gitattributes 已有 忽略凭证与运行产物;统一 LF 行尾。
init.ps1 / init.sh 已有 已配置真实命令,使用 python3.12/pip3.12 跨平台兼容。
manage.py 已有 Wagtail/Django 入口。
requirements.txt 已有 Python 依赖,全部 pin 精确版本。
skelet/ 已有 Django 配置包(wagtail start 生成 base/dev/production settings)。
home/ / search/ 已有 wagtail start 默认 app,保留不改名;HomePage 在 home。
core/ 已有 业务 app,已加入 INSTALLED_APPS;模型、模板、测试待建。
.venv/ 已有(不入库) Python 3.12 虚拟环境,--system-site-packages(Pillow 12.0 来自 MSYS2)。
各 app tests.py home/tests.py 已有 smoke 与模型测试(T-003 起),暂不建独立 tests/ 目录。

任务看板状态

  • 已完成:T-000 初始化 harness 文档、T-001 初始化 Wagtail 项目骨架、T-002 建立基础配置与环境样例、T-003 建立最小验证基线。
  • 正在进行:无。
  • 下一个可领取任务:T-101 建立场景、语言、框架、数据库、功能标签模型。

当前可运行内容

# 标准开发命令(在 bash 中运行)
.venv/bin/python3.12 manage.py check
.venv/bin/python3.12 manage.py test
.venv/bin/python3.12 manage.py runserver

开始编码前检查

  1. 读仓库级 agent 规则文件。
  2. 读 docs/00-ai-start-here.md。
  3. 读 docs/05-coding-rules.md。
  4. 在 docs/06-tasks.md 取第一个 TODO 且依赖均 DONE 的任务。
  5. 将该任务状态改为 DOING。

维护规则

当实际代码状态发生变化时,同步更新本文件、docs/06-tasks.md 和 progress.md。