إعداد بيئة التطوير المحلية

إعداد بيئة التطوير المحلية

الخادم (FastAPI)

cd backend
python -m venv venv
source venv/bin/activate  # على Windows: venv\Scripts\activate
pip install -r requirements.txt

# شغّل PostgreSQL و Redis (أو استخدم Docker)
docker compose up db redis -d

# شغّل الخادم مع إعادة التحميل الفوري
uvicorn app.main:app --reload --port 8000

توثيق الواجهة متاح على: http://localhost:8000/docs

الواجهة الأمامية (Next.js)

cd frontend/web
npm install
npm run dev

الواجهة الأمامية على http://localhost:3000 — تُمرّر /api/ إلى الخادم تلقائيًا.

متغيرات البيئة

انسخ .env.example إلى .env واضبط:

• DATABASE_URL — سلسلة اتصال PostgreSQL
• REDIS_URL — سلسلة اتصال Redis
• SECRET_KEY — مفتاح توقيع JWT (أنشئه بأمر: openssl rand -hex 32)

تشغيل الاختبارات

cd backend
pytest tests/ -v