Enterprise 版本

文件電子申報（Document E-Filing）

速覽

NextPDF Enterprise 會依一個司法管轄區設定檔，將一份 PDF 最佳化為適合電子法院/政府申報的遞送成品，並在超出某設定檔大小上限時，將它切分為大小受限的段落。它會依設定備妥用於申報的格式；它不保證任何文件會被法院或登錄機關接受。

供應與授權

此能力隨附於 NextPDF Enterprise（nextpdf/enterprise），並在 Enterprise 層級的授權封套下啟用。未具該授權的部署不會載入此能力的類別。比較各版本並取得授權。

安裝

composer require nextpdf/enterprise:^3

概念總覽

EFilingOptimizer 會對一份輸入 PDF 執行一條固定的管線：

清洗（Sanitization）。 主動內容（JavaScript 與 action）會透過內容解除與重建引擎移除。
線性化（Linearization）。 文件會被線性化以利快速網頁檢視。
大小檢查與切分（Size check and split）。 若結果超出設定檔大小上限，SizeAwareSplitter 會將它切分為各自能容納的段落，以對頁數的二分搜尋選擇切分點。

一個司法管轄區設定檔（EFilingProfile）承載這些約束：每段最大檔案大小、JPEG 重壓縮品質、表單攤平、JavaScript 移除、線性化，以及物件串流壓縮。內建設定檔包括 US PACER（25 MiB 上限）、EU e-Justice（10 MiB 上限），以及 Taiwan Judicial Yuan（10 MiB 上限）。結果（EFilingResult）會回報各段落、原始與最佳化後的大小、已套用的最佳化，以及任何警告。

電子申報輸出是一份 遞送成品，而非一個文件生命週期狀態。一份最佳化或切分後的 PDF 對傳輸而言已是最終版，且絕不可重新進入簽署或封存管線，因為重新處理會破壞雜湊鏈與證據完整性。

此模組主張與不主張什麼

此模組會 依設定備妥用於電子法院/政府申報的格式。它不保證任何法院、登錄機關或申報入口會接受。入口規則、可接受格式、大小上限與程序要求，會因司法管轄區而異，並隨時間改變。內建設定檔將常見公布的約束編碼為一種便利；在申報前，請對照目的地登錄機關的當前規則加以核實。

為何如此運作

管線以一個固定順序執行——清洗、線性化、大小檢查——因為每個階段都會消耗前一階段的輸出。內容解除與重建先執行，因為申報輸入來自不可信各方，必須在改寫前先解除。線性化在大小檢查之前，因為它會改變位元組佈局，進而改變切分器必須遵守的大小。splitByMaxSize() 接著會對照設定檔的 maxFileSizeBytes 上限核實每個產生的段落，而不是信任平均頁面估計值。仍超出上限的單一頁面不可分割，因此它會以警告呈現，而非被捨棄。遞送成品被排除於重新簽署與重新封存之外，因為重新處理已申報的位元組會破壞證據雜湊鏈。

設計背景：清洗不可信 PDF：內容解除與重建。

API 介面

類別	職責
`EFilingOptimizer`	執行清洗 → 線性化 → 依大小切分管線。
`EFilingProfile`	司法管轄區約束設定檔（`pacer()`、`euJustice()`、`taiwan()` 或自訂）。
`SizeAwareSplitter`	將一份 PDF 切分為位元組限制以下的段落。
`EFilingSegment`	一個輸出段落：位元組、頁面範圍、大小、索引。
`EFilingResult`	彙總：各段落、大小、最佳化、警告。

程式碼範例——快速上手

use NextPDF\Enterprise\Document\EFiling\EFilingOptimizer;
use NextPDF\Enterprise\Document\EFiling\EFilingProfile;

$result = (new EFilingOptimizer())->optimize($pdfBytes, EFilingProfile::pacer());

程式碼範例——正式環境

$result = (new EFilingOptimizer())->optimize($pdfBytes, EFilingProfile::euJustice());

foreach ($result->warnings as $warning) {
    $logger->warning('efiling.warning', ['message' => $warning]);
}

foreach ($result->segments as $segment) {
    $store->put("filing/{$segment->segmentIndex}.pdf", $segment->pdfData);
}
// Confirm the destination registry's current rules before submitting.

邊界案例與陷阱

