إذا فتحت أول طلب دمج Pull Request في حياتك فغالباً حدث واحد من أمرين: إما أن زميلك وافق عليه بعد ثلاثين ثانية بكلمة «LGTM» أي «يبدو جيداً»، ثم ظهر الخطأ في الإنتاج بعد يومين وعرفت أن أحداً لم يقرأ الكود فعلاً، وإما أنك تلقيت أربعين تعليقاً عن المسافات وأسماء المتغيرات وطريقة كتابة الأقواس، فشعرت أن المراجعة محاكمة وليست مساعدة. والموقف المعاكس ليس أسهل، فعندما يطلب منك أن تراجع كود زميل أقدم منك لا تعرف بماذا تبدأ، ولا كم تكتب، ولا هل يحق لك أن ترفض.
ومراجعة الكود Code Review من الممارسات التي يتفق عليها الجميع على الورق ويختلفون في تطبيقها، والسبب أنها عمل بشري بين شخصين، فيها جانب تقني هو ما تبحث عنه في الكود، وجانب إنساني هو كيف تقول ما وجدته. وفي ما هو DevOps؟ وضعنا مراجعة الكود ثانية في ترتيب الممارسات بعد إدارة النسخ مباشرة، وفي أول مستودع Git لك رأينا رقماً خاطئاً في README وصل إلى السيرفر لأن لا أحد راجعه. وفي هذا المقال نبني الممارسة نفسها خطوة بخطوة على Gitea بحسابين، كاتب ومراجع، ونرى ما يمسكه طلب الدمج وما لا يمسكه. وسوف نناقش في هذا المقال ما يلي:
- ما هو طلب الدمج، ولماذا نراجع الكود، وما الذي تقوله الأبحاث عن فائدته الحقيقية، وما لا تستطيع المراجعة فعله.
- تجربة كاملة على Gitea: حماية الفرع main، وطلب دمج، وتعليقات على الأسطر، وطلب تعديلات، وإصلاح، وموافقة تسقط تلقائياً عند Commit جديد، ثم دمج.
- دور الكاتب: كيف تجعل طلبك صغيراً وواضحاً وسهل المراجعة.
- دور المراجع: بماذا تبدأ، ومتى توافق، وكم تأخذ من الوقت.
- كيف تكتب تعليقاً مفيداً، وماذا تفعل عند الخلاف، وما الذي تتركه للأدوات.
ما هو طلب الدمج Pull Request؟
طلب الدمج هو صفحة على منصة استضافة الكود تقول فيها: «عندي فرع فيه تغيير، وأريد أن يدخل إلى الفرع الرئيسي، فانظروا فيه أولاً». وتعرض الصفحة الفروقات Diff بين الفرعين سطراً سطراً، وتسمح للزملاء بالتعليق على أي سطر، وبالموافقة أو طلب التعديل، وتعرض نتيجة الاختبارات الآلية، ثم يدمج الفرع بزر واحد عندما تتحقق الشروط. ويسمى في GitHub وGitea طلب السحب Pull Request، لأنك تطلب من صاحب المستودع أن «يسحب» تغييراتك، ويسمى في GitLab طلب الدمج Merge Request، والفكرة واحدة، وتفاصيل الميزة في Gitea في توثيق Pull Requests.
وقبل المنصات كانت المراجعة تتم بإرسال الفروقات بالبريد، ومشروع Linux ما زال يعمل بهذه الطريقة حتى اليوم، أما في أغلب الفرق فطلب الدمج أصبح المكان الذي يلتقي فيه كل شيء: الكود والنقاش والاختبارات والقرار. والصورة التالية تبين الدورة الكاملة التي سوف نمر بها في التجربة:

