Backend-Api/CompanyManagment.App.Contracts/EmployeeFaceEmbedding/IEmployeeFaceEmbeddingApplication.cs

using System.Collections.Generic;
using System.Threading.Tasks;

namespace CompanyManagment.App.Contracts.EmployeeFaceEmbedding;

/// <summary>
/// سرویس مدیریت Embedding چهره کارکنان
/// این سرویس فقط برای دریافت و ارسال داده است و هیچ command-driven نیست
/// </summary>
public interface IEmployeeFaceEmbeddingApplication
{
    /// <summary>
    /// دریافت embedding بر اساس شناسه
    /// </summary>
    Task<EmployeeFaceEmbeddingDto> GetByIdAsync(string id);

    /// <summary>
    /// دریافت embedding بر اساس شناسه کارمند
    /// </summary>
    Task<EmployeeFaceEmbeddingDto> GetByEmployeeIdAsync(long employeeId);

    /// <summary>
    /// دریافت لیست embeddings بر اساس شناسه کارگاه
    /// </summary>
    Task<List<EmployeeFaceEmbeddingDto>> GetByWorkshopIdAsync(long workshopId);

    /// <summary>
    /// دریافت لیست embeddings بر اساس لیست شناسه کارگاه‌ها
    /// </summary>
    Task<List<EmployeeFaceEmbeddingDto>> GetByWorkshopIdsAsync(List<long> workshopIds);

    /// <summary>
    /// ذخیره یا به‌روزرسانی embedding
    /// اگر Id وجود داشته باشد، به‌روزرسانی می‌شود، در غیر این صورت ایجاد می‌شود
    /// </summary>
    Task<string> SaveAsync(EmployeeFaceEmbeddingDto dto);

    /// <summary>
    /// حذف embedding
    /// </summary>
    Task DeleteAsync(string id);
}