دليل التشغيل الكامل

من الصفر إلى نظام AI يعمل بالكامل — اتبع الخطوات بالترتيب

التقدم الكلي0% (0/6)

الواجهة

localhost:3000

API

localhost:8000

PostgreSQL

localhost:5432

Ollama

localhost:11434

خطوة 1

إعداد متغيرات البيئة

Environment Setup

انسخ ملف .env.example وعدّل القيم السرية قبل أي شيء آخر.

نسخ الملف
cp .env.example .env
توليد مفتاح سري (PowerShell)
[Convert]::ToBase64String((1..32 | ForEach-Object { Get-Random -Max 256 }) -as [byte[]])
توليد مفتاح سري (Linux/Mac)
openssl rand -hex 32
💡ضع قيمًا مختلفة لـ APP_SECRET_KEY و JWT_SECRET_KEY و TOKEN_SALT — ثلاثة مفاتيح مستقلة.
خطوة 2

تشغيل الخدمات بـ Docker

Start Docker Services

تشغيل PostgreSQL، Redis، Ollama، Backend، Frontend، Nginx دفعة واحدة.

بناء وتشغيل (المرة الأولى)
docker compose up -d --build
تشغيل بدون إعادة البناء
docker compose up -d
متابعة السجلات
docker compose logs -f backend
حالة الحاويات
docker compose ps
💡انتظر حتى يظهر status: healthy لجميع الخدمات (30-60 ثانية).
خطوة 3

تهيئة قاعدة البيانات

Database Initialization

خطوة 4

تحميل نماذج الذكاء الاصطناعي

Load AI Models (Ollama)

خطوة 5

التحقق من صحة النظام

Health Check

خطوة 6

إنشاء أول رمز API

Create First API Token