一份已在設定檔限制以下的文件，會回傳單一段落，在大小上不變。
一個超出限制的單一頁面無法被進一步切分；它會被回傳為一個超出限制的段落並附帶一則警告。請在自訂設定檔中降低影像品質，或預先處理該頁面。
若清洗拒絕了輸入，會記錄一則警告並保留原始位元組；申報前請檢視警告。
內建設定檔上限反映的是常見公布值，而非來自各入口的即時資料源。請將它們視為待核實的預設值。

效能

成本隨文件大小與頁數增加。切分會對頁數執行二分搜尋，因此切分嘗試次數與頁數呈對數關係。對於大型、影像密集的文件，線性化與重壓縮主導牆鐘時間。

安全注意事項

主動內容會在遞送前透過內容解除與重建移除。請將來自不可信各方的輸入 PDF 視為具敵意；清洗步驟是一道緩解措施，而非對下游系統安全性的保證。

資料落地與 PII 緩解措施

已申報的文件經常含有個人與案件資料。處理在行程內於本機進行；此模組不進行任何對外網路呼叫。請對各段落與原始檔案套用你自己的保留控制措施。

安全遙測與日誌清洗

警告與最佳化紀錄描述的是管線動作，而非文件內容。請避免在共用接收端記錄來自你周圍程式碼的檔案路徑或案件識別碼。

一致性

行為	參考	狀態
關聯檔案關係語意	ISO 19005-3:2012 §6.7.8	在載體適用之處遵循
嵌入檔案載體要求	ISO 19005-4:2020 Annex A	在載體適用之處遵循

此表記錄周圍 PDF/A 處理所建置依據的規格。它不是關於任何法院或登錄機關接受與否的聲明。

FIPS 模式行為

此模組不執行任何密碼學運算。

威脅模型

承載主動內容、不可信的輸入 PDF 是主要輸入。緩解措施：在線性化與遞送前進行內容解除與重建；遞送成品被排除於重新簽署與重新封存之外，以保護證據完整性。

行為合約

EFilingOptimizer 執行一條固定的管線：內容解除與重建、線性化，然後在超出設定檔上限時進行一次大小檢查並以二分搜尋切分。
一份已在設定檔限制以下的文件，會回傳單一、大小不變的段落。
一個超出限制的單一頁面，會被回傳為一個超出限制的段落並附帶一則警告；它無法被進一步切分。
一份電子申報成品對傳輸而言已是最終版，且絕不可重新進入簽署或封存管線；重新處理會破壞雜湊鏈與證據完整性。

發布邊界

本頁僅記載外部可觀察的行為與受支援的公開 API 介面。內部命名空間路徑、輔助類別、機制表、runbook 檔名，以及工單前綴皆不在範圍內。

Core 回退

NextPDF Core 沒有司法管轄區設定檔的電子申報最佳化器、沒有 CDR 清洗階段，也沒有依大小切分器。僅有 Core 的部署必須自行建構任何申報準備管線。

Pro 回退

NextPDF Pro 不提供司法管轄區設定檔的電子申報最佳化器、內建的 PACER / EU e-Justice / Taiwan Judicial Yuan 設定檔、CDR 清洗階段，或依大小切分器。在僅有 Pro 的部署中，請求設定檔驅動的電子申報最佳化的設定，沒有 Enterprise 元件可滿足它。Enterprise 介面請參閱 Enterprise 概覽。

Enterprise 邊界註記

內部機制細節保留在原始碼儲存庫的內部文件中，不在本手冊範圍內。

部署邊界

內建設定檔上限將常見公布的約束編碼為一種便利，而非來自各入口的即時資料源；在申報前對照目的地登錄機關的當前規則加以核實，是申報者的責任。處理在行程內於本機進行；此模組不進行任何對外網路呼叫。將文件傳輸到法院、登錄機關或申報入口屬於此模組之外的事務。

法律合規邊界

NextPDF 會依一個司法管轄區設定檔備妥用於電子法院/政府申報的格式。它不保證一份文件會被任何法院、登錄機關、法庭或申報入口接受，也不提供法律建議。申報規則、可接受格式、大小限制、簽章要求，以及程序期限由相關主管機關訂定，會因司法管轄區而異，並隨時改變。核實並滿足那些規則是申報者的責任。請諮詢法律顧問與目的地登錄機關的當前指引。

另請參閱

文件電子申報參考 — 此模組完整的公開 API 介面。
Invoice — 結構化發票產生。
Enterprise 概覽
核心、Pro 與 Enterprise 功能對照表