package com.yunhai.userhome.service;

import com.yunhai.platform.utils.model.BoaApp;
import com.yunhai.platform.utils.model.BoaAppType;
import com.yunhai.platform.utils.model.BoaUser;

import java.util.List;
import java.util.Optional;

/**
 * 远程「用户可访问应用」数据服务（跨仓 UserBase）。
 *
 * <p>实现 {@link com.yunhai.userhome.service.impl.OpenApiAppRemoteServiceImpl}
 * 经 {@code YschBaseOpenApi.getUserApp} 实时拉取（自动带 yh-app-auth 签名），
 * 数据权威在 UserBase；本模块不冗余应用元数据。</p>
 */
public interface AppRemoteService {

    /** 取当前用户可访问的应用全集（按应用类型分组，BoaAppType.id/name/apps）。 */
    List<BoaAppType> getUserApps(BoaUser user);

    /** 按应用ID取单个应用（在已拉取的全集中查找，避免额外跨仓请求）。 */
    Optional<BoaApp> getAppById(BoaUser user, Integer appId);
}