CipherShift365 — Branded PDF Generator

<PackageReference Include="QuestPDF" Version="2026.6.1" />

dotnet add package QuestPDF --version 2026.6.1

cd src/Portal/CipherShift365.Portal.Pdf
dotnet restore
dotnet build

using CipherShift365.Portal.Pdf;
using CipherShift365.Core.Analysis;

// 1. Define branding
var brand = new BrandingProfile(
    OrganizationName: "Acme Corp",
    PrimaryColor: "#1a3a5c",
    AccentColor: "#c0392b",
    LegalFooter: "CipherShift365 by 365Architect — www.365architect.com — Confidential"
);

// 2. Create generator
var generator = new PdfReportGenerator(brand);

// 3. Generate PDF (DiscoveryReport comes from ScanService)
byte[] pdfBytes = generator.Generate(discoveryReport, cnsaValidationResult);

// 4. Save to disk
await File.WriteAllBytesAsync("acme-pqc-report.pdf", pdfBytes);

curl -X POST http://localhost:5000/v1/reports/render \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"project":".", "organization":"Acme Corp"}' \
  --output report.pdf

public sealed record BrandingProfile(
    string OrganizationName,    // Appears in header, adjusts pronouns in summary
    string? LogoPath = null,    // Future: embed PNG logo in header (currently unused by renderer)
    string PrimaryColor = "#1a3a5c",   // Header text, rule lines, table headers
    string AccentColor = "#c0392b",    // Non-compliant verdict color
    string SafeColor = "#27ae60",      // Compliant verdict / QuantumSafe color
    string LegalFooter = "CipherShift365 by 365Architect — www.365architect.com — Post-Quantum Cryptography Readiness Platform"
);

BrandingProfile.Default  // OrganizationName: "365Architect", all colors at defaults

// Financial services firm
new BrandingProfile("Goldman Partners", PrimaryColor: "#003366", AccentColor: "#cc0000");

// Government agency — CNSA-focused
new BrandingProfile("Department of Defense — PQC Office",
    PrimaryColor: "#1a3a5c",
    LegalFooter: "CNSA 2.0 Readiness Assessment — For Official Use Only");

// Minimalist
new BrandingProfile("StartupXYZ", "#2c3e50", "#e74c3c", "#27ae60",
    "Generated by CipherShift365 — PQC Platform by 365Architect");

---

## Developer Manual

### Architecture

### Project File

```xml
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <RootNamespace>CipherShift365.Portal.Pdf</RootNamespace>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="QuestPDF" Version="2026.6.1" />
  </ItemGroup>
  <ItemGroup>
    <ProjectReference Include="..\..\Core\CipherShift365.Core.Analysis\CipherShift365.Core.Analysis.csproj" />
  </ItemGroup>
</Project>

# Generate twice
dotnet run -- generate report1.pdf
dotnet run -- generate report2.pdf

# Compare
Get-FileHash report1.pdf | Select-Object -ExpandProperty Hash
Get-FileHash report2.pdf | Select-Object -ExpandProperty Hash
# → Identical hashes (if no CnsaValidationResult timestamp difference)

static PdfReportGenerator() { QuestPDF.Settings.License = LicenseType.Community; }

private static void RenderMySection(IContainer c, DiscoveryReport r)
{
    c.Column(col =>
    {
        col.Item().Text("My Custom Section").FontSize(12).Bold();
        col.Item().Text($"Data: {r.Analysis.Findings.Count} findings").FontSize(10);
        // Add tables, rows, score cards as needed
    });
}

// Register in RenderContent():
col.Item().Element(x => RenderMySection(x, r));

// Header row with grey background
private static void TableHeader(TableDescriptor t, params string[] h)
{
    t.Header(hdr =>
    {
        foreach (var x in h)
            hdr.Cell().Background(Colors.Grey.Lighten2).Padding(4)
                .Text(x).FontSize(8).Bold();
    });
}

// Data row with light bottom border
private static void TableRow(TableDescriptor t, params string[] cells)
{
    foreach (var c in cells)
        t.Cell().BorderBottom(0.5f).BorderColor(Colors.Grey.Lighten2)
            .Padding(3).Text(c).FontSize(7).LineHeight(1.2f);
}

table.ColumnsDefinition(cd =>
{
    cd.RelativeColumn(2);     // 2 parts (Algorithm)
    cd.RelativeColumn(1);     // 1 part (Role)
    cd.RelativeColumn(1.5f);  // 1.5 parts (Risk)
    cd.RelativeColumn(3);     // 3 parts (Location)
    cd.RelativeColumn(1.5f);  // 1.5 parts (PQC Target)
});
// Total: 9 parts → 2/9 = ~22%, 1/9 = ~11%, etc.

private static string Truncate(string? text, int max) =>
    text is null || text.Length <= max ? text ?? "" : text[..(max - 3)] + "...";

using CipherShift365.Portal.Pdf;
using CipherShift365.Core.Analysis;
using CipherShift365.Core.Runtime;

// Minimal example: assemble a DiscoveryReport manually
var kb = new InMemoryKnowledgeBase(new KbVersion(1, 0, 0), Array.Empty<KbEntry>());
var riskModel = new RiskModel(kb);
var engine = new AnalysisEngine(riskModel);

var pipeline = new DiscoveryPipeline(engine, kb, new IdentityService(), riskModel, new PolicyEngine(riskModel));
var report = await pipeline.RunAsync(".", ct: CancellationToken.None);

var brand = new BrandingProfile("My Organization");
var generator = new PdfReportGenerator(brand);
var pdf = generator.Generate(report);

await File.WriteAllBytesAsync("output.pdf", pdf);
Console.WriteLine($"Generated {pdf.Length} bytes");

var clients = new[]
{
    new BrandingProfile("Client Alpha", PrimaryColor: "#003399"),
    new BrandingProfile("Client Beta", PrimaryColor: "#990033"),
};

foreach (var brand in clients)
{
    var gen = new PdfReportGenerator(brand);
    var pdf = gen.Generate(report);
    var filename = $"pqc-report-{brand.OrganizationName.Replace(" ", "-").ToLower()}.pdf";
    await File.WriteAllBytesAsync(filename, pdf);
}

[HttpPost("export/pdf")]
public async Task<IActionResult> ExportPdf([FromBody] ExportRequest req)
{
    var report = await _scanService.ScanAsync(req.Project);
    var brand = new BrandingProfile(req.Organization ?? "365Architect");
    var generator = new PdfReportGenerator(brand);
    var pdf = generator.Generate(report, _cnsaValidator.Validate(report.SignedCbom));

    return File(pdf, "application/pdf",
        $"ciphershift-{DateTime.UtcNow:yyyyMMdd-HHmmss}.pdf");
}