Vue.js: المشروع النهائي: لوحة تحكم المتجر

Business Scenarios:
  - 5,000 Small and Medium-Sized Business Owners(Per household 30-300 SKU)
  - 30,000 Items SKU
  - Daily 10,000 Order
  - 5 Role Permissions(admin / manager / editor / viewer / guest)
  - Real-time Data(Dashboard,Order,Notice)
  - Multilingual(5 Language)

src/
├-- api/                   # API Packaging
│   ├-- auth.ts
│   ├-- product.ts
│   ├-- order.ts
│   └-- user.ts
├-- assets/                # Static Resources
├-- components/            # Public Components
│   ├-- BaseButton.vue
│   ├-- BaseTable.vue       # Secondary Packaging Element Plus
│   ├-- BasePagination.vue
│   ├-- BaseDialog.vue
│   └-- charts/             # Charts
│       ├-- SalesChart.vue
│       ├-- UserChart.vue
│       └-- OrderChart.vue
├-- composables/           # Composite Functions
│   ├-- useAuth.ts
│   ├-- usePermission.ts
│   ├-- useTable.ts
│   └-- usePagination.ts
├-- layouts/                # Layout
│   ├-- DefaultLayout.vue   # After logging in
│   └-- AuthLayout.vue      # Login Page
├-- router/                # Routing
│   └-- index.ts
├-- stores/                 # Pinia
│   ├-- auth.ts
│   ├-- product.ts
│   ├-- order.ts
│   └-- app.ts              # Global(Topic / Sidebar)
├-- types/                  # TS Type
│   ├-- user.ts
│   ├-- product.ts
│   └-- api.ts
├-- utils/                  # Tools
│   ├-- request.ts          # axios Packaging
│   ├-- auth.ts
│   └-- format.ts
├-- views/                  # Page
│   ├-- dashboard/          # Dashboard
│   ├-- login/              # Log In
│   ├-- product/            # Products
│   ├-- order/              # Order
│   ├-- user/               # User
│   ├-- marketing/          # Marketing
│   └-- error/              # 403 / 404
├-- App.vue
└-- main.ts

{
  "name": "mercury-admin",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "dev": "vite",
    "build": "vue-tsc --noEmit && vite build",
    "preview": "vite preview",
    "test": "vitest",
    "test:e2e": "playwright test",
    "lint": "eslint . --ext .vue,.ts,.tsx"
  },
  "dependencies": {
    "vue": "^3.4.0",
    "vue-router": "^4.3.0",
    "pinia": "^2.1.0",
    "element-plus": "^2.5.0",
    "@element-plus/icons-vue": "^2.3.0",
    "echarts": "^5.4.0",
    "vue-echarts": "^7.0.0",
    "axios": "^1.6.0",
    "dayjs": "^1.11.0",
    "vueuse": "^10.7.0"
  },
  "devDependencies": {
    "@vitejs/plugin-vue": "^5.0.0",
    "vite": "^5.0.0",
    "vue-tsc": "^1.8.0",
    "typescript": "^5.3.0",
    "unplugin-vue-components": "^0.26.0",
    "unplugin-auto-import": "^0.17.0",
    "unplugin-icons": "^0.17.0",
    "@iconify-json/carbon": "^1.1.0",
    "sass": "^1.69.0",
    "vitest": "^1.0.0",
    "@vue/test-utils": "^2.4.0",
    "@playwright/test": "^1.40.0"
  }
}

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import AutoImport from 'unplugin-auto-import'
import Components from 'unplugin-vue-components'
import Icons from 'unplugin-icons/vite'
import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'
import path from 'path'

export default defineConfig({
  plugins: [
    vue(),
    AutoImport({
      imports: ['vue', 'vue-router', 'pinia', 'vueuse'],
      resolvers: [ElementPlusResolver()],
      dts: 'src/auto-imports.d.ts'
    }),
    Components({
      resolvers: [ElementPlusResolver()],
      dts: 'src/components.d.ts'
    }),
    Icons({ autoInstall: true })
  ],
  resolve: {
    alias: { '@': path.resolve(__dirname, 'src') }
  },
  server: {
    port: 5173,
    proxy: { '/api': { target: 'http://localhost:3000', changeOrigin: true } }
  },
  build: {
    rollupOptions: {
      output: {
        manualChunks: {
          'vue-vendor': ['vue', 'vue-router', 'pinia'],
          'echarts-vendor': ['echarts', 'vue-echarts']
        }
      }
    }
  }
})

