feat(TopUpAgent): add , edit, delete , toggle ,...

README.md

@@ -1,26 +1,146 @@
-For testing purposes, you can use these demo credentials:
-- **Email**: admin@example.com
-- **Password**: password
+# Payment Admin Panel Dashboard
 
-## Project Structure
+یک داشبورد مدیریتی مدرن برای مدیریت سیستم پرداخت با رابط کاربری زیبا و کاربردی.
+
+## ویژگی‌ها
+
+- 🔐 سیستم احراز هویت کامل (ورود و بازیابی رمز عبور)
+- 📊 داشبورد با نمودارها و آمار
+- 📍 مدیریت موقعیت‌های جغرافیایی (کشور، استان، شهر)
+- 🏢 مدیریت صادرکنندگان
+- 🌙 پشتیبانی از حالت تاریک
+- 📱 طراحی واکنش‌گرا (Responsive)
+
+## تکنولوژی‌های استفاده شده
+
+- **React 18** - کتابخانه UI
+- **Vite** - ابزار ساخت و توسعه
+- **React Router DOM** - مسیریابی
+- **Zustand** - مدیریت state
+- **Axios** - درخواست‌های HTTP
+- **Tailwind CSS** - استایل‌دهی
+- **Recharts** - نمودارها
+- **Lucide React** - آیکون‌ها
+- **React Toastify** - اعلان‌ها
+
+## نصب و راه‌اندازی
+
+### پیش‌نیازها
+
+- Node.js (نسخه 16 یا بالاتر)
+- npm یا yarn
+
+### مراحل نصب
+
+1. کلون کردن پروژه:
+```bash
+git clone <repository-url>
+cd dashboard-issuer
+```
+
+2. نصب وابستگی‌ها:
+```bash
+npm install
+```
+
+3. اجرای پروژه در حالت توسعه:
+```bash
+npm run dev
+```
+
+4. ساخت نسخه production:
+```bash
+npm run build
+```
+
+5. پیش‌نمایش نسخه production:
+```bash
+npm run preview
+```
+
+## دستورات موجود
+
+- `npm run dev` - اجرای سرور توسعه
+- `npm run build` - ساخت نسخه production
+- `npm run preview` - پیش‌نمایش نسخه production
+- `npm run lint` - بررسی کد با ESLint
+
+## اطلاعات ورود تست
+
+برای تست سیستم می‌توانید از این اطلاعات استفاده کنید:
+- **ایمیل**: admin@example.com
+- **رمز عبور**: password
+
+## ساختار پروژه
 
 ```
-src//
+src/
 ├── components/
 │   ├── Navbar.jsx        
 │   ├── Sidebar.jsx         
 │   └── DataTable.jsx       
 ├── pages/
 │   ├── Dashboard.jsx       
-│   ├── Transactions.jsx    
-│   ├── Settings.jsx       
-│   └── Login.jsx           
+│   ├── Login.jsx           
+│   ├── ForgotPassword.jsx  
+│   ├── Location.jsx        
+│   └── Issuer.jsx          
 ├── context/
 │   └── AuthContext.jsx     
+├── store/
+│   └── authStore.js        
 ├── services/
-│   └── api.js              
+│   ├── api.js              
+│   ├── apiClient.js        
+│   ├── authAPI.js          
+│   ├── issuerAPI.js        
+│   ├── countryAPI.js       
+│   ├── provinceAPI.js      
+│   ├── cityAPI.js          
+│   ├── currencyAPI.js      
+│   ├── permissionsAPI.js   
+│   ├── generalAPI.js       
+│   └── paymentsAPI.js       
+├── utils/
+│   └── errorHandler.js     
 ├── App.jsx                 
-├── main.jsx            
-└── index.css              
+├── main.jsx                
+├── index.css               
+└── layout.css              
 ```
-.
+
+## صفحات و مسیرها
+
+- `/` - داشبورد اصلی
+- `/login` - صفحه ورود
+- `/forgot-password` - بازیابی رمز عبور
+- `/location` - مدیریت موقعیت‌ها (کشور، استان، شهر)
+- `/issuer` - مدیریت صادرکنندگان
+
+## API Services
+
+پروژه از سرویس‌های API زیر استفاده می‌کند:
+
+- **authAPI.js** - احراز هویت و مدیریت کاربر
+- **issuerAPI.js** - مدیریت صادرکنندگان
+- **countryAPI.js** - مدیریت کشورها
+- **provinceAPI.js** - مدیریت استان‌ها
+- **cityAPI.js** - مدیریت شهرها
+- **currencyAPI.js** - مدیریت ارزها
+- **permissionsAPI.js** - مدیریت دسترسی‌ها
+- **generalAPI.js** - سرویس‌های عمومی
+- **paymentsAPI.js** - مدیریت پرداخت‌ها و آمار داشبورد
+- **apiClient.js** - کلاینت اصلی API
+- **api.js** - تنظیمات پایه API
+
+## توسعه
+
+پروژه از ESLint برای بررسی کیفیت کد استفاده می‌کند. قبل از commit کردن تغییرات، حتماً کد را بررسی کنید:
+
+```bash
+npm run lint
+```
+
+## مجوز
+
+این پروژه خصوصی است.