mta-mcp 2.6.0 → 2.7.0

package/templates/vue/api-layer/mock/index.ts

@@ -0,0 +1,122 @@
+/**
+ * Mock 系统入口
+ * 
+ * 提供 Mock 开关和常用工具函数
+ */
+import type { ApiResponse, PageData } from '../types'
+
+// Mock 开关（由环境变量控制）
+export const MOCK_ENABLED = import.meta.env.VITE_MOCK_ENABLED === 'true'
+
+// Mock 延迟时间（模拟网络请求）
+export const MOCK_DELAY = 300
+
+/**
+ * 延迟函数
+ */
+export const delay = (ms: number = MOCK_DELAY) => 
+  new Promise(resolve => setTimeout(resolve, ms))
+
+// 别名
+export const sleep = delay
+
+/**
+ * 生成成功响应
+ */
+export function successResponse<T>(data: T): ApiResponse<T> {
+  return {
+    code: 0,
+    data,
+    message: 'success',
+  }
+}
+
+/**
+ * 生成错误响应
+ */
+export function errorResponse(message: string, code = -1): ApiResponse<null> {
+  return {
+    code,
+    data: null,
+    message,
+  }
+}
+
+/**
+ * 生成分页响应
+ */
+export function generatePageResponse<T>(
+  list: T[],
+  page: number,
+  pageSize: number,
+  total?: number
+): ApiResponse<PageData<T>> {
+  const start = (page - 1) * pageSize
+  const end = start + pageSize
+  const data = list.slice(start, end)
+  
+  return {
+    code: 0,
+    data: {
+      list: data,
+      total: total ?? list.length,
+      page,
+      pageSize,
+    },
+    message: 'success',
+  }
+}
+
+/**
+ * 生成随机 ID
+ */
+export function randomId(): string {
+  return Date.now().toString(36) + Math.random().toString(36).substr(2, 9)
+}
+
+/**
+ * 生成随机日期（近 n 天内）
+ */
+export function randomDate(days = 30): string {
+  const date = new Date()
+  date.setDate(date.getDate() - Math.floor(Math.random() * days))
+  return date.toISOString().split('T')[0] + ' ' + date.toTimeString().split(' ')[0]
+}
+
+/**
+ * 从数组中随机选择
+ */
+export function randomPick<T>(arr: T[]): T {
+  return arr[Math.floor(Math.random() * arr.length)]
+}
+
+/**
+ * 生成随机整数
+ */
+export function randomInt(min: number, max: number): number {
+  return Math.floor(Math.random() * (max - min + 1)) + min
+}
+
+/**
+ * 生成随机金额（保留两位小数）
+ */
+export function randomAmount(min = 100, max = 10000): number {
+  return Number((Math.random() * (max - min) + min).toFixed(2))
+}
+
+/**
+ * 生成随机手机号
+ */
+export function randomPhone(): string {
+  const prefixes = ['138', '139', '150', '151', '152', '158', '159', '186', '187', '188']
+  return randomPick(prefixes) + String(Math.random()).slice(2, 10)
+}
+
+/**
+ * 生成随机邮箱
+ */
+export function randomEmail(name?: string): string {
+  const domains = ['qq.com', '163.com', 'gmail.com', 'outlook.com']
+  const prefix = name || `user${randomInt(1000, 9999)}`
+  return `${prefix}@${randomPick(domains)}`
+}

package/templates/vue/api-layer/modules/_template.ts

