# 快速参考

## 🚀 快速开始 (5分钟)

### 1. 安装和开发

```bash
# 安装依赖
npm install

# 启动开发服务器
npm run dev
# 访问 http://localhost:5173
```

### 2. 配置企业微信

编辑 `src/js/wecom-config.js`:
```javascript
export const WECOM_CONFIG = {
    corpId: 'ww1234567890abcdef',
    agentId: '1000001',
    redirectUri: 'https://your-domain.com/',
    apiBaseUrl: '/api'
};
```

### 3. 后端配置

复制和编辑 `.env`:
```bash
cp .env.example .env
```

编辑 `.env`:
```env
WECOM_CORP_ID=ww1234567890abcdef
WECOM_APP_SECRET=your_secret
WECOM_AGENT_ID=1000001
```

## 📁 项目结构速览

```
src/
├── main.js                    # 入口
├── js/
│   ├── app.js                # 主逻辑
│   ├── wechat-oauth.js        # OAuth 客户端
│   ├── api-client.js          # HTTP 客户端
│   └── utils.js              # 工具函数
└── styles/
    └── main.css              # 样式
```

## 🔑 关键 API

### 用户认证

```javascript
// 检查是否已认证
if (oauth.isAuthorized()) {
    const user = window.currentUser;
    console.log(user.name);
}

// 获取授权链接
const authUrl = oauth.getAuthUrl();

// 清除用户信息
oauth.clearUserInfo();
```

### HTTP 请求

```javascript
const apiClient = new ApiClient('/api');

// 获取用户信息
const data = await apiClient.getUserInfoByCode(code);

// 自定义请求
const result = await apiClient.post('/custom-endpoint', {});
```

### 工具函数

```javascript
// 显示消息
showMessage('成功!', 'success');
showMessage('错误!', 'error');

// 复制到剪贴板
await copyToClipboard('text');

// 日期格式化
formatDateTime(new Date());
```

## 🔐 安全清单

- [ ] 已在企业微信后台配置回调地址
- [ ] 已设置可信域名
- [ ] 已配置 HTTPS
- [ ] 已验证 State 参数
- [ ] 已实现权限检查
- [ ] 已设置 CSRF 防护

## 🐛 常见错误

| 错误 | 原因 | 解决方案 |
|------|------|---------|
| `redirect_uri mismatch` | 回调地址不匹配 | 检查配置文件 |
| `获取用户信息失败` | 后端 API 问题 | 检查后端服务 |
| 授权码过期 | 超过10分钟未使用 | 重新授权 |
| 授权时无权限 | 应用权限配置不足 | 扩大应用权限范围 |

## 📦 部署命令

```bash
# 构建
npm run build

# 预览构建
npm run preview

# 启动后端
node server-example.js
```

## 🔗 相关链接

- [完整集成指南](./WECOM_INTEGRATION_GUIDE.md)
- [OAuth 后端指南](./WECOM_OAUTH_GUIDE.md)
- [项目总结](./PROJECT_SUMMARY.md)
- [企业微信文档](https://work.weixin.qq.com/api/doc)

## 💻 环境要求

- Node.js 14+
- npm 6+ 或 pnpm
- HTTPS (生产环境必须)

## 📞 获取帮助

1. 查看浏览器控制台 (F12)
2. 检查网络请求 (Network 标签)
3. 参考文档中的故障排查
4. 查看企业微信官方文档

---

**提示**: 保存此文档快速查阅！