آزر
0 من 10 خطوات
دليل التشغيل · آزر

أهلاً سيدي أحمد.
خطوة بخطوة، وبلا استعجال

هذا الدليل يمشي معك من الصفر — حتى لو ما فتحت «التيرمنال» في حياتك. كل خطوة: وش تنسخ، وين تلصق، وش تضغط، ووش بتشوف. اتبعها بالترتيب، وعلّم على كل واحدة تخلص.

أول مرة على التيرمنال؟ عادي تماماً — الدليل معك
0

تعرّف على التيرمنال٣٠ ثانية تطمئنك قبل ما نبدأ

«التيرمنال» شاشة تكتب فيها أوامر بسيطة للجهاز. هذي القواعد الخمس تكفيك:

  • تفتحه كذا: اضغط ⌘ + مسافة، اكتب Terminal، واضغط Enter. بتفتح شاشة فيها سطر ينتظرك.
  • كل أمر: تنسخه من هنا (زر «نسخ»)، تلصقه في التيرمنال، وتضغط Enter عشان يشتغل.
  • اللصق على الماك: ⌘ + V (مو Ctrl). لو ما لصق، جرّب من قائمة Edit → Paste.
  • لو طلع كلام كثير يمشي بسرعة — طبيعي. خلّه يخلّص لين يرجع السطر ينتظرك.
  • لو طلع كلام أحمر أو كلمة error — لا تخاف. انسخه كله والصقه لكلود وقل «طلع لي هذا، وش أسوي؟».
مطمئن: ما تقدر تكسر شي بالكتابة. أسوأ شي يطلع رسالة، ونعالجها. خذ راحتك.
تمرين — جرّب التيرمنال أول مرة
1 افتح التيرمنال 2 انسخ الأمر 3 الصقه ⌘V 4 Enter
echo مرحبا يا أحمد
وش بتشوفسطر جديد مكتوب فيه: مرحبا يا أحمد
1

جهّز حساباتك الثلاثةمفاتيحك لآزر — كلها باسمك

عشان كلود يبني تغيير حقيقي في آزر، يحتاج «مفاتيح» = حسابات. كلها باسمك أنت (منفصلة عن محمد).

  • حساب Claude (تسويه أنت الحين) — افتح claude.ai في المتصفح، سجّل بإيميلك، واشترك في خطة Max. هذا اللي يشغّل كلود.
  • حساب Cloudflare — محمد بيدعوك. بيوصلك إيميل «دعوة»، افتحه واضغط قبول، وسجّل دخول باسمك.
  • حساب GitHub — محمد بيدعوك. نفس الشي: إيميل دعوة → قبول.
ما تاخذ حسابات محمد ولا كلمات سره، وهو ما ياخذ حساباتك. كل واحد بحسابه.
2

ثبّت الأساساتبرنامجان يعتمد عليهم كلود — مرة وحدة وتنساهم

بنثبّت «Homebrew» (مدير برامج للماك) وبعده «Node». نسخ ولصق بس.

أول واحد Homebrew — انسخ، الصق في التيرمنال ⌘V، Enter
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
وش بتشوفبيسألك تضغط Enter عشان يكمّل، وبيطلب كلمة سر جهازك.
مهم وطبيعي: لما تكتب كلمة سر الجهاز، ما تظهر على الشاشة (ولا نجوم ولا شي) — هذا طبيعي في التيرمنال. اكتبها عادي واضغط Enter. بعدها بياخذ دقايق ويطلع كلام كثير — خلّه يخلّص.
بعده Node و GitHub — نفس الطريقة
brew install node gh
وش بتشوفكلام تحميل يمشي، وبعد دقيقة-دقيقتين يرجع السطر ينتظرك.
تمرين — تأكد إنها اشتغلت
1 انسخ 2 الصق ⌘V 3 Enter
node -v
وش بتشوفرقم مثل v22.3.0 (المهم يطلع رقم، مو رسالة خطأ).
3

ثبّت كلود وسجّل دخولالقلب — العقل اللي يشتغل معك

أول ثبّت كلود — انسخ، الصق ⌘V، Enter
npm install -g @anthropic-ai/claude-code
وش بتشوفكلام تحميل، وبعدها يرجع السطر ينتظرك.
بعده شغّل كلود
claude
وش بتشوفأول مرة بيفتح لك المتصفح عشان تسجّل دخول بحساب Claude حقك. سجّل، وارجع للتيرمنال — بتلقى كلود يرحّب فيك.
ملاحظةللخروج من كلود أي وقت: اكتب /exit واضغط Enter. ولرجوعه: اكتب claude.
تمرين — تأكد إنه اشتغل معك

وكلود شغّال، اكتب له أي شي واضغط Enter، مثلاً:

السلام عليكم، تشتغل معي؟
4

نزّل مجلد آزر وجهّز عقل كلودهنا كلود يصير «يعرف آزر»

كلود العادي ذكي، بس عشان يعرف آزر (الهوية، القواعد، طريقة الشغل) نزوّده بـ«العقل». كله جاهز في مجلد واحد يعطيك محمد رابطه.