@@ -0,0 +1,109 @@
+/**
+ * [模块名] API
+ * 
+ * 💡 使用说明：
+ * 1. 复制此文件，重命名为业务模块名（如 user.ts, order.ts）
+ * 2. 修改 URLs 对象中的接口地址
+ * 3. 定义业务相关的类型
+ * 4. 实现具体的 API 函数
+ * 5. 在 modules/index.ts 中导出
+ */
+import { post, get, put, del } from '../request'
+import { MOCK_ENABLED } from '../mock'
+// import * as mockModule from '../mock/[module]'
+import type { ApiResponse, PageResponse, PageParams } from '../types'
+
+// ========== 接口地址 ==========
+
+const URLs = {
+  list: '/xxx/list',
+  detail: '/xxx/detail',
+  create: '/xxx/create',
+  update: '/xxx/update',
+  delete: '/xxx/delete',
+}
+
+// ========== 类型定义 ==========
+
+/** 数据项类型 */
+export interface ItemData {
+  id: string
+  name: string
+  status: string
+  createdAt: string
+  updatedAt: string
+  // ... 添加其他字段
+}
+
+/** 创建/更新参数 */
+export interface CreateParams {
+  name: string
+  // ... 添加其他参数
+}
+
+/** 列表查询参数 */
+export interface ListParams extends PageParams {
+  keyword?: string
+  status?: string
+  startDate?: string
+  endDate?: string
+  // ... 添加其他筛选条件
+}
+
+// ========== 接口实现 ==========
+
+/**
+ * 获取列表
+ */
+export async function getList(params: ListParams): Promise<PageResponse<ItemData>> {
+  // if (MOCK_ENABLED) return mockModule.mockGetList(params)
+  return get(URLs.list, params)
+}
+
+/**
+ * 获取详情
+ */
+export async function getDetail(id: string): Promise<ApiResponse<ItemData>> {
+  // if (MOCK_ENABLED) return mockModule.mockGetDetail(id)
+  return get(URLs.detail, { id })
+}
+
+/**
+ * 创建
+ */
+export async function create(data: CreateParams): Promise<ApiResponse<ItemData>> {
+  // if (MOCK_ENABLED) return mockModule.mockCreate(data)
+  return post(URLs.create, data)
+}
+
+/**
+ * 更新
+ */
+export async function update(id: string, data: Partial<CreateParams>): Promise<ApiResponse<ItemData>> {
+  // if (MOCK_ENABLED) return mockModule.mockUpdate(id, data)
+  return put(`${URLs.update}/${id}`, data)
+}
+
+/**
+ * 删除
+ */
+export async function remove(id: string): Promise<ApiResponse<null>> {
+  // if (MOCK_ENABLED) return mockModule.mockDelete(id)
+  return del(URLs.delete, { id })
+}
+
+/**
+ * 批量删除
+ */
+export async function batchRemove(ids: string[]): Promise<ApiResponse<null>> {
+  // if (MOCK_ENABLED) return mockModule.mockBatchDelete(ids)
+  return post(`${URLs.delete}/batch`, { ids })
+}
+
+/**
+ * 更新状态
+ */
+export async function updateStatus(id: string, status: string): Promise<ApiResponse<null>> {
+  // if (MOCK_ENABLED) return mockModule.mockUpdateStatus(id, status)
+  return put(`${URLs.update}/${id}/status`, { status })
+}

package/templates/vue/api-layer/modules/index.ts

@@ -0,0 +1,16 @@
+/**
+ * API 模块统一导出
+ * 
+ * 💡 添加新模块时：
+ * 1. 复制 _template.ts，重命名为业务模块名
+ * 2. 在此处添加 export
+ * 
+ * @example
+ * export * as userApi from './user'
+ * export * as orderApi from './order'
+ * export * as productApi from './product'
+ */
+
+// 按项目实际模块添加导出...
+// export * as userApi from './user'
+// export * as authApi from './auth'

package/templates/vue/api-layer/request.ts

