72 lines
3.7 KiB
Markdown
72 lines
3.7 KiB
Markdown
# 当前实现状态
|
||
|
||
> 本文是可覆盖的当前快照，记录代码与任务看板的现实状态，帮助 AI coding agent 避免只看计划而忽略仓库现状。
|
||
|
||
## 职责边界
|
||
|
||
- [`06-tasks.md`](06-tasks.md)：任务看板，维护任务状态、依赖和验收要点。
|
||
- [`../progress.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-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
|
||
# 标准开发命令（在 MSYS2 bash 中运行）
|
||
.venv/bin/python manage.py check
|
||
.venv/bin/python manage.py test
|
||
.venv/bin/python 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`。
|
||
|