3.7 KiB
3.7 KiB
当前实现状态
本文是可覆盖的当前快照,记录代码与任务看板的现实状态,帮助 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/python manage.py check通过(3 个 treebeard 兼容警告非阻塞) - 当前 blocker:无;下一步执行
T-002
当前目录要点
| 路径 | 状态 | 说明 |
|---|---|---|
docs/ |
已有 | harness coding 文档和项目需求 / 方案。 |
AGENTS.md |
已有 | AI agent 仓库入口。 |
CLAUDE.md |
已有 | Claude Code 薄入口。 |
progress.md |
已有 | 只追加执行流水。 |
business/ |
已有 | 商业计划、内容策略、变现、竞品分析。 |
deploy/ |
已有,不入库 | 本机部署凭证(SSH 私钥等),被 .gitignore 整目录忽略。 |
.gitignore / .gitattributes |
已有 | 忽略凭证与运行产物;统一 LF 行尾。 |
init.ps1 / init.sh |
已有,占位 | T-001 初始化生产代码后替换真实命令。 |
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 建立场景、语言、框架、数据库、功能标签模型。
当前可运行内容
# 标准开发命令(在 MSYS2 bash 中运行)
.venv/bin/python manage.py check
.venv/bin/python manage.py test
.venv/bin/python manage.py runserver
开始编码前检查
- 读仓库级 agent 规则文件。
- 读
docs/00-ai-start-here.md。 - 读
docs/05-coding-rules.md。 - 在
docs/06-tasks.md取第一个TODO且依赖均DONE的任务。 - 将该任务状态改为
DOING。
维护规则
当实际代码状态发生变化时,同步更新本文件、docs/06-tasks.md 和 progress.md。