Pengajuan Dokumen Elektronik

Sekilas pandang

NextPDF Enterprise mengoptimalkan PDF menjadi artefak pengiriman yang cocok untuk e-court / pengajuan pemerintah sebagaimana dikonfigurasi oleh profil yurisdiksi, dan memisahkannya menjadi segmen yang terbatas-ukuran ketika batas ukuran profil terlampaui. Ia menyiapkan format untuk pengajuan sebagaimana dikonfigurasi; ia tidak menjamin bahwa dokumen apa pun diterima oleh pengadilan atau registri.

Ketersediaan & lisensi

Kapabilitas ini disertakan dalam NextPDF Enterprise (nextpdf/enterprise) dan aktif dengan envelope lisensi tingkat Enterprise. Penerapan tanpa entitlement tersebut tidak memuat class kapabilitas ini. Bandingkan edisi dan dapatkan lisensi.

Pasang

composer require nextpdf/enterprise:^3

Tinjauan konseptual

EFilingOptimizer menjalankan pipeline tetap terhadap PDF masukan:

1. Sanitasi. Konten aktif (JavaScript dan aksi) dihapus melalui mesin content-disarm-and-reconstruction.
2. Linearisasi. Dokumen dilinearisasi untuk tampilan web cepat.
3. Pemeriksaan ukuran dan pemisahan. Jika hasilnya melebihi batas ukuran profil, SizeAwareSplitter membaginya menjadi segmen yang masing-masing muat, menggunakan pencarian biner atas jumlah halaman untuk memilih titik pisah.

Profil yurisdiksi (EFilingProfile) membawa batasan: ukuran berkas maksimum per segmen, kualitas rekompresi JPEG, perataan formulir, penghapusan JavaScript, linearisasi, dan kompresi object-stream. Profil bawaan mencakup US PACER (batas 25 MiB), EU e-Justice (batas 10 MiB), dan Taiwan Judicial Yuan (batas 10 MiB). Hasil (EFilingResult) melaporkan segmen, ukuran asli dan teroptimalkan, optimasi yang diterapkan, dan peringatan apa pun.

Keluaran e-filing adalah artefak pengiriman, bukan keadaan siklus-hidup-dokumen. PDF yang dioptimalkan atau dipisah bersifat final untuk transmisi dan tidak boleh masuk kembali ke pipeline penandatanganan atau pengarsipan, karena pemrosesan ulang akan merusak rantai hash dan integritas bukti.

Apa yang diklaim dan tidak diklaim modul ini

Modul ini menyiapkan format untuk e-court / pengajuan pemerintah sebagaimana dikonfigurasi. Modul ini tidak menjamin penerimaan oleh pengadilan, registri, atau portal pengajuan mana pun. Aturan portal, format yang diterima, batas ukuran, dan persyaratan prosedural bervariasi menurut yurisdiksi dan berubah dari waktu ke waktu. Profil bawaan meng-encode batasan yang umum diterbitkan sebagai kemudahan; verifikasikan terhadap aturan saat ini dari registri tujuan sebelum mengajukan.

Mengapa cara kerjanya begini

Pipeline berjalan dalam satu urutan tetap — sanitasi, linearisasi, pemeriksaan-ukuran — karena setiap tahap mengonsumsi keluaran tahap sebelumnya. Content disarm and reconstruction berjalan pertama, karena masukan pengajuan datang dari pihak tak tepercaya dan harus di-disarm sebelum ditulis ulang. Linearisasi mendahului pemeriksaan ukuran karena ia mengubah tata letak byte, dan karenanya ukuran yang harus dihormati splitter. splitByMaxSize() kemudian memverifikasi setiap segmen yang dihasilkan terhadap batas maxFileSizeBytes profil alih-alih memercayai estimasi rata-rata-per-halaman. Satu halaman yang masih melebihi batas tidak dapat dibagi, sehingga ia muncul sebagai peringatan alih-alih dibuang. Artefak pengiriman dikecualikan dari penandatanganan-ulang dan pengarsipan-ulang, karena pemrosesan ulang byte yang telah diajukan akan merusak rantai hash bukti.

Latar belakang desain: Menyanitasi PDF tak tepercaya: content disarm and reconstruction.

Permukaan API

Class	Tanggung jawab
EFilingOptimizer	Menjalankan pipeline sanitize → linearize → size-split.
EFilingProfile	Profil batasan yurisdiksi (pacer(), euJustice(), taiwan(), atau khusus).
SizeAwareSplitter	Memisahkan PDF menjadi segmen di bawah batas byte.
EFilingSegment	Satu segmen keluaran: byte, rentang halaman, ukuran, indeks.
EFilingResult	Agregat: segmen, ukuran, optimasi, peringatan.

Contoh kode — Mulai cepat

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

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

Contoh kode — Produksi

$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.

Kasus tepi & jebakan

• Dokumen yang sudah di bawah batas profil mengembalikan satu segmen, tidak berubah dari sisi ukuran.
• Satu halaman yang melebihi batas tidak dapat dipisah lebih lanjut; ia dikembalikan sebagai satu segmen di luar batas dengan peringatan. Turunkan kualitas gambar dalam profil khusus atau pra-proses halaman tersebut.
• Jika sanitasi menolak masukan, peringatan dicatat dan byte asli dipertahankan; periksa peringatan sebelum mengajukan.
• Batas profil bawaan mencerminkan nilai yang umum diterbitkan, bukan umpan langsung dari setiap portal. Perlakukan sebagai baku yang perlu dikonfirmasi.

