create-koa-boot 1.0.0

package/templates/example/uniapp/components/loading-view.vue

@@ -0,0 +1,77 @@
+<template>
+	<view v-if="visible" class="loading-view">
+		<view class="loading-view__mask" @touchmove.stop.prevent />
+		<view class="loading-view__content">
+			<view class="loading-view__spinner" />
+			<text class="loading-view__text">{{ text }}</text>
+		</view>
+	</view>
+</template>
+
+<script>
+/**
+ * 全局加载组件
+ *
+ * @props {boolean} visible - 是否显示
+ * @props {string} text - 加载文字
+ */
+export default {
+	name: 'LoadingView',
+	props: {
+		visible: { type: Boolean, default: false },
+		text: { type: String, default: '加载中...' }
+	}
+}
+</script>
+
+<style lang="scss" scoped>
+.loading-view {
+	position: fixed;
+	top: 0;
+	left: 0;
+	right: 0;
+	bottom: 0;
+	z-index: 9999;
+	display: flex;
+	align-items: center;
+	justify-content: center;
+
+	&__mask {
+		position: absolute;
+		top: 0;
+		left: 0;
+		right: 0;
+		bottom: 0;
+		background: rgba(0, 0, 0, 0.15);
+	}
+
+	&__content {
+		position: relative;
+		display: flex;
+		flex-direction: column;
+		align-items: center;
+		padding: 40rpx 60rpx;
+		background: rgba(0, 0, 0, 0.75);
+		border-radius: 16rpx;
+	}
+
+	&__spinner {
+		width: 48rpx;
+		height: 48rpx;
+		border: 4rpx solid rgba(255, 255, 255, 0.3);
+		border-top-color: #ffffff;
+		border-radius: 50%;
+		animation: spin 0.8s linear infinite;
+	}
+
+	&__text {
+		margin-top: 16rpx;
+		font-size: 26rpx;
+		color: #ffffff;
+	}
+}
+
+@keyframes spin {
+	to { transform: rotate(360deg); }
+}
+</style>

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

@@ -0,0 +1,7 @@
+/**
+ * Composable 统一导出
+ */
+
+export { useRequest } from './useRequest'
+export { usePagination } from './usePagination'
+export { useNetwork } from './useNetwork'

package/templates/example/uniapp/composables/useNetwork.js

@@ -0,0 +1,56 @@
+/**
+ * useNetwork - 网络状态监听组合式函数
+ *
+ * 提供网络类型、是否连接等状态，并支持状态变化回调
+ *
+ * @example
+ * const { isConnected, networkType } = useNetwork()
+ * watch(isConnected, val => { if (!val) uni.showToast({ title: '网络已断开' }) })
+ */
+import { ref, onMounted, onUnmounted } from 'vue'
+
+export function useNetwork(options = {}) {
+	const { onConnect, onDisconnect, onChange } = options
+
+	const isConnected = ref(true)
+	const networkType = ref('unknown')
+
+	let changeHandler = null
+
+	function updateNetwork(res) {
+		isConnected.value = res.isConnected
+		networkType.value = res.networkType
+
+		if (res.isConnected) {
+			onConnect?.(res)
+		} else {
+			onDisconnect?.(res)
+		}
+		onChange?.(res)
+	}
+
+	onMounted(() => {
+		uni.getNetworkType({
+			success: res => {
+				networkType.value = res.networkType
+				isConnected.value = res.networkType !== 'none'
+			}
+		})
+
+		changeHandler = res => updateNetwork(res)
+		uni.onNetworkStatusChange(changeHandler)
+	})
+
+	onUnmounted(() => {
+		if (changeHandler) {
+			uni.offNetworkStatusChange(changeHandler)
+		}
+	})
+
+	return {
+		isConnected,
+		networkType
+	}
+}
+
+export default useNetwork

package/templates/example/uniapp/composables/usePagination.js

