Files
khalijpay-issuer/README.md
2025-12-23 23:29:58 +03:30

4.2 KiB

Payment Admin Panel Dashboard

یک داشبورد مدیریتی مدرن برای مدیریت سیستم پرداخت با رابط کاربری زیبا و کاربردی.

ویژگی‌ها

  • 🔐 سیستم احراز هویت کامل (ورود و بازیابی رمز عبور)
  • 📊 داشبورد با نمودارها و آمار
  • 📍 مدیریت موقعیت‌های جغرافیایی (کشور، استان، شهر)
  • 🏢 مدیریت صادرکنندگان
  • 🌙 پشتیبانی از حالت تاریک
  • 📱 طراحی واکنش‌گرا (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. کلون کردن پروژه:
git clone <repository-url>
cd dashboard-issuer
  1. نصب وابستگی‌ها:
npm install
  1. اجرای پروژه در حالت توسعه:
npm run dev
  1. ساخت نسخه production:
npm run build
  1. پیش‌نمایش نسخه production:
npm run preview

دستورات موجود

  • npm run dev - اجرای سرور توسعه
  • npm run build - ساخت نسخه production
  • npm run preview - پیش‌نمایش نسخه production
  • npm run lint - بررسی کد با ESLint

اطلاعات ورود تست

برای تست سیستم می‌توانید از این اطلاعات استفاده کنید:

ساختار پروژه

src/
├── components/
│   ├── Navbar.jsx        
│   ├── Sidebar.jsx         
│   └── DataTable.jsx       
├── pages/
│   ├── Dashboard.jsx       
│   ├── Login.jsx           
│   ├── ForgotPassword.jsx  
│   ├── Location.jsx        
│   └── Issuer.jsx          
├── context/
│   └── AuthContext.jsx     
├── store/
│   └── authStore.js        
├── services/
│   ├── 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               
└── 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 کردن تغییرات، حتماً کد را بررسی کنید:

npm run lint

مجوز

این پروژه خصوصی است.