قبل ما تبدألو كلود شغّال، اخرج منه أول: اكتب /exit واضغط Enter. لأن الأوامر الجاية للتيرمنال مو لكلود.
1 سجّل دخول GitHub — مرة وحدة بس (عشان تقدر تنزّل مجلدات آزر الخاصة)
gh auth login
وش بتشوفبيسألك أسئلة — جاوب بالترتيب واضغط Enter بعد كل وحدة: اختر GitHub.comHTTPSY (نعم) ← Login with a web browser. بيعطيك رمز — انسخه، بيفتح المتصفح، الصقه ووافق. بعدها ارجع للتيرمنال.
للتنقّل بين الخيارات: استخدم أسهم لوحة المفاتيح (↑ ↓) ثم Enter على اللي تبيه.
2 نزّل مجلد آزر — انسخ الكل، الصق ⌘V، Enter
cd ~ git clone https://github.com/mhmmdalmutairi/azr-onboarding.git cd azr-onboarding
وش بتشوفكلام تحميل بسيط، وبعدها يرجع السطر (وتصير «داخل» المجلد).
3 شغّل الإعداد — يركّب المهارات والإعدادات تلقائياً
bash ١-الإعداد/setup.sh
وش بتشوفرسائل فيها ✓ (نُسخ كذا، نُسخ كذا)، وفي الآخر يقول لك «خلص الإعداد الأساسي» + خطوتين بسيطتين.
خطوة التوكنات: الإعداد بيطلب منك تحط «توكناتك» (مفاتيح Cloudflare و GitHub) في ملفين. لا تتوتّر — افتح كلود وقل له: «ساعدني أحط توكناتي في الإعدادات»، وهو يمشي معك خطوة بخطوة.
تمرين — تأكد إن العقل ركّب

شغّل كلود (claude)، واكتب له:

وش مهارات آزر المتوفرة عندك؟
5

جرّب أول طلب حقيقيتكلّمه بالعربي، وهو يشتغل

خلّنا نفتح البوابة (مكان عمل آزر اليومي) ونجرّب.

في التيرمنال (اخرج من كلود أول بـ/exit لو شغّال) — انسخ الكل، الصق، Enter
cd ~ git clone https://github.com/mhmmdalmutairi/azr-portal.git cd azr-portal claude
وش بتشوفالبوابة تتنزّل، وبعدها كلود يفتح وهو «داخل» مشروع البوابة.
تمرين — أول سؤال حقيقي لكلود
اشرح لي وش تسوي البوابة، وكم جدول في قاعدة بياناتها؟
من هنا رايح: أي شي تبيه، قوله لكلود بالعربي («عدّل كذا»، «أضف كذا»). هو يكتب الكود، وأنت تقرّر.
6

كيف تنشر تعديلكيصير حيّاً على الموقع

لما تعتمد تعديلاً، ما تحتاج تعرف أوامر — بس قل لكلود:

انشر التعديل، وتأكد إنه نزل صح.
وش يسوي كلودينشر، ويتحقق من المحتوى الفعلي (مو بس رسالة «نجاح») — وهذي قاعدة عندنا.
القاعدة: النشر دائماً مع تحقّق بالمحتوى. كلود يعرفها، بس ذكّره لو نسي.
7

مساحتك — جرّب بلا خوفتضيف وتجرّب بلا ما تكسر شي

عندك مساحة خاصة تجرّب فيها، بلا ما تأثّر على البوابة الحيّة. تديرها بالكلام:

  • «جهّز لي مساحة تجريب لخاصية كذا» → كلود يعطيك نسخة معزولة تجرّب فيها.
  • «رقّها للإنتاج بس تظهر لحسابي فقط» → تشوفها أنت بس، لين تتأكد.
  • «عمّمها للجميع» → تصير للكل.
القاعدة الذهبية: جرّب في مساحتك — ما يوصل الإنتاج إلا بترقية واعية منك.
8

الخطوط الحمراءبسيطة، بس مهمة

  • الاستضافة Cloudflare دائماً — لا Vercel.
  • أي سر (كلمة مرور/توكن) ما يُكتب في ملف — يُحفظ بمكان آمن.
  • روابط العملاء من البوابة حصراً.
  • النشر دائماً مع تحقّق بالمحتوى.
  • البريد البارد مسودات — محمد يراجعها ويرسلها.
9

جاهز — أفكار لدوركخصائص تخدمك كرئيس تنفيذي

صرت جاهز. هذي أفكار تبنيها/تجرّبها في مساحتك، ولو عجبتك ترقّيها:

لوحة القيادةإيراد + صفقات + مشاريع + ما ينتظر قرارك
صندوق الاعتماداتتسعير وعروض تعتمدها بضغطة
مؤشر صحة الأنبوبالفرص العالقة ومنذ متى
سجل القراراتكل قرار موثّق: متى وليش
نبض العلاقاتمين يحتاج تواصل، فرص مهملة
تقريرك الأسبوعيملخص الأسبوع يوصلك تلقائياً

جرّب تقول لكلود: «ابنِ لي في مساحتي التجريبية لوحة قيادة تنفيذية».