سجل تدقيق AST

لمحة سريعة

يسجّل ⁨NextPDF Enterprise⁩ كل تحوّر ⁨AST⁩ بوصفه سجل تدقيق ملحَق فقط لكل مستند، ويُنتج مقاطع ⁨AST⁩ محدودة دلاليًّا ومرسّاة بالاستشهاد للمسارات اللاحقة. ويدعم السجل مسارات التدقيق والتعقّب. وهو ليس تصديقًا قانونيًّا ولا اعتماد سلامة مستند.

التوفّر والترخيص

يُشحَن هذا القدرة في ⁨NextPDF Enterprise⁩ (nextpdf/enterprise) ويُفعَّل بمظروف ترخيص من درجة ⁨Enterprise⁩. ولا يحمّل النشرُ دون ذلك الاستحقاق أصنافَ القدرة. ‏قارِن الإصدارات واحصل على ترخيص.

التثبيت

composer require nextpdf/enterprise:^3

نظرة مفاهيمية

‏AstAuditTrailInterface هو عقد التسجيل. يحوّل record($documentSourceHash, $log) كل مدخل من MutationLog لـ ⁨AST⁩ في ⁨Pro⁩ إلى AstAuditEntry ويلحقه؛ وتراكم الاستدعاءات المتكرّرة بتجزئة المستند نفسها المدخلات. والتنفيذ ملحَق فقط بحسب العقد: فبمجرّد تسجيل مدخل لا يمكن تعديله أو إزالته. ويُرجِع findByDocument($hash) مدخلات مستند واحد بترتيب الإدراج؛ ويُرجِع count() المجموع عبر كل المستندات. وInMemoryAstAuditTrail هو التنفيذ المرجعي.

‏AstAuditEntry سجل غير قابل للتغيير لتحوّر واحد: تجزئة مصدر المستند، ومعرّف العقدة المعياري، ونوع التحوّر (updated / inserted / deleted)، وفهرس الصفحة المبني على الصفر، ولقطتا السمات قبل/بعد، والوقت بتوقيت ⁨UTC⁩ الذي سُجِّل فيه المدخل. والاسترجاع محصور بتجزئة كل مستند، فيظل تاريخ التدقيق معزولًا لكل مستند.

يمشي AstAwareChunker عبر ⁨AST⁩ بالعمق أولًا ويصدر مثيلات AstChunk تحترم بنية المستند: تبدأ العناوين مقطعًا جديدًا، ويتراكم نص الأوراق حتى حجم مُعدّ، وتحافظ نافذة تداخل على الاستمرارية عبر حدود الانقسام. ويحمل كل مقطع معرّف العقدة وفهرس الصفحة والمربّع المُحيط ونوع العقدة لأول عقدة مُسهِمة فيه، حتى تستطيع الأنظمة اللاحقة الاستشهاد بموضع مصدر دقيق.

ما الذي تؤكّده هذه الوحدة

تتولّى هذه الوحدة تسجيل تاريخ التحوّر وإنتاج مقاطع مُنظَّمة. وهي لا تعتمد السلامة ولا تقدّم تصديقًا قانونيًّا.

• سجل التدقيق ملحَق فقط بحسب العقد ضمن المخزن المُعدّ. ودلالة العبث وعدم الإنكار خاصّتان بمكان وكيفية احتفاظك بالسجل وختمه زمنيًّا (راجِع الأدلّة)، لا ضمانٌ تقدّمه هذه الوحدة بذاتها.
• تسجيل تحوّر يوثّق حدوثه. وهو لا يتحقق من التغيير ولا يأذن به.
• تشير استشهادات المقاطع إلى مواضع المصدر؛ وهي أدوات تنقّل، لا ادّعاءات مطابقة.

يدعم سجل التدقيق مسارات التدقيق؛ وهو ليس تصديقًا قانونيًّا ولا اعتماد تدقيق.

حدّ الدرجة

• ⁨NextPDF Core⁩ / ⁨Pro⁩ ⁨AST⁩ يوفّران نموذج ⁨AST⁩ وسجل التحوّر.
• ⁨NextPDF Enterprise⁩ ⁨AST⁩ (هذه الصفحة) يضيف سجل التدقيق الملحَق فقط لكل مستند فوق تلك التحوّرات والمقطِّع المرسّى بالاستشهاد. وهو يستهلك سجل تحوّر ⁨Pro⁩؛ وهو لا يحلّ محلّ نموذج ⁨AST⁩.

لماذا يعمل بهذه الطريقة

