zbyle sluzby podle CC

Controllers/StatisticsController.cs

@@ -0,0 +1,62 @@
+using IdokladSdk.Enums;
+using Microsoft.AspNetCore.Mvc;
+using Idoklad.Services;
+
+namespace Idoklad.Controllers;
+
+/// <summary>Agenda statistics and summaries. Requires iDoklad credentials.</summary>
+[ApiController]
+[Route("statistics")]
+[Produces("application/json")]
+[Tags("Statistics")]
+public sealed class StatisticsController : ControllerBase
+{
+    private readonly StatisticsService _service;
+
+    public StatisticsController(StatisticsService service) => _service = service;
+
+    /// <summary>Invoicing totals for a relative period (e.g. LastSevenDays, ThisMonth).</summary>
+    [HttpGet("invoicing-for-period/{periodType}")]
+    public async Task<IActionResult> InvoicingForPeriod(PeriodType periodType, CancellationToken ct)
+        => Ok(await _service.InvoicingForPeriodAsync(periodType, ct));
+
+    /// <summary>Invoicing totals for a relative year (e.g. ThisYear, LastYear).</summary>
+    [HttpGet("invoicing-for-year/{yearType}")]
+    public async Task<IActionResult> InvoicingForYear(YearType yearType, CancellationToken ct)
+        => Ok(await _service.InvoicingForYearAsync(yearType, ct));
+
+    /// <summary>Invoicing summary broken down by quarter.</summary>
+    [HttpGet("quarter-summary")]
+    public async Task<IActionResult> QuarterSummary(CancellationToken ct)
+        => Ok(await _service.QuarterSummaryAsync(ct));
+
+    /// <summary>Top partners by turnover (optionally limited by count).</summary>
+    [HttpGet("top-partners")]
+    public async Task<IActionResult> TopPartners([FromQuery] int? count, CancellationToken ct)
+        => Ok(await _service.TopPartnersAsync(count, ct));
+
+    /// <summary>Overall agenda summary (totals and key figures).</summary>
+    [HttpGet("agenda-summary")]
+    public async Task<IActionResult> AgendaSummary(CancellationToken ct)
+        => Ok(await _service.AgendaSummaryAsync(ct));
+
+    /// <summary>Statistics for a single contact by id.</summary>
+    [HttpGet("contact/{id:int}")]
+    public async Task<IActionResult> StatisticForContact(int id, CancellationToken ct)
+        => Ok(await _service.StatisticForContactAsync(id, ct));
+
+    /// <summary>Receivables broken down by debt age intervals.</summary>
+    [HttpGet("debt-intervals")]
+    public async Task<IActionResult> DebtIntervals(CancellationToken ct)
+        => Ok(await _service.DebtIntervalsAsync(ct));
+
+    /// <summary>Top debtors by outstanding amount (optionally limited by count).</summary>
+    [HttpGet("top-debtors")]
+    public async Task<IActionResult> TopDebtors([FromQuery] int? count, CancellationToken ct)
+        => Ok(await _service.TopDebtorsAsync(count, ct));
+
+    /// <summary>Progress of the agenda towards the VAT-payer registration threshold.</summary>
+    [HttpGet("vat-payer-progress")]
+    public async Task<IActionResult> VatPayerProgress(CancellationToken ct)
+        => Ok(await _service.VatPayerProgressAsync(ct));
+}