# 系统架构和工作流程记录

## websopy系统架构
1. **Java后端服务**：提供API接口，处理微信扫码登录、用户同步等
2. **websopy-pc网站**：前端用户界面，调用后端API
3. **微信生态集成**：
   - 微信公众号扫码登录
   - 用户信息同步到websopy系统

## 扫码登录绑定手机号流程
1. **后端已完成修改**：
   - QrLoginServiceImpl添加nextAction逻辑
   - QrLoginStatusResponse新增nextAction、redirectUrl、successMessage字段
   - 用户没有手机号时设为bind_phone状态
   - 用户有手机号时可直接跳转/console

2. **websopy-pc前端需要修改**：
   - 状态轮询逻辑需要处理nextAction字段
   - 需要创建绑定手机号页面
   - 需要调用绑定手机号API
   - 需要实现登录成功后跳转逻辑

## 关键API接口
- `/api/qr-login/generate` - 生成扫码token
- `/api/qr-login/status/{token}` - 检查扫码状态
- `/api/qr-login/bind-phone` - 绑定手机号

## 错误修复历史
- 修复了`Column 'tenant_id' cannot be null`错误
- 用户同步时确保同时发送tenantId和tenant_id两种格式
- 同步用户前从数据库重新加载确保数据完整