# 腾讯浏览器兑换前端

这是一个聚焦腾讯浏览器会话兑换流程的 Vue 3 前端，当前只保留单一业务入口，不再承担历史迁移脚手架的职责。

## 功能范围

- 提供 `/tx/browser` 单页入口
- 支持 QQ / 微信扫码登录切换
- 支持浏览器会话创建、状态轮询、角色确认、兑换提交
- 支持结果信息展示，以及在后端产物存在时预览截图

## 项目原则

- 保持页面职责单一，只服务腾讯浏览器兑换链路
- 与本地后端接口保持一致，优先保证稳定性和可维护性
- 页面层尽量薄，状态编排、轮询、展示映射分别收口

## 本地开发

安装依赖并启动开发环境：

```bash
cd /Users/yml/codes/order-site-rewrite
npm install
npm run dev
```

构建生产包：

```bash
npm run build
```

开发环境默认代理到本地后端：

```bash
http://localhost:3000
```

如需切换后端地址，启动前设置：

```bash
VITE_API_TARGET=http://你的后端地址 npm run dev
```

## 结构说明

```text
src/
  lib/          HTTP 基础设施
  router/       路由
  services/     腾讯接口调用
  types/        腾讯会话 / 活动 / 兑换类型
  composables/  页面编排、轮询、展示映射
  components/   腾讯页面子组件
  views/        页面壳
  styles/       全局样式
```

## 当前状态

- 主页面已经拆成扫码卡片、兑换面板、结果面板三个组件
- 会话轮询、错误提示、展示文案已分别从页面模板中抽离
- 前端当前没有全局 store，所有状态都围绕单页流程局部管理