# Go Desk 启动指南

## 前置条件

1. Go v1.25.4 已安装
2. Node.js 和 npm 已安装
3. MySQL 数据库 lab_dev 已启动

## 安装 Wails CLI

```bash
go install github.com/wailsapp/wails/v2/cmd/wails@latest
```

**如果 `wails` 命令找不到**：

1. 获取 GOPATH：
   ```bash
   go env GOPATH
   ```

2. 使用完整路径运行（假设 GOPATH 是 `D:\Go\go-workspace`）：
   ```bash
   D:\Go\go-workspace\bin\wails.exe dev
   ```

3. 或添加到 PATH 环境变量（永久解决）：
   - 将 `%GOPATH%\bin` 添加到系统 PATH
   - 重新打开终端

## 首次启动步骤

### 1. 安装 Go 依赖

```bash
cd go-desk
go mod tidy
```

### 2. 安装前端依赖

```bash
cd web
npm install
```

### 3. 构建前端（必须）

```bash
npm run build
```

这会生成 `frontend/dist` 目录，包含前端构建产物。

### 4. 开发模式运行

```bash
# 回到项目根目录
cd ..

# 启动 Wails 开发服务器
wails dev
```

## 开发流程

### 修改前端代码后

```bash
cd web
npm run build
cd ..
wails dev
```

### 修改后端代码后

直接重启 `wails dev` 即可。

## 常见问题

### 问题1：找不到 frontend/dist 目录

**解决**：需要先构建前端
```bash
cd web
npm run build
```

### 问题2：数据库连接失败

**检查**：
1. 测试服 MySQL 是否可访问（外网IP: 39.99.243.191:3306）
2. 数据库 lab_dev 是否存在
3. 用户名密码是否正确（root/Lake@2019）
4. 网络连接是否正常（可能需要VPN或白名单）

### 问题3：前端调用后端方法失败

**检查**：
1. 确保 `main.go` 中正确设置了 `Services: []interface{}{app}`
2. 前端调用方式：`window.go.main.App.QueryUsers(...)`
3. 检查浏览器控制台错误信息

### 问题4：wails 命令找不到

**解决**：
- 使用完整路径：`%GOPATH%\bin\wails.exe`
- 或添加到 PATH 环境变量

## 构建发布版本

### 1. 确保前端已构建

```bash
cd web
npm run build
cd ..
```

### 2. 执行构建

```bash
# 构建当前平台（Windows）
wails build

# 或明确指定平台
wails build -platform windows/amd64
```

### 3. 构建产物

构建成功后，可执行文件位于123：
```
build/bin/go-desk.exe
```

### 4. 运行打包后的应用

直接双击 `build/bin/go-desk.exe` 运行，或使用命令行：

```bash
build\bin\go-desk.exe
```

**注意事项**：
- 打包后的应用是独立的可执行文件，包含所有前端资源
- 首次运行需要确保 MySQL 数据库 `lab_dev` 可访问
- 数据库连接信息硬编码在代码中（localhost:3306, root/123456）
- 如需分发，确保目标机器有 MySQL 数据库或修改为远程数据库连接
