AgentForge | مسبك الوكلاء

Interactive AI Skills Platform — مركز قيادة تعلّم الذكاء الاصطناعي (عربي RTL)

ليست أكاديمية فيديوهات ولا موقع كورسات: منصة تعلم تفاعلية يقود فيها المستخدم رحلة تدريب عملية مع 30 موجه AI متخصص (AI Mentors) — تتعلم، تنفّذ على الأداة الحقيقية، ترفع الأدلة، تُقيَّم بمعايير معلنة، تصحح أخطاءك، وترتقي بالصعوبة تلقائياً حتى تبني دليل مهارة موثقاً.

المنهجية: تعلّم ← نفّذ ← أثبت ← تقييم ← صحّح ← ارتقِ الشعار التجاري: تعلّم. نفّذ. أثبت.

---

محرك التعلم (Learning Engine) — القلب الجديد

المكوّن	ماذا يفعل
30 موجه AI	مدرب عام يرى كل الأدوات + موجه متخصص لكل أداة (ChatGPT, Gemini, DeepSeek, Qwen, Kimi, Grok, MiniMax, MiMo, GLM, Claude, Perplexity, Le Chat, HuggingChat, VS Code, Copilot, Cursor, Codex, Gemini CLI, Antigravity, Cline, Roo Code, Windsurf, Trae, Claude Code, Qwen Code, OpenCode, Ollama, LM Studio, Open WebUI, Continue, n8n, Dify, Flowise, Langflow)
165 مهمة تقييمية	بنك مهام بـ8 مستويات صعوبة (شاهد→املك): تنفيذ خارجي على الأداة ثم رفع أدلة ثم تقييم
مقيّم تقواعدي شفاف	Rubrics معلنة (أوامر/بحث/تحليل/استدلال/برمجة/أتمتة/محلي) — يحلل بنية الأدلة ويشرح كل درجة. لا انتحال صفة LLM ولا بث مصطنع
صعوبة تكيفية	الصعوبة التالية تتحدد بدرجاتك وتاريخ محاولاتك مع سقف تدرّج (لا قفز)
9 مهارات مرصودة	هندسة الأوامر، البحث، تحليل الصور، الاستدلال، اختيار الأداة، إدارة الوكلاء، وكلاء البرمجة، الأتمتة، الذكاء المحلي — والمستوى الإجمالي «مشغّل AI»
ملف إنجاز + XP + Streak	أدلة موثقة قابلة للتصدير JSON، شهادات مسارات، أفضل الأعمال
تهيئة شخصية	أسئلة أول دخول (مستوى/هدف/جهاز/ذاكرة/كرت) → خطة مراحل مخصصة
قاعدة معرفة	مفاهيم وأدلة ومقارنات صادقة ومسرد وقواعد أمان الوكلاء + موارد خارجية موثوقة

قواعد حاكمة: لا مفاتيح API في الواجهة أبداً • لا ميزات وهمية (fake streaming/evaluations ممنوعة) • «مجاني» لا يُقال إلا بعد تحقق من المصدر الرسمي • static-first: كل المحرك يعمل في المتصفح على GitHub Pages، وعند تشغيل الخادم تُفعَّل المزامنة المركزية تلقائياً.

---

الأكاديمية (المحتوى التعليمي المحفوظ)

أول أكاديمية عربية تجارية حقيقية لإتقان منصات ووكلاء الذكاء الاصطناعي — من أول محادثة مع شات بوت مجاني، حتى تشغيل النماذج المحلية على جهازك وإدارة سرب وكلاء يعملون عنك.

---

ما الذي يميز هذه المنصة؟

