create-koa-boot 1.0.0

package/templates/example/uniapp/pages.json

@@ -0,0 +1,89 @@
+{
+	"pages": [
+		{
+			"path": "pages/login/index",
+			"style": {
+				"navigationStyle": "custom",
+				"navigationBarTitleText": "登录"
+			}
+		},
+		{
+			"path": "pages/home/index",
+			"style": {
+				"navigationStyle": "custom"
+			}
+		},
+		{
+			"path": "pages/mine/index",
+			"style": {
+				"navigationStyle": "custom"
+			}
+		},
+		{
+			"path": "pages/mine/profile/index",
+			"style": {
+				"navigationStyle": "custom"
+			}
+		},
+		{
+			"path": "pages/mine/about/index",
+			"style": {
+				"navigationStyle": "custom"
+			}
+		},
+		{
+			"path": "pages/mine/security/index",
+			"style": {
+				"navigationStyle": "custom"
+			}
+		},
+		{
+			"path": "pages/mine/help/index",
+			"style": {
+				"navigationStyle": "custom"
+			}
+		},
+		{
+			"path": "pages/message/index",
+			"style": {
+				"navigationStyle": "custom",
+				"navigationBarTitleText": "消息中心",
+				"enablePullDownRefresh": true,
+				"onReachBottomDistance": 100
+			}
+		},
+		{
+			"path": "pages/index/index",
+			"style": {
+				"navigationBarTitleText": "首页",
+				"navigationBarBackgroundColor": "#2979ff",
+				"navigationBarTextStyle": "white"
+			}
+		},
+		{
+			"path": "pages/demo/index",
+			"style": {
+				"navigationBarTitleText": "接口演示",
+				"navigationBarBackgroundColor": "#2979ff",
+				"navigationBarTextStyle": "white",
+				"enablePullDownRefresh": true,
+				"onReachBottomDistance": 100
+			}
+		},
+		{
+			"path": "pages/demo/detail",
+			"style": {
+				"navigationBarTitleText": "详情",
+				"navigationBarBackgroundColor": "#2979ff",
+				"navigationBarTextStyle": "white"
+			}
+		}
+	],
+	"globalStyle": {
+		"navigationBarTextStyle": "black",
+		"navigationBarTitleText": "uni-app Scaffold",
+		"navigationBarBackgroundColor": "#F8F8F8",
+		"backgroundColor": "#F5F5F5"
+	},
+	"uniIdRouter": {}
+}

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

@@ -0,0 +1,22 @@
+/**
+ * API 模块入口
+ * 统一导出所有业务 API 模块
+ */
+
+import http from '@/http/ajax.js'
+
+/**
+ * 通用请求方法
+ * @param {Object} options
+ * @returns {Promise}
+ */
+export const request = options => http.request(options)
+
+export { http }
+
+// 按业务模块导出 API
+export { authApi } from './modules/auth'
+export { demoApi } from './modules/demo'
+export { commonApi } from './modules/common'
+export { messageApi } from './modules/message'
+export { aiApi } from './modules/ai'

package/templates/example/uniapp/services/mock/goods.js