Kinerja

Biaya berskala dengan ukuran dokumen dan jumlah halaman. Pemisahan melakukan pencarian biner atas jumlah halaman, sehingga jumlah upaya pemisahan logaritmik terhadap jumlah halaman. Linearisasi dan rekompresi mendominasi waktu wall untuk dokumen besar yang berat-gambar.

Catatan keamanan

Konten aktif dihapus sebelum pengiriman melalui content disarm and reconstruction. Perlakukan PDF masukan dari pihak tak tepercaya sebagai bermusuhan; langkah sanitasi adalah mitigasi, bukan jaminan keamanan untuk sistem hilir.

Residensi data & mitigasi PII

Dokumen yang diajukan kerap berisi data pribadi dan data perkara. Pemrosesan bersifat di dalam proses dan lokal; modul tidak melakukan panggilan jaringan keluar. Terapkan kontrol retensi Anda sendiri pada segmen dan pada aslinya.

Telemetri aman & pembersihan log

Peringatan dan catatan optimasi menjelaskan aksi pipeline, bukan konten dokumen. Hindari mencatat path berkas atau pengenal perkara dari kode di sekitar Anda di sink bersama.

Kesesuaian

Perilaku	Rujukan	Status
Semantik relasi associated-file	ISO 19005-3:2012 §6.7.8	Dihormati jika carrier berlaku
Persyaratan carrier berkas-tertanam	ISO 19005-4:2020 Annex A	Dihormati jika carrier berlaku

Tabel ini mencatat spesifikasi yang menjadi dasar pembangunan penanganan PDF/A di sekitarnya. Ini bukan pernyataan penerimaan oleh pengadilan atau registri mana pun.

Perilaku mode-FIPS

Modul ini tidak melakukan operasi kriptografi.

Model ancaman

PDF masukan tak tepercaya yang membawa konten aktif adalah masukan utama. Mitigasi: content disarm and reconstruction sebelum linearisasi dan pengiriman; artefak pengiriman dikecualikan dari penandatanganan-ulang dan pengarsipan-ulang untuk melindungi integritas bukti.

Kontrak perilaku

• EFilingOptimizer menjalankan pipeline tetap: content disarm and reconstruction, linearisasi, lalu pemeriksaan ukuran dengan pemisahan pencarian-biner ketika batas profil terlampaui.
• Dokumen yang sudah di bawah batas profil mengembalikan satu segmen berukuran-tidak-berubah.
• Satu halaman di luar batas dikembalikan sebagai satu segmen di luar batas dengan peringatan; ia tidak dapat dipisah lebih lanjut.
• Artefak e-filing bersifat final untuk transmisi dan tidak boleh masuk kembali ke pipeline penandatanganan atau pengarsipan; pemrosesan ulang akan merusak rantai hash dan integritas bukti.

Batas publikasi

Halaman ini hanya mendokumentasikan perilaku yang dapat diamati secara eksternal dan permukaan API publik yang didukung. Path namespace internal, class pembantu, tabel mekanisme, nama berkas runbook, dan prefiks tiket berada di luar cakupan.

Fallback Core

NextPDF Core tidak memiliki optimizer e-filing profil-yurisdiksi, tidak ada tahap sanitasi CDR, dan tidak ada splitter sadar-ukuran. Penerapan khusus-Core harus membangun pipeline persiapan-pengajuan apa pun sendiri.

Fallback Pro

NextPDF Pro tidak menyediakan optimizer e-filing profil-yurisdiksi, profil bawaan PACER / EU e-Justice / Taiwan Judicial Yuan, tahap sanitasi CDR, atau splitter sadar-ukuran. Konfigurasi yang meminta optimasi e-filing yang digerakkan-profil dalam penerapan khusus-Pro tidak memiliki komponen Enterprise untuk memenuhinya. Lihat Tinjauan Enterprise untuk permukaan Enterprise.

Catatan batas Enterprise

Detail mekanisme internal tetap berada dalam dokumentasi internal repositori sumber dan berada di luar cakupan manual ini.

Batas penerapan

Batas profil bawaan meng-encode batasan yang umum diterbitkan sebagai kemudahan, bukan umpan langsung dari setiap portal; mengonfirmasikannya terhadap aturan saat ini dari registri tujuan sebelum mengajukan adalah tanggung jawab pengaju. Pemrosesan bersifat di dalam proses dan lokal; modul tidak melakukan panggilan jaringan keluar. Transport ke pengadilan, registri, atau portal pengajuan berada di luar modul ini.

Batas kepatuhan hukum

NextPDF menyiapkan format untuk e-court / pengajuan pemerintah sebagaimana dikonfigurasi oleh profil yurisdiksi. Ia tidak menjamin bahwa dokumen akan diterima oleh pengadilan, registri, tribunal, atau portal pengajuan mana pun, dan tidak memberikan nasihat hukum. Aturan pengajuan, format yang diterima, batas ukuran, persyaratan tanda tangan, dan tenggat prosedural ditetapkan oleh otoritas terkait, bervariasi menurut yurisdiksi, dan berubah. Memverifikasi dan memenuhi aturan tersebut adalah tanggung jawab pengaju. Konsultasikan dengan penasihat hukum dan panduan saat ini dari registri tujuan.

Lihat juga

• Referensi Pengajuan Dokumen Elektronik — permukaan API publik lengkap untuk modul ini.
• Invoice — pembuatan faktur terstruktur.
• Tinjauan Enterprise
• Matriks fitur Core vs Pro vs Enterprise