version 2

src/GreenHome.AI.DeepSeek/QUICKSTART.md

@@ -0,0 +1,126 @@
+# 🚀 راهنمای سریع شروع - 5 دقیقه!
+
+## مرحله 1: دریافت API Key (2 دقیقه)
+
+1. به https://platform.deepseek.com بروید
+2. روی "Sign Up" کلیک کنید (یا Login اگر قبلاً ثبت‌نام کرده‌اید)
+3. وارد Dashboard شوید
+4. از منوی سمت چپ، گزینه "API Keys" را انتخاب کنید
+5. روی "Create API Key" کلیک کنید
+6. یک نام برای کلید انتخاب کنید (مثلاً "GreenHome")
+7. کلید را کپی کنید ⚠️ (فقط یک بار نمایش داده می‌شود!)
+
+## مرحله 2: تنظیم API Key (1 دقیقه)
+
+فایل `appsettings.json` را باز کنید و API Key را جایگزین کنید:
+
+```json
+{
+  "DeepSeek": {
+    "ApiKey": "اینجا-کلید-خود-را-بگذارید"
+  }
+}
+```
+
+## مرحله 3: اجرای برنامه (1 دقیقه)
+
+```bash
+cd GreenHome.Api
+dotnet run
+```
+
+## مرحله 4: تست API (1 دقیقه)
+
+### با Swagger:
+1. مرورگر را باز کنید: http://localhost:5000/swagger
+2. endpoint `/api/ai/ask` را باز کنید
+3. روی "Try it out" کلیک کنید
+4. این را در Body بگذارید:
+```json
+{
+  "question": "سلام! آیا کار می‌کنی؟"
+}
+```
+5. روی "Execute" کلیک کنید
+6. پاسخ را ببینید! ✅
+
+### با Curl:
+```bash
+curl -X POST http://localhost:5000/api/ai/ask \
+  -H "Content-Type: application/json" \
+  -d '{"question":"سلام! آیا کار می‌کنی؟"}'
+```
+
+### با Postman:
+1. Postman را باز کنید
+2. یک درخواست POST جدید بسازید
+3. URL: `http://localhost:5000/api/ai/ask`
+4. Headers: `Content-Type: application/json`
+5. Body (raw JSON):
+```json
+{
+  "question": "سلام! آیا کار می‌کنی؟"
+}
+```
+6. Send را بزنید!
+
+## 🎉 تبریک! شما آماده‌اید!
+
+اکنون می‌توانید از AI در پروژه خود استفاده کنید.
+
+## مثال‌های آماده برای تست:
+
+### 1. سوال درباره خانه هوشمند:
+```json
+{
+  "question": "چگونه می‌توانم مصرف برق خانه را کاهش دهم؟"
+}
+```
+
+### 2. دریافت پیشنهاد:
+**Endpoint:** POST `/api/ai/suggest`
+```json
+{
+  "deviceContext": "دمای اتاق: 28 درجه، رطوبت: 65%، ساعت: 14:00"
+}
+```
+
+### 3. سوال با زمینه خاص:
+```json
+{
+  "question": "بهترین دمای کولر برای خواب چیست؟",
+  "systemPrompt": "شما یک متخصص خانه هوشمند و بهینه‌سازی انرژی هستید."
+}
+```
+
+## ❓ مشکل دارید؟
+
+### خطا: 401 Unauthorized
+- ✅ بررسی کنید API Key را صحیح کپی کرده‌اید
+- ✅ فاصله اضافی ندارد
+- ✅ در appsettings.json به درستی قرار دارد
+
+### خطا: Connection Refused
+- ✅ مطمئن شوید برنامه اجرا شده است (`dotnet run`)
+- ✅ پورت صحیح است (معمولاً 5000 یا 5001)
+
+### خطا: 429 Too Many Requests
+- ✅ کمی صبر کنید (1-2 دقیقه)
+- ✅ تعداد درخواست‌های شما زیاد بوده است
+
+## 📚 مستندات بیشتر
+
+- مستندات کامل: [README.md](README.md)
+- راهنمای استفاده: [USAGE_FA.md](USAGE_FA.md)
+- خلاصه پروژه: [SUMMARY.md](SUMMARY.md)
+
+## 🎯 مرحله بعدی
+
+اکنون می‌توانید:
+1. ✅ از AI در Controller های خود استفاده کنید
+2. ✅ پیشنهادات هوشمند برای کاربران ارائه دهید
+3. ✅ تحلیل داده‌های سنسورها را انجام دهید
+4. ✅ چت‌بات هوشمند بسازید
+
+موفق باشید! 🚀
+