• 35 درساً عربياً كاملاً موزعة على 6 مسارات متدرجة — محتوى حقيقي عميق (700-1200 كلمة للدرس) بأهداف وخلاصات وتمارين عملية واختبارات تفاعلية بعد كل درس.
• 33+ أداة مجانية 100% مُنتقاة ومُجرّبة: ChatGPT، Gemini، DeepSeek، Qwen، Kimi، Grok، MiniMax، GLM، MiMo، Claude، Antigravity، Cursor، VS Code + Copilot، Codex، Cline، Ollama، LM Studio، Open WebUI، n8n، Langflow، Flowise، Dify وأكثر.
• شهادات إتمام تلقائية باسم الطالب ورقم تحقق فريد، قابلة للطباعة PDF.
• نظام اشتراكات تجاري كامل: خطة مجانية سخية + Pro شهري/سنوي + أكواد مؤسسين + جاهزية Stripe Payment Links.
• تسجيل دخول حقيقي: حسابات بريد مشفّرة (scrypt) + تسجيل دخول جوجل عبر Google Identity Services مع تحقق توقيع RS256 على الخادم.
• ويندوز أولاً: كل خطوات التنصيب والتشغيل مكتوبة لويندوز خطوة بخطوة.

المسارات الستة

#	المسار	المحتوى
1	أساس الذكاء الاصطناعي للجميع (مجاني بالكامل)	كيف يفكر النموذج، الشات بوت مقابل الوكيل، السياق والتوكنات والهلوسة، خريطة أدوات 2025
2	احترف الشات بوتات المجانية	العمالقة الثلاثة، الثورة الصينية المفتوحة، التخصصات، البحث الحي والتحليل العميق، المشروع المقارن
3	هندسة الأوامر	الصيغة الذهبية، Few-shot وسلسلة الأفكار، الإخراج المنظم، أوامر النظام، مكتبة برومبتات شخصية
4	وكلاء البرمجة	VS Code وCopilot المجاني، Cursor وWindsurf وTrae، Antigravity وGemini CLI وCodex CLI، Cline وRoo Code، مشروع موقع كامل
5	النماذج المحلية على ويندوز	LM Studio، دليل الرامات واختيار النموذج، Ollama، Open WebUI، ربط Continue بـ VS Code، مختبر محلي كامل
6	وكلاء الأتمتة	فلسفة الأتمتة، n8n محلياً، Langflow وFlowise، Dify، ربط APIs المجانية، وكيل يراقب ويلخّص ويبلّغ

البنية التقنية

