mm_os 2.8.0 → 2.8.1

package/demo/app/user/plugin/main/api_user_client/servicer/api.json

@@ -0,0 +1,29 @@
+{
+	// 路由路径
+	"path": "/api/user/servicer",
+	// 名称, 用于动态增删改API配置
+	"name": "user_servicer",
+	// 标题, 用于开发文档显示
+	"title": "在线客服",
+	// 描述, 用于介绍该路由的作用
+	"description": "用于获取在线客服列表",
+	// 函数文件, 用于驱动脚本, 实现业务 
+	"func_file": "./index.js",
+	// 请求方法, 选填 GET, POST, ALL。 ALL指同时支持GET/POST
+	"method": "GET",
+	// 开放域, 如果域未开放, 则只有特定的协议头才能访问该API, 同时API文档不接见
+	"scope": true,
+	// 缓存时长, 单位: 分钟。使用缓存后, 二次访问API直接从缓存读取, 不重复执行业务脚本
+	"cache": 0,
+	// 是否客户端缓存, 使用客户端则不再访问服务器, 直接从浏览器中拿; 使用服务端缓存则会访问服务器   
+	"client_cache": false,
+	// SQL配置路径, 用于将请求参数拼接成SQL, 实现比较复杂的查询
+	"sql_path": "./sql.json",
+	// 参数配置路径, 用于校验API请求参数是否正确, 同时显示在API文档中 
+	"param_path": "./param.json",
+	/* 授权协议 */
+	"oauth": {
+		// 是否需要登录, true表示需要登录才能访问该接口
+		"signIn": false
+	}
+}

package/demo/app/user/plugin/main/api_user_client/servicer/index.js

