Penny Lens 服务端认证系统详解

interface User {
  _id?: string;           // 用户唯一标识
  username: string;       // 用户名
  password: string;       // 加密后的密码
  email?: string;         // 邮箱
  avatar?: string;        // 头像 URL
  phoneNumber?: string;   // 电话号码
  userType: UserType;     // 用户类型
  status: UserStatus;     // 用户状态
  createdAt: number;      // 创建时间戳
  updatedAt: number;      // 更新时间戳
  delFlag: boolean;       // 软删除标记
  lastLoginAt?: number;   // 最后登录时间
  currentSessionId?: string; // 当前会话ID
}

interface Session {
  _id?: string;           // 会话ID
  userId: string;         // 关联的用户ID
  token: string;          // JWT Token
  deviceId?: string;      // 设备唯一标识
  deviceInfo?: string;    // 设备信息
  ipAddress?: string;     // IP地址
  loginTime: number;      // 登录时间
  expireTime: number;     // 过期时间
  status: SessionStatus;  // 会话状态
  platform?: LoginPlatform; // 登录平台
}

interface UserLoginRecord {
  _id?: string;           // 记录ID
  userId: string;         // 用户ID
  loginTime: number;      // 登录时间
  platform: LoginPlatform; // 登录平台
  deviceId?: string;      // 设备ID
  deviceInfo?: string;    // 设备信息
  ipAddress?: string;     // IP地址
  success: boolean;       // 登录是否成功
  errorMessage?: string;  // 失败原因
}

class UnifiedLoginService extends BaseService {
  /**
   * 统一登录方法
   * @param params 登录参数
   * @returns 登录结果，包含用户信息和Token
   */
  public async login(params: UnifiedLoginRequest): Promise<UserResponse> {}
  
  /**
   * 验证JWT Token
   * @param token JWT Token字符串
   * @returns 验证结果，包含用户信息
   */
  public async verifyToken(token: string): Promise<VerifyTokenResult> {}
  
  /**
   * 刷新会话Token
   * @param token 当前Token
   * @returns 新的Token
   */
  public async refreshToken(token: string): Promise<string> {}
  
  /**
   * 注销登录
   * @param token 当前Token
   */
  public async logout(token: string): Promise<void> {}
}

interface UserLoginRequest {
  email: string;         // 用户邮箱
  password: string;      // 用户密码
  platform: "email";     // 登录平台
  deviceId?: string;     // 设备ID
  deviceInfo?: string;   // 设备信息
}

interface WechatLoginRequest {
  code: string;          // 微信授权码
  platform: "wechat";    // 登录平台
  deviceId?: string;     // 设备ID
  deviceInfo?: string;   // 设备信息
}

interface AlipayLoginRequest {
  authCode: string;      // 支付宝授权码
  platform: "alipay";    // 登录平台
  deviceId?: string;     // 设备ID
  deviceInfo?: string;   // 设备信息
}

{
  "action": "user.login",
  "params": {
    "platform": "email", // 或 "wechat", "alipay"
    "email": "user@example.com",
    "password": "password123",
    "deviceId": "device123",
    "deviceInfo": "iOS 15.0, iPhone 13"
  }
}

{
  "code": 200,
  "message": "登录成功",
  "data": {
    "id": "61c0c50b6d1b2c001fd2a345",
    "username": "user123",
    "email": "user@example.com",
    "avatar": "https://example.com/avatar.jpg",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "createdAt": 1639149835278,
    "updatedAt": 1642345678901
  }
}

{
  "action": "user.verifyToken",
  "params": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

{
  "code": 200,
  "message": "验证成功",
  "data": {
    "valid": true,
    "userId": "61c0c50b6d1b2c001fd2a345",
    "username": "user123",
    "expiresAt": 1644923456789
  }
}

{
  "action": "user.logout",
  "params": {}
}

{
  "code": 200,
  "message": "注销成功",
  "data": null
}