@@ -0,0 +1,73 @@
+/**
+ * 商品 Mock 数据（订货商城示例）
+ * 后端接口就绪后替换为 services/modules 下的真实 API
+ */
+
+/** 首页热销商品 */
+export const HOT_PRODUCTS = [
+	{ skuId: 'SKU001', name: '东北大米 5kg', spec: '袋装', price: 29.9, stock: 200, minQty: 1 },
+	{ skuId: 'SKU002', name: '大豆油 5L', spec: '桶装', price: 45.0, stock: 90, minQty: 10 },
+	{ skuId: 'SKU003', name: '新鲜蔬菜组合装', spec: '箱装', price: 41.89, stock: 8, minQty: 1 },
+	{ skuId: 'SKU004', name: '绿豆 2.5kg', spec: '袋装', price: 43.99, stock: 30, minQty: 1 }
+]
+
+/** 分类树（一级分类 -> 子分类 -> 商品） */
+export const CATEGORY_TREE = [
+	{
+		id: 1,
+		name: '粮油调味',
+		subs: ['大米面粉', '食用油', '调味品', '方便速食'],
+		products: [
+			{ skuId: 'SKU001', name: '东北大米 5kg', spec: '袋装', price: 29.9, stock: 200, minQty: 1 },
+			{ skuId: 'SKU002', name: '大豆油 5L', spec: '桶装', price: 45.0, stock: 90, minQty: 10 },
+			{ skuId: 'SKU005', name: '面粉 10kg', spec: '袋装', price: 52.0, stock: 60, minQty: 1 },
+			{ skuId: 'SKU006', name: '生抽酱油 1.9L', spec: '瓶装', price: 18.8, stock: 120, minQty: 1 }
+		]
+	},
+	{
+		id: 2,
+		name: '生鲜果蔬',
+		subs: ['叶菜类', '根茎类', '菌菇类', '水果'],
+		products: [
+			{ skuId: 'SKU003', name: '新鲜蔬菜组合装', spec: '箱装', price: 41.89, stock: 8, minQty: 1 },
+			{ skuId: 'SKU007', name: '土豆 10kg', spec: '袋装', price: 25.0, stock: 45, minQty: 1 },
+			{ skuId: 'SKU008', name: '西红柿 5kg', spec: '箱装', price: 32.5, stock: 20, minQty: 1 }
+		]
+	},
+	{
+		id: 3,
+		name: '农资耗材',
+		subs: ['地膜', '肥料', '农具'],
+		products: [
+			{ skuId: 'SKU009', name: '复合肥 25kg', spec: '袋装', price: 128.0, stock: 40, minQty: 2 },
+			{ skuId: 'SKU010', name: '农用地膜 8kg', spec: '卷装', price: 96.0, stock: 15, minQty: 1 }
+		]
+	},
+	{
+		id: 4,
+		name: '包装材料',
+		subs: ['纸箱', '保鲜袋', '胶带'],
+		products: [
+			{ skuId: 'SKU011', name: '五层纸箱 50个', spec: '捆装', price: 75.0, stock: 100, minQty: 1 },
+			{ skuId: 'SKU012', name: '保鲜袋 500只', spec: '盒装', price: 22.0, stock: 200, minQty: 1 }
+		]
+	},
+	{
+		id: 5,
+		name: '酒水饮料',
+		subs: ['矿泉水', '碳酸饮料', '茶饮'],
+		products: [
+			{ skuId: 'SKU013', name: '矿泉水 550ml*24', spec: '箱装', price: 28.8, stock: 300, minQty: 1 },
+			{ skuId: 'SKU014', name: '冰红茶 500ml*15', spec: '箱装', price: 42.0, stock: 80, minQty: 1 }
+		]
+	},
+	{
+		id: 6,
+		name: '日用杂品',
+		subs: ['清洁用品', '一次性用品'],
+		products: [
+			{ skuId: 'SKU015', name: '洗洁精 5kg', spec: '桶装', price: 26.9, stock: 70, minQty: 1 },
+			{ skuId: 'SKU016', name: '一次性手套 100只', spec: '盒装', price: 9.9, stock: 500, minQty: 1 }
+		]
+	}
+]

package/templates/example/uniapp/services/mock/index.js

@@ -0,0 +1 @@
+export { getOrderList, getOrderDetail, ORDER_STATUS, ORDER_TYPE } from './orders'

package/templates/example/uniapp/services/mock/orders.js