القرار الحامل هو ضبط النطاق. تسجّل هذه الوحدة أن تحوّرًا حدث؛ وتُفوَّض الديمومة ودلالة العبث وعدم الإنكار إلى المخزن الساند ووحدة الأدلّة. وهذا يُبقي الوعد صادقًا: أداة لحفظ السجلات للمدقّقين، لا تصديقًا لا تستطيع الوحدة إثباته وحدها. والاسترجاع مُفهرَس بـ documentSourceHash، فلا يتسرّب تاريخ مستند إلى آخر أبدًا. ويرسّي المقطِّع كل مقطع إلى عقدته الأولى ويتحقق من maxChunkChars وoverlapChars مسبقًا، فتظل الاستشهادات دقيقة. ويبقى الاحتفاظ والإقامة بيد المُشغِّل، فيخدم السطح نفسه مخازن أدلّة مُسنَدة بـ ⁨WORM⁩ ومسارات أخفّ على حدّ سواء.

خلفية التصميم: امتثال يمكنك تسليمه لمدقّق.

سطح واجهة البرمجة

الصنف / الواجهة	المسؤولية
AstAuditTrailInterface	عقد التسجيل الملحَق فقط والاسترجاع لكل مستند.
AstAuditEntry	سجل غير قابل للتغيير لتحوّر واحد مع لقطتَي قبل/بعد.
InMemoryAstAuditTrail	تنفيذ مرجعي لسجل ملحَق فقط.
AstAwareChunker	مقطِّع ⁨AST⁩ يحترم البنية ومرسّى بالاستشهاد.
AstChunk	مقطع واحد بمعرّف العقدة وفهرس الصفحة والمربّع المُحيط ونوع العقدة.

نموذج شيفرة — بداية سريعة

$trail->record($documentSourceHash, $mutationLog);
$entries = $trail->findByDocument($documentSourceHash);

نموذج شيفرة — الإنتاج

$trail->record($documentSourceHash, $mutationLog);

foreach ($trail->findByDocument($documentSourceHash) as $entry) {
    $logger->info('ast.audit', [
        'node'     => $entry->nodeId,
        'type'     => $entry->mutationType,
        'page'     => $entry->pageIndex,
        'recorded' => $entry->occurredAt->format(DATE_RFC3339),
    ]);
}
// Persist the trail in a WORM-backed store for tamper-evidence (see Evidence).

الحالات الحدّية والمزالق

• يُراكم تسجيل MutationLog نفسه مرّتين المدخلات؛ أزِل التكرار في المنبع إن احتجت إلى الخمول الاصطلاحي.
• السجل في الذاكرة غير دائم؛ توفّر عمليات نشر الإنتاج AstAuditTrailInterface دائمًا.
• الإلحاق فقط عقد للمخزن، لا خاصّة تشفيرية؛ اقرِنه بتغليف الأدلّة من أجل دلالة العبث.

الأداء

التسجيل خطّي بعدد مدخلات التحوّر. والتقطيع مشية ⁨AST⁩ واحدة بالعمق أولًا؛ وتتناسب الكلفة مع عدد العُقد وحجم المقطع المُعدّ.

ملاحظات أمنية

قد تحتوي لقطتا قبل/بعد على نص مستند. عامِل السجل بوصفه حسّاسًا في حالة السكون. ويمنع عقد الإلحاق فقط التعديلات في الموضع عبر واجهة البرمجة هذه، لكن الديمومة ودلالة العبث تعتمدان على المخزن الساند.

إقامة البيانات وتخفيفات البيانات الشخصية

قد تحمل لقطات التحوّر بيانات شخصية مُستخرَجة من المستندات. ويُفوَّض الاحتفاظ إلى تنفيذك للسجل، فتتبع الإقامة مخزنك. طبّق ضوابط الاحتفاظ والتقليل على اللقطات المُسجَّلة.

قياسات آمنة وتنقية السجلات

معرّفات العُقد وأنواع التحوّرات وفهارس الصفحات والطوابع الزمنية آمنة للتسجيل. وقد تحتوي لقطتا قبل/بعد على محتوى مستند؛ احجبها قبل إعادة توجيهها إلى مصارف مشتركة.

المطابقة

السلوك	المرجع	الحالة
سياق التحديث التدريجي / السلامة	ISO 32000-2:2020 §12.8	مُشار إليه (سياق دلالة العبث)

يسجّل هذا الجدول سياق المواصفة الذي تعمل ضمنه هذه الوحدة. وسجل التدقيق أداة لحفظ السجلات، لا تصديق ولا تصديق قانوني.

سلوك وضع ⁨FIPS⁩

لا تجري هذه الوحدة أي عملية تشفير. ويتولّى التجزئة والتوقيع والختم الزمني لدلالة العبث وحدات الأدلّة والأمان والتوقيع.

نموذج التهديد

