From 68ef03e8630856c99ff3917a6f1fe96f0ee45f97 Mon Sep 17 00:00:00 2001 From: Babak Alizadeh Date: Wed, 23 Jul 2025 16:43:30 +0000 Subject: [PATCH] bug fix in dto --- hesabixCore/docs/AI_Tools_System.md | 261 ------------------ .../src}/Dto/TaxSettingsDto.php | 0 2 files changed, 261 deletions(-) delete mode 100644 hesabixCore/docs/AI_Tools_System.md rename {src => hesabixCore/src}/Dto/TaxSettingsDto.php (100%) diff --git a/hesabixCore/docs/AI_Tools_System.md b/hesabixCore/docs/AI_Tools_System.md deleted file mode 100644 index 14eb3d7..0000000 --- a/hesabixCore/docs/AI_Tools_System.md +++ /dev/null @@ -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 های پیشرفته - - وب‌هوک‌ها - -## نکات فنی - -### مدیریت خطاها -- بررسی وجود کلیدهای مورد نیاز -- مدیریت خطاهای شبکه -- لاگ‌گیری کامل - -### بهینه‌سازی عملکرد -- کش‌گذاری پاسخ‌ها -- کاهش درخواست‌های تکراری -- بهینه‌سازی پرامپ‌ها - -### امنیت -- بررسی دسترسی کاربران -- اعتبارسنجی ورودی‌ها -- محافظت از داده‌های حساس - -## نتیجه‌گیری - -سیستم جدید هوشمند هوش مصنوعی حسابیکس با رویکردی نوآورانه و انعطاف‌پذیر طراحی شده است. این سیستم قابلیت توسعه بالایی دارد و می‌تواند به راحتی با نیازهای آینده سازگار شود. - -مزایای اصلی این سیستم عبارتند از: -- هوشمندی بیشتر در تشخیص دستورات -- انعطاف‌پذیری بالا -- قابلیت توسعه آسان -- تجربه کاربری بهتر -- امنیت و کنترل بیشتر - -این سیستم پایه‌ای محکم برای توسعه‌های آینده فراهم می‌کند و می‌تواند به عنوان یک دستیار هوشمند واقعی برای کاربران حسابیکس عمل کند. \ No newline at end of file diff --git a/src/Dto/TaxSettingsDto.php b/hesabixCore/src/Dto/TaxSettingsDto.php similarity index 100% rename from src/Dto/TaxSettingsDto.php rename to hesabixCore/src/Dto/TaxSettingsDto.php