@@ -0,0 +1,153 @@
+/**
+ * Mock 订单数据服务
+ * 模拟真实 API 的分页查询和详情查询
+ */
+
+// 订单状态枚举
+export const ORDER_STATUS = {
+	PENDING: { label: '待处理', value: 'pending', color: '#f3a73f' },
+	PROCESSING: { label: '处理中', value: 'processing', color: '#2979ff' },
+	COMPLETED: { label: '已完成', value: 'completed', color: '#18bc37' },
+	CANCELLED: { label: '已取消', value: 'cancelled', color: '#999999' }
+}
+
+// 订单类型枚举
+export const ORDER_TYPE = {
+	PURCHASE: { label: '采购单', value: 'purchase', icon: 'shopping-cart' },
+	SALES: { label: '销售单', value: 'sales', icon: 'cart' },
+	TRANSFER: { label: '调拨单', value: 'transfer', icon: 'car' },
+	RETURN: { label: '退货单', value: 'return', icon: 'redo' }
+}
+
+// 生成 30 条 mock 订单数据
+const types = Object.values(ORDER_TYPE)
+const statuses = Object.values(ORDER_STATUS)
+
+function mockItem(index) {
+	const type = types[index % types.length]
+	const statusIdx = (index % 7)
+	let status
+	if (statusIdx < 3) status = statuses[0]       // 0-2: pending
+	else if (statusIdx < 5) status = statuses[1]  // 3-4: processing
+	else if (statusIdx === 5) status = statuses[2] // 5: completed
+	else status = statuses[3]                      // 6: cancelled
+
+	const baseDate = new Date(2026, 6, 1)
+	baseDate.setHours(baseDate.getHours() - index * 3)
+
+	const customers = ['张氏酒业', '龙泉窖藏', '华润商贸', '金六福酒业', '五谷丰登',
+		'古今酒坊', '泸州老窖经销商', '汾酒集团', '贵州茅台代理', '洋河股份']
+
+	return {
+		id: `OD${String(20260701000 + index).slice(-9)}`,
+		type: type.value,
+		typeName: type.label,
+		typeIcon: type.icon,
+		status: status.value,
+		statusName: status.label,
+		statusColor: status.color,
+		orderNo: `PO-2026-${String(index + 1).padStart(4, '0')}`,
+		title: `${type.label} - ${type.label}${index + 1}号`,
+		customerName: customers[index % customers.length],
+		customerPhone: `138${String(index + 1).padStart(8, '0').slice(0, 8)}`,
+		customerAddress: `四川省成都市高新区天府大道${1000 + index}号`,
+		amount: parseFloat((Math.random() * 50000 + 500).toFixed(2)),
+		quantity: Math.floor(Math.random() * 200) + 10,
+		unit: ['箱', '瓶', '吨', '件'][index % 4],
+		productName: ['52度典藏白酒', '38度经典陈酿', '酱香型原浆', '浓香型特曲',
+			'清香型老酒', '米香型佳酿', '凤香型珍品', '兼香型精品', '特香型收藏', '馥郁香型臻品'][index % 10],
+		description: `该订单包含${type.label}相关货品，共计${Math.floor(Math.random() * 5) + 2}个品项。`
+			+ `客户已确认需求，请及时安排处理。如需加急处理请联系客户确认。`,
+		createTime: baseDate.toISOString(),
+		updateTime: new Date(baseDate.getTime() + 3600000).toISOString(),
+		handler: ['张三', '李四', '王五', '赵六'][index % 4],
+		warehouse: ['成都总仓', '绵阳分仓', '德阳分仓', '宜宾分仓'][index % 4],
+		remark: index % 5 === 0 ? '加急处理，客户已催单' : (index % 3 === 0 ? '请注意包装防损' : ''),
+		tags: (() => {
+			const tagPool = ['加急', '大额', 'VIP客户', '新客户']
+			const tags = []
+			if (index % 4 === 0) tags.push('加急')
+			if (index % 10 === 0) tags.push('大额')
+			if (index % 6 === 0) tags.push('VIP客户')
+			if (index % 8 === 0) tags.push('新客户')
+			return tags
+		})()
+	}
+}
+
+// 全量 mock 数据（30 条）
+const ALL_ORDERS = Array.from({ length: 30 }, (_, i) => mockItem(i))
+
+/**
+ * 模拟列表查询（带分页）
+ * @param {Object} params - { page, pageSize }
+ * @returns {Promise<{list: Array, total: number, hasMore: boolean}>}
+ */
+export function getOrderList(params = {}) {
+	const { page = 1, pageSize = 10 } = params
+	return new Promise((resolve) => {
+		const delay = page === 1 ? 600 : 400 // 首次加载稍慢以展示骨架屏
+		setTimeout(() => {
+			const start = (page - 1) * pageSize
+			const end = start + pageSize
+			const list = ALL_ORDERS.slice(start, end)
+			resolve({
+				list,
+				total: ALL_ORDERS.length,
+				page,
+				pageSize,
+				hasMore: end < ALL_ORDERS.length
+			})
+		}, delay)
+	})
+}
+
+/**
+ * 模拟订单详情查询
+ * @param {string} id - 订单 ID
+ * @returns {Promise<Object|null>}
+ */
+export function getOrderDetail(id) {
+	return new Promise((resolve) => {
+		setTimeout(() => {
+			const item = ALL_ORDERS.find(o => o.id === id)
+			if (item) {
+				// 详情页扩展数据
+				resolve({
+					...item,
+					items: generateOrderItems(item),
+					logs: generateLogs(item)
+				})
+			} else {
+				resolve(null)
+			}
+		}, 300)
+	})
+}
+
+/** 生成订单明细行 */
+function generateOrderItems(order) {
+	return [
+		{ name: order.productName, spec: '500ml × 6瓶/箱', qty: Math.floor(order.quantity * 0.4), unit: order.unit, price: parseFloat((order.amount * 0.4 / Math.floor(order.quantity * 0.4)).toFixed(2)) },
+		{ name: order.productName + '（简装版）', spec: '500ml × 12瓶/箱', qty: Math.floor(order.quantity * 0.35), unit: order.unit, price: parseFloat((order.amount * 0.3 / Math.floor(order.quantity * 0.35)).toFixed(2)) },
+		{ name: order.productName + '（礼盒装）', spec: '500ml × 2瓶/礼盒', qty: Math.floor(order.quantity * 0.25), unit: order.unit, price: parseFloat((order.amount * 0.3 / Math.floor(order.quantity * 0.25)).toFixed(2)) }
+	]
+}
+
+/** 生成操作日志 */
+function generateLogs(order) {
+	const logs = [
+		{ time: order.createTime, action: '创建订单', operator: '系统' },
+		{ time: order.updateTime, action: '提交审核', operator: order.handler }
+	]
+	if (order.status === 'processing') {
+		logs.push({ time: new Date(Date.now() - 7200000).toISOString(), action: '开始处理', operator: order.handler })
+	}
+	if (order.status === 'completed') {
+		logs.push(
+			{ time: new Date(Date.now() - 86400000).toISOString(), action: '开始处理', operator: order.handler },
+			{ time: new Date(Date.now() - 43200000).toISOString(), action: '处理完成', operator: order.handler }
+		)
+	}
+	return logs
+}

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

