mm_os 2.8.9 → 2.9.1

package/demo/app/sys/event_api/ws/main.js

@@ -0,0 +1,15 @@
+var api = $.api_admin('ws', 'web Socket通讯');
+// 首次启动更新api接口;
+api.update();
+
+/**
+ * @description 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+async function main(ctx, db) {
+	$.push(db, $.sql.db(), true);
+	return api.run(ctx, db);
+};
+exports.main = main;

package/demo/app/sys/plugin/main/api_client/activation/api.json

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

package/demo/app/sys/plugin/main/api_client/activation/index.js

@@ -0,0 +1,185 @@
+const os = require('os');
+var host = "https://www.fman.top";
+var auth_info = {
+	domain: "",
+	ip: "",
+	validity: "1970-01-01 00:00:00",
+	authorization: false
+};
+var time_last = (new Date()).addDays(-1);
+
+function get_ipv4() {
+	var ip = "";
+	const interfaces = os.networkInterfaces();
+	for (const iface of Object.values(interfaces)) {
+		for (const config of iface) {
+			if (config.family === 'IPv4' && !config.internal) {
+				ip = config.address;
+				break;
+			}
+		}
+	}
+	return ip;
+}
+
+var ipv4 = get_ipv4();
+
+/**
+ * 获取授权信息
+ */
+$.get_auth_info = async function(domain) {
+	var ret;
+	var file = "/cache/auth.cache";
+	if (file.hasFile()) {
+		var code = file.loadText();
+		// 查询激活码信息
+		var http = new $.Http();
+		var url = host + "/api/source/activate_sys?method=check";
+		var res = await http.post(url, {
+			code,
+			domain,
+			ip: ipv4
+		});
+		if (res.body) {
+			ret = res.body.toJson();
+			if (ret.result && ret.result.obj) {
+				auth_info = ret.result.obj;
+				// 检测是否已过期
+				var now = new Date();
+				if (now < auth_info.validity.toTime()) {
+					$.config.authorization = true;
+					$.globalBag.authorization = true;
+					auth_info.authorization = true;
+				}
+				ret.result.obj.code = code;
+			}
+		}
+	}
+	time_last = new Date();
+	return ret;
+}
+
+/**
+ * 检测授权
+ * @param {Object} host 请求的域名或IP
+ * @param {Object} update_info 是否更新授权信息
+ */
+$.check_auth = async function(host, update_info) {
+	if (update_info) {
+		var now = new Date();
+		if (now > time_last.addDays(1)) {
+			await $.get_auth_info(host);
+		}
+	}
+	var auth = false;
+	if (host) {
+		if (auth_info.domain) {
+			var arr = auth_info.domain.split(';');
+			for (var i = 0; i < arr.length; i++) {
+				var d = arr[i];
+				if (host.endWith(d)) {
+					auth = true;
+					break;
+				}
+			}
+		}
+	}
+	return auth;
+}
+
+/**
+ * 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+async function main(ctx, db) {
+	var ret;
+	// 获取请求参数
+	var req = ctx.request;
+	var {
+		query,
+		body
+	} = req;
+	var conf = await $.config.conf();
+	if (ctx.method === "GET") {
+		var {
+			key,
+			code
+		} = query;
+
+		// 激活码
+		if (!code && !key) {
+			ret = await $.get_auth_info(req.hostname);
+			if (ret) {
+				return ret;
+			}
+			var conf = await $.config.conf();
+			var {
+				activation_key
+			} = conf;
+			// 如果不包含激活码，则返回设备信息
+			var info = "/config/lock.cache".loadText();
+			return $.ret.obj({
+				key: activation_key,
+				info: info.replace(/\r/g, "").replace(/\n/g, "^")
+			});
+		} else if (key) {
+			// 查询激活码信息
+			var http = new $.Http();
+			var url = host + "/api/source/activate_info?key=" + key;
+			var res = await http.get(url);
+			if (!res.body) {
+				return $.ret.error(10001, "激活服务器连接失败！");
+			}
+			// 获取激活码信息
+			return res.body;
+		}
+	} else {
+		// 获取请求参数
+		var {
+			key,
+			info,
+			code,
+			ip,
+			domain
+		} = body;
+		if (code) {
+			// 如果code不存在，则为生成激活码
+			var http = new $.Http();
+			var url = host + "/api/source/activate_sys";
+			var res = await http.post(url, {
+				code
+			});
+			if (!res.body) {
+				return $.ret.error(10001, "激活服务器连接失败！");
+			}
+			var json = res.body.toJson();
+			if (json.result && json.result.bl) {
+				"/cache/auth.cache".saveText(code);
+				ret = $.ret.bl(true, "激活成功！");
+			} else {
+				ret = res.body;
+			}
+		} else {
+			if (!info) {
+				return $.ret.error(70001, "系统信息(info)是必须的！");
+			}
+			if (!key) {
+				return $.ret.error(70001, "激活密钥(key)是必须的！");
+			}
+			var http = new $.Http();
+			var url = host + "/api/source/activate_sys?";
+			var res = await http.post(url, {
+				key,
+				info,
+				ip,
+				domain
+			});
+			return res.body;
+		}
+	}
+	return ret;
+};
+
+exports.main = main;

package/demo/app/sys/plugin/main/api_client/activation/param.json

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

package/demo/app/sys/plugin/main/api_client/app_balance/api.json

@@ -0,0 +1,18 @@
+{
+    "name": "sys_app_balance",
+    "title": "第三方查询用户余额",
+    "description": "用于第三方应用查询本应用的用户余额",
+    "path": "/api/sys/app_balance",
+    "method": "GET",
+    "cache": 0,
+    "client_cache": false,
+    "func_file": "./index.js",
+    "check_param": true,
+	// 参数配置路径, 用于校验API请求参数是否正确, 同时显示在API文档中 
+	"param_path": "./param.json",
+	/* 授权协议 */
+	"oauth": {
+		// 是否需要登录, true表示需要登录才能访问该接口
+		"signIn": false
+	}
+}

