diff --git "a/docs/\351\230\266\346\256\2650\351\252\214\346\224\266_\351\246\226\351\241\265\346\210\252\345\233\276.png" "b/docs/\351\230\266\346\256\2650\351\252\214\346\224\266_\351\246\226\351\241\265\346\210\252\345\233\276.png" new file mode 100644 index 0000000..26e84f0 Binary files /dev/null and "b/docs/\351\230\266\346\256\2650\351\252\214\346\224\266_\351\246\226\351\241\265\346\210\252\345\233\276.png" differ diff --git "a/docs/\351\230\266\346\256\2650\351\252\214\346\224\266\350\256\260\345\275\225.md" "b/docs/\351\230\266\346\256\2650\351\252\214\346\224\266\350\256\260\345\275\225.md" new file mode 100644 index 0000000..514bc80 --- /dev/null +++ "b/docs/\351\230\266\346\256\2650\351\252\214\346\224\266\350\256\260\345\275\225.md" @@ -0,0 +1,64 @@ +# docwise-web 阶段 0 验收记录 + +## 基本信息 + +- 验收对象:docwise-web(后端 FastAPI + SQLite / 前端 Vue3 + Vite + Naive UI) +- 验收日期:2026-08-06 +- 验收人:邹州(阶段 0 兼任验收员) +- 验收标准(README):按 README 操作,十分钟内看到前端首页,且后端健康检查通过 +- 验收结论:**通过** + +## 环境 + +- Windows +- bun 1.3.14(自带运行时) +- Python 3.12(backend/.venv) +- Chromium 无头浏览器(用于渲染检查) + +## 验收过程(对照 README 步骤) + +### 1. 后端启动 + +- 步骤:cd backend → 安装依赖 → 启动 uvicorn(端口 8000) +- 结果: + - `GET http://127.0.0.1:8000/api/health` → `{"status":"ok","service":"docwise-web","version":"0.1.0"}` + - `GET http://127.0.0.1:8000/api/tasks` → `[]` +- 数据库:首次启动自动建表,文件在 `backend/data/docwise.db`(未提交仓库)✅ + +### 2. 前端启动 + +- 步骤:cd frontend → bun install(全新安装 56 个包成功)→ bun dev +- 结果:`http://127.0.0.1:5173` 打开首页,HTTP 200,页面标题「docwise-web · 文档翻译智能体」 + +### 3. 首页要素核对 + +- 项目名 docwise-web ✅ +- 一句话定位「Agent 是大脑,程序是手脚」✅ +- PDF 上传入口占位(点击或拖拽 PDF 到此处)✅ +- 三个特性卡片(翻译 / 结构保留排版 / 质检一条龙)✅ +- 技术标签:Vue 3 / Vite / Naive UI ✅ + +### 4. 前后端联调 + +- 前端 `/api` 由 Vite 代理到后端 8000,无需额外 CORS 配置 ✅ +- 首页底部显示「后端状态:已连接 · 任务列表共 0 条」✅ +- 后端未启动时优雅降级显示「未连接(请先启动后端)」(代码检查)✅ + +### 5. 构建与渲染检查 + +- `vite build` 零警告 ✅ +- 无头浏览器渲染:标题、上传占位、3 个特性卡片、技术标签全部正常,控制台零报错 ✅ + +## 截图 + +- 首页截图已提交仓库:`frontend/screenshots/homepage.png`(PR #7) +- 验收时的页面渲染截图:`阶段0验收_首页截图.png`(与本文档同目录) + +## 卡点 / 问题清单 + +- 无功能性卡点,全过程一次跑通 +- 备注(不计问题):README 前端启动用 bun,与任务单原写的 npm 命令不同,属仓库技术约定的正常口径调整;新人照 README 操作即可跑通 + +## 验收人确认 + +- 邹州,2026-08-06