Compare commits
3 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
ca51f65dc7 | ||
|
|
c1c16213ab | ||
|
|
39d14f6468 |
147
README.md
147
README.md
@@ -1,146 +1 @@
|
||||
# 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. کلون کردن پروژه:
|
||||
```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/
|
||||
├── 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 کردن تغییرات، حتماً کد را بررسی کنید:
|
||||
|
||||
```bash
|
||||
npm run lint
|
||||
```
|
||||
|
||||
## مجوز
|
||||
|
||||
این پروژه خصوصی است.
|
||||
------ read me ------
|
||||
@@ -114,7 +114,7 @@ const Login = () => {
|
||||
</div>
|
||||
</div>
|
||||
<h2 className="mt-6 text-center text-3xl font-bold text-gray-900 dark:text-white">
|
||||
Khalij Finance Issuer Admin
|
||||
Khalij Finance Agent Admin
|
||||
</h2>
|
||||
<p className="mt-2 text-center text-sm text-gray-600 dark:text-gray-400">
|
||||
Sign in to your account
|
||||
@@ -204,10 +204,10 @@ const Login = () => {
|
||||
<div className="space-y-6">
|
||||
<div>
|
||||
<h3 className="text-lg font-medium text-gray-900 dark:text-white mb-2">
|
||||
Select an Issuer
|
||||
Select an Agent
|
||||
</h3>
|
||||
<p className="text-sm text-gray-600 dark:text-gray-400 mb-4">
|
||||
Please select the issuer you want to sign in with:
|
||||
Please select the agent you want to sign in with:
|
||||
</p>
|
||||
</div>
|
||||
|
||||
|
||||
@@ -6,13 +6,8 @@
|
||||
|
||||
export * from './authAPI';
|
||||
|
||||
export { countryAPI } from './countryAPI';
|
||||
export { provinceAPI } from './provinceAPI';
|
||||
export { cityAPI } from './cityAPI';
|
||||
export { listPermissions } from './permissionsAPI';
|
||||
export { generalAPI } from './generalAPI';
|
||||
export { paymentsAPI } from './paymentsAPI';
|
||||
export { currencyAPI } from './currencyAPI';
|
||||
export { topUpAgentAPI } from './topUpAgentAPI';
|
||||
|
||||
export { walletAPI } from './walletAPI';
|
||||
export { voucherAPI } from './voucherAPI';
|
||||
|
||||
Reference in New Issue
Block a user