using Model;
using Model.Dto.Asset;
using SqlSugar;
using System.Collections.Generic;
using System.Threading.Tasks;

namespace Service.Interface
{
    /// <summary>
    /// 设备二维码 服务接口
    /// 编码内容为扫码直达 URL：{baseUrl}/asset/ledger/equipment?id={equipmentId}
    /// baseUrl 由 Controller 从 HTTP 请求构造（scheme://host）后传入，保持 Service 层框架无关
    /// 生成时把 URL 写入 EquipmentEntity.QrCodeUrl；打印返回 HTML 页面（含 base64 二维码图）
    /// </summary>
    public interface IQrCodeService
    {
        /// <summary>生成二维码 URL 并写入设备（baseUrl 形如 http://host:port）</summary>
        Task<Result<QrCodeDto>> GenerateAsync(long equipmentId, string baseUrl);

        /// <summary>生成二维码 PNG 图片字节（同时确保 URL 已写库）</summary>
        Task<Result<byte[]>> GenerateImageAsync(long equipmentId, string baseUrl);

        /// <summary>批量生成二维码 URL（逐个写库，单条失败不影响其它）</summary>
        Task<Result<List<QrCodeBatchResultDto>>> BatchGenerateAsync(long[] equipmentIds, string baseUrl);

        /// <summary>设备二维码列表（分页，关键字匹配 Code/Name；qrOnly=1 仅看已生成）</summary>
        Task<Result<List<QrCodeDto>>> GetListPagedAsync(int pageIndex, int pageSize, RefAsync<int> total, string? keyword = null, bool qrOnly = false);

        /// <summary>获取打印用 HTML 页面（含二维码 base64 图 + 设备信息，浏览器 Ctrl+P 打印）</summary>
        Task<Result<string>> GetPrintHtmlAsync(long equipmentId, string baseUrl);

        /// <summary>绑定 RFID 编号到设备（覆盖式写入 RfidCode）</summary>
        Task<Result> BindRfidAsync(long equipmentId, string rfidCode);
    }
}