مسار قواعد البيانات 💯

مسار تعليمي يُمكّن المهتمين بمجال قواعد البيانات من بناء فهم راسخ لأساسيات قواعد البيانات، واكتساب مهارات SQL المتقدمة، والتعامل بكفاءة مع قواعد البيانات باستخدام MongoDB، بالإضافة إلى إدارة البيانات وتخزينها عبر Firebase بأسلوب احترافي وعملي.

———

📌 المهارات المكتسبة من المسار:

- القدرة على اختيار نوع قاعدة البيانات المناسب حسب المشروع.
- التمييز بين قواعد البيانات: Structured Data & UnStructured Data.
- مهارات التعامل مع SQL.
- مهارات التعامل مع MongoDB.
- إدارة قواعد البيانات باستخدام Firebase.
- كتابة استعلامات CRUD (Create, Read, Update, Delete).
- ربط قواعد البيانات مع تطبيقات الويب أو الموبايل.

———

📌 رابط المسار:
https://satr.tuwaiq.edu.sa/path/BDwtRrEpyD/view

تعال ندردش شوية عن الـ JSDoc 💯
.
.
لو أنت شغال بـ JavaScript أو TypeScript ممكن تبقى سمعت مصطلح الـ JSDoc

خليني أقولك إن شغلك ممكن يكون جامد جدًا، لكن لو الكود بتاعك مش موثق كويس (Well Documented)، هتبقى بتعذب الشخص اللي هيشتغل عليه بعدك، وممكن حتى "أنت" نفسك تتعذب لو رجعتله بعد فترة. وهنا بقى بييجي دور JSDoc. 💡

———

📌 إيه هو الـ JSDoc؟

الـ JSDoc ببساطة هو tool أو مكتبة بتسمحلك تكتب documentation داخل الكود نفسه باستخدام comments. الفكرة إنه يخليك تشرح الكود بتاعك بشكل structured ومفهوم لأي حد يقرأه.

والأجمل إنه كمان بيساعدك لو بتشتغل بـ TypeScript أو حتى JavaScript عشان يحسن تجربة الكتابة بـ IDE زي VSCode.

———

📌 ليه تستخدم الـ JSDoc؟

✅ الـ Documentation هتكون واضحة وسهلة:
الكود بتاعك ممكن يكون معقد أو فيه لوجيك معقد شوية. باستخدام JSDoc، تقدر توضح إيه اللي الكود بيعمله، إيه الـ inputs اللي بياخدها، وإيه الـ output اللي بيرجعه.


✅ هتلاقي Autocomplete محترم:
لو بتكتب الكود في IDE زي WebStorm أو VSCode، الـ JSDoc comments بتساعدك بـ Autocomplete رهيب. يعني لو كودك معقد شوية، هيبقى سهل جدًا تعرف إيه الـ properties أو الـ methods المتاحة وأنت بتكتب.


✅ تحسين الـ Type Checking:
لو بتشتغل بـ JavaScript ومش TypeScript، الـ JSDoc ممكن يديك تقريبًا نفس الفائدة اللي TypeScript بتقدمها من ناحية الـ types (مش بنفس القوة طبعًا، بس حاجة محترمة).


✅ لو شغال في تيم، الـ documentation اللي بتكتبها بـ JSDoc بتوفر على زمايلك وقت كبير في فهم الكود، وده بيقلل الـ technical debt بشكل كبير.

———

💡 إزاي تبدأ مع الـ JSDoc؟

الموضوع بسيط جدًا هتدخل على الموقع ده وتبدأ تشوف الأجزاء اللي عاوز تعملها توثيق (Documentation) سواء كانت Function أو Object Types أو Classes
https://jsdoc.app

وده مقال لذيذ فيه شوية معلومات حلوة:
https://dev.to/alisamir/a-comprehensive-guide-to-jsdoc-3meb

———

💯 نصائح وإرشادات:

- بلاش توثق حاجات بديهية، يعني لو عندك function اسمها add، مش محتاج تكتب "دي بتجمع حاجتين" لو اسمها واضح. استخدم الـ JSDoc للحاجات اللي فعلًا محتاجة توضيح.
- خلي التعليقات (Comments) بتاعتك قصيرة ومباشرة.

———

وفقكم الله لكل خير 🌿

مجموعة مدونات تقنية مميزة في مجال هندسة البرمجيات 🔻

الريبو ده فيه مجموعة من أفضل المدونات اللي هتعلمك كل حاجة عن البرمجة والتقنيات المختلفة. 🌐

Software Engineering Blogs ✍️

A curated list of engineering blogs

https://github.com/kilimchoi/engineering-blogs