159 lines
4.8 KiB
Markdown
159 lines
4.8 KiB
Markdown
|
# 腾讯云短信验证码集成实施状态
|
|||
|
|
|
|||
|
|
## ✅ 已完成的任务
|
|||
|
|
|
|||
|
|
### 后端实施（FastAPI）
|
|||
|
|
|
|||
|
|
1. **环境配置与依赖** ✅
|
|||
|
|
- 已在 `api/requirements.txt` 中添加 `tencentcloud-sdk-python>=3.0.1000`
|
|||
|
|
- 已在 `api/.env.production` 中添加腾讯云短信配置项
|
|||
|
|
|
|||
|
|
2. **数据库模型扩展** ✅
|
|||
|
|
- 已在 `api/database/models.py` 中添加 `SmsVerificationCode` 模型
|
|||
|
|
- 已扩展 `RefreshToken` 表，添加 `device_info` 字段
|
|||
|
|
|
|||
|
|
3. **短信服务实现** ✅
|
|||
|
|
- 已创建 `api/services/sms_service.py`
|
|||
|
|
- 实现了验证码生成、发送、验证和频率限制功能
|
|||
|
|
- 集成了腾讯云SMS SDK
|
|||
|
|
|
|||
|
|
4. **认证路由扩展** ✅
|
|||
|
|
- 已在 `api/routers/auth.py` 中添加以下端点：
|
|||
|
|
- `POST /api/auth/sms/send` - 发送验证码
|
|||
|
|
- `POST /api/auth/login/sms` - 验证码登录
|
|||
|
|
- `POST /api/auth/register/sms` - 验证码注册
|
|||
|
|
- `POST /api/auth/password/reset` - 重置密码
|
|||
|
|
- `POST /api/auth/password/change` - 修改密码
|
|||
|
|
- `POST /api/auth/phone/change` - 修改手机号
|
|||
|
|
- `POST /api/auth/logout/all` - 登出所有设备
|
|||
|
|
|
|||
|
|
5. **数据库迁移脚本** ✅
|
|||
|
|
- 已创建 `api/migrations/add_sms_verification.sql`
|
|||
|
|
|
|||
|
|
### Android端实施
|
|||
|
|
|
|||
|
|
6. **数据模型** ✅
|
|||
|
|
- 已在 `AuthModels.kt` 中添加所有短信验证相关的请求和响应模型
|
|||
|
|
|
|||
|
|
7. **网络服务** ✅
|
|||
|
|
- 已在 `AuthService.kt` 中添加所有短信验证相关的API调用方法
|
|||
|
|
|
|||
|
|
8. **ViewModel扩展** ✅
|
|||
|
|
- 已在 `AuthViewModel.kt` 中添加：
|
|||
|
|
- 验证码倒计时状态管理
|
|||
|
|
- 发送验证码、验证码登录/注册、重置密码、修改密码、修改手机号、登出所有设备等方法
|
|||
|
|
|
|||
|
|
9. **UI组件** ✅
|
|||
|
|
- 已创建 `SmsCodeInput.kt` - 验证码输入框组件
|
|||
|
|
- 已创建 `SendSmsButton.kt` - 发送验证码按钮组件
|
|||
|
|
- 已创建 `PasswordStrengthIndicator.kt` - 密码强度指示器组件
|
|||
|
|
|
|||
|
|
10. **注册页面** ✅
|
|||
|
|
- 已修改 `RegisterScreen.kt`，添加验证码验证流程
|
|||
|
|
- 集成了验证码输入、发送按钮和密码强度指示器
|
|||
|
|
|
|||
|
|
## 🔄 进行中/待完成的任务
|
|||
|
|
|
|||
|
|
### Android端UI实施
|
|||
|
|
|
|||
|
|
11. **登录页面** 🔄
|
|||
|
|
- 需要修改 `LoginScreen.kt`
|
|||
|
|
- 添加密码登录和验证码登录的切换功能
|
|||
|
|
- 添加"忘记密码"链接
|
|||
|
|
|
|||
|
|
12. **密码重置页面** ⏳
|
|||
|
|
- 需要创建 `ResetPasswordScreen.kt`
|
|||
|
|
- 实现通过验证码重置密码的完整流程
|
|||
|
|
|
|||
|
|
13. **账户管理页面** ⏳
|
|||
|
|
- 需要创建 `AccountManagementScreen.kt`
|
|||
|
|
- 实现修改密码、修改手机号、登出管理功能
|
|||
|
|
|
|||
|
|
14. **个人页面修改** ⏳
|
|||
|
|
- 需要修改 `ProfileScreen.kt`
|
|||
|
|
- 添加"账户管理"入口
|
|||
|
|
- 移除原有的登出按钮（归并到账户管理中）
|
|||
|
|
|
|||
|
|
15. **导航配置** ⏳
|
|||
|
|
- 需要更新 `AppNavigation.kt`
|
|||
|
|
- 添加密码重置页面和账户管理页面的路由
|
|||
|
|
|
|||
|
|
### 测试与部署
|
|||
|
|
|
|||
|
|
16. **测试** ⏳
|
|||
|
|
- 创建后端测试脚本 `api/test_sms_verification.py`
|
|||
|
|
- 进行端到端测试
|
|||
|
|
|
|||
|
|
17. **部署** ⏳
|
|||
|
|
- 配置生产环境的腾讯云短信服务凭证
|
|||
|
|
- 执行数据库迁移脚本
|
|||
|
|
- 更新 `docker-compose.yml` 添加环境变量
|
|||
|
|
|
|||
|
|
## 📝 下一步操作指南
|
|||
|
|
|
|||
|
|
### 1. 完成剩余的Android UI页面
|
|||
|
|
|
|||
|
|
#### 修改登录页面
|
|||
|
|
```kotlin
|
|||
|
|
// 在 LoginScreen.kt 中添加：
|
|||
|
|
// 1. 登录方式切换（密码/验证码）
|
|||
|
|
// 2. 验证码登录UI
|
|||
|
|
// 3. "忘记密码"链接
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 创建密码重置页面
|
|||
|
|
```kotlin
|
|||
|
|
// 创建 ResetPasswordScreen.kt
|
|||
|
|
// 实现：手机号 → 验证码 → 新密码 → 确认密码 → 提交
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 创建账户管理页面
|
|||
|
|
```kotlin
|
|||
|
|
// 创建 AccountManagementScreen.kt
|
|||
|
|
// 包含：修改密码、修改手机号、登出当前设备、登出所有设备
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 配置腾讯云短信服务
|
|||
|
|
|
|||
|
|
1. 登录腾讯云控制台
|
|||
|
|
2. 开通短信服务
|
|||
|
|
3. 创建应用并获取 SDK AppID
|
|||
|
|
4. 配置签名和模板：
|
|||
|
|
- 注册验证码模板
|
|||
|
|
- 登录验证码模板
|
|||
|
|
- 重置密码验证码模板
|
|||
|
|
- 修改手机号验证码模板
|
|||
|
|
5. 获取 SecretId 和 SecretKey
|
|||
|
|
6. 更新 `api/.env.production` 文件中的配置
|
|||
|
|
|
|||
|
|
### 3. 执行数据库迁移
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd api
|
|||
|
|
psql -U postgres -d life_echo -f migrations/add_sms_verification.sql
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 4. 测试验证
|
|||
|
|
|
|||
|
|
1. 后端测试：
|
|||
|
|
- 测试发送验证码API
|
|||
|
|
- 测试验证码登录/注册
|
|||
|
|
- 测试密码重置
|
|||
|
|
- 测试频率限制
|
|||
|
|
|
|||
|
|
2. Android端测试：
|
|||
|
|
- 测试注册流程（已完成UI）
|
|||
|
|
- 测试登录流程（待完成UI）
|
|||
|
|
- 测试密码重置流程（待完成UI）
|
|||
|
|
- 测试账户管理功能（待完成UI）
|
|||
|
|
|
|||
|
|
## 🎯 核心功能已就绪
|
|||
|
|
|
|||
|
|
后端所有API已经实现并可以使用，Android端的核心组件和ViewModel也已准备就绪。剩余工作主要是完成UI页面的开发和集成测试。
|
|||
|
|
|
|||
|
|
## 📞 技术支持
|
|||
|
|
|
|||
|
|
如有问题，请参考：
|
|||
|
|
- 后端API文档：`api/docs/README.md`
|
|||
|
|
- 前端实施计划：查看项目根目录下的计划文件
|