المدونة
مقالات عملية مرتبة حسب المجال والمستوى، اختر المجال المناسب واقرأ من مستوى مبتدئ إلى محترف.
Batch API في Claude للمتوسط: وفّر 50% لو شغلك مش real-time
لو بتبعت 50 ألف طلب شهرياً لـ Claude API علشان تترجم تذاكر دعم أو تلخّص PDFs، أنت بتدفع ضعف اللي محتاجه. Batch API بيخفّض الفاتورة 50% بشرط واحد: الرد ممكن يستنى ساعة بدل ثانية. مقال للمتوسط بمثال المطبعة للمبتدئ، كود Python شغّال على anthropic SDK 0.49+ و Claude Sonnet 4.6، حساب فعلي على workload عربي بـ 42K طلب شهرياً، 4 trade-offs خفية، ومتى Batch API بيكون قرار غلط.
اعمل Real-time Dashboard بـ Server-Sent Events في Node.js — بديل WebSocket في 60 سطر
لو dashboard المراقبة بياخد polling كل ثانية و 800 مستخدم مفتوحينه، السيرفر بياخد 800 طلب/ثانية مالهومش لزمة. Server-Sent Events بسطرين Express بيخلّوا السيرفر يدفع التحديثات للمتصفح لحظة حدوثها، بدون WebSocket ولا مكتبات client. دليل تنفيذي للمتوسط في 60 سطر، شرح علمي من WHATWG HTML Living Standard، كود Node.js 22 + Express 5 شغّال، أرقام مقاسة على Hetzner CPX21 (الـ CPU من 47% لـ 2.1%، الـ bandwidth -92%)، 4 trade-offs خفية، ومتى SSE اختيار غلط.
Cloudflare Tunnel للمتوسط: افتح خدمتك المحلية للعالم بدون Port Forwarding في 6 دقائق
دليل تنفيذي للمتوسط لإعداد Cloudflare Tunnel على Raspberry Pi أو لاب توب — افتح خدمتك للإنترنت بدون port forwarding ولا VPN ولا IP عام مكشوف، مع أرقام مقاسة من 60 يوم إنتاج، 4 trade-offs خفية، ومتى الطريقة دي مش الحل أصلاً.
Debounce و Throttle للمتوسط: من 10 طلبات API لطلب واحد بسطرين
صندوق البحث اللي بيبعت طلب مع كل حرف بيهدر 90% من طلباته على الفاضي. Debounce و Throttle بيحلّوا ده بسطرين JavaScript. شرح للمتوسط بمثال المصعد والأتوبيس، كود جاهز للنسخ، أرقام توفير حقيقية، 4 trade-offs، ومتى الاتنين يكونوا اختيار غلط.
Event Loop في JavaScript للمتوسط: ليه setTimeout(0) مش بيتنفّذ فورًا
لو كتبت setTimeout(fn, 0) وفاكرها هتشتغل حالًا، في عندك bug صامت مستنّي وقته. المقال يشرح الـ Event Loop للمتوسط: الفرق بين microtask و macrotask، ليه Promise بيسبق setTimeout، كود يثبت الترتيب، سيناريو واجهة بتتجمد بسبب microtask starvation، 4 trade-offs، ومتى ميهمكش الموضوع أصلًا.
PgBouncer Transaction Pooling للمتوسط: من 8,400 connection error/دقيقة إلى صفر
لو الـ API بتاعك بيرجّع FATAL: too many clients already وقت الذروة، PostgreSQL مش ضعيف — انت بتفتح 1,200 connection على DB قابل لـ 100 فقط. PgBouncer 1.23 في transaction mode بيخلّي 1,000 طلب متزامن يشتغلوا على 25 connection حقيقي، وبيقلّل connection errors من 8,420 في الدقيقة لـ صفر، مع نزول P95 من 480ms لـ 28ms. مقال للمتوسط بمثال المطعم للمبتدئ، شرح علمي للـ 3 modes من توثيق PgBouncer 1.23 الرسمي، إعداد كامل قابل للنسخ، كود Node.js شغّال على pg 8.x، أرقام مقاسة من إنتاج 1,240 req/sec، 4 trade-offs خفية بما فيهم prepared statements و LISTEN/NOTIFY، ومتى Transaction Pooling بيكون مضيعة وقت.
TypeScript Discriminated Unions للمتوسط: امنع 87% من type errors في الـ state machines بـ tag واحد
لو state machine في تطبيق React بيلطّخك بـ "Cannot read property 'data' of undefined" كل أسبوع، المشكلة مش في الـ runtime — هي إن TypeScript مش قادر يفرّق بين حالات الـ state. Discriminated Union بـ tag واحد بيخلّي الـ compiler يضمنلك إن state.data بس متاحة لما الحالة تكون success. مقال للمتوسط بمثال إشارة المرور للمبتدئ، شرح علمي من TypeScript Handbook و sum types، كود شغّال على TS 5.6 و React 19، أرقام مقاسة من dashboard مالي بـ 24 مكوّن state-driven (type errors من 47/أسبوع لـ 6، bugs الإنتاج من 8 لـ 1 في 90 يوم)، 4 trade-offs خفية، ومتى Discriminated Union مبالغة هندسية.
Passkeys و WebAuthn للمتوسط: ابني login آمن بدون passwords في 90 سطر Node.js
دليل تنفيذي للمتوسط لاستبدال كلمة المرور بـ Passkey واحدة باستخدام WebAuthn. مثال المفتاح الذكي للمبتدئ، شرح علمي من W3C Recommendation 2024، كود Node.js شغّال على @simplewebauthn/server 10، أرقام مقاسة من منصة عربية بـ 14,200 مستخدم نشط، 4 trade-offs خفية، ومتى Passkeys بتكون اختيار غلط.
Redis Pipelining للمتوسط: من 12K لـ 290K SET/ثانية بسطر
لو خدمتك بتعمل 12,400 SET/ثانية على Redis و CPU الـ client على 92%، المشكلة في round-trips مش في Redis. Pipelining بسطر بايثون واحد بيرفع الرقم لـ 290,300 SET/ثانية على نفس السيرفر. شرح للمتوسط بمثال موظف الدليفري للمبتدئ، تعريف علمي من توثيق Redis 7.4 الرسمي، كود Python شغّال على redis-py 5.0.8، أرقام إنتاج من خدمة authentication، 4 trade-offs خفية، ومتى Pipelining بيكون كارثة.
stale-while-revalidate للمتوسط: API response في 4ms بدل 380ms بسطر Cache-Control
لو الـ API بياخد 380ms كل ما الـ cache يخلص ويستنى refresh، Cache-Control: stale-while-revalidate بـ سطرين بيخلّي 99% من الطلبات ترجع في 4ms والـ refresh في الخلفية. مقال للمتوسط بمثال المخبز للمبتدئ، شرح علمي من RFC 5861، إعداد Nginx و Cloudflare Workers قابل للنسخ، أرقام من API بـ 1.2 مليون طلب يوميًا، 4 trade-offs خفية، ومتى الـ stale-while-revalidate يكون مضيعة وقت.