using FoodLabeling.Application.Contracts.Dtos.AuthSession;
using Volo.Abp.Application.Services;

namespace FoodLabeling.Application.Contracts.IServices;

/// <summary>
/// 当前登录会话：菜单权限与退出（美国版 Web 管理端）
/// </summary>
public interface IAuthSessionAppService : IApplicationService
{
    /// <summary>
    /// 获取当前登录用户的角色编码、权限码与可见菜单树
    /// </summary>
    /// <remarks>
    /// 非 SaaS（<c>EnabledSaasMultiTenancy=false</c>）且用户名为 <c>admin</c> 时返回全部未删除菜单（与 <c>AccountService.GetVue3Router</c> 行为对齐）。
    /// SaaS 开启时：平台主库登录（JWT / <c>__tenant</c> 无业务租户 Id，含全 0）即使用户名为 <c>admin</c> 也仅返回平台菜单
    /// （<c>PermissionCode</c> 以 <c>menu.platform</c> 开头或 <c>Router</c> 以 <c>/platform</c> 开头，含祖先节点以成树）；
    /// 公司业务租户登录时即使用户名为 <c>admin</c> 也按 RoleMenu 关联查询，与 <c>UpdateCompanyMenus</c> 同步的管理员菜单权限一致。
    /// 返回体额外包含：<c>userId</c>（当前登录用户 Id，与 <c>user.id</c> 一致，非租户 Id）、<c>lastUpdated</c>（系统编辑全局时间戳，与任意写接口成功联动；无戳时回退用户 LastModificationTime）、<c>role</c>（角色展示名，多角色英文逗号拼接）、<c>fullName</c>（姓名优先，其次昵称、用户名）。
    /// 角色名通过 <c>Role</c> 表直查（<c>RoleDbEntity</c>），避免走仓储 IDataPermission。
    /// </remarks>
    /// <returns>用户简要信息、权限码与菜单树</returns>
    /// <response code="200">成功</response>
    /// <response code="401">未登录或令牌无效</response>
    /// <response code="500">服务器错误</response>
    Task<CurrentUserMenuPermissionsOutputDto> GetMyMenusAsync();

    /// <summary>
    /// 退出登录：清除服务端用户信息缓存（JWT 仍由前端丢弃）
    /// </summary>
    /// <remarks>
    /// 与框架 <c>AccountService.PostLogout</c> 一致；未登录时返回 <c>false</c>。
    /// </remarks>
    /// <returns>是否执行了缓存清理（已登录为 true）</returns>
    /// <response code="200">成功</response>
    /// <response code="500">服务器错误</response>
    Task<bool> LogoutAsync();
}