system-prompts-and-models-of-ai-tools/dealix/QUICK_START.md

🚀 الخطوات السريعة — ارفع المشروع على GitHub في دقيقة واحدة

الطريقة الأسهل — سكربت جاهز

# 1. فك الضغط
tar -xzf ai-company-saudi-v2.0.0.tar.gz
cd ai-company-saudi

# 2. تأكد أن gh CLI مثبت ومسجّل دخولك
#    (اختياري لكنه الأسهل)
gh auth login

# 3. شغّل السكربت (عدّل اسم المستخدم)
GITHUB_USER=your-github-username \
REPO_NAME=ai-company-saudi \
VISIBILITY=private \
bash scripts/github_setup.sh

السكربت يقوم بـ:

1. فحص أمني — يتأكد ما فيه أي سر مكشوف
2. git init وإنشاء commit أول شامل
3. إنشاء الريبو على GitHub (خاص افتراضياً)
4. رفع الفرع main
5. إنشاء tag v2.0.0 ورفعه
6. إنشاء GitHub Release مع CHANGELOG

---

الطريقة اليدوية — إذا تبغى تتحكم بكل خطوة

tar -xzf ai-company-saudi-v2.0.0.tar.gz
cd ai-company-saudi

# تأكد إن .env ما موجود (لازم تبقى بس .env.example)
ls .env 2>/dev/null && echo "⚠️ احذف .env قبل ما تكمل!"

# Initialize
git init -b main
git add -A
git commit -m "feat: initial release v2.0.0"

# أنشئ الريبو على github.com يدوياً ثم:
git remote add origin git@github.com:YOUR-USER/ai-company-saudi.git
git push -u origin main

# الـ tag
git tag -a v2.0.0 -m "Release v2.0.0"
git push origin v2.0.0

---

بعد الرفع — خطوات GitHub مهمة

1. فعّل Branch Protection على main

Settings → Branches → Add rule:

• Require pull request reviews (1 reviewer)
• Require status checks to pass (CI job)
• Require conversation resolution
• Do not allow force pushes

2. فعّل الحماية الأمنية

Settings → Code security:

• ✅ Dependency graph
• ✅ Dependabot alerts
• ✅ Dependabot security updates
• ✅ Secret scanning
• ✅ Push protection (for secrets)

3. أضف Secrets للـ CI (اختياري للاختبارات)

Settings → Secrets and variables → Actions:

• ANTHROPIC_API_KEY (للاختبارات التي تستدعي LLM فعلياً)
• CODECOV_TOKEN (لرفع تقارير التغطية)

4. فعّل GitHub Actions

في أول push، اذهب إلى Actions tab وتأكد إن CI workflow نجح.

---

⚠️ مهم جداً قبل أي شيء

المفاتيح اللي كانت في ملف PROJECT_FULL_REPORT.md الأصلي تسرّبت مسبقاً. لازم تدوّرها كلها قبل استخدام المشروع:

المزود	الرابط
Anthropic	https://console.anthropic.com/settings/keys
DeepSeek	https://platform.deepseek.com/api_keys
Groq	https://console.groq.com/keys
GLM (Z.ai)	https://open.bigmodel.cn/usercenter/apikeys
Google	https://console.cloud.google.com/apis/credentials
HubSpot	Settings → Integrations → Private Apps
ClickBank	Account Settings → API
HIX AI	Account → API

بعد التدوير، ضعها في .env محلياً (ما ترفع .env أبداً) وفي GitHub Secrets للـ CI.

---

الأوامر الأساسية بعد الرفع

# إعداد التطوير المحلي
make setup

# تشغيل محلي
make run                    # على http://localhost:8000/docs

# اختبارات
make test

# Docker كامل
make docker-up

# CLI تفاعلي
python cli.py menu
# أو
python cli.py demo          # عرض توضيحي شامل
python cli.py sector healthcare -e
python cli.py status