@@ -0,0 +1,19 @@
+/**
+ * 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+async function main(ctx, db) {
+	// 获取请求参数
+	var req = ctx.request;
+	var {
+		query,
+		body
+	} = req;
+	query.admin = '客服';
+	var ret = await this.sql.run(query, body, db);
+	return ret;
+};
+
+exports.main = main;

package/demo/app/user/plugin/main/api_user_client/servicer/param.json

@@ -0,0 +1,41 @@
+{
+	// 是否启用过滤, 启用过滤后, 不符合的参数会被过滤掉
+	"filter": true,
+	// 校验脚本文件, 可以使用脚本的方式加一步进行校验, 让传参更加安全
+	"func_file": "",
+	// get请求
+	"get": {
+		// 查询参数校验项
+		"query": [],
+		// 查询必填参数
+		"query_required": []
+	},
+	// post请求
+	"post": {
+		// 查询参数校验项
+		"query": [],
+		// 查询必填参数
+		"query_required": [],
+		// 正文参数校验项
+		"body": [],
+		// 正文必填参数
+		"body_required": []
+	},
+	// 校验列表
+	"list": [{
+			// 参数key名
+			"name": "user_id",
+			// 参数中文名
+			"title": "用户ID",
+			// 数据类型
+			"type": "number",
+			// 数字类型时设置
+			"number": {
+				// 最小数值
+				"min": 1
+			},
+			// 分隔参数，允许传多个值，为空则限制1个值
+			"splitter": "|"
+		}
+	]
+}

package/demo/app/user/plugin/main/api_user_client/servicer/sql.json

@@ -0,0 +1,113 @@
+{
+    "name": "user_account",
+    "title": "聊天客服",
+    "table": "user_account",
+    "key": "user_id",
+    "orderby_default": "`user_id` desc",
+    "field_obj": "`user_id`,`state`,`vip`,`gm`,`mc`,`group_id`,`admin_id`,`referee_id`,`login_time`,`invite_code`,`phone`,`phone_state`,`username`,`nickname`,`email`,`email_state`,`login_ip`,`signature`,`avatar`,`friends`,`time_create`,`wallet_address`",
+    "field_default": "`user_id`,`state`,`vip`,`gm`,`mc`,`group_id`,`invite_code`,`phone`,`username`,`nickname`,`email`,`signature`,`avatar`",
+    "method": "get get_obj avg sum count",
+    "query": {
+        "avatar": "`avatar` like '%{0}%'",
+        "time_create_min": "`time_create` >= '{0}'",
+        "time_create_max": "`time_create` <= '{0}'",
+        "email": "`email` like '%{0}%'",
+        "email_state_min": "`email_state` >= {0}",
+        "email_state_max": "`email_state` <= {0}",
+        "friends": "`friends` like '%{0}%'",
+        "gm_min": "`gm` >= {0}",
+        "gm_max": "`gm` <= {0}",
+        "invite_code": "`invite_code` like '%{0}%'",
+        "login_ip": "`login_ip` like '%{0}%'",
+        "login_time_min": "`login_time` >= '{0}'",
+        "login_time_max": "`login_time` <= '{0}'",
+        "mc_min": "`mc` >= {0}",
+        "mc_max": "`mc` <= {0}",
+        "nickname": "`nickname` like '%{0}%'",
+        "password": "`password` like '%{0}%'",
+        "phone": "`phone` like '%{0}%'",
+        "phone_state_min": "`phone_state` >= {0}",
+        "phone_state_max": "`phone_state` <= {0}",
+        "salt": "`salt` like '%{0}%'",
+        "signature": "`signature` like '%{0}%'",
+        "state_min": "`state` >= {0}",
+        "state_max": "`state` <= {0}",
+        "username": "`username` like '%{0}%'",
+        "vip_min": "`vip` >= {0}",
+        "vip_max": "`vip` <= {0}",
+        "keyword": "(`username` like '%{0}%' || `nickname` like '%{0}%')",
+        "wallet_address": "`wallet_address` like '%{0}%'",
+		"admin": "`admin_id` = (SELECT `admin_id` FROM `user_admin` WHERE `name` = '{0}')"
+    },
+	"query_default": {
+		"admin": "`admin_id` = (SELECT `admin_id` FROM `user_admin` WHERE `name` = '客服')"
+	},
+    "update": {
+        "email_state_add": "`email_state` = `email_state` + {0}",
+        "gm_add": "`gm` = `gm` + {0}",
+        "mc_add": "`mc` = `mc` + {0}",
+        "phone_state_add": "`phone_state` = `phone_state` + {0}",
+        "state_add": "`state` = `state` + {0}",
+        "vip_add": "`vip` = `vip` + {0}"
+    },
+    "format": [
+        {
+            "key": "state",
+            "title": "账户状态",
+            "list": [
+                "",
+                "可用",
+                "异常",
+                "已冻结",
+                "已注销"
+            ]
+        },
+        {
+            "key": "group_id",
+            "title": "所在用户组",
+            "table": "user_group",
+            "name": "name"
+        },
+        {
+            "key": "admin_id",
+            "title": "所在管理组",
+            "table": "user_admin",
+            "name": "name"
+        },
+        {
+            "key": "referee_id",
+            "title": "推荐人",
+            "table": "user_account",
+            "name": "nickname",
+            "id": "user_id"
+        },
+        {
+            "key": "phone_state",
+            "title": "手机认证",
+            "list": [
+                "未认证",
+                "审核中",
+                "已认证"
+            ]
+        },
+        {
+            "key": "email_state",
+            "title": "邮箱认证",
+            "list": [
+                "未认证",
+                "审核中",
+                "已认证"
+            ]
+        }
+    ],
+    "filter": {
+        "table": "table",
+        "page": "page",
+        "size": "size",
+        "method": "method",
+        "orderby": "orderby",
+        "field": "field",
+        "count_ret": "count_ret",
+        "user_id": "user_id"
+    }
+}

package/demo/app/user/plugin/main/api_user_client/set_address/api.json

@@ -0,0 +1,37 @@
+{
+	// 路由路径
+	"path": "/api/user/set_address",
+	// 名称, 用于动态增删改API配置
+	"name": "user_set_address",
+	// 标题, 用于开发文档显示
+	"title": "设置收货地址",
+	// 描述, 用于介绍该路由的作用
+	"description": "用于设置收货地址",
+	// 函数文件, 用于驱动脚本, 实现业务 
+	"func_file": "./index.js",
+	// 请求方法, 选填 GET, POST, ALL。 ALL指同时支持GET/POST
+	"method": "POST",
+	// 开放域, 如果域未开放, 则只有特定的协议头才能访问该API, 同时API文档不接见
+	"scope": true,
+	// 缓存时长, 单位: 分钟。使用缓存后, 二次访问API直接从缓存读取, 不重复执行业务脚本
+	"cache": 0,
+	// 是否客户端缓存, 使用客户端则不再访问服务器, 直接从浏览器中拿; 使用服务端缓存则会访问服务器   
+	"client_cache": false,
+	// 参数配置路径, 用于校验API请求参数是否正确, 同时显示在API文档中 
+	"param_path": "./param.json",
+	/* 授权协议 */
+	"oauth": {
+		// 是否需要登录, true表示需要登录才能访问该接口
+		"signIn": true,
+		// 会员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"vip": 0,
+		// 管理员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"gm": 0,
+		// 商户/第三方权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"mc": 0,
+		// 用户组, 允许访问该接口的普通用户群体, 传ID数组，例如: [1,5]
+		"user_group": [],
+		// 管理组, 允许访问该接口的管理员群体, 传ID数组，例如: [1,5]
+		"user_admin": []
+	}
+}

