Compliance Reports

Compliance Reports are asynchronously generated documents that provide audit-ready summaries of your compliance posture. Reports are generated in the background and stored for download once ready, supporting regulatory inspections, internal audits, and executive reporting.

Report Generation Process

Background report compilation pipeline compiling data from across all compliance sub-systems into standardized export formats.

Asynchronous Generation

Reports are generated asynchronously to avoid blocking HTTP requests for large datasets. When you request a report, the system immediately creates a ComplianceReport record with IsReady=false and queues the generation job. Poll the reports list to check when IsReady becomes true.

Report Generation Command

Dispatching report compilation jobs with custom date ranges, regulation profile filters, and output format specifications.

public class GenerateReportCommandHandler : ICommandHandler<GenerateReportCommand, Guid>
{
    public async Task<Result<Guid>> Handle(GenerateReportCommand request, CancellationToken ct)
    {
        // 1. Create pending report record
        var report = new ComplianceReport
        {
            TenantId = _tenantContext.TenantId,
            ReportType = request.ReportType,
            Title = $"Compliance Report - {request.ReportType}",
            Status = ReportStatus.Pending
        };
        
        await _repository.AddAsync(report, ct);
        await _unitOfWork.SaveChangesAsync(ct);
        
        // 2. Queue background job
        BackgroundJob.Enqueue<IReportGeneratorJob>(x => x.GenerateAsync(report.Id, ct));
        
        return Result<Guid>.Success(report.Id);
    }
}

API Endpoints