# CollabLedger Web

Vite + Vue 3 Web 管理端，作为根目录 pnpm workspace 的子包维护。

## 本地开发

从仓库根目录执行：

```bash
pnpm install
pnpm dev:web
```

`frontend/web/.env.development` 默认使用：

```env
VITE_PORT=80
VITE_APP_BASE_API=/dev-api
```

开发环境下，`vite.config.ts` 会把 `/dev-api` 代理到本地后端 `http://localhost:3000`。

## Vercel 部署

Web 管理端作为独立的 Vercel Project 部署。先全局安装并登录 Vercel CLI：

```bash
pnpm add -g vercel
vercel login
```

进入 Web 目录并关联项目：

```bash
cd frontend/web
vercel link
```

推荐配置：

```text
Framework Preset: Vite
Install Command: pnpm install
Build Command: pnpm build
Output Directory: dist
```

在 Vercel 项目环境变量中配置后端地址：

```bash
vercel env add VITE_APP_BASE_API production
```

变量值示例：

```env
VITE_APP_BASE_API=https://your-backend.example.com
```

部署：

```bash
vercel deploy --prod
```

`vercel.json` 已配置 SPA 路由回退，刷新管理端子路由时会返回 `index.html`。