80 lines
2.9 KiB
C#
80 lines
2.9 KiB
C#
|
using SIGCM2.Domain.Pricing.ChargeableChars;
|
||
|
|
|
||
|
|
namespace SIGCM2.Application.Abstractions.Persistence;
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// PRC-001 — Write + query access to dbo.ChargeableCharConfig.
|
||
|
|
/// Implemented by ChargeableCharConfigRepository (Dapper) in Infrastructure.
|
||
|
|
///
|
||
|
|
/// InsertWithCloseAsync: invokes usp_ChargeableCharConfig_InsertWithClose which atomically
|
||
|
|
/// closes any active row for (MedioId, Symbol) and inserts the new row.
|
||
|
|
///
|
||
|
|
/// GetActiveForMedioAsync: invokes usp_ChargeableCharConfig_GetActiveForMedio which returns
|
||
|
|
/// both per-medio rows AND global (MedioId IS NULL) rows for the given asOfDate.
|
||
|
|
/// The Application service applies the per-medio > global priority rule.
|
||
|
|
/// </summary>
|
||
|
|
public interface IChargeableCharConfigRepository
|
||
|
|
{
|
||
|
|
/// <summary>
|
||
|
|
/// Invokes usp_ChargeableCharConfig_InsertWithClose inside the ambient TransactionScope.
|
||
|
|
/// Closes any active row matching (MedioId, Symbol) and inserts a new one.
|
||
|
|
/// Returns the Id of the newly inserted row.
|
||
|
|
/// Throws:
|
||
|
|
/// - ChargeableCharConfigForwardOnlyException on SQL THROW 50409
|
||
|
|
/// - ChargeableCharConfigInvalidException on SQL THROW 50404 (not-found guard)
|
||
|
|
/// </summary>
|
||
|
|
Task<long> InsertWithCloseAsync(
|
||
|
|
long? medioId,
|
||
|
|
string symbol,
|
||
|
|
string category,
|
||
|
|
decimal price,
|
||
|
|
DateOnly validFrom,
|
||
|
|
CancellationToken ct = default);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Returns all active rows whose [ValidFrom, ValidTo] window covers the given asOfDate
|
||
|
|
/// for the specified medio, including global rows (MedioId IS NULL).
|
||
|
|
/// The SP returns both per-medio AND global rows — callers apply priority.
|
||
|
|
/// </summary>
|
||
|
|
Task<IReadOnlyList<ChargeableCharConfig>> GetActiveForMedioAsync(
|
||
|
|
long medioId,
|
||
|
|
DateOnly asOfDate,
|
||
|
|
CancellationToken ct = default);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Returns paginated rows filtered by MedioId and IsActive.
|
||
|
|
/// Skip = (page - 1) * pageSize computed by the caller.
|
||
|
|
/// </summary>
|
||
|
|
Task<IReadOnlyList<ChargeableCharConfig>> ListAsync(
|
||
|
|
long? medioId,
|
||
|
|
bool activeOnly,
|
||
|
|
int skip,
|
||
|
|
int take,
|
||
|
|
CancellationToken ct = default);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Returns total row count for the given filters (used for pagination metadata).
|
||
|
|
/// </summary>
|
||
|
|
Task<int> CountAsync(
|
||
|
|
long? medioId,
|
||
|
|
bool activeOnly,
|
||
|
|
CancellationToken ct = default);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Returns the row with the given Id, or null if not found.
|
||
|
|
/// </summary>
|
||
|
|
Task<ChargeableCharConfig?> GetByIdAsync(
|
||
|
|
long id,
|
||
|
|
CancellationToken ct = default);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Deactivates the row with the given Id by setting IsActive = false and ValidTo = today.
|
||
|
|
/// Idempotent: no-op if already inactive.
|
||
|
|
/// Called inside the ambient TransactionScope of the handler.
|
||
|
|
/// </summary>
|
||
|
|
Task DeactivateAsync(
|
||
|
|
long id,
|
||
|
|
DateOnly today,
|
||
|
|
CancellationToken ct = default);
|
||
|
|
}
|