Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/阶段0验收_首页截图.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
64 changes: 64 additions & 0 deletions docs/阶段0验收记录.md
Original file line number Diff line number Diff line change
@@ -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