package/demo/app/user/plugin/main/api_user_client/set_address/index.js

@@ -0,0 +1,101 @@
+// 集合路由、导航，不开发前端的情况下可以将以下2行注释掉
+// const nav = $.nav_admin('{0}');
+// nav.update();
+
+/**
+ * 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+async function main(ctx, db) {
+	// 获取请求参数
+	var req = ctx.request;
+	var {
+		query,
+		body
+	} = req;
+
+	var user = ctx.session.user;
+	if (!user) {
+		return $.ret.error(10000, "用户未登录!");
+	}
+
+	var user_id = user.user_id;
+	body.user_id = user_id;
+
+	db.table = 'user_address';
+	var db1 = db.new('user_address', 'address_id');
+	// if (body.default > 0) {
+	// 	var bl = await db1.set({
+	// 		user_id
+	// 	}, {
+	// 		default: 0
+	// 	});
+	// 	if (!bl) {
+	// 		return $.ret.error(10000, '提交地址失败！');
+	// 	}
+	// }
+
+	var m = query.method;
+	var address_id = body.address_id;
+	delete query.method;
+	delete body.address_id;
+
+	console.log("query", query, "body", body);
+
+	console.log("执行类型: " + m);
+	// 添加事件
+	if (m === "add") {
+		var bl = await db1.add(body);
+		return bl > 0 ? $.ret.bl(true, '添加成功！') : $.ret.error(10000, '添加失败！');
+	}
+	// 删除事件
+	else if (m === "del") {
+		if (!address_id) {
+			return $.ret.error(10000, '地址ID是必填字段！');
+		}
+
+		var obj = await db1.getObj({
+			address_id,
+			user_id
+		});
+		if (!obj) {
+			return $.ret.error(10000, "对象不存在或不属于你");
+		}
+
+		var bl = await db1.del({
+			address_id,
+			user_id
+		});
+		console.log(bl);
+		return bl > 0 ? $.ret.bl(true, '删除成功！') : $.ret.error(10000, '删除失败！');
+	}
+	// 修改事件
+	else if (m === "set") {
+		if (!address_id) {
+			return $.ret.error(10000, '地址ID是必填字段！');
+		}
+
+		delete body.address_id;
+		var obj = await db1.getObj({
+			address_id,
+			user_id
+		});
+		if (!obj) {
+			return $.ret.error(10000, "对象不存在或不属于你");
+		}
+
+		var bl = await db1.set({
+			address_id,
+			user_id
+		}, body);
+		return bl > 0 ? $.ret.bl(true, '修改成功！') : $.ret.error(10000, '修改失败！');
+	}
+	// 错误返回
+	else {
+		return $.ret.error(10000, '错误的方法(method)！');
+	}
+};
+
+exports.main = main;

package/demo/app/user/plugin/main/api_user_client/set_address/param.json

@@ -0,0 +1,165 @@
+{
+	"name": "user_address",
+	"title": "收货地址",
+	"add": {
+		"query_required": [
+			"method"
+		],
+		"body": [
+			"sex",
+			"house_number",
+			"tag"
+		],
+		"body_required": [
+			"province",
+			"city",
+			"area",
+			"name",
+			"phone",
+			"address",
+			"state_default"
+		]
+	},
+	"set": {
+		"query_required": [
+			"method"
+		],
+		"body": [
+			"sex",
+			"house_number",
+			"tag",
+			"province",
+			"city",
+			"area",
+		 "name",
+			"phone",
+			"address",
+			"state_default"
+		],
+		"body_required": [
+			"address_id"
+		]
+	},
+	"del": {
+		"query_required": [
+			"method"
+		],
+		"body": [],
+		"body_required": [
+			"address_id"
+		]
+	},
+	"list": [{
+			"name": "address_id",
+			"title": "地址ID",
+			"description": "",
+			"type": "number",
+			"dataType": "mediumint",
+			"number": {
+				"max": 8388607
+			}
+		},
+		{
+			"name": "user_id",
+			"title": "用户ID",
+			"description": "表示该地址是哪个用户的(user_account.phone)",
+			"type": "number",
+			"dataType": "mediumint",
+			"number": {
+				"max": 8388607
+			}
+		},
+		{
+			"name": "province",
+			"title": "省",
+			"description": "",
+			"type": "string",
+			"dataType": "varchar",
+			"string": {
+				"max": 9,
+				"notEmpty": true
+			}
+		},
+		{
+			"name": "city",
+			"title": "市",
+			"description": "",
+			"type": "string",
+			"dataType": "varchar",
+			"string": {
+				"max": 9,
+				"notEmpty": true
+			}
+		},
+		{
+			"name": "area",
+			"title": "区",
+			"description": "",
+			"type": "string",
+			"dataType": "varchar",
+			"string": {
+				"max": 9,
+				"notEmpty": true
+			}
+		},
+		{
+			"name": "state_default",
+			"title": "设置默认",
+			"description": "(0非默认|1默认)",
+			"type": "number",
+			"dataType": "tinyint",
+			"number": {
+				"max": 1
+			}
+		},
+		{
+			"name": "tag",
+			"title": "标签",
+			"description": "(0无标签|1家|2学校|3公司)",
+			"type": "number",
+			"dataType": "smallint",
+			"string": {
+				"max": 125
+		 }
+		},
+		{
+			"name": "name",
+			"title": "收件人姓名",
+			"description": "",
+			"type": "string",
+			"dataType": "varchar",
+			"string": {
+				"max": 32
+			}
+		},
+		{
+			"name": "phone",
+			"title": "收件人电话",
+			"description": "",
+			"type": "string",
+			"dataType": "varchar",
+			"string": {
+				"max": 11,
+				"format": "phone"
+			}
+		},
+		{
+			"name": "address",
+			"title": "收件地址",
+			"description": "",
+			"type": "string",
+			"dataType": "varchar",
+			"string": {
+				"max": 255
+			}
+		},
+		{
+			"name": "keyword",
+			"title": "关键词",
+			"description": "用于搜索收件人姓名(name)",
+			"type": "string",
+			"dataType": "varchar",
+			"string": {}
+		}
+	]
+}

package/demo/app/user/plugin/main/api_user_client/set_avatar/api.json

@@ -0,0 +1,35 @@
+{
+	// 路由路径
+	"path": "/api/user/set_avatar",
+	// 名称, 用于动态增删改API配置
+	"name": "user_set_avatar",
+	// 标题, 用于开发文档显示
+	"title": "修改头像",
+	// 描述, 用于介绍该路由的作用
+	"description": "描述接口使用方法",
+	// 函数文件, 用于驱动脚本, 实现业务 
+	"func_file": "./index.js",
+	// 请求方法, 选填 GET, POST, ALL。 ALL指同时支持GET/POST
+	"method": "ALL",
+	// 开放域, 如果域未开放, 则只有特定的协议头才能访问该API, 同时API文档不接见
+	"scope": true,
+	// 缓存时长, 单位: 分钟。使用缓存后, 二次访问API直接从缓存读取, 不重复执行业务脚本
+	"cache": 0,
+	// 是否客户端缓存, 使用客户端则不再访问服务器, 直接从浏览器中拿; 使用服务端缓存则会访问服务器   
+	"client_cache": false,
+	/* 授权协议 */
+	"oauth": {
+		// 是否需要登录, true表示需要登录才能访问该接口
+		"signIn": true,
+		// 会员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"vip": 0,
+		// 管理员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"gm": 0,
+		// 商户/第三方权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"mc": 0,
+		// 用户组, 允许访问该接口的普通用户群体, 传ID数组，例如: [1,5]
+		"user_group": [],
+		// 管理组, 允许访问该接口的管理员群体, 传ID数组，例如: [1,5]
+		"user_admin": []
+	}
+}

