yss-project/WXWORK-ACTIVATION-DEBUG-QUICKSTART.md

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

⚡ 快速开始（2分钟）

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

# 1. 启动服务
ng serve

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

测试页面功能：

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

测试流程：

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

---

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

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

重置问卷状态（重新触发引导弹窗）：

(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();})()

查看问卷状态：

(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. 重置问卷状态 2. 前往工作台	显示问卷引导弹窗
填写问卷	1. 点击"立即填写" 2. 完成21题 3. 提交	提交成功，状态更新
再次登录	1. 完成问卷后 2. 刷新工作台	不再显示引导弹窗
组长查看	1. 组长登录 2. 点击员工 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：弹窗不显示

// Console执行
localStorage.getItem('Parse/ProfileId')  // 确认有Profile ID
// 然后执行重置命令（见上方）

问题2：测试页面报错

# 清理并重新安装
rm -rf node_modules package-lock.json
npm install
ng serve

问题3：数据不同步

// 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助手