@@ -0,0 +1,17 @@
+/**
+ * AI 智能助手 API 模块
+ * 对应后端接口: /ai/*
+ * 响应格式: ResponseResult<T> = { code: number, data: T, message: string }
+ */
+import http from '@/http/ajax.js'
+
+export const aiApi = {
+	/**
+	 * AI 对话（OpenAI 兼容 Function Calling，可查询业务数据）
+	 * @param {Array<{role: string, content: string}>} messages 对话消息（最新一条为当前问题）
+	 * @param {boolean} disableTools 传 true 时强制关闭工具调用（纯闲聊）
+	 * 注意：工具调用链路较长，需覆盖全局 30s 超时
+	 */
+	chat: (messages, disableTools = false) =>
+		http.post('/ai/chat', { messages, disableTools }, { timeout: 180000 }),
+}

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

@@ -0,0 +1,76 @@
+/**
+ * 认证（登录 / 登出 / 用户信息）API 模块
+ * 对应后端接口: /system/user/*
+ * 响应格式: ResponseResult<T> = { code: number, data: T, message: string }
+ */
+import http from '@/http/ajax.js'
+
+export const authApi = {
+	/**
+	 * 账号密码登录
+	 * POST /system/user/login
+	 * @param {Object} params
+	 * @param {string} params.username - 用户名 / 手机号
+	 * @param {string} params.password - 登录密码
+	 * @returns {Promise<ResponseResult<{ token: string, user: object }>>}
+	 */
+	login(params) {
+		return http.post('/system/user/login', params, { showLoading: false })
+	},
+
+	/**
+	 * 退出登录
+	 * POST /system/user/logout
+	 * 后端记录登出日志；本地凭据由 userStore.logout 兜底清理
+	 * @returns {Promise<ResponseResult<null>>}
+	 */
+	logout() {
+		return http.post('/system/user/logout')
+	},
+
+	/**
+	 * 获取当前登录用户基本信息
+	 * GET /system/user/info
+	 * @returns {Promise<ResponseResult<object>>}
+	 */
+	getUserInfo() {
+		return http.get('/system/user/info')
+	},
+	/**
+	 * 修改用户密码
+	 * PUT /system/user/{id}/password
+	 * @param {Object} params
+	 * @param {string} params.oldPassword - 旧密码
+	 * @param {string} params.newPassword - 新密码
+	 * @param {string} params.confirmPassword - 确认密码
+	 * @returns {Promise<ResponseResult<null>>}
+	 */
+	changePassword(params) {
+		return http.put(`/system/user/${params.id}/password`, params)
+	},
+	/**
+	 * 获取当前登录用户完整信息（角色 + 权限 + 菜单）
+	 * GET /system/user/current
+	 * @returns {Promise<ResponseResult<{ user: object, roles: any[], permissions: any[], menus: any[] }>>}
+	 */
+	getCurrentUser() {
+		return http.get('/system/user/current')
+	},
+	// 获取用户列表
+	getUserList(params) {
+		return http.get('/system/user/page', { params })
+	},
+	// 分页获取字典类型树（含字典项）
+	getDictTree() {
+		return http.get('/system/dict-type/tree/page', { page: 1, pageSize: 999 })
+	},
+	/**
+	 * 上报 APP 推送设备 cid（App 端登录成功后调用，用于 APP 推送独立链路）
+	 * POST /system/user/push-cid
+	 * @param {string} cid - uni.getPushClientId() 获取的设备标识
+	 * @returns {Promise<ResponseResult<null>>}
+	 */
+	reportPushCid(cid) {
+		return http.post('/system/user/push-cid', { cid }, { showLoading: false })
+	}
+}

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

@@ -0,0 +1,11 @@
+/**
+ * 公共（首页 / 个人中心）API 模块
+ * 对应后端接口: /system/common/*
+ * 响应格式: ResponseResult<T> = { code: number, data: T, message: string }
+ */
+import http from '@/http/ajax.js'
+
+export const commonApi = {
+	// 获取操作日志分页列表
+	getOperationLog: () => http.get('/system/operation-log'),
+}

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

@@ -0,0 +1,50 @@
+/**
+ * Demo API 模块（示例）
+ * 新业务模块参考本文件创建
+ */
+
+import http from '@/http/ajax.js'
+
+const PREFIX = '/demo'
+
+export const demoApi = {
+	/**
+	 * 获取列表（分页）
+	 * @param {Object} params - { page, size, ...query }
+	 */
+	getList(params = {}) {
+		return http.get(`${PREFIX}/list`, params)
+	},
+
+	/**
+	 * 获取详情
+	 * @param {string|number} id
+	 */
+	getDetail(id) {
+		return http.get(`${PREFIX}/detail`, { id })
+	},
+
+	/**
+	 * 创建
+	 * @param {Object} data
+	 */
+	create(data) {
+		return http.post(`${PREFIX}/create`, data)
+	},
+
+	/**
+	 * 更新
+	 * @param {Object} data
+	 */
+	update(data) {
+		return http.put(`${PREFIX}/update`, data)
+	},
+
+	/**
+	 * 删除
+	 * @param {string|number} id
+	 */
+	delete(id) {
+		return http.delete(`${PREFIX}/delete`, { id })
+	}
+}