tnsu-approval-route/backend/Tnsu.ApprovalRoute.Infrastructure/SharePoint/ISharePointListProvisioner.cs

namespace Tnsu.ApprovalRoute.Infrastructure.SharePoint;

/// <summary>Созданный список: серверный относительный url (он же ListId) и Title.</summary>
public sealed record ProvisionedList(string ListId, string Title);

/// <summary>
/// Создание следующей пары списков серии в SharePoint («&lt;Форма&gt; &lt;N&gt; — данные»
/// + «&lt;Форма&gt; &lt;N&gt; — согласование») дублированием текущей пары.
///
/// Интерфейс живёт в Infrastructure, а не в Application, потому что Application уже
/// ссылается на Infrastructure (так же устроен <see cref="ISharePointClient"/>) —
/// обратная ссылка замкнула бы проекты в кольцо.
/// </summary>
public interface ISharePointListProvisioner
{
    /// <summary>
    /// Создать пару списков с номером <paramref name="number"/>, скопировав структуру
    /// со списка <paramref name="sourceDataListId"/>. Возвращает созданный список ДАННЫХ
    /// (список согласования создаётся тем же вызовом, но наружу не отдаётся — его
    /// находят по конвенции имени).
    /// </summary>
    Task<ProvisionedList> CreateNextListPairAsync(
        string siteUrl,
        string sourceDataListId,
        int number,
        CancellationToken cancellationToken);
}