QYZH.InteractiveMagazine/QYZH.InteractiveMagazine.IService/IWeChatAuthService.cs

using QYZH.InteractiveMagazine.Models.Entity;
using QYZH.InteractiveMagazine.Models.WeChat;

namespace QYZH.InteractiveMagazine.IService;

/// <summary>
/// 微信小程序认证服务
/// </summary>
public interface IWeChatAuthService : IBaseService<Users>
{
    /// <summary>
    /// 微信小程序登录（首次创建用户，非首次直接登录）
    /// </summary>
    /// <param name="input">登录输入（含微信 code 和可选的手机号 code）</param>
    /// <returns>登录结果（含 Token 和用户信息）</returns>
    Task<WeChatLoginOutput> LoginAsync(WeChatLoginInput input);

    /// <summary>
    /// 微信小程序快捷登录（通过 OpenId 直接登录，用户需已存在）
    /// </summary>
    /// <param name="input">快捷登录输入（含 OpenId）</param>
    /// <returns>登录结果（含 Token 和用户列表）</returns>
    Task<WeChatLoginOutput> QuickLoginAsync(WeChatQuickLoginInput input);

    /// <summary>
    /// 切换用户（同一 OpenId 下切换身份）
    /// </summary>
    /// <param name="currentUserId">当前登录用户ID</param>
    /// <param name="input">切换用户输入</param>
    /// <returns>切换结果（含新 Token 和目标用户详情）</returns>
    Task<WeChatSwitchUserOutput> SwitchUserAsync(long currentUserId, WeChatSwitchUserInput input);
}