@@ -0,0 +1,279 @@
+/**
+ * Axios 请求封装
+ * 
+ * 💡 自定义点（按项目调整）：
+ * - API_TIMEOUT: 请求超时时间
+ * - NO_TOKEN_URLS: 无需 Token 的接口白名单
+ * - TOKEN_KEY/USER_KEY: 本地存储键名
+ * - showMessage: UI 框架消息提示方法
+ * - 响应拦截器中的业务状态码判断
+ */
+import axios from 'axios'
+import type { AxiosInstance, AxiosRequestConfig, AxiosResponse, InternalAxiosRequestConfig } from 'axios'
+import router from '@/router'
+import type { ApiResponse } from './types'
+
+// ========== 常量配置 ==========
+
+const API_TIMEOUT = 30000
+
+// 无需 Token 的接口白名单（按项目调整）
+const NO_TOKEN_URLS = [
+  '/login',
+  '/register',
+  '/captcha',
+  '/sms-code',
+]
+
+// ========== Token 管理 ==========
+
+const TOKEN_KEY = 'app_token'
+const USER_KEY = 'app_user'
+
+export const getToken = (): string | null => localStorage.getItem(TOKEN_KEY)
+export const setToken = (token: string): void => localStorage.setItem(TOKEN_KEY, token)
+export const clearToken = (): void => {
+  localStorage.removeItem(TOKEN_KEY)
+  localStorage.removeItem(USER_KEY)
+}
+
+export const getUserInfo = <T = any>(): T | null => {
+  const userStr = localStorage.getItem(USER_KEY)
+  if (!userStr) return null
+  try {
+    return JSON.parse(userStr)
+  } catch {
+    return null
+  }
+}
+
+export const setUserInfo = (user: any): void => {
+  localStorage.setItem(USER_KEY, JSON.stringify(user))
+}
+
+// ========== 消息提示 ==========
+
+// 💡 按 UI 框架替换此对象
+// Element Plus: import { ElMessage } from 'element-plus'
+// Ant Design Vue: import { message } from 'ant-design-vue'
+
+const showMessage = {
+  success: (msg: string) => console.log('✅', msg),
+  error: (msg: string) => console.error('❌', msg),
+  warning: (msg: string) => console.warn('⚠️', msg),
+}
+
+// Element Plus 示例：
+// const showMessage = {
+//   success: (msg: string) => ElMessage.success(msg),
+//   error: (msg: string) => ElMessage.error(msg),
+//   warning: (msg: string) => ElMessage.warning(msg),
+// }
+
+// ========== 错误码映射 ==========
+
+const ERROR_CODE_MAP: Record<number, string> = {
+  400: '请求参数错误',
+  401: '登录已过期，请重新登录',
+  403: '没有操作权限',
+  404: '请求的资源不存在',
+  500: '服务器内部错误',
+  502: '网关错误',
+  503: '服务暂不可用',
+  504: '网关超时',
+}
+
+// ========== 错误处理 ==========
+
+const handleRequestError = (error: any): Promise<never> => {
+  console.error('请求错误:', error)
+  
+  if (error.code === 'ERR_NETWORK') {
+    showMessage.error('网络连接失败，请检查网络设置')
+  } else if (error.code === 'ECONNABORTED') {
+    showMessage.error('请求超时，请稍后重试')
+  }
+  
+  return Promise.reject(error)
+}
+
+const handleResponseError = (error: any): Promise<never> => {
+  const status = error?.response?.status
+  const data = error?.response?.data
+  const message = data?.message || ERROR_CODE_MAP[status] || '请求失败，请稍后重试'
+  
+  if (status === 401) {
+    clearToken()
+    showMessage.warning(message)
+    router.push({ name: 'login' }) // 💡 按项目调整登录路由
+    return Promise.reject(error)
+  }
+  
+  showMessage.error(message)
+  return Promise.reject(error)
+}
+
+// ========== Axios 实例 ==========
+
+const instance: AxiosInstance = axios.create({
+  baseURL: import.meta.env.VITE_API_BASE_URL || '/api',
+  timeout: API_TIMEOUT,
+  headers: { 'Content-Type': 'application/json' },
+})
+
+// 请求拦截器
+instance.interceptors.request.use(
+  (config: InternalAxiosRequestConfig) => {
+    const needToken = !NO_TOKEN_URLS.some(url => config.url?.includes(url))
+    
+    if (needToken) {
+      const token = getToken()
+      if (token) {
+        // 💡 按后端要求调整 Token 传递方式
+        config.headers.Authorization = `Bearer ${token}`
+        // config.headers.token = token
+      }
+    }
+    
+    return config
+  },
+  handleRequestError
+)
+
+// 响应拦截器
+instance.interceptors.response.use(
+  (response: AxiosResponse) => {
+    const res = response.data
+    
+    // 文件流直接返回
+    if (response.config.responseType === 'blob') {
+      return res
+    }
+    
+    // 💡 业务状态码判断（按后端约定调整）
+    // 格式 A: { code: 0, data, message }
+    // 格式 B: { code: 200, data, msg }
+    // 格式 C: { success: true, data, message }
+    if (res.code === 0 || res.code === 200 || res.success === true) {
+      return res
+    }
+    
+    // 401 Token 过期
+    if (res.code === 401) {
+      clearToken()
+      showMessage.warning(res.message || '登录已过期')
+      router.push({ name: 'login' })
+      return Promise.reject(new Error(res.message))
+    }
+    
+    // 其他业务错误
+    showMessage.error(res.message || res.msg || '请求失败')
+    return Promise.reject(new Error(res.message || res.msg))
+  },
+  handleResponseError
+)
+
+// ========== 请求方法 ==========
+
+export async function get<T = any>(
+  url: string,
+  params?: Record<string, any>,
+  config?: AxiosRequestConfig
+): Promise<ApiResponse<T>> {
+  return instance.get(url, { params, ...config })
+}
+
+export async function post<T = any>(
+  url: string,
+  data?: any,
+  config?: AxiosRequestConfig
+): Promise<ApiResponse<T>> {
+  return instance.post(url, data, config)
+}
+
+export async function put<T = any>(
+  url: string,
+  data?: any,
+  config?: AxiosRequestConfig
+): Promise<ApiResponse<T>> {
+  return instance.put(url, data, config)
+}
+
+export async function del<T = any>(
+  url: string,
+  params?: Record<string, any>,
+  config?: AxiosRequestConfig
+): Promise<ApiResponse<T>> {
+  return instance.delete(url, { params, ...config })
+}
+
+// ========== 工具函数 ==========
+
+/**
+ * 包装异步请求，返回 [data, error] 元组
+ * 借鉴 Go 语言错误处理风格，避免 try/catch
+ * 
+ * @example
+ * const [res, err] = await wrap(userApi.getList(params))
+ * if (err) {
+ *   console.error('请求失败:', err)
+ *   return
+ * }
+ * // 使用 res.data
+ */
+export async function wrap<T>(
+  promise: Promise<T>
+): Promise<[T, null] | [null, Error]> {
+  try {
+    const data = await promise
+    return [data, null]
+  } catch (error) {
+    return [null, error as Error]
+  }
+}
+
+/**
+ * 下载文件
+ */
+export async function downloadFile(
+  url: string,
+  params?: Record<string, any>,
+  filename?: string
+): Promise<void> {
+  const response = await instance.get(url, {
+    params,
+    responseType: 'blob',
+  })
+  
+  const blob = new Blob([response as any])
+  const link = document.createElement('a')
+  link.href = URL.createObjectURL(blob)
+  link.download = filename || 'download'
+  link.click()
+  URL.revokeObjectURL(link.href)
+}
+
+/**
+ * 上传文件
+ */
+export async function uploadFile<T = any>(
+  url: string,
+  file: File,
+  fieldName = 'file',
+  extraData?: Record<string, any>
+): Promise<ApiResponse<T>> {
+  const formData = new FormData()
+  formData.append(fieldName, file)
+  
+  if (extraData) {
+    Object.entries(extraData).forEach(([key, value]) => {
+      formData.append(key, value)
+    })
+  }
+  
+  return instance.post(url, formData, {
+    headers: { 'Content-Type': 'multipart/form-data' },
+  })
+}
+
+export default instance