// stores/auth.ts
import { defineStore } from 'pinia'
import { ref, computed } from 'vue'
import { loginApi, getUserInfoApi } from '@/api/auth'

export const useAuthStore = defineStore('auth', () => {
  const token = ref<string>(localStorage.getItem('token') || '')
  const user = ref<User | nulo>(nulo)
  const roles = ref<string[]>([])
  const permissions = ref<string[]>([])
  
  const isLoggedIn = computed(() => !!token.value)
  const isAdmin = computed(() => roles.value.includes('admin'))
  
  async function login(credentials: { username: string; password: string }) {
    const { data } = await loginApi(credentials)
    token.value = data.token
    user.value = data.user
    roles.value = data.roles
    permissions.value = data.permissions
    localStorage.setItem('token', data.token)
  }
  
  async function fetchUserInfo() {
    const { data } = await getUserInfoApi()
    user.value = data.user
    roles.value = data.roles
    permissions.value = data.permissions
  }
  
  function logout() {
    token.value = ''
    user.value = nulo
    roles.value = []
    permissions.value = []
    localStorage.removeItem('token')
  }
  
  return { token, user, roles, permissions, isLoggedIn, isAdmin, login, fetchUserInfo, logout }
}, {
  persist: {
    key: 'mercury-auth',
    paths: ['token', 'user', 'roles', 'permissions']
  }
})

// router/index.ts
import { createRouter, createWebHistory } from 'vue-router'
import { useAuthStore } from '@/stores/auth'

const router = createRouter({
  history: createWebHistory(),
  routes: [
    { path: '/login', component: () => import('@/views/login/LoginPage.vue') },
    {
      path: '/',
      component: () => import('@/layouts/DefaultLayout.vue'),
      meta: { requiresAuth: true },
      children: [
        { path: '', redirect: '/dashboard' },
        { path: 'dashboard', component: () => import('@/views/dashboard/DashboardPage.vue') },
        { path: 'products', component: () => import('@/views/product/ProductListPage.vue') }
      ]
    }
  ]
})

router.beforeEach((to, from, next) => {
  const auth = useAuthStore()
  
  if (to.meta.requiresAuth && !auth.isLoggedIn) {
    return next({ name: 'login', query: { redirect: to.fullPath } })
  }
  
  next()
})

export default router

// directives/permission.ts
import { useAuthStore } from '@/stores/auth'

export const permission = {
  mounted(el: HTMLElement, binding: { value: string }) {
    const auth = useAuthStore()
    if (!auth.permissions.includes(binding.value)) {
      el.parentNode?.removeChild(el)
    }
  }
}

<button v-permission="'product.create'">Create Product</button>

<!-- views/dashboard/DashboardPage.vue -->
<template>
  <div class="dashboard">
    <!-- 1. KPI Card -->
    <div class="kpi-grid">
      <KpiCard title="Today's Sales" :value="stats.todaySales" :change="+12%" />
      <KpiCard title="Orders" :value="stats.todayOrders" :change="+5%" />
      <KpiCard title="Active Users" :value="stats.activeUsers" :change="+8%" />
      <KpiCard title="Conversion" :value="stats.conversion" :change="-2%" />
    </div>
    
    <!-- 2. 5 View Chart -->
    <el-row :gutter="20">
      <el-col :span="12">
        <SalesChart :data="salesData" />
      </el-col>
      <el-col :span="12">
        <UserChart :data="userData" />
      </el-col>
      <el-col :span="24">
        <OrderChart :data="orderData" />
      </el-col>
      <el-col :span="12">
        <CategoryChart :data="categoryData" />
      </el-col>
      <el-col :span="12">
        <TopProductsTable :data="topProducts" />
      </el-col>
    </el-row>
  </div>
</template>

<script setup lang="ts">
import { onMounted, ref } from 'vue'
import { getDashboardStatsApi } from '@/api/dashboard'

const stats = ref({})
const salesData = ref([])
const userData = ref([])
const orderData = ref([])
const categoryData = ref([])
const topProducts = ref([])

