توثيق سجل التدقيق لأودو 19
دليل سجل التدقيق: اختيار ما يُدقَّق وقراءة السجلات وتاريخ السجل وصلاحيات الوصول والتنظيف والحدود.
يشرح الإصدار 1.0.0حُدّث في 23 أكتوبر 2026
ابدأ من هنا
ببساطة: غيّر أحدهم السعر أو عنوان العميل أو حذف سجلًا، ولا أحد يعرف مَن ومتى. لا يتتبع سجل الرسائل في أودو إلا بعض الحقول ولا يتتبع الحذف. تسجّل سجل التدقيق كل إنشاء وتغيير وحذف في النماذج التي تختارها، مع مَن فعله ومتى ومن أي عنوان IP والقيمة القديمة والجديدة لكل حقل.
نصيحة: السجلات للقراءة فقط. لا أحد، ولا المدير، يستطيع تعديلها أو حذفها من الواجهة؛ وتُزال فقط بتنظيف السجلات القديمة إن ضبطته.
ماذا تحصل عليه
| الميزة | ما تفعله |
|---|---|
| قواعد التدقيق | اختر النماذج التي تُدقَّق وما يُسجَّل: الإنشاءات والتغييرات والحذف. |
| القيمة القديمة والجديدة | كل حقل تغيّر مع قيمته قبل التغيير وبعده. |
| مَن ومتى وأين | المستخدم والتاريخ والوقت والشركة وعنوان IP للطلب. |
| الحذف | يُسجَّل السجل المحذوف بكل حقوله لترى ما فُقد. |
| سجل التدقيق | بند سجل التدقيق في قائمة الإجراءات لكل نموذج وقائمة مدقَّقة. |
| ضيّق النطاق | سجّل بعض الحقول فقط، أو تجاهل حقولًا كثيرة التغيّر، أو تجاهل مستخدمًا مثل مستخدم التكامل. |
| آمن | لا تُسجَّل كلمات المرور والمفاتيح والحقول التقنية. وفشل التسجيل لا يعطّل العملية. |
| التنظيف | احذف السجلات الأقدم من عدد من الأيام، كل يوم. |
| العربية | كل شيء مترجم ويعمل من اليمين إلى اليسار. |
المتطلبات
| البند | التفاصيل |
|---|---|
| أودو | 19.0 (Community أو Enterprise) |
| التطبيقات المطلوبة | لا شيء سوى أساس أودو (base وmail) |
| الرخصة | OPL-1 (رخصة أودو الخاصة v1.0) |
التثبيت
- فُكّ ضغط الحزمة. بداخلها
taqnix_audit_log.zip؛ فُكّه لتحصل على المجلدtaqnix_audit_log. - انسخ المجلد إلى أحد مجلدات
addons_pathفي خادم أودو وأعد تشغيل أودو. - سجّل الدخول كمدير وفعّل وضع المطوّر ثم افتح التطبيقات واضغط تحديث قائمة التطبيقات.
- أزل مرشح «التطبيقات» وابحث عن Audit Log واضغط تثبيت.
# or from the command line ./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_audit_log --stop-after-init
اختر ما تدقّقه
ببساطة: افتح الإعدادات ← سجل التدقيق ← قواعد التدقيق. اضغط إضافة النماذج المعتادة لتدقيق أوامر البيع وأوامر الشراء والقيود والجهات والمنتجات والتحويلات والمستخدمين والموظفين والفرص والمهام (المثبَّت منها)، أو اضغط جديد لتختار نموذجًا بنفسك.
| الحقل | المعنى |
|---|---|
| النموذج | النموذج المراد تدقيقه. لا يمكن تدقيق سجل التدقيق نفسه ولا النماذج المؤقتة. |
| تسجيل الإنشاءات / التغييرات / الحذف | علّم ما تريد تسجيله. |
| هذه الحقول فقط | فارغ: كل حقل مخزَّن. اختر حقولًا لتسجيلها وحدها. |
| الحقول المتجاهَلة | حقول لا تُسجَّل أبدًا لهذا النموذج، مثل عدّاد محسوب. |
| المستخدمون المتجاهَلون | لا تُسجَّل التغييرات التي يجريها هؤلاء المستخدمون، مثل مستخدم التكامل. |
| نشط | أوقف قاعدة دون حذفها. |
اقرأ السجلات
ببساطة: الإعدادات ← سجل التدقيق ← سجلات التدقيق تعرض كل عملية: التاريخ والمستخدم والعملية والنموذج والسجل وعدد الحقول وعنوان IP. الإنشاءات خضراء والحذف أحمر. رشّح بالعملية أو باليوم أو بآخر 7 أيام، وجمّع بالمستخدم أو النموذج، أو ابحث عن اسم سجل.
ببساطة: افتح سجلًا لترى كل حقل بـقيمته القديمة وقيمته الجديدة. وفي الحذف ترى القيم التي كانت للسجل.
تاريخ سجل واحد
ببساطة: متى دُقِّق نموذج، صار لكل نماذجه وقوائمه الإجراء ← سجل التدقيق. يفتح سجلات ذلك السجل وحده (أو السجلات التي حدّدتها في القائمة).
نصيحة: يعرض سجل الرسائل الحقول المتتبَّعة في ذلك النموذج وبعضها فقط. أما سجل التدقيق فيغطي كل حقل مخزَّن وكذلك الحذف.
من يقرأ السجلات
| المجموعة | تستطيع |
|---|---|
| سجل التدقيق: المدقِّق | قراءة سجلات التدقيق. والمديرون مدقِّقون تلقائيًا. |
| المدير | قراءة السجلات وإدارة قواعد التدقيق والإعدادات. |
ببساطة: أضف مستخدمًا إلى مجموعة المدقِّق (الإعدادات ← المستخدمون) ليقرأ مدير السجلات دون أن يصير مديرًا للنظام.
الإعدادات والتنظيف
ببساطة: الإعدادات ← سجل التدقيق.
| الإعداد | ما يفعله |
|---|---|
| الاحتفاظ بالسجلات (أيام) | مهمة يومية تحذف السجلات الأقدم من هذا العدد. 0 يحتفظ بها للأبد. |
| قواعد التدقيق | اختصار إلى قائمة القواعد. |
مهم: قد تكبر السجلات بسرعة في النماذج الكثيفة مثل القيود. اختر النماذج التي تحتاجها فعلًا وحدّد عدد أيام.
العربية ومن اليمين إلى اليسار
ببساطة: القوائم والتسميات مترجمة. أما أسماء السجلات وقيم الحقول فتظهر كما خُزّنت.
الحدود
| الحد | التفصيل |
|---|---|
| ORM أودو فقط | تُسجَّل التغييرات التي تتم عبر ORM (الشاشات والاستيراد وRPC والشيفرة). ولا تُسجَّل تغييرات SQL المباشرة. |
| الحقول المخزَّنة | لا تُسجَّل الحقول المحسوبة غير المخزَّنة. |
| القيم الثنائية والكبيرة | لا تُسجَّل الصور والملفات؛ وتُقصَّر النصوص الطويلة. |
| ليست محصّنة ضد قاعدة البيانات | لا يمكن تعديل السجلات من أودو، لكن من يملك الوصول إلى قاعدة البيانات يستطيع تعديلها. |
| مساحة القرص | صف لكل تغيير. استخدم إعداد التنظيف. |
للمطورين
ببساطة: تخطَّ هذا الفصل إن كنت تستخدم الوحدة فقط.
| البند | التفاصيل |
|---|---|
| النماذج | taqnix.audit.rule وtaqnix.audit.log وtaqnix.audit.log.line. |
| الربط | تمدّد الوحدة base: تتحقق create وwrite وunlink من قاعدة واحدة مخبّأة لكل نموذج. |
| التخطي | مرّر tx_no_audit=True في السياق لتخطي التسجيل، مثلًا في ترحيل جماعي. |
env['taqnix.audit.rule'].create({'model_id': env['ir.model']._get_id('sale.order')})
# a migration that must not be logged
records.with_context(tx_no_audit=True).write({'state': 'done'})
# the logs of a record
env['taqnix.audit.log'].search([('model_name', '=', 'sale.order'), ('res_id', '=', order.id)])استكشاف الأخطاء
| المشكلة | ما العمل |
|---|---|
| لا يُسجَّل شيء | تحقق من وجود القاعدة وأنها نشطة وأن العملية (إنشاء أو تغيير أو حذف) معلَّمة. ويُتخطى المستخدم المتجاهَل والحقل المتجاهَل. |
| لا أرى قائمة سجل التدقيق | تحتاج مجموعة المدقِّق أو أن تكون مديرًا. |
| «هذا النموذج مُدقَّق أصلًا» | للنموذج قاعدة واحدة. عدّلها بدل إنشاء أخرى. |
| «لا يمكن حذف سجلات التدقيق» | هذا مقصود. استخدم الاحتفاظ بالسجلات (أيام) لإزالة القديم. |
| بند سجل التدقيق غير ظاهر | يظهر حين توجد قاعدة للنموذج؛ أعد تحميل الصفحة. |
التحديث والإزالة
استبدل المجلد بالإصدار الجديد وأعد تشغيل أودو ونفّذ -u taqnix_audit_log. تبقى القواعد والسجلات. وإزالة الوحدة تحذف قواعدها وسجلاتها.
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الوحدة أو راسل support@taqnix.com مع إصدار أودو ولقطة شاشة.