@@ -0,0 +1,96 @@
+/**
+ * usePagination - 分页列表组合式函数
+ *
+ * 封装了分页列表的常见逻辑：loading、finished、list、reset、loadMore
+ *
+ * @example
+ * const { list, loading, finished, loadMore, reset } = usePagination(demoApi.getList)
+ * // 下拉刷新: reset() → loadMore()
+ * // 上拉加载: loadMore()
+ */
+import { ref, reactive } from 'vue'
+
+export function usePagination(apiFn, options = {}) {
+	const {
+		pageKey = 'page',
+		sizeKey = 'size',
+		defaultSize = 10,
+		immediate = false,
+		formatQuery = null
+	} = options
+
+	const list = ref([])
+	const loading = ref(false)
+	const finished = ref(false)
+	const error = ref(null)
+	const pagination = reactive({
+		page: 1,
+		size: defaultSize,
+		total: 0
+	})
+
+	async function loadMore(extraParams = {}) {
+		if (loading.value || finished.value) return []
+
+		loading.value = true
+		error.value = null
+
+		let query = { [pageKey]: pagination.page, [sizeKey]: pagination.size, ...extraParams }
+		if (formatQuery) {
+			query = formatQuery(query)
+		}
+
+		try {
+			const res = await apiFn(query)
+			const result = res?.data ?? res
+			const rows = result.rows ?? result.list ?? result.records ?? result.data ?? []
+			const total = result.total ?? result.count ?? rows.length
+
+			if (pagination.page === 1) {
+				list.value = rows
+			} else {
+				list.value = [...list.value, ...rows]
+			}
+
+			pagination.total = total
+			finished.value = list.value.length >= total
+			pagination.page++
+
+			return rows
+		} catch (e) {
+			error.value = e
+			throw e
+		} finally {
+			loading.value = false
+		}
+	}
+
+	function reset() {
+		pagination.page = 1
+		list.value = []
+		finished.value = false
+		error.value = null
+	}
+
+	async function refresh(extraParams) {
+		reset()
+		return loadMore(extraParams)
+	}
+
+	if (immediate) {
+		loadMore()
+	}
+
+	return {
+		list,
+		loading,
+		finished,
+		error,
+		pagination,
+		loadMore,
+		reset,
+		refresh
+	}
+}
+
+export default usePagination

package/templates/example/uniapp/composables/useRequest.js

@@ -0,0 +1,73 @@
+/**
+ * useRequest - 通用请求组合式函数
+ *
+ * 封装了 loading、error、data 状态管理和请求执行逻辑
+ *
+ * @example
+ * const { data, loading, error, run } = useRequest(demoApi.getList)
+ * run({ page: 1, size: 10 })
+ */
+import { ref } from 'vue'
+
+export function useRequest(apiFn, options = {}) {
+	const {
+		immediate = false,
+		initialData = null,
+		onSuccess = null,
+		onError = null,
+		onFinally = null
+	} = options
+
+	const data = ref(initialData)
+	const loading = ref(false)
+	const error = ref(null)
+
+	/**
+	 * 执行请求
+	 * @param  {...any} args - 传递给 apiFn 的参数
+	 * @returns {Promise}
+	 */
+	async function run(...args) {
+		loading.value = true
+		error.value = null
+
+		try {
+			const res = await apiFn(...args)
+			data.value = res?.data ?? res
+			onSuccess?.(data.value)
+			return data.value
+		} catch (e) {
+			error.value = e
+			onError?.(e)
+			throw e
+		} finally {
+			loading.value = false
+			onFinally?.()
+		}
+	}
+
+	/** 刷新（使用上次参数重新请求） */
+	function refresh() {
+		return run(...(run._lastArgs || []))
+	}
+
+	// 包装 run，记录最后参数
+	const wrappedRun = (...args) => {
+		wrappedRun._lastArgs = args
+		return run(...args)
+	}
+
+	if (immediate) {
+		wrappedRun()
+	}
+
+	return {
+		data,
+		loading,
+		error,
+		run: wrappedRun,
+		refresh
+	}
+}
+
+export default useRequest

package/templates/example/uniapp/config/enums.js

@@ -0,0 +1,14 @@
+/**
+ * 前端统一枚举聚合（系统模块演示版）
+ * 项目已裁剪为「系统模块演示」形态，供应链相关枚举（销售/采购/库存/财务）已移除，
+ * 此处仅保留系统级通用枚举，与后端 backend/src/common/enums/system 保持一致。
+ * 后端枚举变动时，同步修改本文件即可全局生效
+ */
+
+/* ===================== 系统级 system ===================== */
+/** 操作日志-操作类型 */
+export const OPERATION_ACTION_TYPES = ['create', 'update', 'delete', 'login', 'export', 'import', 'query']
+/** 登录日志-动作类型 */
+export const LOGIN_ACTION_TYPES = ['login', 'logout']
+/** 日志结果 */
+export const LOG_STATUSES = ['success', 'fail']

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

