Skip to content

feat(frontend): 搭建 Vue3 + Naive UI 前端骨架与首页 - #7

Merged
dcdc4747 merged 6 commits into
mainfrom
feat/frontend-homepage
Aug 5, 2026
Merged

feat(frontend): 搭建 Vue3 + Naive UI 前端骨架与首页#7
dcdc4747 merged 6 commits into
mainfrom
feat/frontend-homepage

Conversation

@eternal-pudding

@eternal-pudding eternal-pudding commented Aug 5, 2026

Copy link
Copy Markdown
Collaborator

做了什么

  • 新建 frontend/:Vue 3 + Vite + Naive UI 前端骨架(bun 管理依赖,含 bun.lock)
  • 首页:产品介绍(docwise-web 文档翻译智能体)、PDF 上传入口占位、三个特性卡片、后端状态实时检测(/api/health、/api/tasks)
  • Vite dev 代理 /api 到 127.0.0.1:8000,无需额外 CORS 配置
  • README 补充前端启动章节

怎么验证

  1. 启动后端:cd backend && uv sync && uv run uvicorn app.main:app --port 8000
  2. 启动前端:cd frontend && bun install && bun dev
  3. 打开 http://127.0.0.1:5173,看到首页且底部显示后端状态已连接

验证结果

  • 前后端真实联调通过:/api/health 返回 ok,任务列表 0 条
  • 无头浏览器渲染检查:标题、上传占位、3 个特性卡片、3 个技术标签均正常,控制台零报错
  • vite build 零警告

首页截图

docwise-web 首页

@dcdc4747

dcdc4747 commented Aug 5, 2026

Copy link
Copy Markdown
Owner

总体结论:PR #7(feat(frontend): 搭建 Vue3 + Naive UI 前端骨架与首页)基本完成阶段 0 前端任务,建议合并前做两处小修改。

已实测验证(等价于验收流程):

  • bun install 成功(56 个包),vite build 零警告
  • bun dev 后 http://127.0.0.1:5173 返回 200,页面标题正常
  • /api 代理到后端 /api/health 返回 ok,首页显示「后端状态:已连接,任务列表共 0 条」
  • 无头浏览器渲染:标题、上传占位、3 张特性卡片均正常,控制台零报错

待修改项:

  1. PR 描述补一张首页截图(仓库 AGENTS.md 要求 PR 描述包含「相关截图」,也方便验收留证据)。
  2. frontend/src/App.vue:/api/health 正常但 /api/tasks 失败时,页面会显示「任务列表共 ? 条」。建议 taskCount 为 null 时不渲染这一行(或显示「任务列表暂不可用」)。

可选改进:
3. README 前端启动节加一句「bun 自带运行时,无需单独安装 Node.js」,避免与任务单里「Node.js 版本」的表述造成困惑。

其余无需改动:分支命名、Conventional Commits(feat(frontend) / docs(repo))、bun 技术栈、无密钥提交均符合仓库约定。改完 push 到原分支即可,PR 会自动更新。

@eternal-pudding

Copy link
Copy Markdown
Collaborator Author

已按评审意见修改并推送,PR 已更新:

  1. PR 描述补充首页截图(frontend/screenshots/homepage.png)。
  2. App.vue:/api/tasks 不可用时隐藏任务数行,不再显示「任务列表共 ? 条」。
  3. README 前端启动节补充「bun 自带运行时,无需单独安装 Node.js」。
    已验证:vite build 零警告,无头浏览器渲染正常,后端状态显示「已连接,任务列表共 0 条」。

@dcdc4747
dcdc4747 merged commit 0696a58 into main Aug 5, 2026
1 check passed
@dcdc4747 dcdc4747 added the 前端 label Aug 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants