Add Vue user H5 client

This commit is contained in:
2026-07-06 17:34:37 +08:00
parent 17cba7cf61
commit e9f3db9ab2
20 changed files with 2433 additions and 0 deletions

View File

@@ -0,0 +1,52 @@
# 阶段二记录:用户端 H5 第一批
日期2026-07-06
## 本次目标
根据已确认决策,用户端直接使用 Vue 3不使用 uni-app。本次先搭建 H5 工程,并接入后端 mock 登录和 mock 聊天接口,为后续手机端主链路开发打基础。
## 已完成
- 新建 `ai_knowledge_base_v2/apps/user-client/`
- 使用 Vue 3 + Vite + TypeScript。
- 新增用户端 `.env.example``README.md`、构建脚本。
- 新增 API 服务层:
- Token 保存和清理
- 发送验证码
- 登录
- 退出登录
- 当前用户信息
- 会话列表
- 创建会话
- 聊天历史
- SSE 问答
- 停止生成
- 新增页面组件:
- 登录面板
- 会话抽屉
- 聊天气泡
- 输入框
- 主应用壳
- 完成手机端优先样式。
## 已验证
- `npm install` 通过0 个漏洞。
- `npm run build` 通过。
- 前端 dev server 启动通过,访问 `http://127.0.0.1:5173/` 返回 200。
## 当前边界
- Markdown 渲染还是基础文本展示,后续需要接入 Markdown 渲染库。
- 后端数据库服务未纳入统一启动编排,完整登录/聊天链路需要先启动后端和数据库。
- 会话重命名接口已接 API但 UI 入口还未做。
- 停止生成目前是后端占位逻辑,真实模型接入后需要做请求取消。
- 本轮未做浏览器截图级视觉验收;后续接完整本地编排后,需要补移动端和桌面端截图检查。
## 下一步建议
1. 补本地开发编排MySQL + backend + user-client。
2. 用真实启动环境跑通登录和 mock 聊天。
3. 增加 Markdown 渲染和错误提示细化。
4. 开始管理后台或继续完善用户端主链路。

View File

@@ -26,3 +26,4 @@
| `2026-07-06-tech-decisions.md` | 技术决策记录。 |
| `2026-07-06-decision-register.md` | 开发决策登记表,集中记录用户明确决策和默认工程决策。 |
| `2026-07-06-phase2-backend-foundation.md` | 阶段二后端基础工程第一批记录。 |
| `2026-07-06-phase2-user-client.md` | 阶段二用户端 Vue 3 H5 第一批记录。 |