المدخل سجل تحوّر. التخفيفات: عقد تسجيل ملحَق فقط، وحصر لكل مستند لعزل التواريخ، وتفويض الديمومة ودلالة العبث إلى مخزن قادر على ⁨WORM⁩ ووحدة الأدلّة.

عقد السلوك

• سجل التدقيق ملحَق فقط بحسب العقد ضمن المخزن المُعدّ: فبمجرّد تسجيل مدخل لا يمكن تعديله أو إزالته عبر واجهة البرمجة هذه.
• كل مدخل سجل غير قابل للتغيير لتحوّر واحد (تجزئة مصدر المستند، ومعرّف العقدة المعياري، ونوع التحوّر، وفهرس الصفحة، ولقطتا قبل/بعد، والوقت المُسجَّل بتوقيت ⁨UTC⁩)؛ والاسترجاع محصور بتجزئة كل مستند.
• يُراكم تسجيل سجل التحوّر نفسه مرّتين المدخلات — أزِل التكرار في المنبع إن لزم الخمول الاصطلاحي.
• يمشي المقطِّع عبر ⁨AST⁩ بالعمق أولًا ويصدر مقاطع تحترم البنية تحمل معرّف العقدة وفهرس الصفحة والمربّع المُحيط ونوع العقدة لاستشهاد مصدر دقيق.
• تسجيل تحوّر يوثّق حدوثه؛ وهو لا يتحقق من التغيير ولا يأذن به، واستشهادات المقاطع أدوات تنقّل، لا ادّعاءات مطابقة.

حدّ النشر

توثّق هذه الصفحة سلوكًا قابلًا للرصد خارجيًّا وسطح واجهة البرمجة العام المدعوم فقط. أما مسارات أسماء النطاقات الداخلية وأصناف المساعدة وجداول الآليات وأسماء ملفات أدلّة التشغيل وبادئات التذاكر فهي خارج النطاق.

احتياطي ⁨Core⁩

‏⁨NextPDF Core⁩ / ⁨Pro⁩ ⁨AST⁩ يوفّران نموذج ⁨AST⁩ وسجل التحوّر. ولا يملك سجل التدقيق الملحَق فقط لكل مستند والمقطِّع المرسّى بالاستشهاد مكافئًا في درجة ⁨Core⁩؛ ويستهلك سطح ⁨Enterprise⁩ سجل التحوّر، وهو لا يحلّ محلّ نموذج ⁨AST⁩.

احتياطي ⁨Pro⁩

‏⁨NextPDF Pro⁩ ⁨AST⁩ يوفّر نموذج ⁨AST⁩ وسجل التحوّر لكن دون سجل تدقيق ملحَق فقط لكل مستند ودون مقطِّع مرسّى بالاستشهاد. وهذان يُشحَنان في حزمة nextpdf/enterprise فقط؛ ويستهلك سطح ⁨Enterprise⁩ سجل تحوّر ⁨Pro⁩.

ملاحظة حدّ ⁨Enterprise⁩

يُوصَف عقد التسجيل، والاسترجاع لكل مستند، والمقطِّع على مستوى السلوك. والسجل المرجعي في الذاكرة مُوثَّق؛ ويوفّر المضيف الاحتفاظ الدائم، وأي بواطن مخزن داخلية خارج نطاق السطح العام.

حدّ النشر التشغيلي

الإلحاق فقط عقد للمخزن، لا خاصّة تشفيرية. ويوفّر المُشغِّل تنفيذ سجل دائمًا وهو مسؤول عن الاحتفاظ به في مخزن مُسنَد بـ ⁨WORM⁩ من أجل دلالة العبث؛ وتعتمد الديمومة وعدم الإنكار على ذلك المخزن وعلى وحدة الأدلّة، لا على هذه الوحدة وحدها. وقد تحمل لقطات التحوّر بيانات شخصية؛ وتتبع الإقامة مخزن المُشغِّل.

حدّ الامتثال القانوني

لا ينطبق أي قيد لضوابط التصدير على سطح سجل تدقيق ⁨AST⁩. ويدعم سجل التدقيق مسارات التدقيق؛ وهو ليس تصديقًا قانونيًّا ولا اعتماد تدقيق. وهذه الوثيقة ليست رأيًا قانونيًّا؛ استشِر مستشاريك في الامتثال والشؤون القانونية.

انظر أيضًا

• الأدلّة — اختم السجل وأرّخه زمنيًّا.
• التحقق — فحوصات سياسات بنيوية.
• ⁨Core AST⁩ — نموذج ⁨AST⁩.
• سجل تدقيق ⁨AST⁩ — المرجع العميق — بواطن المخزن الدائم وسطح واجهة البرمجة العام الكامل.