package/demo/app/sys/plugin/main/api_client/app_balance/index.js

@@ -0,0 +1,61 @@
+$.check_app = async function(db, apikey) {
+	if (!apikey) {
+		return $.ret.error(30000, "apikey不能为空！");
+	}
+	var db1 = db.new("sys_app");
+	var app = await db1.getObj({
+		apikey
+	});
+	if (!app) {
+		return $.ret.error(10000, "应用不存在！");
+	}
+
+	if (app.times_today > app.times_allow) {
+		return $.ret.error(10000, "今日请求已达上限！");
+	}
+
+	app.times_count += 1;
+	app.times_today += 1;
+	return null;
+}
+
+/**
+ * 接口主函数
+ * @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_id,
+		apikey
+	} = query;
+
+	// 应用鉴权
+	var ret = await $.check_app(db, apikey);
+	if (ret) {
+		return ret;
+	}
+
+	// 获取用户积分
+	var db2 = db.new("user_count", "user_id");
+	var u = await db2.getObj({
+		user_id
+	});
+	if (!u) {
+		return $.ret.error(10000, "用户不存在！");
+	}
+
+	return $.ret.body({
+		balance: u.coin
+	});
+};
+
+exports.main = main;

package/demo/app/sys/plugin/main/api_client/app_balance/param.json

@@ -0,0 +1,36 @@
+{
+	// 是否启用过滤, 启用过滤后, 不符合的参数会被过滤掉
+	"filter": true,
+	// get请求
+	"get": {
+		// 查询必填参数
+		"query_required": ["user_id", "apikey"]
+	},
+	// 校验列表
+	"list": [{
+			// 参数key名
+			"name": "user_id",
+			// 参数中文名
+			"title": "用户ID",
+			// 数据类型
+			"type": "number",
+			// 数字类型时设置
+			"number": {
+				// 最小数值
+				"min": 1
+			},
+			// 分隔参数，允许传多个值，为空则限制1个值
+			"splitter": "|"
+		}, {
+			"name": "apikey",
+			"title": "应用密钥",
+			"type": "string",
+			// 字符串类型时设置
+			"string": {
+				// 传值范围，字符串时为限制字符长度
+				"range": [8, 64]
+			},
+			"splitter": "|"
+		}
+	]
+}

package/demo/app/sys/plugin/main/api_client/app_pay/api.json

@@ -0,0 +1,23 @@
+{
+	// 路由路径
+	"path": "/api/sys/app_pay",
+	// 名称, 用于动态增删改API配置
+	"name": "sys_app_pay",
+	// 标题, 用于开发文档显示
+	"title": "第三方调用支付",
+	// 描述, 用于介绍该路由的作用
+	"description": "用户第三方应用接入支付系统",
+	// 函数文件, 用于驱动脚本, 实现业务 
+	"func_file": "./index.js",
+	// 请求方法, 选填 GET, POST, ALL。 ALL指同时支持GET/POST
+	"method": "POST",
+	// 开放域, 如果域未开放, 则只有特定的协议头才能访问该API, 同时API文档不接见
+	"scope": true,
+	// 参数配置路径, 用于校验API请求参数是否正确, 同时显示在API文档中 
+	"param_path": "./param.json",
+	/* 授权协议 */
+	"oauth": {
+		// 是否需要登录, true表示需要登录才能访问该接口
+		"signIn": false
+	}
+}

package/demo/app/sys/plugin/main/api_client/app_pay/index.js

