آزر
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
وش بتشوفرسائل فيها ✓ (نُسخ كذا، نُسخ كذا)، وفي الآخر يقول لك «خلص الإعداد الأساسي» + خطوتين بسيطتين.
4 سجّل دخولك لـCloudflare — يفتح المتصفح، بلا أي مفتاح
npx wrangler login
وش بتشوفبيفتح المتصفح على صفحة Cloudflare وتسألك تسمح — اضغط Allow. بعدها يرجع التيرمنال ويقول Successfully logged in. خلاص.
قاعدة ما تنكسر — اقرأها مرتين: ما تكتب مفتاحاً ولا كلمة سر في أي مكان — لا في ملف، ولا في محادثة كلود. كل دخولاتك في آزر تصير بالمتصفح بالأمرين اللي فوق (gh auth login و npx wrangler login) — وهذولا يحفظونها لك بمكان آمن على جهازك.

لو لصقت مفتاحاً في محادثة، يعتبر انكشف ولازم يُلغى ويُسوّى غيره — لأن المحادثة تُحفظ. ولو طلب منك أي شيء مفتاحاً مكتوباً: توقّف واسأل محمد.
تمرين — تأكد إن العقل ركّب

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

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

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

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

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

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

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

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

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

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

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

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

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

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

صرت جاهز. وقبل الأفكار — في شيء جاهز لك من الحين.

لوحة تحكّم آزر — مبنية وشغّالة، ولك فيها أعلى دور
admin.azr.studio
كيف تدخلبيطلب منك إيميل وكلمة مرور. اترك خانة الإيميل فارغة، واكتب كلمة المرور في الخانة الثانية بس. دورك مسجّل فيها «الرئيس التنفيذي» — وهو الدور الوحيد اللي يعتمد التسعير.
كلمة المرور: يعطيك إياها محمد مباشرة — وجهاً لوجه أو باتصال. لا تكتبها في محادثة كلود ولا في أي شات، نفس قاعدة الخطوة ٤.

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

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

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