onMounted(async () => {
  const { data } = await getDashboardStatsApi()
  Object.assign(stats.value, data.stats)
  salesData.value = data.sales
  userData.value = data.users
  orderData.value = data.orders
  categoryData.value = data.categories
  topProducts.value = data.topProducts
})
</script>

<!-- components/charts/SalesChart.vue -->
<template>
  <el-card title="Sales Trend">
    <v-chart :option="chartOption" autoresize style="height: 300px" />
  </el-card>
</template>

<script setup lang="ts">
import { computed } from 'vue'
import { use } from 'echarts/core'
import { CanvasRenderer } from 'echarts/renderers'
import { LineChart } from 'echarts/charts'
import { GridComponent, TooltipComponent, LegendComponent } from 'echarts/components'

use([CanvasRenderer, LineChart, GridComponent, TooltipComponent, LegendComponent])

const props = defineProps<{
  data: Array<{ date: string; sales: number }>
}>()

const chartOption = computed(() => ({
  tooltip: { trigger: 'axis' },
  xAxis: { type: 'category', data: props.data.map(d => d.date) },
  yAxis: { type: 'value' },
  series: [{
    name: 'Sales',
    type: 'line',
    data: props.data.map(d => d.sales),
    smooth: true
  }]
}))
</script>

<!-- views/product/ProductListPage.vue -->
<template>
  <BaseTable
    :data="products"
    :columns="columns"
    :total="total"
    :loading="loading"
    @search="onSearch"
    @page="onPage"
  >
    <template #toolbar>
      <el-button type="primary" v-permission="'product.create'" @click="onCreate">
        Create Product
      </el-button>
    </template>
    
    <template #column-status="{ row }">
      <el-tag :type="statusType(row.status)">{{ row.status }}</el-tag>
    </template>
    
    <template #column-actions="{ row }">
      <el-button v-permission="'product.edit'" @click="onEdit(row)">Edit</el-button>
      <el-button v-permission="'product.delete'" type="danger" @click="onDelete(row)">Delete</el-button>
    </template>
  </BaseTable>
</template>

<script setup lang="ts">
import { ref, onMounted } from 'vue'
import { getProductsApi, deleteProductApi } from '@/api/product'

const products = ref<Product[]>([])
const total = ref(0)
const loading = ref(false)
const search = ref({ name: '', category: '', status: '' })
const page = ref(1)
const size = ref(20)

const columns = [
  { key: 'id', label: 'ID', width: 80 },
  { key: 'name', label: 'Name' },
  { key: 'category', label: 'Category' },
  { key: 'price', label: 'Price', formatter: (row) => `$${row.price}` },
  { key: 'stock', label: 'Stock' },
  { key: 'status', label: 'Status' }
]

async function fetchData() {
  loading.value = true
  const { data } = await getProductsApi({ ...search.value, page: page.value, size: size.value })
  products.value = data.items
  total.value = data.total
  loading.value = false
}

function onSearch() { page.value = 1; fetchData() }
function onPage(p) { page.value = p; fetchData() }

async function onDelete(row) {
  await ElMessageBox.confirm(`Delete ${row.name}?`, 'Confirm')
  await deleteProductApi(row.id)
  ElMessage.success('Deleted')
  fetchData()
}

onMounted(fetchData)
</script>

<!-- views/product/ProductEditDialog.vue -->
<template>
  <el-dialog v-model="visible" :title="isEdit ? 'Edit Product' : 'Create Product'" width="700px">
    <el-form :model="form" :rules="rules" ref="formRef" label-width="120px">
      <el-form-item label="Name" prop="name">
        <el-input v-model="form.name" />
      </el-form-item>
      <el-form-item label="Category" prop="category">
        <el-select v-model="form.category">
          <el-option v-for="c in categories" :key="c" :value="c" :label="c" />
        </el-select>
      </el-form-item>
      <el-form-item label="Price" prop="price">
        <el-input-number v-model="form.price" :min="0" />
      </el-form-item>
      <el-form-item label="Stock" prop="stock">
        <el-input-number v-model="form.stock" :min="0" />
      </el-form-item>
      <el-form-item label="Image">
        <el-upload action="/api/upload" :show-file-list="false">
          <img v-if="form.image" :src="form.image" class="preview" />
          <el-button v-else>Upload</el-button>
        </el-upload>
      </el-form-item>
    </el-form>
    
    <template #footer>
      <el-button @click="visible = false">Cancel</el-button>
      <el-button type="primary" @click="onSave">Save</el-button>
    </template>
  </el-dialog>