@@ -0,0 +1,44 @@
+/**
+ * 应用运行配置
+ * 根据环境变量切换不同环境的 API 地址
+ */
+
+// 当前环境：development / production
+const ENV = process.env.NODE_ENV || 'development'
+
+// 各环境 API 地址配置
+const API_CONFIG = {
+	development: 'http://192.168.124.35:3005/api',
+	production: 'https://api.example.com'
+}
+
+// 当前生效的 API 地址（可被 .env 文件中的 VUE_APP_BASE_API 覆盖）
+const BASE_API_URL = process.env.VUE_APP_BASE_API || API_CONFIG[ENV]
+
+// 各环境 H5 站点地址（用于 APP/小程序分享时拼接可访问的完整链接）
+const H5_SITE_CONFIG = {
+	development: 'http://192.168.124.35:8088',
+	production: 'https://h5.example.com'
+}
+
+// 当前生效的 H5 站点地址（可被 .env 文件中的 VUE_APP_H5_URL 覆盖）
+const H5_SITE_URL = process.env.VUE_APP_H5_URL || H5_SITE_CONFIG[ENV]
+
+// 请求超时时间（毫秒）
+const REQUEST_TIMEOUT = 30000
+
+// 是否启用请求日志（生产环境默认关闭）
+const ENABLE_LOG = ENV === 'development'
+
+// APP 推送开关（与后端 APP_PUSH_ENABLED 独立，二者都开启才会真正推送）
+// 仅 APP 端生效（H5/小程序无推送能力，自动跳过）。需在 manifest.json 勾选 Push 模块并配置 UniPush 2.0
+const APP_PUSH_ENABLED = true
+
+export {
+	ENV,
+	BASE_API_URL,
+	H5_SITE_URL,
+	REQUEST_TIMEOUT,
+	ENABLE_LOG,
+	APP_PUSH_ENABLED
+}

package/templates/example/uniapp/config/roleMenus.js

