# 🚀 企业微信身份激活调试快速指南

## ⚡ 快速开始（2分钟）

### 方法1：使用可视化测试工具（最简单）

```bash
# 1. 启动服务
ng serve

# 2. 打开测试页面
浏览器访问：http://localhost:4200/test-wxwork-activation/test
```

**测试页面功能**：
- ✅ 一键测试身份激活流程
- ✅ 实时查看执行日志
- ✅ 查看员工信息和问卷状态
- ✅ 重置问卷状态（用于重复测试）
- ✅ 快速跳转到问卷页面/工作台

**测试流程**：
```
点击"开始测试" → 查看日志 → 查看员工信息 → 测试各种场景
```

---

### 方法2：Console快速命令（最快速）

打开任意页面，按 `F12`，粘贴以下命令：

**重置问卷状态**（重新触发引导弹窗）：
```javascript
(async()=>{const P=(await import('https://api.fmode.cn/parse/sdk.js')).default;P.initialize('nova');P.serverURL='https://api.fmode.cn/parse';const id=localStorage.getItem('Parse/ProfileId');const q=new P.Query(P.Object.extend('Profile'));const p=await q.get(id);p.set('surveyCompleted',false);p.unset('surveyCompletedAt');await p.save();location.reload();})()
```

**查看问卷状态**：
```javascript
(async()=>{const P=(await import('https://api.fmode.cn/parse/sdk.js')).default;P.initialize('nova');P.serverURL='https://api.fmode.cn/parse';const id=localStorage.getItem('Parse/ProfileId');const q=new P.Query(P.Object.extend('Profile'));const p=await q.get(id);console.log('姓名:',p.get('realname'));console.log('问卷状态:',p.get('surveyCompleted')?'✅已完成':'❌未完成');})()
```

---

## 🔍 调试流程图

```
┌─────────────────────┐
│  访问测试工具页面    │
│  /test-wxwork-      │
│   activation/test   │
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│  点击"开始测试"      │
│  执行自动化测试流程  │
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│  查看测试结果        │
│  - 员工信息          │
│  - 问卷状态          │
│  - 执行日志          │
└──────────┬──────────┘
           │
           ├─→ 问卷未完成 → 点击"前往问卷页面" → 填写问卷
           │
           └─→ 问卷已完成 → 点击"前往工作台" → 验证不显示引导
```

---

## 📋 测试场景速查

| 场景 | 操作步骤 | 预期结果 |
|------|---------|---------|
| **首次激活** | 1. 重置问卷状态<br>2. 前往工作台 | 显示问卷引导弹窗 |
| **填写问卷** | 1. 点击"立即填写"<br>2. 完成21题<br>3. 提交 | 提交成功，状态更新 |
| **再次登录** | 1. 完成问卷后<br>2. 刷新工作台 | 不再显示引导弹窗 |
| **组长查看** | 1. 组长登录<br>2. 点击员工<br>3. 查看详情 | 显示问卷答案 |

---

## 🎯 关键URL

```
测试工具页面：
http://localhost:4200/test-wxwork-activation/test

员工问卷页面：
http://localhost:4200/wxwork/test/survey/profile

设计师工作台：
http://localhost:4200/wxwork/test/designer/dashboard

组长工作台：
http://localhost:4200/wxwork/test/team-leader/dashboard
```

---

## 🐛 快速排查

### 问题1：弹窗不显示
```javascript
// Console执行
localStorage.getItem('Parse/ProfileId')  // 确认有Profile ID
// 然后执行重置命令（见上方）
```

### 问题2：测试页面报错
```bash
# 清理并重新安装
rm -rf node_modules package-lock.json
npm install
ng serve
```

### 问题3：数据不同步
```javascript
// Console执行，强制刷新Profile状态
location.reload()
```

---

## 📚 完整文档

详细的调试说明请查看：
- `docs/企业微信身份激活与问卷调试指南.md` - 完整调试指南（推荐）
- `EMPLOYEE-SURVEY-INTEGRATION-SUMMARY.md` - 整合实施总结

---

## 💡 调试技巧

### 1. 使用测试模式
```
URL中的 cid 参数设为 'test' 或 'demo'
会自动使用模拟数据，无需真实企微认证
```

### 2. 查看实时日志
```
测试工具页面的日志区域会显示所有操作步骤
Console中也会有详细的输出
```

### 3. 快速重置
```
测试工具页面提供"重置问卷状态"按钮
一键重置，无需手动操作数据库
```

---

## ✅ 调试检查清单

测试前请确认：
- [ ] `ng serve` 已启动
- [ ] 浏览器开发者工具已打开（F12）
- [ ] 已清除浏览器缓存（Ctrl+Shift+Delete）

测试后请验证：
- [ ] 测试工具页面能正常工作
- [ ] 员工信息显示正确
- [ ] 问卷引导弹窗正常显示/隐藏
- [ ] 问卷可以正常填写和提交
- [ ] 组长端可以查看问卷答案

---

## 🆘 获取帮助

遇到问题？
1. 查看Console错误信息
2. 查看Network请求是否成功
3. 参考完整调试指南文档
4. 联系开发团队

---

**版本**: v1.0  
**更新日期**: 2025-10-31  
**维护人员**: AI助手