</template>

<template>
  <BaseTable :data="orders" :columns="columns" :total="total">
    <template #column-status="{ row }">
      <el-tag :type="statusType(row.status)">{{ row.status }}</el-tag>
    </template>
    <template #column-actions="{ row }">
      <el-button @click="viewDetail(row)">View</el-button>
      <el-button v-if="row.status === 'pending'" @click="confirmOrder(row)">Confirm</el-button>
    </template>
  </BaseTable>
  
  <el-dialog v-model="detailVisible" title="Order Detail" width="800px">
    <h3>Order #{{ currentOrder?.id }}</h3>
    <p>User: {{ currentOrder?.user }}</p>
    <p>Total: ${{ currentOrder?.total }}</p>
    <h4>Items:</h4>
    <ul>
      <li v-for="item in currentOrder?.items" :key="item.id">
        {{ item.name }} × {{ item.quantity }} = ${{ item.price * item.quantity }}
      </li>
    </ul>
  </el-dialog>
</template>

<template>
  <BaseTable :data="users" :columns="columns">
    <template #column-roles="{ row }">
      <el-tag v-for="role in row.roles" :key="role" :type="roleType(role)">
        {{ role }}
      </el-tag>
    </template>
    <template #column-actions="{ row }">
      <el-button @click="editRoles(row)">Edit Roles</el-button>
    </template>
  </BaseTable>
  
  <el-dialog v-model="rolesDialog" title="Edit Roles">
    <el-checkbox-group v-model="selectedRoles">
      <el-checkbox v-for="r in allRoles" :key="r" :value="r">{{ r }}</el-checkbox>
    </el-checkbox-group>
    <template #footer>
      <el-button @click="saveRoles">Save</el-button>
    </template>
  </el-dialog>
</template>

// utils/roles.ts
export const ROLES = {
  admin: {
    label: 'Admin',
    permissions: ['*']  // Full Access
  },
  manager: {
    label: 'Manager',
    permissions: ['product.*', 'order.*', 'user.read']
  },
  editor: {
    label: 'Editor',
    permissions: ['product.read', 'product.edit', 'order.read']
  },
  viewer: {
    label: 'Viewer',
    permissions: ['*.read']
  },
  guest: {
    label: 'Guest',
    permissions: ['product.read']
  }
}

<template>
  <el-table :data="coupons" stripe>
    <el-table-column prop="code" label="Code" />
    <el-table-column prop="type" label="Type" :formatter="formatType" />
    <el-table-column prop="discount" label="Discount" />
    <el-table-column label="Status">
      <template #default="{ row }">
        <el-tag :type="statusType(row.status)">{{ row.status }}</el-tag>
      </template>
    </el-table-column>
    <el-table-column label="Valid Period">
      <template #default="{ row }">
        {{ formatDate(row.startAt) }} ~ {{ formatDate(row.endAt) }}
      </template>
    </el-table-column>
  </el-table>
</template>

// vite.config.ts(Production Environment Optimization)
build: {
  outDir: 'dist',
  sourcemap: true,  // Used for Sentry
  minify: 'esbuild',
  cssMinify: 'lightningcss',
  rollupOptions: {
    output: {
      manualChunks: {
        'vue-vendor': ['vue', 'vue-router', 'pinia'],
        'echarts-vendor': ['echarts', 'vue-echarts'],
        'ui-vendor': ['element-plus'],
        'utils': ['axios', 'dayjs']
      }
    }
  }
}

npm install -g vercel
vercel --prod

// vercel.json
{
  "build": { "command": "npm run build" },
  "outputDirectory": "dist",
  "framework": "vite",
  "rewrites": [
    { "source": "/(.*)", "destination": "/index.html" }
  ]
}

// main.ts
import * as Sentry from '@sentry/vue'

Sentry.init({
  app,
  dsn: 'https://your-dsn@sentry.io/123',
  tracesSampleRate: 0.1
})