phronCare/Core/Interfaces/IDeliveryNoteDom.cs
leandro 33fe012b09
All checks were successful
CI/CD Pipeline / Build and Deploy with Docker Compose (pull_request) Successful in 18m57s
feat(sales): incorporar DTO de lectura para Delivery Note #23
- Se agregan DeliveryNoteDto y DeliveryNoteItemDto
- Se implementa proyección a DTO en PhSDeliveryNoteRepository
- Se extiende IPhSDeliveryNoteRepository con métodos DTO
- Se ajusta DeliveryNoteService para trabajar con DTO
- Se actualiza DeliveryNoteController para devolver DTO
- Se elimina exposición directa de EDeliveryNote en la API

Closes #23
2026-03-19 17:41:49 -03:00

37 lines
1.4 KiB
C#

using Domain.Dtos.Sales;
/// <summary>
/// Servicio de dominio para la gestión de consultas de Delivery Note (Remito Ventas).
/// Encapsula el acceso a datos y expone operaciones de lectura para la capa superior.
/// </summary>
public interface IDeliveryNoteDom
{
/// <summary>
/// Obtiene un Delivery Note por su identificador único.
/// </summary>
/// <param name="id">Identificador interno del Delivery Note.</param>
/// <returns>
/// El DTO <see cref="DeliveryNoteDto"/> si existe; en caso contrario, null.
/// </returns>
Task<DeliveryNoteDto?> GetDtoByIdAsync(int id);
/// <summary>
/// Obtiene un Delivery Note a partir de su número de documento.
/// </summary>
/// <param name="deliveryNoteNumber">Número del Delivery Note (ej: DN-00000001).</param>
/// <returns>
/// El DTO <see cref="DeliveryNoteDto"/> si existe; en caso contrario, null.
/// </returns>
Task<DeliveryNoteDto?> GetDtoByDeliveryNoteNumberAsync(string deliveryNoteNumber);
/// <summary>
/// Obtiene todos los Delivery Notes asociados a un presupuesto (Quote).
/// </summary>
/// <param name="quoteId">Identificador del presupuesto relacionado.</param>
/// <returns>
/// Colección de <see cref="DeliveryNoteDto"/> asociadas al presupuesto.
/// Puede estar vacía si no existen registros.
/// </returns>
Task<IEnumerable<DeliveryNoteDto>> GetDtosByQuoteIdAsync(int quoteId);
}