Next.js 16 (App Router) + TypeScript + Tailwind CSS 4 + shadcn/ui
├── الواجهة: SPA كاملة بـ RTL عربي + Framer Motion + راوتر هاش (#/learn، #/lesson/…)
├── المحتوى: بيانات ثابتة TypeScript (src/data) — تعمل في كل الأوضاع
├── الخادم: API Routes + Prisma (SQLite) + مصادقة JWT موقّعة HMAC + scrypt
├── جوجل: GIS زر رسمي + تحقق credential عبر مفاتيح جوجل الرسمية
└── وضعان للتشغيل (نفس الكود):
    ├── وضع الخادم: كل شيء في قاعدة البيانات (dev/إنتاج)
    └── الوضع الثابت: كل شيء في localStorage (GitHub Pages)

الوضعان — كيف يعملان؟

عند إقلاع المنصة تجرّب /api/auth/me:

• 401 → الخادم حي (وضع الخادم): الحسابات والتقدم والاشتراكات في قاعدة البيانات.
• فشل شبكي/404 (استضافة ثابتة) → الوضع المحلي: الحسابات والتقدم في localStorage للمتصفح — المنصة تعمل بالكامل حتى بلا خادم، وتسجيل الدخول بجوجل يعمل عبر GIS مباشرة من المتصفح.

هذا يعني أن نفس المستودع يخدم:

1. إنتاجاً كاملاً على أي خادم Node (Vercel، Railway، VPS…) — حسابات مركزية وقاعدة بيانات.
2. GitHub Pages — نسخة ثابتة كاملة تعمل بجهاز الزائر.

التشغيل السريع (تطوير)

bun install
cp .env.example .env        # عدّل ما يلزم (AUTH_SECRET مهم)
bun run db:push             # إنشاء جداول قاعدة البيانات
bun run dev                 # http://localhost:3000

أول حساب يُسجَّل في قاعدة البيانات يصبح مدير المنصة تلقائياً.

النشر على GitHub Pages (مفعّل تلقائياً)

كل دفعة إلى main تشغّل GitHub Action يبني النسخة الثابتة وينشرها إلى:

https://ps-community.github.io/agentforge/

• المسار: Actions → Deploy to GitHub Pages — النشر تلقائي.
• على Pages تعمل المنصة بالوضع المحلي: الحسابات والتقدم داخل متصفح كل زائر، وتسجيل الدخول بجوجل يعمل بعد إضافة NEXT_PUBLIC_GOOGLE_CLIENT_ID (انظر أدناه).
• للترقية التجارية المركزية انشر نفس المستودع على Vercel/Railway بلا أي تعديل.

تفعيل تسجيل الدخول بجوجل (خطوات المالك)

1. افتح Google Cloud Console وأنشئ مشروعاً.
2. APIs & Services → OAuth consent screen: اختر External وأكمل الحقول الأساسية.
3. Credentials → Create Credentials → OAuth client ID → Web application.
4. في Authorized JavaScript origins أضف:
   • http://localhost:3000
   • https://ps-community.github.io
5. انسخ Client ID وضعه في .env:

   NEXT_PUBLIC_GOOGLE_CLIENT_ID=xxxxxxxx.apps.googleusercontent.com
   

6. أعد التشغيل — زر جوجل الرسمي سيظهر في نافذة الدخول فوراً (لا حاجة لـ Client Secret).

تفعيل الدفع (Stripe Payment Links)

1. أنشئ حساب Stripe وأكمل التحقق.
2. Payment Links → + new: أنشئ رابطاً لخطة شهرية ($9) وآخر سنوي ($69).
3. ضع الروابط في .env:

   STRIPE_LINK_MONTHLY=https://buy.stripe.com/...
   STRIPE_LINK_YEARLY=https://buy.stripe.com/...
   

4. عند إتمام الدفع يرجع المشترك لموقعك — ولتفعيل اشتراكه تلقائياً بالكامل أضف لاحقاً Webhook على /api/subscription/webhook (البنية جاهزة في /api/subscription/checkout).

أكواد المؤسسين

المئة الأول يحصلون على Pro مدى الحياة بكود يدوي تتحكم به كلياً:

FOUNDER_CODES=FOUNDER-2025,AGF-FOUNDER   # غيّرها ودوّرها كما تشاء

تُفعَّل من صفحة «الخطط والترقية» داخل المنصة.

هيكل المشروع

src/
├── app/
│   ├── page.tsx                 # الجذر (يحمّل PlatformRoot)
│   └── api/                     # auth (register/login/logout/google/me)
│                                # progress، subscription (redeem/checkout)
│                                # stats، tracks، tools، waitlist
├── components/
│   ├── platform/                # صفحة الهبوط (hero، tracks، tools، pricing…)
│   ├── auth/auth-dialog.tsx     # نافذة الدخول/التسجيل + زر جوجل GIS
│   ├── app/                     # التطبيق: shell، dashboard، track، lesson…
├── data/
│   ├── content.ts               # 6 مسارات + 35 درس + 33 أداة (مصدر الحقيقة)
│   ├── lessons/                 # محتوى الدروس الكامل (35 ملف درس مُجمّع)
│   └── pricing.ts               # الخطط والأكواد
├── lib/
│   ├── auth-server.ts           # scrypt + JWT HMAC + تحقق جوجل RS256
│   ├── store.ts                 # zustand (وضع خادم/محلي)
│   └── navigation.ts
└── prisma/schema.prisma         # User، Subscription، Progress، Track، Lesson، Tool

الأمان

• كلمات المرور: scrypt مع salt عشوائي لكل مستخدم + مقارنة زمنية ثابتة.
• الجلسات: JWT موقّع HMAC-SHA256 في كوكي httpOnly (30 يوماً).
• جوجل: تحقق كامل للتوقيع RS256 بمفاتيح جوجل الرسمية + aud/iss/exp.
• الدفع: لا تلمس بيانات البطاقات خوادمنا إطلاقاً — Stripe بالكامل.
• لا يتم committing أي أسرار: .env مستثنى من Git.

الأداء والوصولية

• RTL كامل مع خط Cairo العربي.
• تصميم متجاوب من 360px حتى الشاشات العريضة + شريط تنقل سفلي للجوال.
• ARIA labels عربية على كل العناصر التفاعلية، تنقل بلوحة المفاتيح، أهداف لمس 44px+.
• حالات تحميل وأخطاء وتأكيدات Toast لكل إجراء.

---

صُنع بالنار في المسبك — AgentForge © 2025