create-koa-boot 1.0.0

package/templates/example/uniapp/services/modules/fileUpload.js

@@ -0,0 +1,261 @@
+/**
+ * 文件上传 API 模块
+ * 对应后端 /system/file-upload 接口族
+ *
+ * @typedef {Object} FileRecord
+ * @property {string} id
+ * @property {string} fileNo      - 文件编号
+ * @property {string} name        - 文件名
+ * @property {number} size        - 文件大小（字节）
+ * @property {string} type        - MIME 类型
+ * @property {string} url         - 文件访问 URL
+ * @property {string} [description] - 文件描述
+ * @property {string} createdAt
+ * @property {string} updatedAt
+ */
+
+import http from '@/http/ajax.js'
+import * as config from '@/config/index.js'
+
+// ==================== 常量 ====================
+
+/** 上传接口路径（BASE_API_URL 已含 /api 前缀，此处只需相对路径） */
+export const UPLOAD_URL = '/system/file-upload'
+
+/** multipart/form-data 表单字段名 */
+export const UPLOAD_FIELD_NAME = 'file'
+
+/** 默认允许的文件类型（MIME） */
+const ALLOWED_MIME_TYPES = [
+	'image/jpeg',
+	'image/png',
+	'image/gif',
+	'image/webp',
+	'image/bmp',
+	'application/pdf',
+	'application/msword',
+	'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+	'application/vnd.ms-excel',
+	'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+	'text/plain',
+	'application/zip',
+	'application/x-rar-compressed',
+	'video/mp4',
+	'audio/mpeg'
+]
+
+/** 默认允许的文件后缀（小写，含点） */
+const ALLOWED_EXTENSIONS = [
+	'.jpg', '.jpeg', '.png', '.gif', '.webp', '.bmp',
+	'.pdf',
+	'.doc', '.docx',
+	'.xls', '.xlsx',
+	'.txt',
+	'.zip', '.rar',
+	'.mp4',
+	'.mp3'
+]
+
+/** 默认最大文件大小（字节，默认 10MB） */
+export const DEFAULT_MAX_SIZE = 10 * 1024 * 1024
+
+// ==================== 工具函数 ====================
+
+/**
+ * 从文件名中提取后缀（小写，含点）
+ * @param {string} filename
+ * @returns {string} 如 '.jpg'
+ */
+function getExtension(filename) {
+	if (!filename) return ''
+	const idx = filename.lastIndexOf('.')
+	if (idx === -1) return ''
+	return filename.slice(idx).toLowerCase()
+}
+
+// ==================== 校验函数 ====================
+
+/**
+ * 校验上传文件是否合法
+ * @param {Object} options
+ * @param {string} options.name       - 文件名
+ * @param {number} options.size       - 文件大小（字节）
+ * @param {string} [options.type]     - MIME 类型
+ * @param {number} [maxSize]          - 最大大小（默认 DEFAULT_MAX_SIZE）
+ * @param {string[]} [allowedTypes]   - 允许的 MIME 列表
+ * @param {string[]} [allowedExts]    - 允许的后缀列表
+ * @returns {{ valid: boolean, message: string }} 校验结果
+ */
+export function validateFile(options, { maxSize, allowedTypes, allowedExts } = {}) {
+	const { name, size, type } = options || {}
+
+	const max = maxSize ?? DEFAULT_MAX_SIZE
+	const mimes = allowedTypes ?? ALLOWED_MIME_TYPES
+	const exts = allowedExts ?? ALLOWED_EXTENSIONS
+
+	// 1. 文件名为空
+	if (!name) {
+		return { valid: false, message: '文件名不能为空' }
+	}
+
+	// 2. 文件大小为 0 或负数
+	if (!size || size <= 0) {
+		return { valid: false, message: '文件大小无效' }
+	}
+
+	// 3. 大小超限
+	if (size > max) {
+		const maxMB = (max / 1024 / 1024).toFixed(1)
+		return { valid: false, message: `文件大小不能超过 ${maxMB}MB，当前文件 ${(size / 1024 / 1024).toFixed(1)}MB` }
+	}
+
+	// 4. 后缀校验（优先使用 MIME 校验）
+	const ext = getExtension(name)
+	if (ext && !exts.includes(ext)) {
+		// 后缀不在白名单，再尝试 MIME 校验
+		if (!type || !mimes.includes(type)) {
+			return { valid: false, message: `不支持的文件类型 "${ext}"` }
+		}
+	}
+
+	// 5. MIME 类型校验
+	if (type && !mimes.includes(type)) {
+		// MIME 不在白名单，但后缀可能在（如图片无 MIME 的场景）
+		if (ext && exts.includes(ext)) {
+			return { valid: true, message: '' }
+		}
+		return { valid: false, message: `不支持的文件类型 "${type}"` }
+	}
+
+	return { valid: true, message: '' }
+}
+
+// ==================== API 方法 ====================
+
+/**
+ * 上传文件
+ * 使用 uni.uploadFile，自动注入 token、拼接完整 URL
+ *
+ * @param {Object|string} filePath     - uni-app 选择的文件对象或临时路径
+ * @param {Object} [options]
+ * @param {string} [options.filePath]  - 文件临时路径（如果第一参数是对象则自动取 .path）
+ * @param {string} [options.name]      - 自定义文件名（用于校验提示）
+ * @param {number} [options.maxSize]   - 自定义大小限制
+ * @param {string[]} [options.allowedTypes] - 自定义允许 MIME 类型
+ * @param {Object} [options.formData]  - 额外的表单数据
+ * @returns {Promise<{ code: number, message: string, data: FileRecord }>}
+ */
+export function uploadFile(filePath, options = {}) {
+	return new Promise((resolve, reject) => {
+		// 参数归一化
+		let tempPath = ''
+		let fileInfo = { name: '', size: 0, type: '' }
+
+		if (typeof filePath === 'string') {
+			tempPath = filePath
+		} else if (filePath && typeof filePath === 'object') {
+			tempPath = filePath.path || filePath.tempFilePath || options.filePath || ''
+			fileInfo = {
+				name: filePath.name || options.name || '',
+				size: filePath.size || options.size || 0,
+				type: filePath.type || options.type || ''
+			}
+			// options 中的字段优先级更高
+			if (options.name) fileInfo.name = options.name
+			if (options.size) fileInfo.size = options.size
+			if (options.type) fileInfo.type = options.type
+		} else {
+			reject(new Error('无效的文件路径参数'))
+			return
+		}
+
+		if (!tempPath) {
+			reject(new Error('文件路径为空'))
+			return
+		}
+
+		// 文件校验
+		if (fileInfo.name || fileInfo.size) {
+			const { valid, message } = validateFile(fileInfo, {
+				maxSize: options.maxSize,
+				allowedTypes: options.allowedTypes
+			})
+			if (!valid) {
+				uni.showToast({ title: message, icon: 'none' })
+				reject(new Error(message))
+				return
+			}
+		}
+
+		// 注入 token
+		const token = uni.getStorageSync('token')
+		const header = {}
+		if (token) {
+			header['Authorization'] = `Bearer ${token}`
+		}
+
+		const baseUrl = (config.BASE_API_URL || '').replace(/\/$/, '')
+		const fullUrl = baseUrl + UPLOAD_URL
+
+		uni.showLoading({ title: '上传中...', mask: true })
+
+		uni.uploadFile({
+			url: fullUrl,
+			filePath: tempPath,
+			name: UPLOAD_FIELD_NAME,
+			header,
+			formData: options.formData || {},
+			timeout: config.REQUEST_TIMEOUT || 60000,
+			success: (res) => {
+				uni.hideLoading()
+				try {
+					const data = JSON.parse(res.data)
+					const code = data.code
+
+					if (code === 0 || code === 200 || code === 'S' || code === 'success') {
+						resolve(data)
+					} else if (code === 401 || code === 'U00001') {
+						uni.showToast({ title: '登录已过期，请重新登录', icon: 'none' })
+						uni.removeStorageSync('token')
+						setTimeout(() => uni.reLaunch({ url: '/pages/login/index' }), 1500)
+						reject(new Error('登录已过期'))
+					} else {
+						const msg = data.message || data.msg || '上传失败'
+						uni.showToast({ title: msg, icon: 'none' })
+						reject(new Error(msg))
+					}
+				} catch (parseErr) {
+					reject(new Error('上传响应解析失败'))
+				}
+			},
+			fail: (err) => {
+				uni.hideLoading()
+				console.error('[fileUpload] 上传请求失败:', err)
+				uni.showToast({ title: '网络异常，上传失败', icon: 'none' })
+				reject(err)
+			}
+		})
+	})
+}
+
+/**
+ * 删除已上传文件
+ * @param {string} id - 文件记录 ID
+ * @returns {Promise<{ code: number, message: string, data: boolean }>}
+ */
+export function deleteFile(id) {
+	return http.delete(`/system/file-upload/${id}`)
+}
+
+/**
+ * 批量查询文件详情（根据 fileNo 列表）
+ * @param {string[]} fileNos - 文件编号数组
+ * @returns {Promise<{ code: number, message: string, data: FileRecord[] }>}
+ */
+export function getFilesByFileNos(fileNos) {
+	const nos = (fileNos || []).filter(Boolean).join(',')
+	if (!nos) {
+		return Promise.reject(new Error('fileNos 不能为空'))
+	}
+	return http.get('/system/file-upload/batch', { fileNos: nos })
+}

