案例研究：金融報表自動化¶

use NextPDF\Pro\Document\ProDocument;
use NextPDF\Pro\FlowLayout\StreamingLayoutEngine;
use NextPDF\Pro\FlowLayout\LayoutOptions;
use NextPDF\Pro\FlowLayout\Content\{Heading, Paragraph, FlowTable, ChartContent, PageBreak};
use NextPDF\Pro\Charts\{BarChart, LineChart, PieChart, ChartDataset, ChartOptions};
use NextPDF\Pro\Optimizer\{PdfOptimizer, OptimizationLevel};
use NextPDF\Pro\Compliance\PdfA\PdfAConverter;
use NextPDF\Pro\Compliance\PdfA\PdfALevel;
use NextPDF\Pro\Signatures\PAdES\{PadesSignatureAppender, PadesSignatureLevel, PadesSignatureOptions};
use NextPDF\Pro\Signatures\Hsm\Driver\AwsKmsSigningDriver;
use NextPDF\Pro\Signatures\Timestamp\TimestampAuthorityClient;

final class FinancialReportGenerator
{
    public function __construct(
        private readonly FinancialDataService $dataService,
        private readonly AwsKmsSigningDriver $kmsDriver,
        private readonly TimestampAuthorityClient $tsa,
    ) {}

    public function generate(int $year, int $quarter): string
    {
        // 1. 取得強型別財務數據
        $data = $this->dataService->getQuarterlyReport($year, $quarter);

        // 2. 建立串流排版引擎
        $engine = new StreamingLayoutEngine(
            LayoutOptions::create(
                pageWidth: 595.28,
                pageHeight: 841.89,
                marginTop: 80.0,
                marginBottom: 80.0,
                marginLeft: 72.0,
                marginRight: 72.0,
            )
        );

        // 設定文件語言與詮釋資料（PDF/A 必要）
        $engine->setLanguage('zh-TW');
        $engine->setTitle(sprintf('%d 年第 %d 季季報', $year, $quarter));
        $engine->setAuthor('台灣安心保險股份有限公司');

        // 3. 加入自動目錄佔位符
        $toc = $engine->addTableOfContents(title: '目錄', maxLevel: 2);

        // 4. 執行摘要
        $engine->add(Heading::create('執行摘要', level: 1));
        $engine->add(Paragraph::create($data->getExecutiveSummary()));

        // 5. 財務摘要表
        $engine->add(Heading::create('財務摘要', level: 2));
        $engine->add(
            FlowTable::create(headers: ['項目', '本季', '上季', '同比增減'])
                ->addRow(['總保費收入', $data->formatCurrency($data->premiumRevenue), '...', $data->formatGrowth($data->premiumGrowth)])
                ->addRow(['理賠支出', $data->formatCurrency($data->claimsExpense), '...', $data->formatGrowth($data->claimsGrowth)])
                ->addRow(['淨利潤', $data->formatCurrency($data->netProfit), '...', $data->formatGrowth($data->profitGrowth)])
                ->withRepeatHeaderOnNewPage(true)
        );

        // 6. 向量圖表
        $engine->add(Heading::create('財務趨勢分析', level: 2));

        $revenueChart = BarChart::create(
            ChartOptions::create(title: sprintf('Q1–Q4 %d 年保費收入', $year), width: 450.0, height: 220.0)
        )
        ->setLabels($data->getQuarterLabels())
        ->addDataset(
            ChartDataset::create('保費收入（百萬元）')
                ->data($data->getQuarterlyRevenue())
                ->color('#1E3A8A')
        );

        $engine->add(ChartContent::create($revenueChart)->caption('圖 1：各季保費收入'));

        $engine->add(PageBreak::create());

        // 7. 投資組合分析（圓餅圖）
        $portfolioChart = PieChart::create(
            ChartOptions::create(title: '投資組合分布', width: 280.0, height: 280.0)
        )
        ->setMode('donut');

        foreach ($data->getPortfolioAllocation() as $category => $percentage) {
            $portfolioChart->addSlice(/* ... */);
        }

        $engine->add(ChartContent::create($portfolioChart)->caption('圖 2：投資組合分布'));

        // 8. 渲染 PDF
        $rawPdf = $engine->render();

        // 9. 最佳化（簽章前執行）
        $optimizer = new PdfOptimizer(level: OptimizationLevel::Medium);
        $optimizedPdf = $optimizer->optimize($rawPdf);

        // 10. PDF/A-3b 轉換（金管會申報要求）
        $converter = new PdfAConverter(level: PdfALevel::A3b);
        $pdfABytes = $converter->convert($optimizedPdf);

        // 11. PAdES B-LTA 簽章（使用 AWS KMS）
        $hsmContext = HsmSigningContext::fromDriver(
            driver: $this->kmsDriver,
            publicCertificatePem: file_get_contents('/certs/financial-signing.pem'),
        );

        $options = PadesSignatureOptions::fromHsmContext(
            hsmContext: $hsmContext,
            level: PadesSignatureLevel::BLta,
            timestampAuthority: $this->tsa,
            reason: sprintf('CFO authorized — %dQ%d Financial Report', $year, $quarter),
            location: 'Taipei, Taiwan',
        );

        $appender = new PadesSignatureAppender($options);
        return $appender->sign($pdfABytes);
    }
}

final readonly class FinancialReportDTO
{
    public function __construct(
        public readonly int $year,
        public readonly int $quarter,
        /** @var positive-int */
        public readonly int $premiumRevenue,
        /** @var float */
        public readonly float $premiumGrowth,
        /** @var list<float> */
        public readonly array $quarterlyRevenue,
        /** @var array<string, float> */
        public readonly array $portfolioAllocation,
        public readonly string $executiveSummary,
    ) {}

    public function formatCurrency(int $amount): string
    {
        return 'NT$' . number_format($amount / 1_000_000, 2) . 'M';
    }
}

// App\Console\Kernel.php
$schedule->call(fn() => app(FinancialReportGenerator::class)
    ->generate(now()->year, now()->quarter))
    ->quarterly()
    ->at('02:00')
    ->emailOutputOnFailure('cfo@insurance.example.com');