@@ -0,0 +1,150 @@
+/**
+ * 角色动态菜单配置（系统模块演示版）
+ * ==========================================================================
+ * 项目已裁剪为「系统模块演示」形态，个人中心不再展示供应链业务菜单。
+ * 此处仅保留三个演示菜单 + 首页，用于演示「后端菜单权限 + 角色映射」的
+ * 双重鉴权机制（角色映射 ∩ 后端 menuCodes），保证未授权菜单不可见且不可
+ * 通过 URL 直接访问。
+ *
+ * 说明：admin（总部管理员）拥有全部菜单，不受后端 menuCodes 约束。
+ * ==========================================================================
+ */
+
+/**
+ * 菜单项注册表（演示用，指向保留的基础页面）
+ * @param {string} key         菜单唯一标识
+ * @param {string} label       菜单名称（展示用）
+ * @param {string} desc        菜单描述（可选）
+ * @param {string} icon        uv-icon 图标名
+ * @param {string} backendCode 对应后端菜单 code（sys_menus.code）
+ * @param {string} page        移动端页面路径（未开发为空，点击提示开发中）
+ */
+export const MENU_ITEMS = [
+	{ key: 'demo',        label: '接口演示', desc: '/api/demos 演示',       icon: 'file-text',   backendCode: 'system:demo',        page: '/pages/demo/index' },
+	{ key: 'notification',label: '消息通知', desc: '/api/notification 消息', icon: 'bell',        backendCode: 'system:notification', page: '/pages/message/index' },
+	{ key: 'config',      label: '配置中心', desc: '系统配置与角色权限',     icon: 'setting',     backendCode: 'system:config',      page: '/pages/mine/index' }
+]
+
+/**
+ * 基础数据菜单（演示用，指向保留的基础页面）
+ * 权限规则：按 roles 数组直接过滤，不参与后端 menuCodes 交集校验（区别于业务菜单）
+ * @param {string} key   菜单唯一标识
+ * @param {string} label 菜单名称（展示用）
+ * @param {string} icon  uv-icon 图标名
+ * @param {string} page  移动端页面路径
+ * @param {Array}  roles 可见角色 code 列表
+ */
+export const BASE_DATA_MENUS = [
+	{ key: 'home',    label: '首页', icon: 'home', page: '/pages/index/index', roles: ['admin'] },
+	{ key: 'profile', label: '个人中心', icon: 'account', page: '/pages/mine/index', roles: ['admin'] }
+]
+
+/**
+ * 角色 → 菜单 key 映射（业务授权配置）
+ * 值为 'all' 表示拥有全部菜单
+ */
+export const ROLE_MENUS = {
+	// 演示环境：全部角色可访问演示菜单
+	admin: 'all',
+	store_manager: ['demo', 'notification', 'config'],
+	branch_warehouse_manager: ['demo', 'notification', 'config'],
+	warehouse_manager: ['demo', 'notification', 'config'],
+	purchaser: ['demo', 'notification', 'config'],
+	finance_CFO: ['demo', 'notification', 'config']
+}
+
+/** 角色显示名 */
+export const ROLE_NAMES = {
+	store_manager: '门店管理员',
+	branch_warehouse_manager: '前置仓管理员',
+	warehouse_manager: '总仓管理员',
+	purchaser: '采购员',
+	finance_CFO: '财务专员',
+	admin: '总部管理员'
+}
+
+/** 角色优先级（角色越多取权限越大者作为主角色展示） */
+const ROLE_PRIORITY = ['admin', 'warehouse_manager', 'branch_warehouse_manager', 'finance_CFO', 'purchaser', 'store_manager']
+
+/** 提取角色 code 数组 */
+export function getRoleCodes(roles = []) {
+	return (roles || []).map(r => (typeof r === 'string' ? r : r?.code)).filter(Boolean)
+}
+
+/** 获取角色显示名列表 */
+export function getRoleNames(roles = []) {
+	return getRoleCodes(roles).map(code => ROLE_NAMES[code] || code)
+}
+
+/** 获取主角色显示名（多角色时取权限最大者） */
+export function getPrimaryRoleName(roles = []) {
+	const codes = getRoleCodes(roles)
+	if (!codes.length) return ''
+	for (const code of ROLE_PRIORITY) {
+		if (codes.includes(code)) return ROLE_NAMES[code] || code
+	}
+	return codes[0]
+}
+
+/**
+ * 计算当前用户可见的业务菜单
+ * 规则：角色映射表 ∩ 后端菜单权限（admin 不受后端约束）
+ * @param {Array}  roles     后端返回的角色数组
+ * @param {Array}  menuCodes 后端返回的菜单 code 列表
+ * @returns {Array} 菜单项数组
+ */
+export function getMenusByRoles(roles = [], menuCodes = []) {
+	const roleCodes = getRoleCodes(roles)
+	if (!roleCodes.length) return []
+
+	const isAdmin = roleCodes.includes('admin')
+	if (isAdmin) return MENU_ITEMS
+
+	const allowedKeys = new Set()
+	for (const code of roleCodes) {
+		const menuKeys = ROLE_MENUS[code]
+		if (!menuKeys) continue
+		if (Array.isArray(menuKeys)) menuKeys.forEach(k => allowedKeys.add(k))
+	}
+
+	const codeSet = new Set(menuCodes || [])
+	return MENU_ITEMS.filter(item => allowedKeys.has(item.key) && codeSet.has(item.backendCode))
+}
+
+/**
+ * 获取当前用户可见的基础数据菜单（按角色过滤）
+ * @param {Array} roles 后端返回的角色数组
+ * @returns {Array} 菜单项数组
+ */
+export function getBaseDataMenusByRoles(roles = []) {
+	const roleCodes = getRoleCodes(roles)
+	if (!roleCodes.length) return []
+	return BASE_DATA_MENUS.filter(item => item.roles.some(r => roleCodes.includes(r)))
+}
+
+/**
+ * 页面路径 → 菜单项映射（用于路由守卫的 URL 权限拦截）
+ * 仅登记已开发页面的菜单项；page 中可能携带 query，仅取路径部分
+ */
+export function getPageMenuMap() {
+	const map = {}
+	for (const item of MENU_ITEMS) {
+		if (item.page) {
+			const path = item.page.split('?')[0]
+			;(map[path] = map[path] || []).push(item)
+		}
+	}
+	return map
+}
+
+/**
+ * 判断当前用户是否可访问指定页面（App.vue 路由守卫使用）
+ * @param {string} pagePath 页面路径（不含 query），如 '/pages/demo/index'
+ * @returns {boolean}
+ */
+export function canAccessPage(pagePath, roles = [], menuCodes = []) {
+	const pageMenus = getPageMenuMap()[pagePath]
+	if (!pageMenus || !pageMenus.length) return true // 非业务受保护页面放行
+	const visibleKeys = new Set(getMenusByRoles(roles, menuCodes).map(item => item.key))
+	return pageMenus.some(item => visibleKeys.has(item.key))
+}

package/templates/example/uniapp/http/ajax.js

