docs: update documentation for WeChat OAuth login

- README.md: update scan login section to reflect WeChat OAuth flow
- DEPLOY.md: add WeChat environment variables configuration
- 联调测试方案.md: update test case A01 for new login flow

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
empty
2026-02-03 17:36:03 +08:00
parent 2cb9032187
commit b53e732ffa
3 changed files with 27 additions and 8 deletions

View File

@@ -15,7 +15,26 @@
scp -r company-celebration2 user@your-server:/opt/ scp -r company-celebration2 user@your-server:/opt/
``` ```
### 2. 配置域名 ### 2. 配置环境变量
复制环境变量模板并配置:
```bash
cp .env.example .env
```
编辑 `.env` 文件,配置微信开放平台参数:
```env
# 微信开放平台配置(必填)
WECHAT_APP_ID=your_app_id
WECHAT_APP_SECRET=your_app_secret
WECHAT_REDIRECT_URI=https://your-domain.com/api/wechat/callback
```
> 注意:需要在微信开放平台配置授权回调域名(只填域名,不含路径)
### 3. 配置域名
编辑 `deploy/Caddyfile`,将 `your-domain.com` 替换为你的实际域名: 编辑 `deploy/Caddyfile`,将 `your-domain.com` 替换为你的实际域名:
@@ -29,7 +48,7 @@ sed -i 's/your-domain.com/你的域名/g' deploy/Caddyfile
sed -i 's/your-email@example.com/你的邮箱/g' deploy/Caddyfile sed -i 's/your-email@example.com/你的邮箱/g' deploy/Caddyfile
``` ```
### 3. 构建并启动 ### 4. 构建并启动
```bash ```bash
docker-compose up -d --build docker-compose up -d --build
@@ -37,7 +56,7 @@ docker-compose up -d --build
Caddy 会自动申请和管理 SSL 证书,无需手动配置。 Caddy 会自动申请和管理 SSL 证书,无需手动配置。
### 4. 查看日志 ### 5. 查看日志
```bash ```bash
docker-compose logs -f docker-compose logs -f

View File

@@ -16,10 +16,10 @@
- Pixi.js 粒子动效(待机灯笼、滚动风暴、卷轴揭晓) - Pixi.js 粒子动效(待机灯笼、滚动风暴、卷轴揭晓)
- 自动播放抽奖音乐与中奖音效 - 自动播放抽奖音乐与中奖音效
### 📱 扫码登录 ### 📱 微信扫码登录
- PC 端显示二维码 - 大屏显示微信开放平台授权二维码
- 手机微信扫码后填写信息 - 用户微信扫码授权,自动获取 openid 完成登录
- WebSocket 实时状态同步 - WebSocket 实时状态同步,无需手动输入信息
### 🎛️ 导演控制台 ### 🎛️ 导演控制台
- 全流程控制投票开关、抽奖控制、BGM 播放) - 全流程控制投票开关、抽奖控制、BGM 播放)

View File

@@ -41,7 +41,7 @@
### 3.1 模块 A身份验证与连接 ### 3.1 模块 A身份验证与连接
| ID | 测试场景 | 操作步骤 | 预期结果 | 状态 | | ID | 测试场景 | 操作步骤 | 预期结果 | 状态 |
| :--- | :--- | :--- | :--- | :--- | | :--- | :--- | :--- | :--- | :--- |
| A01 | 员工扫码登录 | 微信扫码访问首页 | 1. 显示“请输入姓名”<br>2. 提交后进入首页,显示已连接绿灯 | ☐ | | A01 | 员工扫码登录 | 大屏显示入口二维码,用户微信扫码 | 1. 微信弹出授权确认页<br>2. 授权后自动跳转至投票页,显示"已连接"绿灯 | ☐ |
| A02 | 导播台登录 | 访问 `/admin/director-console` | 1. 拦截跳转至登录页<br>2. 输入 `20268888` 后进入控制台 | ☐ | | A02 | 导播台登录 | 访问 `/admin/director-console` | 1. 拦截跳转至登录页<br>2. 输入 `20268888` 后进入控制台 | ☐ |
| A03 | 大屏连接 | 访问 `/screen/display-mode` | 1. 全屏显示“马到成功”主视觉<br>2. 左下角“在线人数”实时更新 | ☐ | | A03 | 大屏连接 | 访问 `/screen/display-mode` | 1. 全屏显示“马到成功”主视觉<br>2. 左下角“在线人数”实时更新 | ☐ |