لماذا نراجع الكود؟ Why Review
إذا سألت أي مطور عن سبب المراجعة فسوف يقول «لاكتشاف الأخطاء»، وهذا صحيح جزئياً، ولكن الأبحاث تقول شيئاً أكثر إثارة. ففي دراسة من Microsoft Research بعنوان Expectations, Outcomes, and Challenges of Modern Code Review لاحظ الباحثان Alberto Bacchelli وChristian Bird فرقاً متعددة وقابلا مطورين ومديرين وصنفا مئات تعليقات المراجعة يدوياً، فوجدا أن اكتشاف الأخطاء يبقى الدافع الأول للمراجعة، ولكن المراجعات في الواقع تتعلق بالأخطاء أقل مما يتوقع الناس، وتقدم بدلاً من ذلك فوائد أخرى مثل نقل المعرفة Knowledge Transfer، ووعي الفريق بما يحدث في الكود Team Awareness، والوصول إلى حلول بديلة أفضل.
وهذا يغير طريقة نظرتك إلى المراجعة، فهي ليست بوابة تفتيش فقط، وإنما أهم طريقة يتعلم بها الفريق من بعضه، ولذلك فإن فوائدها الحقيقية هي:
- عينان على كل تغيير: الكاتب يرى ما قصده وليس ما كتبه، والمراجع يرى الكود بعين جديدة، فيلاحظ الحالة التي لم يفكر فيها الكاتب، مثل الخصم الأكبر من المبلغ الذي سوف نراه في التجربة.
- نقل المعرفة: بعد كل مراجعة يعرف شخص ثان كيف يعمل هذا الجزء، فإذا غاب الكاتب لم تتوقف الخدمة، وهذا ما يسمى أحياناً تقليل «عامل الحافلة Bus Factor»، أي عدد الأشخاص الذين إذا غابوا توقف المشروع.
- اتساق الكود: المراجعون ينقلون أعراف الفريق في التسمية والتصميم والاختبار إلى كل عضو جديد، دون أن يحتاج أحد إلى كتابة دليل من مئة صفحة.
- سجل للقرار: النقاش في طلب الدمج يبقى مربوطاً بالكود، فإذا سأل أحد بعد سنة «لماذا رفضنا الخصم السالب؟» وجد الإجابة في الطلب.
ما لا تستطيع المراجعة فعله Limits
وللمراجعة حدود يجب أن تعرفها حتى لا تعطيها ثقة أكبر مما تستحق. فالمراجع يقرأ ما يعرض عليه في الفروقات فقط، ولا يرى الكود الذي لم يتغير ويتأثر بالتغيير، ولا يرى ما يحدث عند التشغيل بحجم بيانات الإنتاج، ولا يرى ما لم يدخل المستودع أصلاً. ولذلك فالمراجعة تكمل الاختبارات الآلية والمراقبة ولا تحل محلها.
طلبات من خارج الفريق Forks
في المستودعات المفتوحة، أو في شركة فيها فرق كثيرة، يأتي بعض الطلبات من أشخاص لا يملكون صلاحية الكتابة في المستودع، فينسخون المستودع إلى حسابهم بما يسمى Fork، ويعملون على نسختهم، ثم يفتحون طلب دمج منها إلى المستودع الأصلي. والمراجعة هنا أهم وأخطر في الوقت نفسه، والسبب أن الكاتب قد لا تعرفه، وأن الطلب قد يغير ملفات خط CI نفسه، فإذا شغل خطك هذه الملفات تلقائياً على سيرفرك فقد شغلت كود شخص غريب بصلاحيات الخط وأسراره. ولذلك يطلب Gitea موافقة يدوية قبل تشغيل ال workflows في طلبات من Fork لشخص لا يملك صلاحية الكتابة، كما ذكرنا في Gitea Actions، فلا توافق على التشغيل قبل أن تقرأ ما تغير في المجلد .gitea/workflows/ وفي سكربتات البناء.
وفي مثل هذه الطلبات اقرأ ما يلي بعناية أكبر من المعتاد: الملفات الثنائية والملفات المولدة التي لا تستطيع قراءتها، وتغييرات الاعتماديات Dependencies وأرقام إصداراتها، وأي تغيير في سكربتات البناء أو التثبيت، لأن هذه بالضبط الأماكن التي اختبأ فيها باب xz الخلفي. وإذا كان الطلب كبيراً من شخص جديد فاطلب منه أن يقسمه، فالطلب الصغير الذي تفهمه بالكامل أفضل من الكبير الذي توافق عليه لأنك تعبت من قراءته.
الطلبات المتروكة Stale Pull Requests
في كل مستودع بعد فترة تجد طلبات مفتوحة منذ أسابيع، لم يرد عليها أحد، أو رد المراجع ولم يكمل الكاتب. وهذه الطلبات ليست مشكلة شكلية، فكل طلب مفتوح فرع يبتعد عن main كل يوم، فيصعب دمجه أكثر، وقد يكون فيه إصلاح لعطل ينتظره العملاء ولا يعرف أحد أنه جاهز. والحل عادة بسيط: مراجعة أسبوعية قصيرة لقائمة الطلبات المفتوحة، يقرر فيها الفريق لكل طلب قديم واحداً من ثلاثة: يكمل ويحدد من يراجعه ومتى، أو يغلق مع تعليق يشرح السبب، أو يحول إلى مهمة Issue إذا كانت الفكرة صحيحة والتوقيت غير مناسب. والإغلاق مع السبب ليس إهانة للكاتب، وإنما احترام لوقته، فهو أفضل من طلب يبقى معلقاً دون قرار.
تجربة عملية: طلب دمج كامل على Gitea
سوف نستخدم مستودع حاسبة الفواتير الذي بنيناه في المقال السابق، ونضيف إليه ميزة خصم، ويعمل عليها حسابان: dev1 وهو الكاتب وصاحب المستودع، وrev1 وهو المراجع وله صلاحية كتابة. وكل ما نفعله هنا من الواجهة البرمجية API تستطيع فعله من واجهة الويب، وقد استخدمنا الواجهة البرمجية لكي تستطيع إعادة التجربة كما هي، ولكي يظهر كل طلب ورده كما حدث.
تجهيز المختبر Lab Setup
docker network create dvb-net
docker run -d --name dvb-gitea --network dvb-net -p 3471:3000 \
-e GITEA__security__INSTALL_LOCK=true \
-e GITEA__server__ROOT_URL=http://localhost:3471/ \
-e GITEA__database__DB_TYPE=sqlite3 \
-e GITEA__service__DISABLE_REGISTRATION=true \
-v dvb-gitea-data:/data gitea/gitea:28.3.0
docker exec -u git dvb-gitea gitea admin user create --admin \
--username dev1 --password 'Lab-Pass-2026!' --email [email protected] --must-change-password=false
docker exec -u git dvb-gitea gitea admin user create \
--username rev1 --password 'Lab-Pass-2026!' --email [email protected] --must-change-password=false
G=http://localhost:3471/api/v1
curl -s -u 'dev1:Lab-Pass-2026!' -H 'Content-Type: application/json' -X POST $G/user/repos \
-d '{"name":"invoice-tool","default_branch":"main","private":true}'
curl -s -u 'dev1:Lab-Pass-2026!' -H 'Content-Type: application/json' \
-X PUT $G/repos/dev1/invoice-tool/collaborators/rev1 -d '{"permission":"write"}'ثم ندفع من Container الكاتب dvb-laptop أول نسخة من الكود، وفيها الدالة total واختبار واحد يتأكد من حساب الضريبة:
import unittest
from invoice import total
class TotalTest(unittest.TestCase):
def test_vat(self):
self.assertEqual(total([(100, 2), (50, 1)]), 287.5)
if __name__ == "__main__":
unittest.main()OK
c3f7379 Invoice total with VAT and a testحماية الفرع main Branch Protection
المراجعة التي يمكن تجاوزها ليست قاعدة وإنما اقتراح، فأول ما نضيفه هو قاعدة حماية على الفرع main تمنع الدفع المباشر إليه، وتطلب موافقة واحدة على الأقل قبل أي دمج، وتلغي الموافقات القديمة عندما يضاف Commit جديد إلى الطلب، وتمنع الدمج إذا كان هناك طلب تعديلات قائم. والخيارات كلها مشروحة في توثيق الفروع المحمية في Gitea، وتجدها في الواجهة في Settings ← Branches ← Add New Rule:
curl -s -u 'dev1:Lab-Pass-2026!' -H 'Content-Type: application/json' \
-X POST $G/repos/dev1/invoice-tool/branch_protections -d '{
"rule_name": "main",
"enable_push": false,
"required_approvals": 1,
"dismiss_stale_approvals": true,
"block_on_rejected_reviews": true
}'والآن نجرب أن يدفع صاحب المستودع، وهو أيضاً مدير السيرفر، Commit صغيراً مباشرة إلى main:
echo "# invoice-tool" > README.md
git add README.md && git commit -qm "Add README"
git pushremote: error: Not allowed to push to protected branch main
To http://dvb-gitea:3000/dev1/invoice-tool.git
! [remote rejected] main -> main (pre-receive hook declined)
error: failed to push some refs to 'http://dvb-gitea:3000/dev1/invoice-tool.git'لاحظ أن الرفض شمل صاحب المستودع نفسه، وهذا مقصود، والسبب أن أكثر من يتجاوز المراجعة «لأن التغيير صغير جداً» هم أقدم الناس في الفريق وأكثرهم صلاحيات، وأن التغييرات الصغيرة جداً هي التي تمر دون اختبار. والرسالة pre-receive hook declined تعني أن السيرفر فحص الدفعة قبل أن يقبلها ورفضها، وليس أن هناك مشكلة في الاتصال. وتراجعنا عن هذا ال Commit المحلي بالأمر git reset --hard HEAD~1 لأنه سوف يأتي لاحقاً عبر طلب دمج.
فتح طلب الدمج Open a Pull Request
يعمل الكاتب على فرع جديد، ويضيف خصماً اختيارياً إلى الدالة، ويدفع الفرع:
VAT = 0.15
def total(items, d=0):
subtotal = sum(price * qty for price, qty in items)
subtotal = subtotal - d
return round(subtotal * (1 + VAT), 2)git switch -c feat/discount
git commit -qam "Add discount to invoice total"
git push -u origin feat/discountremote: Create a new pull request for 'feat/discount':
remote: http://localhost:3471/dev1/invoice-tool/pulls/new/feat/discountيقترح Gitea رابطاً لفتح الطلب مباشرة، وفي التجربة فتحناه من الواجهة البرمجية مع وصف من ثلاثة أقسام: ماذا يفعل التغيير، ولماذا، وكيف يختبره المراجع، ثم طلبنا المراجعة من rev1:
## What
Adds an optional discount (in SAR) to `total()`.
## Why
Sales asked for one-off discounts on invoices.
## How to test
`python3 -m unittest`وقبل أي مراجعة جربنا أن ندمج الطلب مباشرة بصلاحية صاحب المستودع:
curl -s -u 'dev1:Lab-Pass-2026!' -H 'Content-Type: application/json' \
-X POST $G/repos/dev1/invoice-tool/pulls/1/merge -d '{"Do":"squash"}'{"message":"Does not have enough approvals","url":"http://localhost:3471/api/swagger"}
HTTP 405الحماية تعمل من الواجهة البرمجية كما تعمل من الواجهة، فلا طريق إلى main إلا عبر موافقة.
المراجعة: تعليقات على الأسطر Request Changes
يفتح المراجع تبويب Files Changed ويقرأ الفروقات، وأول ما يسأله ليس «هل الكود مرتب؟» وإنما «ماذا يحدث في الحالات التي لم يذكرها الكاتب؟». فإذا كان الخصم أكبر من المبلغ نفسه فماذا تكون النتيجة؟ وتأكد من ذلك بتشغيل الكود على الفرع:
python3 -c "from invoice import total; print(total([(100, 1)], d=150))"-57.5فاتورة بقيمة سالبة، أي أن المتجر يدين للعميل بمال بعد أن اشترى منه. وكتب المراجع مراجعة من نوع طلب تعديلات Request Changes، فيها ملخص عام وتعليقان على سطرين محددين، أحدهما مانع للدمج والآخر ملاحظة صغيرة:
{"event": "REQUEST_CHANGES",
"body": "Thanks, the change is small and easy to follow. One blocking issue and one nit before we merge.",
"comments": [
{"path": "invoice.py", "new_position": 6,
"body": "Blocking: a discount larger than the subtotal gives a negative invoice. With items [(100, 1)] and d=150 the total is -57.5. Please reject d < 0 or d > subtotal with a ValueError, and add a test for both cases."},
{"path": "invoice.py", "new_position": 4,
"body": "Nit: `d` is hard to read at the call site. `discount` says what it is."}]}والصورة التالية تبين كيف يظهر ذلك للكاتب في تبويب Files Changed:
![تبويب Files Changed في طلب الدمج Add discount to invoice total #1 على Gitea، والملف invoice.py مع 2 additions و1 deletions، وتحت السطر 4 def total(items, d=0) تعليق rev1: Nit: d is hard to read at the call site. discount says what it is، وتحت السطر 6 subtotal = subtotal - d تعليق rev1: Blocking: a discount larger than the subtotal gives a negative invoice. With items [(100, 1)] and d=150 the total is -57.5. Please reject d < 0 or d > subtotal with a ValueError, and add a test for both cases، ولكل تعليق زرا Resolve conversation وReply](https://arabroot.io/content/images/2026/11/code-review-basics-03-review-comments.webp)
في المراجعة أعلاه لاحظ التالي:
- الملخص يبدأ بما هو جيد في الطلب بجملة واحدة صادقة، ثم يقول بوضوح كم مشكلة فيه وما نوعها، فيعرف الكاتب حجم العمل قبل أن يقرأ التفاصيل.
- التعليق المانع يقول المشكلة، ويعطي مثالاً حقيقياً بأرقام يستطيع الكاتب تكراره، ويقترح حلاً واختباراً، ولا يقول «الكود خطأ» دون شرح.
- الملاحظة الصغيرة تبدأ بكلمة Nit، وهي التسمية التي يستخدمها دليل Google في كتابة تعليقات المراجعة لما هو تحسين صغير لا يمنع الدمج، فلا يضيع الكاتب وقته في نقاش حول ما هو اختياري.
وبعد هذه المراجعة جربنا الدمج مرة ثانية فرفضه Gitea بالرسالة نفسها، لأن طلب التعديلات قائم والموافقة غير موجودة.
الإصلاح مع اختبارات جديدة Tests
يعدل الكاتب على الفرع نفسه، فيغير اسم المعامل، ويرفض الخصم خارج الحدود، ويضيف اختبارين: الأول يتأكد أن الخصم يطبق قبل الضريبة، والثاني يتأكد أن القيم خارج الحدود ترفض:
VAT = 0.15
def total(items, discount=0):
subtotal = sum(price * qty for price, qty in items)
if discount < 0 or discount > subtotal:
raise ValueError(f"discount must be between 0 and {subtotal}")
return round((subtotal - discount) * (1 + VAT), 2) def test_discount_before_vat(self):
self.assertEqual(total([(100, 2)], discount=50), 172.5)
def test_discount_out_of_range(self):
for bad in (-1, 201):
with self.assertRaises(ValueError):
total([(100, 2)], discount=bad)python3 -m unittest -v
git commit -qam "Validate discount and add tests"
git pushtest_discount_before_vat (test_invoice.TotalTest.test_discount_before_vat) ... ok
test_discount_out_of_range (test_invoice.TotalTest.test_discount_out_of_range) ... ok
test_vat (test_invoice.TotalTest.test_vat) ... ok
----------------------------------------------------------------------
Ran 3 tests in 0.001s
OK
remote: Visit the existing pull request:
remote: http://localhost:3471/dev1/invoice-tool/pulls/1لاحظ أن الكاتب لم يفتح طلباً جديداً، وإنما دفع إلى الفرع نفسه، فظهر ال Commit الجديد في الطلب نفسه، ويستطيع المراجع أن يرى ما تغير منذ آخر مراجعة فقط. ولاحظ أن الاختبار الجديد لا يختبر الحالة التي وجدها المراجع فقط، وإنما يجعلها جزءاً دائماً من المشروع، فلو عاد أحد بعد سنة وحذف الشرط لفشل الاختبار قبل أن يصل التغيير إلى المراجعة أصلاً.
مشكلة حقيقية: موافقة بقيت مسودة PENDING
عند هذه الخطوة أرسل المراجع موافقته من الواجهة البرمجية بالحقل "event":"APPROVE"، لأنه الاسم الذي تستخدمه منصات أخرى، فرجع الرد بنجاح، ولكن بحالة غير متوقعة:
"state":"PENDING"
"commit_id":"bb0fbef882202ccfab5c60e145db7d3ec02933d8"
"stale":falseوالحالة PENDING في Gitea تعني مراجعة لم ترسل بعد، أي مسودة يراها المراجع وحده، فالموافقة لم تصل إلى الكاتب، والدمج بقي مرفوضاً بالرسالة نفسها Does not have enough approvals. والسبب أن Gitea يسمي الحالة APPROVED وليس APPROVE، وفي تجربتنا عندما لم يتعرف على القيمة حفظ المراجعة مسودة بدلاً من أن يعطي خطأ. والحل أن نرسل المسودة نفسها بالقيمة الصحيحة:
curl -s -u 'rev1:Lab-Pass-2026!' -H 'Content-Type: application/json' \
-X POST $G/repos/dev1/invoice-tool/pulls/1/reviews/3 \
-d '{"event":"APPROVED","body":"Validation and tests look good. Approved."}'"state":"APPROVED"
"stale":falseوهذا الخطأ الصغير يحدث بأشكال أخرى في الواجهة أيضاً، فالمراجع الذي يكتب تعليقات على عدة أسطر ثم يغلق الصفحة دون أن يضغط Submit Review يترك مراجعته مسودة لا يراها أحد، والكاتب ينتظر رداً لن يصل. فإذا طال انتظار طلبك فاسأل المراجع، وإذا كنت تراجع فتأكد أن مراجعتك ظهرت في الطلب.
ماذا يحدث إذا دفع الكاتب بعد الموافقة؟ What If
الآن الطلب عليه موافقة، والسؤال الذي يكشف قيمة الإعداد dismiss_stale_approvals: ماذا لو أضاف الكاتب Commit جديداً بعد أن وافق المراجع؟ هل تبقى الموافقة على كود لم يره المراجع؟ أضاف الكاتب ملف README ودفعه، ثم سألنا عن حالة المراجعات وجربنا الدمج:
"id":2 "state":"REQUEST_CHANGES" "stale":true
"id":3 "state":"APPROVED" "stale":true
{"message":"Does not have enough approvals","url":"http://localhost:3471/api/swagger"}
HTTP 405أصبحت الموافقة قديمة stale لأنها كانت على Commit لم يعد آخر ما في الفرع، فلم تعد تحسب، ورفض الدمج. وفي صفحة الطلب يظهر ذلك بوضوح، مع السبب:

وقد يتساءل البعض: أليس هذا مزعجاً إذا كان التغيير الجديد سطراً في README؟ والإجابة أن السيرفر لا يعرف هل التغيير الجديد بسيط أم لا، والكاتب الذي يريد أن يمرر شيئاً دون مراجعة، أو الذي يدفع بالخطأ تغييراً من فرع آخر، سوف يفعل ذلك تحديداً بعد الموافقة، ولذلك فالقاعدة الآمنة أن الموافقة تكون على ما سوف يدمج بالضبط. وبعد أن نظر المراجع في ال Commit الأخير وافق من جديد، وأصبح الطلب جاهزاً، والصورة التالية تبين بداية صفحة الطلب كما يراها الفريق، مع الوصف والطلب المرفوض الذي سقط وتعليقات الأسطر التي أصبحت قديمة Outdated لأن الكود تغير تحتها:

ماذا يبقى في التاريخ بعد الدمج؟ Squash Merge
دمجنا الطلب بطريقة الضغط Squash، التي تجمع كل Commits الفرع في Commit واحد على main، مع حذف الفرع بعد الدمج:
curl -s -u 'dev1:Lab-Pass-2026!' -H 'Content-Type: application/json' \
-X POST $G/repos/dev1/invoice-tool/pulls/1/merge -d '{
"Do": "squash",
"MergeTitleField": "Add discount to invoice total (#1)",
"MergeMessageField": "Reviewed-by: rev1",
"delete_branch_after_merge": true}'
git switch main && git pull
git log --oneline
git show --stat --format="%an%n%s%n%b" HEAD803cb75 Add discount to invoice total (#1)
c3f7379 Invoice total with VAT and a test
Dev One
Add discount to invoice total (#1)
Reviewed-by: rev1
Co-authored-by: Dev One <[email protected]>
README.md | 3 +++
invoice.py | 8 +++++---
test_invoice.py | 8 ++++++++
3 files changed, 16 insertions(+), 3 deletions(-)في المخرج أعلاه لاحظ التالي:
- أربعة Commits في الفرع، منها الخطأ الأول وإصلاحه، أصبحت Commit واحداً نظيفاً على
main، ورقم الطلب(#1)في عنوانه يربطه بالنقاش كله، فمن يقرأ السجل بعد سنة يفتح الطلب ويعرف لماذا يوجد الشرط. - أضفنا سطر
Reviewed-byإلى الرسالة، وأضاف Gitea من نفسه سطرCo-authored-byلكاتب ال Commits، وهذه أسطر ذيل Trailers تقرؤها الأدوات. - الضغط Squash ليس الطريقة الوحيدة، فالدمج العادي يحفظ كل Commits الفرع، وإعادة التأسيس Rebase تضعها فوق
mainبخط مستقيم، والمقارنة بين الطرق في الدمج مع الضغط Squash Merge.
وعند الانتهاء احذف المختبر:
docker rm -f dvb-gitea dvb-laptop
docker volume rm dvb-gitea-data
docker network rm dvb-netدور الكاتب Author: طلب يسهل مراجعته
أغلب المراجعات السيئة تبدأ من طلب سيئ، فالمراجع الذي يفتح طلباً فيه ثلاثون ملفاً وعنوانه «تحديثات» لن يقرأه بعناية مهما كانت نيته. ولذلك فنصف جودة المراجعة في يد الكاتب، وأهم ما يفعله ما يلي.
اجعل الطلب صغيراً Small Pull Requests
يقول دليل Google في التغييرات الصغيرة Small CLs إنه لا توجد قاعدة ثابتة للحجم «الكبير جداً»، ولكن 100 سطر حجم معقول غالباً، و1000 سطر كبير جداً غالباً، وإن العبرة أيضاً بعدد الملفات، فمئتا سطر في ملف واحد قد تكون مقبولة، أما إذا توزعت على خمسين ملفاً فهي كبيرة جداً. والصورة التالية تبين لماذا يهم الحجم:

وإذا كانت الميزة كبيرة فقسمها إلى طلبات متتالية كل واحد منها يعمل وحده: أولاً تغيير في قاعدة البيانات لا يستخدمه أحد بعد، ثم الكود الذي يكتب فيها، ثم الواجهة، مع Feature Flag يخفي الميزة حتى تكتمل، كما شرحنا في التطوير على الفرع الرئيسي Trunk-Based. ولا تخلط إعادة الهيكلة Refactoring مع تغيير السلوك في طلب واحد، والسبب أن المراجع لا يستطيع أن يعرف أي سطر من الثلاثمئة يغير ما يفعله البرنامج وأيها مجرد نقل.
اكتب وصفاً يجيب عن الأسئلة PR Description
الوصف الجيد يجيب عن ثلاثة أسئلة قبل أن يسألها المراجع: ماذا يفعل التغيير، ولماذا الآن، وكيف أتأكد أنه يعمل. ودليل Google في كتابة وصف التغيير يطلب أن يكون السطر الأول ملخصاً قصيراً يفهم وحده، لأنه هو ما يظهر في السجل والقوائم، وأن يشرح الباقي المشكلة والسياق والقرارات التي قد تبدو غريبة. وإذا كان التغيير في الواجهة فأضف صورة قبل وبعد، وإذا كان هناك قرار ناقشته مع أحد فاذكره، وإذا تركت شيئاً عمداً لطلب لاحق فاكتب ذلك حتى لا يطلبه المراجع.
راجع طلبك قبل أن تطلب المراجعة Self-review
افتح تبويب Files Changed في طلبك واقرأه كأنك المراجع، فسوف تجد غالباً سطر Debug نسيته، أو ملفاً لا علاقة له بالطلب، أو اختباراً معطلاً بالتعليق. وتأكد أن الاختبارات تعمل على جهازك أو في خط CI قبل أن تطلب من إنسان أن يقضي وقته في القراءة، والسبب أن وقت المراجع أغلى من وقت الآلة. وإذا وجدت في طلبك جزءاً معقداً فلا تشرحه في تعليق على الطلب، وإنما اكتب الشرح في الكود نفسه أو بسط الكود، لأن تعليق الطلب يختفي مع الدمج، أما التعليق في الكود فيبقى لكل من يقرؤه بعد ذلك.
استقبل التعليقات بلا دفاع Responding
التعليق على كودك ليس تعليقاً عليك، والمراجع الذي وجد خصماً سالباً وفر عليك مكالمة غاضبة من المحاسبة. فرد على كل تعليق إما بإصلاح، وإما بشرح لماذا لا ترى التغيير مناسباً، ولا تترك تعليقاً دون رد، وإذا أصلحت ما طلب فاكتب ذلك أو أغلق المحادثة بزر Resolve حتى يعرف المراجع أين يبدأ. وإذا تكرر سؤال المراجع «ماذا يفعل هذا السطر؟» فهذه علامة أن الكود يحتاج إلى أن يكون أوضح، وليس أن المراجع يحتاج إلى شرح.
دور المراجع Reviewer: بماذا تبدأ؟
المراجع المبتدئ يبدأ عادة بما يراه أولاً: المسافات والأقواس والأسماء، فيكتب عشرين تعليقاً عنها، ويفوته أن التصميم كله لا يناسب المشكلة. والترتيب الأفضل هو العكس، من الأغلى إصلاحاً إلى الأرخص، وهو قريب مما يذكره دليل Google في ما الذي تبحث عنه في المراجعة:

- التصميم Design: هل هذا التغيير في المكان الصحيح؟ هل يتكامل مع بقية النظام؟ هل هذا وقت هذه الميزة أصلاً؟ إذا كان الجواب لا فقل ذلك أولاً وتوقف، فلا فائدة من مراجعة الأسماء في كود سوف يعاد كتابته.
- السلوك Functionality: هل يفعل الكود ما يقصده الكاتب، وهل ما يقصده الكاتب هو ما يحتاجه المستخدم؟ فكر في الحالات الحدية: القيمة الصفرية والسالبة والفارغة والكبيرة جداً، والطلبين في الوقت نفسه، كما فعلنا مع الخصم.
- التعقيد Complexity: هل يستطيع زميل جديد أن يفهم الكود بسرعة؟ هل هناك تعميم لحالة لن تأتي؟ الكود الأبسط الذي يحل المشكلة الحالية أفضل من المرن الذي يحل مشاكل متخيلة.
- الاختبارات Tests: هل يوجد اختبار لما تغير؟ وهل الاختبار يفشل فعلاً إذا تعطل الكود؟ الاختبار الذي ينجح دائماً لا يختبر شيئاً.
- الأسماء والتعليقات Naming: هل الأسماء تقول ما يحمله المتغير؟ هل التعليقات تشرح «لماذا» وليس «ماذا»؟
- التنسيق Style: المسافات وطول السطر وترتيب الاستيراد تمسكها أداة التنسيق Formatter والفاحص Linter في ثانية، فلا تكتب فيها تعليقاً بيدك، وإنما اطلب أن تضاف الأداة إلى خط CI.
كيف تقرأ الفروقات؟ Reading the Diff
لا تقرأ الملفات بالترتيب الأبجدي الذي تعرضه المنصة، فهذا الترتيب لا علاقة له بمنطق التغيير. ابدأ بالوصف لتعرف ماذا يجب أن يحدث، ثم بالاختبارات لأنها تقول بلغة الكود ما يتوقعه الكاتب، فإذا لم تجد اختباراً لحالة ذكرها الوصف فقد وجدت أول تعليق. ثم اقرأ الملف الذي فيه أهم تغيير في السلوك، ثم الملفات التي تعتمد عليه. وإذا كان التغيير يمس منطقاً حساساً، مثل الحسابات المالية أو الصلاحيات، فلا تكتف بالقراءة، وإنما اسحب الفرع إلى جهازك وشغله كما فعل المراجع في التجربة عندما جرب خصماً أكبر من الفاتورة. وفي Gitea يحفظ كل طلب في مرجع خاص اسمه refs/pull/<رقم الطلب>/head، فتستطيع أن تجلبه حتى لو كان من Fork لا تعرف عنوانه بالأمر git fetch origin pull/1/head:pr-1 ثم git switch pr-1، وفي التجربة جلب هذا الأمر الطلب حتى بعد دمجه وحذف فرعه، وطبع السطر * [new ref] refs/pull/1/head -> pr-1 وآخر Commit فيه، أي أن نسخة الطلب تبقى محفوظة على السيرفر للرجوع إليها. ولاحظ زر Viewed بجانب كل ملف في تبويب Files Changed، فهو يحفظ لك ما قرأته، وإذا دفع الكاتب Commit جديداً يعرض لك الملفات التي تغيرت منذ قراءتك فقط.
متى توافق؟ The Standard
هذا السؤال يحير كثيراً من المراجعين: هل أوافق إذا لم يكن الكود كما كنت سوف أكتبه؟ ويجيب دليل Google في معيار مراجعة الكود إجابة واضحة: وافق على التغيير عندما يحسن الصحة العامة للكود بشكل مؤكد، حتى لو لم يكن مثالياً، والسبب كما يقول الدليل أنه لا يوجد كود مثالي، وإنما يوجد كود أفضل. فالمراجع الذي يطلب الكمال يعطل الفريق، والذي يوافق على كل شيء يترك الكود يسوء تدريجياً، والميزان بينهما هو: هل الكود بعد الدمج أفضل منه قبله؟ فإذا كان كذلك وبقيت ملاحظات صغيرة فوافق واكتبها كNit.
كم تأخذ من الوقت؟ Review Speed
المراجعة البطيئة أسوأ مما تبدو، فالكاتب الذي ينتظر يومين يبدأ عملاً آخر، فإذا جاءت التعليقات احتاج إلى أن يتذكر ما كان يفعله، والفرع يبتعد عن main فتزيد التعارضات، والفريق يتعلم أن يجمع تغييرات أكثر في كل طلب لكي يقلل الانتظار، فتكبر الطلبات وتسوء المراجعة. ولذلك يقول دليل Google في سرعة المراجعة إن يوم عمل واحد هو أقصى وقت للرد على طلب مراجعة. ولا يعني ذلك أن تقطع تركيزك في كل مرة يصل فيها طلب، وإنما أن تراجع في الفواصل الطبيعية من يومك، مثل بعد الانتهاء من مهمة أو بعد الغداء.
كيف تكتب تعليقاً مفيداً؟ Review Comments
التعليق نفسه يمكن أن يكتب بطريقة تجعل الكاتب يشكرك، وبطريقة تجعله يدافع عن كوده بدلاً من أن يفكر فيه، والفرق في أربعة أشياء: أن تعلق على الكود وليس على الشخص، وأن تشرح السبب، وأن تقول بوضوح هل التعليق مانع أم اختياري، وأن تسأل عندما لا تكون متأكداً. والجدول التالي يبين أمثلة:
| تعليق سيئ | تعليق أفضل | لماذا؟ |
|---|---|---|
| هذا خطأ. | Blocking: مع خصم 150 على فاتورة 100 تصبح النتيجة -57.5، فارفض القيم خارج الحدود وأضف اختباراً. | المشكلة ومثال يكررها والحل المقترح |
| لماذا كتبت هذا بهذه الطريقة؟ | هل فكرت في استخدام القاموس هنا بدلاً من الحلقة؟ أظنه أوضح، ولكن قد يكون لك سبب لا أعرفه. | سؤال حقيقي وليس اتهاماً، ويترك القرار للكاتب |
| أنت دائماً تنسى الاختبارات. | هذا التغيير يحتاج إلى اختبار للحالة الفارغة. | عن الكود وليس عن الشخص، وعن هذا الطلب وحده |
| غير الاسم. | Nit: d صعب القراءة عند الاستدعاء، وdiscount يقول ما هو. | اختياري بوضوح، ومعه السبب |
وبعض الفرق تتبع صيغة ثابتة تسمى Conventional Comments، حيث يبدأ كل تعليق بكلمة تحدد نوعه، مثل suggestion: وissue: وquestion: وnitpick: وpraise:، مع وسم (non-blocking) أو (blocking). والفائدة أن الكاتب يعرف من الكلمة الأولى ماذا يطلب منه، فلا يقضي ساعة في تعديل ما كان مجرد اقتراح. ولا تنس أن تكتب تعليقاً إيجابياً عندما ترى شيئاً جيداً فعلاً، مثل اختبار ذكي أو تبسيط واضح، فالمراجعة التي لا تحمل إلا النقد تجعل الناس يخافون من فتح الطلبات.
عندما تختلفان Disagreements
إذا تبادلت أنت والكاتب أكثر من ثلاث ردود على التعليق نفسه دون اتفاق، فتوقف عن الكتابة وتحدثا مباشرة بمكالمة قصيرة، والسبب أن النص يفقد النبرة، وأن الردود الطويلة تتحول إلى من يكسب النقاش بدلاً من ما هو أفضل للكود. وبعد الاتفاق اكتب الخلاصة في الطلب حتى يعرفها من يقرأ لاحقاً. وإذا بقي الخلاف فالمرجع هو ما اتفق عليه الفريق من قواعد مكتوبة، ثم رأي شخص ثالث له خبرة في هذا الجزء، وليس الأقدم في الفريق ولا الأعلى صوتاً. وإذا كان الخلاف على التفضيل الشخصي وليس على صحة الكود، فالقرار للكاتب، لأن هذا كوده وهو من سوف يصونه.
ما تتركه للآلة Automation
كل ما تستطيع آلة أن تتحقق منه لا يجب أن يتحقق منه إنسان، فوقت المراجع يجب أن يذهب إلى ما لا تفهمه الآلة: هل هذا التصميم مناسب، وهل هذه الحالة الحدية مغطاة، وهل يفهم الزميل الجديد هذا الكود. ولذلك فأول ما تضيفه بعد المراجعة البشرية هو خط CI يعمل مع كل طلب دمج، ويشغل:
- أداة التنسيق Formatter مثل Black لـ Python أو Prettier لـ JavaScript، فلا يعود أحد يناقش المسافات.
- الفاحص Linter الذي يمسك الأخطاء الشائعة مثل المتغير غير المستخدم.
- الاختبارات الآلية، ومعها تحقق من أن الطلب لا يقلل التغطية Coverage بشكل كبير.
- فحص الأسرار المسربة، كما في اكتشاف الأسرار المسربة مع Gitleaks وTruffleHog.
وفي Gitea تستطيع أن تجعل نجاح هذه الفحوص شرطاً للدمج في قاعدة حماية الفرع نفسها، بجانب الموافقة، وسوف نبني هذا الخط في مقال CI/CD للمبتدئين من مرحلة DevOps والنشر المستمر. أما المراجعة الأمنية بقائمة متطلبات محددة فقد شرحناها في متطلبات الأمان ومراجعة الكود مع OWASP ASVS، وإذا كان جزء من الكود في فريقك يكتبه مساعد ذكاء اصطناعي فاقرأ مراجعة كود الذكاء الاصطناعي دون أن تصبح شكلية، والسبب أن هذا الكود يبدو مرتباً وواثقاً حتى عندما يكون خاطئاً، فيغري المراجع بالموافقة السريعة.
قواعد الفريق Team Agreement
المراجعة تعمل أفضل عندما تكون قواعدها مكتوبة ومتفقاً عليها، وليس في رأس كل شخص، والجدول التالي يبين الإعدادات التي استخدمناها في التجربة، وما ننصح به لفريق صغير:
| الإعداد في Gitea | ماذا يفعل | ما ننصح به |
|---|---|---|
Disable Push (enable_push: false) | يمنع الدفع المباشر إلى الفرع حتى للمدير | شغله على main وفروع الإصدار |
| Required approvals | عدد الموافقات المطلوبة قبل الدمج | واحدة لفريق صغير، واثنتان للأجزاء الحساسة مثل الدفع والصلاحيات |
| Dismiss stale approvals | يلغي الموافقة عند Commit جديد | شغله، فالموافقة على ما يدمج بالضبط |
| Block merge on rejected reviews | يمنع الدمج إذا كان هناك طلب تعديلات قائم | شغله، حتى لا يتجاوز موافق ثان اعتراض الأول |
| Status checks | يشترط نجاح فحوص CI قبل الدمج | شغله عندما يصبح عندك خط CI |
| Protected file patterns | ملفات لا تتغير إلا بموافقة خاصة | ملفات خط CI والنشر، لأن تعديلها يغير ما يعمل بصلاحيات السيرفر |
ومع الإعدادات اكتب في ملف CONTRIBUTING.md في المستودع قواعد بسيطة: الحجم المتوقع للطلب، وما يجب أن يكون في الوصف، والوقت المتوقع للرد، وكيف تكتب التعليقات المانعة والاختيارية. وتستطيع أن تضيف قالباً للوصف في المجلد .gitea فيظهر تلقائياً عند فتح كل طلب.
المراجعة في فريق من شخصين Small Teams
قد يقول البعض: نحن مطوران فقط، فهل نحتاج كل هذا؟ والإجابة نعم، بل إن الفريق الصغير يحتاجه أكثر، والسبب أن غياب شخص واحد يعني غياب نصف المعرفة. ولكن الشكل يختلف، ففي فريق من شخصين لا معنى لموافقتين، ولا لانتظار يوم كامل، والأنسب أن يراجع كل منكما طلب الآخر في اليوم نفسه، وأن تبقى الطلبات صغيرة جداً حتى تراجع في عشر دقائق. وإذا كنت تعمل وحدك على مشروع فما زال لطلب الدمج فائدة: افتح الطلب، واتركه ساعة أو حتى صباح اليوم التالي، ثم اقرأه كأن غيرك كتبه، فسوف تجد ما لم تره وأنت تكتب، ويبقى خط CI يعمل على الطلب قبل الدمج، ويبقى التاريخ يحكي لماذا تغير كل شيء.
أما في الحالات العاجلة، مثل إصلاح عطل في الإنتاج في منتصف الليل، فلا تلغ الحماية، وإنما اتفق مسبقاً على مسار سريع: طلب صغير، ومراجع مناوب يوافق خلال دقائق، ومراجعة أعمق في الصباح التالي. والسبب أن أكثر الأعطال الثانية تأتي من إصلاح عاجل للعطل الأول لم يره أحد غير كاتبه، وهو متعب وتحت ضغط.
هل يراجع المبتدئ كود من هو أقدم منه؟ Junior Reviewers
نعم، ويجب أن يفعل. فالمبتدئ يرى الكود كما سوف يراه أي شخص جديد ينضم إلى الفريق، فإذا لم يفهم جزءاً فهذه معلومة مهمة للكاتب، لأن الكود الذي لا يفهمه إلا من كتبه سوف يصبح مشكلة عندما يغيب. والطريقة المناسبة أن يكتب المبتدئ أسئلة أكثر من الأوامر: «لم أفهم لماذا نحتاج القفل هنا، هل يمكن أن تشرح؟»، و«ماذا يحدث إذا كانت القائمة فارغة؟»، وأن يوافق على ما فهمه ويقول بوضوح ما لم يستطع أن يحكم عليه، حتى يطلب الكاتب رأياً ثانياً لذلك الجزء. وعلى الأقدم في الفريق أن يرد على هذه الأسئلة باهتمام، لأن الفريق الذي يسخر من سؤال المبتدئ في المراجعة يعلمه أن يوافق بصمت.
كيف تعرف أن المراجعة تعمل؟ Review Metrics
إذا أردت أن تقيس المراجعة في فريقك فقس الانتظار والحجم، ولا تقس عدد التعليقات. والأرقام المفيدة ثلاثة: الوقت حتى أول رد على الطلب، والوقت من فتح الطلب حتى دمجه، وحجم الطلبات بالأسطر والملفات. فإذا كان أول رد يأتي بعد ثلاثة أيام فالمشكلة في توزيع وقت المراجعة وليس في من يكتبون الكود، وإذا كانت الطلبات تكبر مع الوقت فالفريق يجمع العمل لأنه يخاف الانتظار. وهذه الأرقام ترتبط مباشرة بزمن التغيير Change Lead Time من مقاييس DORA التي ذكرناها في ما هو DevOps؟، لأن الوقت الذي ينتظره الطلب في المراجعة جزء من الوقت الذي ينتظره التغيير قبل أن يصل إلى المستخدم. أما عدد التعليقات لكل شخص فلا يقول شيئاً عن الجودة، وإذا تحول إلى رقم يقيم به الناس فسوف يكتب المراجعون تعليقات أكثر وأقل فائدة، أو أقل وأكثر مجاملة.
أخطاء شائعة Common Mistakes
- الموافقة الشكلية «LGTM» دون قراءة: تعطي الفريق ثقة لا يستحقها، فإذا لم يكن عندك وقت للمراجعة فقل ذلك واطلب من غيرك، ولا توافق على ما لم تقرأه.
- التعليق على التنسيق بيدك: يضيع وقت الطرفين ويجعل المراجعة تبدو تافهة، فأضف أداة تنسيق إلى خط CI.
- الطلبات الضخمة: لا تراجع بعناية، وتنتظر طويلاً، وتجمع التعارضات، فقسمها.
- مراجعة تبقى مسودة: المراجع كتب تعليقاته ولم يضغط Submit، فبقيت
PENDINGلا يراها أحد كما حدث معنا في التجربة. - إبقاء الموافقات القديمة: دون
dismiss_stale_approvalsيستطيع أي Commit بعد الموافقة أن يدخل دون أن يراه أحد. - تحويل المراجعة إلى تقييم للأشخاص: عد التعليقات على كل مطور أو استخدامها في التقييم السنوي يجعل الناس يخفون الأخطاء ويفتحون طلبات أقل، وهذا عكس ما تريده.
- اعتبار المراجعة بديلاً عن الاختبار: المراجع لا يشغل الكود على كل الحالات، فالاختبار الآلي هو الذي يحفظ ما وجده المراجع لكل التغييرات القادمة.
قائمة تحقق Checklist
| الكاتب قبل طلب المراجعة | المراجع قبل الموافقة |
|---|---|
| الطلب يحل شيئاً واحداً، ونحو بضع مئات من الأسطر أو أقل | فهمت ماذا يحل الطلب ولماذا، ويناسب التصميم بقية النظام |
| الوصف يقول ماذا ولماذا وكيف تختبر | فكرت في الحالات الحدية وجربت واحدة على الأقل |
| قرأت الفروقات بنفسي ولا يوجد سطر Debug أو ملف غريب | يوجد اختبار لما تغير، وهو يفشل إذا تعطل الكود |
| الاختبارات تعمل محلياً أو في CI | التعليقات المانعة واضحة ومعها السبب، والاختيارية تبدأ بNit |
| لا يوجد خلط بين إعادة هيكلة وتغيير سلوك | المراجعة أرسلت فعلاً وليست مسودة |
| رددت على كل تعليق أو أغلقته | الكود بعد الدمج أفضل منه قبله، حتى لو لم يكن مثالياً |
ماذا تقرأ بعد ذلك؟ Next Steps
دليلGit في العمل اليومي: الدمج والتراجع دون أن تخسر عملكمتى تستخدم Merge ومتى تستخدم Rebase، وكيف تنقل إصلاحاً إلى فرع الإصدار أو تسترجع عملاً ظننت أنه ضاع.
دليلTrunk-Based Development: فروع قصيرة ودمج يوميلماذا تنفجر الفروع الطويلة يوم الإصدار، وكيف يدمج الفريق عمله في main كل يوم بأمان مع CI وFeature Flags.
دليلOWASP ASVS ومراجعة الكود الأمنية لكل Pull Requestكيف تكتب متطلبات أمان يمكن اختبارها مع OWASP ASVS، وتراجع كل طلب دمج أمنياً في عشرين دقيقة بقائمة جاهزة.
دليلمراجعة كود الذكاء الاصطناعي دون أن تصبح شكليةكيف تراجع طلبات الدمج التي يكتبها الذكاء الاصطناعي بحسب خطرها، وتترك للبوابات الآلية ما تستطيع قياسه.إذا أردت أن تفهم طرق الدمج الثلاث والتعارضات فاقرأ Git في العمل اليومي، وإذا كان فريقك يعيش مع فروع طويلة تتعارض يوم الإصدار فاقرأ التطوير على الفرع الرئيسي Trunk-Based، حيث تصبح الطلبات الصغيرة والمراجعة السريعة شرطاً للدمج اليومي.
الخلاصة Summary
- طلب الدمج هو المكان الذي يلتقي فيه الكود والنقاش والاختبارات والقرار، وحماية الفرع
mainهي ما يجعل المراجعة قاعدة وليست اقتراحاً. - فائدة المراجعة الأولى في الواقع هي نقل المعرفة ووعي الفريق، إلى جانب اكتشاف الأخطاء، ولها حدود: لا ترى إلا ما في الفروقات، ولا تحل محل الاختبارات والمراقبة.
- في التجربة رفض Gitea الدفع المباشر حتى للمدير، ورفض الدمج دون موافقة، وأسقط الموافقة تلقائياً عند Commit جديد، وكشف تعليق واحد على سطر فاتورة بقيمة سالبة.
- الكاتب يجعل طلبه صغيراً وموصوفاً ومراجعاً من نفسه، والمراجع يبدأ بالتصميم والسلوك ويترك التنسيق للأدوات، ويوافق عندما يصبح الكود أفضل وليس عندما يصبح مثالياً، ويرد خلال يوم عمل.
- اكتب التعليق عن الكود وليس عن الشخص، مع السبب، وقل بوضوح هل هو مانع أم اختياري.
سجل التحديثات Changelog
- نوفمبر 2026: كتابة المقال واختبار التجربة على Gitea 28.3.0 مع git 2.54.0 وPython 3 على Alpine 3.24.3.