package/templates/example/uniapp/services/modules/message.js

@@ -0,0 +1,77 @@
+/**
+ * 消息通知 API 模块
+ * 对应后端：backend/src/business/notification（路由前缀 /api/notification）
+ * 响应结构：{ code, data, message }，业务数据在 res.data
+ */
+
+import http from '@/http/ajax.js'
+
+const PREFIX = '/notification'
+
+export const messageApi = {
+	/**
+	 * 分页查询当前用户消息（分类/已读筛选，按时间倒序）
+	 * @param {Object} params - { page, pageSize, msgType?: 'TODO'|'PROGRESS'|'WARNING', isRead?: boolean }
+	 */
+	getPage(params = {}) {
+		return http.get(`${PREFIX}/page`, params)
+	},
+
+	/**
+	 * 未读消息数（红点轮询）
+	 */
+	getUnreadCount(options = {}) {
+		return http.get(`${PREFIX}/unread-count`, {}, options)
+	},
+
+	/**
+	 * 标记单条消息已读（仅限本人消息）
+	 * @param {string} id
+	 */
+	markRead(id) {
+		return http.patch(`${PREFIX}/${id}/read`)
+	},
+
+	/**
+	 * 全部标记已读（仅限本人消息）
+	 */
+	markAllRead() {
+		return http.patch(`${PREFIX}/read-all`)
+	},
+
+	/**
+	 * 外部通知测试推送接收人列表（仅管理员）
+	 * 返回 { channel: { type, dependency, configured, reason }, users: [...] }
+	 * dependency: 'phone'(短信) | 'email'(邮件) | 'wechat_userid'(企微)
+	 * @param {string} [keyword] - 按姓名/账号/手机号/邮箱过滤
+	 */
+	getReceivers(keyword = '') {
+		return http.get(`${PREFIX}/receivers`, { keyword })
+	},
+
+	/**
+	 * 外部通知测试发送（仅管理员），按当前 EXTERNAL_NOTIFY_CHANNEL 渠道发送
+	 * @param {Object} payload - { receiverUserIds: string[], title?: string, content: string }
+	 */
+	testSend(payload) {
+		return http.post(`${PREFIX}/test-send`, payload)
+	},
+
+	/**
+	 * APP 推送测试接收人列表（仅管理员，独立链路）
+	 * 返回 { channel: { type:'app', dependency:'push_cid', configured, reason }, users: [...] }
+	 * @param {string} [keyword] - 按姓名/账号/手机号过滤
+	 */
+	getAppReceivers(keyword = '') {
+		return http.get(`${PREFIX}/app/receivers`, { keyword })
+	},
+
+	/**
+	 * APP 推送测试发送（仅管理员，独立链路），按 APP_PUSH_ENABLED 开关推送
+	 * 只有登录过 App 并上报过 cid 的用户可送达
+	 * @param {Object} payload - { receiverUserIds: string[], title?: string, content: string }
+	 */
+	appTestSend(payload) {
+		return http.post(`${PREFIX}/app/test-send`, payload)
+	}
+}

