bug fix in dto

hesabixCore/docs/AI_Tools_System.md

@@ -1,261 +0,0 @@
-# سیستم هوشمند هوش مصنوعی حسابیکس - نسخه 2.0
-
-## مقدمه
-
-سیستم جدید هوشمند هوش مصنوعی حسابیکس با رویکردی کاملاً متفاوت طراحی شده است. در این نسخه، به جای تشخیص دستی دستورات، به هوش مصنوعی گفته می‌شود که چه ابزارهایی دارد و اجازه داده می‌شود خودش تصمیم بگیرد که از کدام ابزار استفاده کند.
-
-## ویژگی‌های کلیدی
-
-### 🔧 تشخیص خودکار ابزارها
-- هوش مصنوعی خودش تشخیص می‌دهد که چه ابزاری مناسب است
-- نیازی به تشخیص دستی دستورات نیست
-- انعطاف‌پذیری بالا در درک درخواست‌های کاربر
-
-### 📝 پرامپ‌های سیستمی هوشمند
-- پرامپ‌های جامع که تمام ابزارها را معرفی می‌کنند
-- مثال‌های کاربردی برای هر ابزار
-- قوانین و محدودیت‌های استفاده
-
-### 🎯 تعامل چندمرحله‌ای
-- امکان انجام عملیات پیچیده در چند مرحله
-- جمع‌آوری اطلاعات تدریجی
-- تجربه کاربری بهتر
-
-## معماری سیستم
-
-### 1. AIService (سرویس اصلی)
-```php
-class AIService {
-    // پرامپ سیستمی هوشمند
-    private function getSystemPrompt(): string
-    
-    // پردازش پاسخ هوش مصنوعی
-    private function processAIResponse(string $aiResponse, ?Business $business, $user): array
-    
-    // استخراج دستورات ابزار
-    private function extractToolCommands(string $aiResponse): array
-    
-    // اجرای دستورات ابزار
-    private function executeToolCommand(array $command, ?Business $business, $user): array
-}
-```
-
-### 2. PersonManagementService (مدیریت اشخاص)
-```php
-class PersonManagementService {
-    // ابزارهای مدیریت اشخاص
-    public function addPerson(array $params, Business $business, $user): array
-    public function deletePerson(array $params, Business $business, $user): array
-    public function editPerson(array $params, Business $business, $user): array
-    public function showPerson(array $params, Business $business, $user): array
-    public function searchPersons(array $params, Business $business): array
-}
-```
-
-## ابزارهای موجود
-
-### مدیریت اشخاص (person_management)
-
-#### 1. افزودن شخص جدید
-```bash
-add_person{name:نام شخص}
-```
-
-**مثال‌ها:**
-- `add_person{name:علی}`
-- `add_person{name:احمد محمدی}`
-
-#### 2. حذف شخص
-```bash
-delete_person{name:نام شخص}
-```
-
-**مثال‌ها:**
-- `delete_person{name:علی}`
-- `delete_person{name:محسن محمودی}`
-
-#### 3. ویرایش شخص
-```bash
-edit_person{name:نام شخص, phone:موبایل, address:آدرس, email:ایمیل}
-```
-
-**مثال‌ها:**
-- `edit_person{name:علی, phone:09123456789}`
-- `edit_person{name:احمد, address:تهران، خیابان ولیعصر}`
-
-#### 4. نمایش مشخصات
-```bash
-show_person{name:نام شخص}
-```
-
-**مثال‌ها:**
-- `show_person{name:علی}`
-- `show_person{name:محسن محمودی}`
-
-#### 5. جستجوی اشخاص
-```bash
-search_persons{search:متن جستجو, limit:تعداد نتایج}
-```
-
-**مثال‌ها:**
-- `search_persons{search:علی}`
-- `search_persons{search:محمد, limit:5}`
-
-## پرامپ سیستمی
-
-پرامپ سیستمی شامل موارد زیر است:
-
-### معرفی ابزارها
-```
-شما یک دستیار هوشمند برای سیستم حسابداری حسابیکس هستید. شما دسترسی به ابزارهای زیر دارید:
-
-🔧 ابزارهای موجود:
-
-1. **مدیریت اشخاص** (person_management):
-   - افزودن شخص جدید: add_person{name:نام شخص}
-   - حذف شخص: delete_person{name:نام شخص}
-   - ویرایش شخص: edit_person{name:نام شخص, phone:موبایل, address:آدرس, email:ایمیل}
-   - نمایش مشخصات: show_person{name:نام شخص}
-   - جستجوی اشخاص: search_persons{search:متن جستجو, limit:تعداد نتایج}
-```
-
-### قوانین استفاده
-```
-📋 قوانین استفاده:
-- اگر کاربر درخواست عملیات مدیریت اشخاص دارد، از دستورات بالا استفاده کنید
-- نام شخص می‌تواند نام مستعار یا نام کامل باشد
-- برای عملیات پیچیده، ابتدا اطلاعات را جمع‌آوری کنید
-- همیشه پاسخ فارسی و واضح ارائه دهید
-```
-
-### مثال‌های کاربردی
-```
-💡 مثال‌های استفاده:
-- 'علی رو حذف کن' → delete_person{name:علی}
-- 'شخص جدید با نام احمد اضافه کن' → add_person{name:احمد}
-- 'مشخصات محسن رو نشون بده' → show_person{name:محسن}
-```
-
-## جریان کار
-
-### 1. دریافت درخواست کاربر
-```
-کاربر: "شخص علی را حذف کن"
-```
-
-### 2. ساخت پرامپ هوشمند
-```
-پرامپ = پرامپ سیستمی + اطلاعات کسب و کار + سوال کاربر
-```
-
-### 3. ارسال به هوش مصنوعی
-```
-هوش مصنوعی پرامپ را دریافت کرده و تصمیم می‌گیرد که از ابزار مناسب استفاده کند
-```
-
-### 4. تشخیص دستورات ابزار
-```
-پاسخ هوش مصنوعی: "برای حذف شخص علی، از دستور delete_person{name:علی} استفاده می‌کنم."
-```
-
-### 5. استخراج و اجرای دستورات
-```
-دستور استخراج شده: delete_person{name:علی}
-نتیجه اجرا: "شخص علی با موفقیت حذف شد."
-```
-
-### 6. ساخت پاسخ نهایی
-```
-پاسخ نهایی = پاسخ هوش مصنوعی + نتایج ابزارها
-```
-
-## مزایای سیستم جدید
-
-### 🚀 هوشمندی بیشتر
-- هوش مصنوعی خودش تصمیم می‌گیرد
-- نیازی به تشخیص دستی دستورات نیست
-- انعطاف‌پذیری بالا در درک درخواست‌ها
-
-### 🔧 قابلیت توسعه
-- افزودن ابزارهای جدید آسان است
-- پرامپ‌ها قابل به‌روزرسانی هستند
-- معماری مقیاس‌پذیر
-
-### 🎯 تجربه کاربری بهتر
-- تعامل طبیعی‌تر
-- پاسخ‌های هوشمندانه‌تر
-- پشتیبانی از عملیات پیچیده
-
-### 🛡️ امنیت و کنترل
-- تمام عملیات در لاگ ثبت می‌شود
-- بررسی دسترسی کاربران
-- کنترل خطاها
-
-## توسعه آینده
-
-### ابزارهای پیشنهادی
-1. **مدیریت محصولات**
-   - افزودن، ویرایش، حذف محصولات
-   - مدیریت موجودی
-   - قیمت‌گذاری
-
-2. **مدیریت تراکنش‌ها**
-   - ثبت تراکنش‌های مالی
-   - گزارش‌گیری
-   - تحلیل داده‌ها
-
-3. **گزارش‌گیری هوشمند**
-   - گزارش‌های مالی
-   - تحلیل‌های آماری
-   - پیش‌بینی‌ها
-
-4. **مدیریت حساب‌ها**
-   - مدیریت حساب‌های بانکی
-   - صندوق‌ها
-   - حقوق‌ها
-
-### بهبودهای پیشنهادی
-1. **یادگیری ماشین**
-   - بهبود تشخیص دستورات
-   - شخصی‌سازی پاسخ‌ها
-   - پیش‌بینی نیازهای کاربر
-
-2. **پشتیبانی چندزبانه**
-   - پشتیبانی از زبان‌های مختلف
-   - تشخیص خودکار زبان
-   - ترجمه خودکار
-
-3. **یکپارچه‌سازی پیشرفته**
-   - اتصال به سرویس‌های خارجی
-   - API های پیشرفته
-   - وب‌هوک‌ها
-
-## نکات فنی
-
-### مدیریت خطاها
-- بررسی وجود کلیدهای مورد نیاز
-- مدیریت خطاهای شبکه
-- لاگ‌گیری کامل
-
-### بهینه‌سازی عملکرد
-- کش‌گذاری پاسخ‌ها
-- کاهش درخواست‌های تکراری
-- بهینه‌سازی پرامپ‌ها
-
-### امنیت
-- بررسی دسترسی کاربران
-- اعتبارسنجی ورودی‌ها
-- محافظت از داده‌های حساس
-
-## نتیجه‌گیری
-
-سیستم جدید هوشمند هوش مصنوعی حسابیکس با رویکردی نوآورانه و انعطاف‌پذیر طراحی شده است. این سیستم قابلیت توسعه بالایی دارد و می‌تواند به راحتی با نیازهای آینده سازگار شود.
-
-مزایای اصلی این سیستم عبارتند از:
-- هوشمندی بیشتر در تشخیص دستورات
-- انعطاف‌پذیری بالا
-- قابلیت توسعه آسان
-- تجربه کاربری بهتر
-- امنیت و کنترل بیشتر
-
-این سیستم پایه‌ای محکم برای توسعه‌های آینده فراهم می‌کند و می‌تواند به عنوان یک دستیار هوشمند واقعی برای کاربران حسابیکس عمل کند.