# 用户相关服务

> **最后更新**：2025-01-14

---

## 服务列表

### 1. [用户管理服务](./user-service.md)

**职责**：用户登录、认证、授权、用户信息管理、账号绑定等。

**核心功能**：

- 手机号验证码登录
- 微信扫码登录
- 用户信息 CRUD
- 账号绑定（手机号、微信、邮箱）
- 用户名管理
- 头像上传

---

### 2. [短信验证码服务](./sms-service.md)

**职责**：发送和验证短信验证码。

**核心功能**：

- 发送验证码
- 验证验证码
- 防刷机制
- 多场景支持（登录、绑定、修改密码等）

---

### 3. [微信登录服务](./wechat-service.md)

**职责**：微信扫码登录、账号绑定。

**核心功能**：

- 生成登录二维码
- 处理微信回调
- 获取用户信息
- 账号绑定

---

### 4. [算力积分管理服务](./credit-service.md)

**职责**：积分查询、消耗、退款、定价管理。

**核心功能**：

- 积分余额查询
- 积分消耗（预扣/确认/退还）
- 积分流水记录
- 动态定价计算
- 积分套餐管理

---

### 5. [充值管理服务](./recharge-service.md)

**职责**：充值订单创建、支付处理、订单管理。

**核心功能**：

- 创建充值订单
- 处理支付回调
- 订单查询
- 订单取消
- 订单超时处理

---

### 6. [支付服务](./payment-service.md)

**职责**：统一支付接口，支持微信支付和支付宝支付。

**核心功能**：

- 微信支付集成
- 支付宝支付集成
- 支付回调验证
- 订单查询

---

## 服务依赖关系

```
user-service (核心)
    ├── sms-service (短信验证)
    ├── wechat-service (微信登录)
    └── credit-service (积分管理)
            └── recharge-service (充值)
                    └── payment-service (支付)
```

---

## 业务流程

### 用户注册登录流程

```
用户输入手机号 → 发送验证码 (sms-service)
→ 验证验证码 → 自动注册/登录 (user-service)
→ 生成 JWT Token → 返回用户信息
```

### 微信登录流程

```
获取登录二维码 (wechat-service) → 用户扫码授权
→ 接收微信回调 → 获取用户信息
→ 自动注册/登录 (user-service) → 返回 Token
```

### 充值流程

```
选择充值套餐 → 创建订单 (recharge-service)
→ 调用支付接口 (payment-service) → 用户支付
→ 接收支付回调 → 增加积分 (credit-service)
→ 记录流水 → 通知用户
```

### 积分消耗流程

```
发起 AI 生成任务 → 计算所需积分 (credit-service)
→ 检查余额 → 预扣积分 → 调用 AI 生成
→ 成功：确认扣减 / 失败：退还积分
```

---

## 相关文档

- [算力积分体系设计](../../../方案/算力积分体系设计.md)
- [用户登录体系重构](../../../计划/用户登录体系重构.md)
- [API 设计规范](../../05-api-design.md)