package/templates/example/uniapp/stores/cart.js

@@ -0,0 +1,126 @@
+import { defineStore } from 'pinia'
+
+const STORAGE_KEY = 'cart_items'
+
+/**
+ * 购物车状态管理
+ * 商品项结构: { skuId, name, spec, price, minQty, quantity, checked, imageNo, imageUrl }
+ * 本地持久化，后端购物车接口就绪后可在 actions 中接入同步逻辑
+ */
+export const useCartStore = defineStore('cart', {
+	state: () => ({
+		items: []
+	}),
+	getters: {
+		/** 购物车商品总件数（角标用） */
+		totalCount(state) {
+			return state.items.reduce((sum, item) => sum + item.quantity, 0)
+		},
+		/** 已勾选商品列表 */
+		checkedItems(state) {
+			return state.items.filter(item => item.checked)
+		},
+		/** 已勾选件数 */
+		checkedCount() {
+			return this.checkedItems.length
+		},
+		/** 已勾选商品合计金额 */
+		checkedAmount() {
+			return this.checkedItems.reduce((sum, item) => sum + item.price * item.quantity, 0)
+		},
+		/** 是否全选 */
+		isAllChecked(state) {
+			return state.items.length > 0 && state.items.every(item => item.checked)
+		}
+	},
+	actions: {
+		/** 从本地存储恢复购物车 */
+		initFromStorage() {
+			try {
+				const cached = uni.getStorageSync(STORAGE_KEY)
+				if (Array.isArray(cached)) {
+					this.items = cached
+				}
+			} catch (e) {
+				console.warn('[store/cart] initFromStorage failed', e)
+			}
+		},
+		/** 持久化到本地存储 */
+		persist() {
+			uni.setStorageSync(STORAGE_KEY, this.items)
+		},
+		/**
+		 * 加入购物车（重复加购默认累加数量）
+		 * @param {Object} product - { skuId, name, spec, price, minQty }
+		 * @param {number} [quantity] - 默认为最低起订量
+		 * @param {boolean} [replace=false] - 已存在时直接覆盖数量并刷新信息快照（一键补货用）
+		 */
+		addItem(product, quantity, replace = false) {
+			const exist = this.items.find(item => item.skuId === product.skuId)
+			const minQty = product.minQty || 1
+			if (exist) {
+				exist.quantity = replace
+					? Math.max(minQty, quantity || minQty)
+					: exist.quantity + (quantity || 1)
+				if (replace) {
+					exist.name = product.name
+					exist.spec = product.spec || ''
+					exist.price = product.price
+					exist.minQty = minQty
+					exist.imageNo = product.imageNo || ''
+					exist.imageUrl = product.imageUrl || ''
+				}
+			} else {
+				this.items.push({
+					skuId: product.skuId,
+					name: product.name,
+					spec: product.spec || '',
+					price: product.price,
+					minQty,
+					quantity: quantity || minQty,
+					checked: true,
+					imageNo: product.imageNo || '',
+					imageUrl: product.imageUrl || ''
+				})
+			}
+			this.persist()
+		},
+		/** 修改数量（不低于最低起订量） */
+		updateQuantity(skuId, quantity) {
+			const item = this.items.find(i => i.skuId === skuId)
+			if (!item) return
+			item.quantity = Math.max(item.minQty || 1, quantity)
+			this.persist()
+		},
+		/** 勾选/取消勾选单项 */
+		toggleChecked(skuId) {
+			const item = this.items.find(i => i.skuId === skuId)
+			if (!item) return
+			item.checked = !item.checked
+			this.persist()
+		},
+		/** 全选/取消全选 */
+		toggleAllChecked() {
+			const target = !this.isAllChecked
+			this.items.forEach(item => {
+				item.checked = target
+			})
+			this.persist()
+		},
+		/** 移除单项 */
+		removeItem(skuId) {
+			this.items = this.items.filter(i => i.skuId !== skuId)
+			this.persist()
+		},
+		/** 移除已勾选项（结算/批量删除后调用） */
+		removeChecked() {
+			this.items = this.items.filter(i => !i.checked)
+			this.persist()
+		},
+		/** 清空购物车 */
+		clear() {
+			this.items = []
+			this.persist()
+		}
+	}
+})

package/templates/example/uniapp/stores/index.js

@@ -0,0 +1,5 @@
+import * as Pinia from 'pinia'
+
+const store = Pinia.createPinia()
+
+export default store