package/demo/app/user/plugin/main/api_user_client/set_avatar/index.js

@@ -0,0 +1,77 @@
+const path = require('path');
+const fs = require('fs');
+var dir = path.join($.runPath, "/static/img/avatar/");
+dir.addDir();
+var url_path = "/img/avatar/";
+
+/**
+ * 处理头像
+ * @param {String} avatar
+ * @param {Number} user_id
+ */
+function handle_avatar(avatar, user_id){
+	var url;
+	if(avatar.indexOf("data:") === 0){
+		var extension = avatar.between('data:image/', ';');
+		var name = "user_" + user_id + "." + extension;
+		var file = path.join(dir, name);
+		var data = avatar.replace(/^data:image\/\w+;base64,/, "");
+		var bf = Buffer.from(data, 'base64');
+		try {
+			fs.writeFileSync(file, bf);
+			url = url_path + name;
+		} catch (e) {
+			fs.closeSync(file);
+			console.log(e);
+		}
+	} else {
+		url = avatar;
+	}
+	return url;
+}
+
+/**
+ * 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+async function main(ctx, db) {
+	// 获取请求参数
+	var req = ctx.request;
+	var {
+		query,
+		body
+	} = req;
+	
+	// console.log("运行修改头像" ,query ,body);
+	var user = ctx.session.user;
+	if(!user){
+		return $.ret.error(10000 ,"用户未登录！");
+	}
+	var user_id = user.user_id;
+	
+	var avatar = query.avatar || body.avatar;
+	if(!avatar){
+		return $.ret.error(10000 ,"头像是必填字段！");
+	}
+	
+	var db1 = Object.assign({} ,db);
+	db1.table = "user_account";
+	
+	var avatar = handle_avatar(avatar, user_id);
+	// console.log("操作", user_id ,avatar ,db1.sql ,db1.error);
+	var bl = await db1.set({user_id} ,{avatar});
+	
+	bl = bl > 0 ? true : false;
+	var message = "头像修改失败！";
+	
+	if(bl){
+		message = "头像修改成功！";
+		user.avatar = avatar;
+		ctx.session.user = user;
+	}
+	return $.ret.bl(bl, message);
+};
+
+exports.main = main;

package/demo/app/user/plugin/main/api_user_client/set_info/api.json

@@ -0,0 +1,35 @@
+{
+	// 路由路径
+	"path": "/api/user/set_info",
+	// 名称, 用于动态增删改API配置
+	"name": "user_set_info",
+	// 标题, 用于开发文档显示
+	"title": "修改用户信息",
+	// 描述, 用于介绍该路由的作用
+	"description": "描述接口使用方法",
+	// 函数文件, 用于驱动脚本, 实现业务 
+	"func_file": "./index.js",
+	// 请求方法, 选填 GET, POST, ALL。 ALL指同时支持GET/POST
+	"method": "ALL",
+	// 开放域, 如果域未开放, 则只有特定的协议头才能访问该API, 同时API文档不接见
+	"scope": true,
+	// 缓存时长, 单位: 分钟。使用缓存后, 二次访问API直接从缓存读取, 不重复执行业务脚本
+	"cache": 0,
+	// 是否客户端缓存, 使用客户端则不再访问服务器, 直接从浏览器中拿; 使用服务端缓存则会访问服务器   
+	"client_cache": false,
+	/* 授权协议 */
+	"oauth": {
+		// 是否需要登录, true表示需要登录才能访问该接口
+		"signIn": true,
+		// 会员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"vip": 0,
+		// 管理员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"gm": 0,
+		// 商户/第三方权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"mc": 0,
+		// 用户组, 允许访问该接口的普通用户群体, 传ID数组，例如: [1,5]
+		"user_group": [],
+		// 管理组, 允许访问该接口的管理员群体, 传ID数组，例如: [1,5]
+		"user_admin": []
+	}
+}