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<WxUser>
{
    /// <summary>
    /// 微信小程序登录（首次仅创建 WxUser，不自动创建 User）
    /// </summary>
    Task<WeChatLoginOutput> LoginAsync(WeChatLoginInput input);

    /// <summary>
    /// 微信小程序快捷登录（通过 OpenId 直接登录）
    /// </summary>
    Task<WeChatLoginOutput> QuickLoginAsync(WeChatQuickLoginInput input);

    /// <summary>
    /// 切换用户（同一 WxUser 下切换 User 身份，重新生成 Token）
    /// </summary>
    /// <param name="wxUserId">当前 WxUser.Id（来自 JWT）</param>
    /// <param name="currentUserId">当前激活 Users.Id（来自 JWT，用于清除旧 Redis Token）</param>
    /// <param name="input">切换目标用户参数</param>
    Task<WeChatSwitchUserOutput> SwitchUserAsync(long wxUserId, long currentUserId, WeChatSwitchUserInput input);

    /// <summary>
    /// 获取当前 WxUser 下所有用户列表
    /// </summary>
    /// <param name="wxUserId">当前登录的 WxUser.Id（来自 JWT）</param>
    /// <returns>用户列表</returns>
    Task<List<WxUserOutput>> GetUsersAsync(long wxUserId);

    /// <summary>
    /// 在当前 WxUser 下新增用户（子用户/角色）
    /// </summary>
    /// <param name="wxUserId">当前登录的 WxUser.Id（来自 JWT）</param>
    /// <param name="input">新增用户参数</param>
    /// <returns>新创建的用户信息</returns>
    Task<WxUserOutput> CreateUserAsync(long wxUserId, CreateChildUserInput input);

    /// <summary>
    /// 修改家长名字（WxUser.Name）
    /// </summary>
    /// <param name="wxUserId">当前登录的 WxUser.Id（来自 JWT）</param>
    /// <param name="input">修改名字参数</param>
    /// <returns>更新后的微信用户信息</returns>
    Task<WxUserInfoOutput> UpdateWxUserNameAsync(long wxUserId, UpdateWxUserNameInput input);
}