@@ -0,0 +1,144 @@
+/**
+ * HTTP 请求核心模块
+ * 基于 uni-ajax (兼容 uni-app 的 ajax 封装)
+ * 提供统一的请求/响应拦截、token 注入、错误处理
+ *
+ * 注意：需要安装 uni-ajax 插件到 uni_modules 目录
+ * 如未安装，可替换为 uni.request 原生封装
+ */
+
+import * as config from '@/config/index.js'
+
+/**
+ * 简易请求封装（不依赖第三方 ajax 库）
+ * 如项目中已有 uni-ajax 模块，可替换 import 路径
+ */
+const http = {
+	/**
+	 * 发起请求
+	 * @param {Object} options - 请求配置
+	 * @returns {Promise}
+	 */
+	request(options = {}) {
+		const { url, method = 'GET', data = {}, header = {}, showLoading = false, silent = false, timeout = config.REQUEST_TIMEOUT } = options
+
+		if (showLoading) {
+			uni.showLoading({ title: '加载中...', mask: true })
+		}
+
+		// 注入 token
+		const token = uni.getStorageSync('token')
+		const headers = {
+			'Content-Type': 'application/json;charset=utf-8',
+			...header
+		}
+		if (token) {
+			headers['Authorization'] = `Bearer ${token}`
+		}
+
+		return new Promise((resolve, reject) => {
+			uni.request({
+				url: config.BASE_API_URL + url,
+				method,
+				data,
+				header: headers,
+				timeout,
+				success: res => {
+					if (showLoading) uni.hideLoading()
+					this._handleResponse(res, resolve, reject, silent)
+				},
+				fail: err => {
+					if (showLoading) uni.hideLoading()
+					this._handleError(err, reject)
+				}
+			})
+		})
+	},
+
+	get(url, params = {}, options = {}) {
+		return this.request({ url, method: 'GET', data: params, ...options })
+	},
+
+	post(url, data = {}, options = {}) {
+		return this.request({ url, method: 'POST', data, ...options })
+	},
+
+	put(url, data = {}, options = {}) {
+		return this.request({ url, method: 'PUT', data, ...options })
+	},
+
+	patch(url, data = {}, options = {}) {
+		return this.request({ url, method: 'PATCH', data, ...options })
+	},
+
+	delete(url, params = {}, options = {}) {
+		return this.request({ url, method: 'DELETE', data: params, ...options })
+	},
+
+	/**
+	 * 统一响应处理
+	 * @param {boolean} [silent=false] - 静默模式：业务/HTTP 错误不弹 toast，仅 reject（供后台预取等场景）
+	 */
+	_handleResponse(res, resolve, reject, silent = false) {
+		if (config.ENABLE_LOG) {
+			console.log(`[HTTP] ${res.config?.method || ''} ${res.config?.url || ''}`, res.data)
+		}
+
+		const { statusCode, data } = res
+
+		// HTTP 状态码判断
+		if (statusCode === 200) {
+			// 根据业务 code 判断（可按项目约定调整）
+			const code = data.code
+			if (code === 0 || code === 200 || code === 'S' || code === 'success') {
+				resolve(data)
+			} else if (code === 401 || data.code === 'U00001' || data.code === 'U00000') {
+				// token 过期
+				this._handleTokenExpired(silent)
+				reject(new Error('登录已过期，请重新登录'))
+			} else {
+				const msg = data.message || data.msg || '请求失败'
+				if (!silent) uni.showToast({ title: msg, icon: 'none' })
+				reject(new Error(msg))
+			}
+		} else if (statusCode === 401) {
+			this._handleTokenExpired(silent)
+			reject(new Error('登录已过期，请重新登录'))
+		} else {
+			const msg = data?.message || data?.msg || `请求错误(${statusCode})`
+			if (!silent) uni.showToast({ title: msg, icon: 'none' })
+			reject(new Error(msg))
+		}
+	},
+
+	/** 统一错误处理 */
+	_handleError(err, reject) {
+		console.error('[HTTP] Request Error:', err)
+		uni.showToast({
+			title: '网络异常，请检查网络后重试',
+			icon: 'none'
+		})
+		reject(err)
+	},
+
+	/**
+	 * token 过期处理
+	 * @param {boolean} [silent=false] - 静默模式（登出等场景）：仅清理本地凭据，
+	 *   不弹提示、不跳转（由调用方自行处理跳转），避免与主动登出的流程冲突
+	 */
+	_handleTokenExpired(silent = false) {
+		uni.removeStorageSync('token')
+		uni.removeStorageSync('userInfo')
+		if (silent) return
+		uni.showToast({
+			title: '登录已过期，请重新登录',
+			icon: 'none',
+			duration: 2000
+		})
+		setTimeout(() => {
+			uni.reLaunch({ url: '/pages/login/index' })
+		}, 1500)
+	}
+}
+
+export default http