اعمل URL Shortener بـ Node.js: من رابط طويل لكود قصير في 60 سطر

1. اكتب دالتين للتحويل بين الرقم والكود. الأولى بتحوّل الرقم لكود Base62، والتانية بترجّعه. النتيجة: toBase62(1000000) بيرجّع '4c92'.

1. اعمل نقطة إنشاء الرابط القصير. بتاخد رابط طويل، تتحقق إنه صالح، تخزّنه، وترجّع الكود. النتيجة: طلب POST بيرجّعلك { "short": "http://localhost:3000/1", "code": "1" }.

1. اعمل نقطة إعادة التوجيه. دي قلب الخدمة: بتاخد الكود، تحوّله لرقم، تجيب الرابط، تزوّد النقرات، وتعمل 301. النتيجة: فتح الرابط القصير بيوصّلك للأصلي فورًا.

خلّي بالك من نقطة مهمة في الكود ده: إحنا بنجيب الرابط بـ WHERE id = ? على المفتاح الأساسي. ده بيخلّي البحث في خانة مفهرسة، فبياخد أقل من مللي ثانية حتى لو عندك عشرات الآلاف من الروابط، مش بيمر على كل صف.

التحقق من أنه يعمل

شغّل السيرفر بـ node app.js، وبعدين جرّب من طرفية تانية:

لو شفت في رد الأمر الأخير سطر HTTP/1.1 301 Moved Permanently وسطر Location: فيه رابطك الطويل، يبقى كل حاجة شغّالة. افتح الكود في المتصفح هيوديك على الصفحة الأصلية على طول.

الـ trade-offs اللي لازم تعرفها

كل قرار هنا معاه ثمن، وده اللي بيفرق المشروع التعليمي عن الجاهز للإنتاج:

• 301 مقابل 302. الـ 301 بيتخزّن في كاش المتصفح، فبتكسب سرعة وتقليل حِمل على سيرفرك. بتخسر إن عدّاد النقرات مش هيزيد بعد أول ضغطة (المتصفح مش بيرجعلك)، وكمان مش هتقدر تغيّر وجهة الرابط بعدين بسهولة لأنها اتخزّنت. لو محتاج إحصائيات دقيقة أو مرونة في تغيير الوجهة، استخدم res.redirect(302, ...) واقبل إن كل ضغطة هتضرب سيرفرك.
• الكود التسلسلي مكشوف. بما إن الكود جاي من رقم بيزيد 1، 2، 3، أي حد يقدر يخمّن الأكواد ويسحب كل روابطك بالترتيب. بتكسب أكواد قصيرة ومرتبة، بتخسر الخصوصية. لو ده مهم، ولّد كود عشوائي أو ابدأ العدّاد من رقم كبير.
• SQLite متزامن (synchronous). better-sqlite3 سريع وبسيط جدًا على سيرفر واحد، بس هو بيقفل أثناء الكتابة. الافتراض هنا إن حِملك أقل من بضعة آلاف طلب في الثانية على عقدة واحدة. فوق كده فكّر في PostgreSQL و connection pool.

متى لا تستخدم هذه الطريقة

متبنيش مختصر روابط بنفسك لو محتاجه على نطاق ضخم متعدد المناطق، أو محتاج لوحة تحليلات جاهزة، أو مميزات فرق ومشاركة. في الحالات دي خدمات زي Bitly أو Dub أو Rebrandly هتوفّرلك شهور شغل. الطريقة دي مثالية للتعلّم، وللأدوات الداخلية، ولما تحب تملك بياناتك بالكامل على دومين بتاعك، وده بالظبط اللي بيبحث عنه ناس كتير.

الخطوة التالية

غيّر سطر واحد بس: خلّي res.redirect(301, ...) يبقى res.redirect(302, ...)، وبعدين افتح نفس الرابط القصير 3 مرات وشوف عمود clicks في قاعدة البيانات بيزيد ولا لأ. الفرق اللي هتشوفه بين الحالتين هيثبّتلك فكرة الكاش والـ 301 بشكل عملي أكتر من أي شرح.

مصادر

• MDN Web Docs — 301 Moved Permanently (شرح كود 301 وسلوك الكاش).
• RFC 9110 — HTTP Semantics: Redirection 3xx (تعريف 301 و302 رسميًا).
• Express — توثيق res.redirect.
• better-sqlite3 — توثيق الـ API (الاستعلامات المتزامنة و prepared statements).
• Node.js — توثيق وحدة http.