@@ -0,0 +1,65 @@
+/**
+ * 接口主函数
+ * @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;
+	
+
+	// 操作sql模板
+	var m = query.method;
+	
+	var {
+		apikey
+	} = query;
+	var {
+		user_id,
+		amount,
+		way,
+		note
+	} = body;
+
+	// 应用鉴权
+	var ret = await $.check_app(db, apikey);
+	if (ret) {
+		return ret;
+	}
+
+	// 获取用户积分
+	var db2 = db.new("user_count", "user_id");
+	var u = await db2.getObj({
+		user_id
+	});
+	if (!u) {
+		return $.ret.error(10000, "用户不存在！");
+	}
+
+	if (u.coin < -amount) {
+		return $.rett.error(10000, "账户余额不足！")
+	}
+
+	// 修改余额并记录
+	u.coin += amount;
+	
+	var db1 = db.new("sys_app");
+	var app = await db1.getObj({
+		apikey
+	});
+	await $.flow(db, user_id, amount,`(${app.name}) ` + note, way, u.coin);
+	$.log.info("第三方应用收支", "应用：" + app.name, "用户ID：" + user_id, "额度：" + amount, "余额：" + u.coin);
+	
+	// 响应结果
+	var ret = $.ret.bl(true, "操作成功！");
+	ret.result.amount = amount;
+	ret.result.balance = u.coin;
+	return ret;
+};
+
+exports.main = main;

package/demo/app/sys/plugin/main/api_client/app_pay/param.json

@@ -0,0 +1,61 @@
+{
+	// 是否启用过滤, 启用过滤后, 不符合的参数会被过滤掉
+	"filter": true,
+	// post请求
+	"post": {
+		// 查询必填参数
+		"query_required": ["apikey"],
+		"body_required": ["user_id", "amount", "way", "note"]
+	},
+	// 校验列表
+	"list": [{
+			// 参数key名
+			"name": "user_id",
+			// 参数中文名
+			"title": "用户ID",
+			// 数据类型
+			"type": "number",
+			// 数字类型时设置
+			"number": {
+				// 最小数值
+				"min": 1
+			},
+			// 分隔参数，允许传多个值，为空则限制1个值
+			"splitter": "|"
+		}, {
+			"name": "apikey",
+			"title": "应用密钥",
+			"type": "string",
+			// 字符串类型时设置
+			"string": {
+				// 传值范围，字符串时为限制字符长度
+				"range": [8, 32]
+			},
+			"splitter": "|"
+		}, {
+			"name": "way",
+			"title": "方式",
+			"type": "number",
+			// 字符串类型时设置
+			"string": {
+				// 传值范围，字符串时为限制字符长度
+				"range": [1, 6]
+			},
+			"splitter": "|"
+		}, {
+			"name": "amount",
+			"title": "额度",
+			"type": "number"
+		}, {
+			"name": "note",
+			"title": "备注",
+			"type": "string",
+			// 字符串类型时设置
+			"string": {
+				// 传值范围，字符串时为限制字符长度
+				"range": [0, 255]
+			},
+			"splitter": "|"
+		}
+	]
+}

package/demo/app/sys/plugin/main/api_client/app_state/api.json

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

package/demo/app/sys/plugin/main/api_client/app_state/index.js

@@ -0,0 +1,46 @@
+
+/**
+ * 接口主函数
+ * @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 {
+		apikey,
+		token
+	} = query;
+	
+	// 应用鉴权
+	var ret = await $.check_app(db, apikey);
+	if (ret) {
+		return ret;
+	}
+	
+	if (token) {
+		var u = await $.cache.get($.dict.session_id + '_' + token);
+		if (u) {
+			var type = typeof(u);
+			if (type === "string") {
+				var o = u.toJson();
+				return $.ret.body(o.user);
+			} else if (type === "object") {
+				if (Object.keys(u).length > 0) {
+					var o = Object.assign({}, u);
+					return $.ret.body(o.user);
+				}
+			}
+		}
+		return $.ret.error(50000, '非法访问');
+	}
+	return $.ret.error(40000, '用户未登录');
+};
+
+exports.main = main;

package/demo/app/sys/plugin/main/api_client/app_state/param.json

@@ -0,0 +1,36 @@
+{
+	// 是否启用过滤, 启用过滤后, 不符合的参数会被过滤掉
+	"filter": true,
+	// get请求
+	"get": {
+		// 查询必填参数
+		"query_required": ["token", "apikey"]
+	},
+	// 校验列表
+	"list": [{
+			// 参数key名
+			"name": "token",
+			// 参数中文名
+			"title": "用户临时访问牌",
+			// 数据类型
+			"type": "string",
+			// 数字类型时设置
+			"string": {
+				// 传值范围，字符串时为限制字符长度
+				"range": [8, 64]
+			},
+			// 分隔参数，允许传多个值，为空则限制1个值
+			"splitter": "|"
+		}, {
+			"name": "apikey",
+			"title": "应用密钥",
+			"type": "string",
+			// 字符串类型时设置
+			"string": {
+				// 传值范围，字符串时为限制字符长度
+				"range": [8, 64]
+			},
+			"splitter": "|"
+		}
+	]
+}

package/demo/app/sys/plugin/main/api_client/component/api.json

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