package/templates/vue/api-layer/types.ts

@@ -0,0 +1,80 @@
+/**
+ * API 通用类型定义
+ * 
+ * 💡 按后端实际响应结构调整字段名
+ */
+
+/**
+ * API 响应基础结构
+ * 
+ * 常见格式：
+ * - { code: 0, data: T, message: '' }
+ * - { code: 200, data: T, msg: '' }
+ * - { success: true, data: T, message: '' }
+ */
+export interface ApiResponse<T = any> {
+  code: number
+  data: T
+  message: string
+  // msg?: string      // 备选字段名
+  // success?: boolean // 备选判断字段
+}
+
+/**
+ * 分页请求参数
+ * 
+ * 常见字段名：
+ * - page / pageNum / current
+ * - pageSize / size / limit
+ */
+export interface PageParams {
+  page: number
+  pageSize: number
+}
+
+/**
+ * 分页响应数据
+ * 
+ * 常见字段名：
+ * - list / records / items / rows
+ * - total / totalCount / count
+ */
+export interface PageData<T> {
+  list: T[]
+  total: number
+  page: number
+  pageSize: number
+}
+
+/**
+ * 分页响应（完整）
+ */
+export type PageResponse<T> = ApiResponse<PageData<T>>
+
+/**
+ * 通用 ID 类型
+ */
+export type ID = string | number
+
+/**
+ * 通用状态枚举
+ */
+export type CommonStatus = 'active' | 'inactive' | 'pending' | 'deleted'
+
+/**
+ * 排序参数
+ */
+export interface SortParams {
+  sortField?: string
+  sortOrder?: 'asc' | 'desc' | 'ascend' | 'descend'
+}
+
+/**
+ * 时间范围参数
+ */
+export interface DateRangeParams {
+  startDate?: string
+  endDate?: string
+  startTime?: string
+  endTime?: string
+}