mm_os 2.8.0 → 2.8.2

package/demo/app/sys/plugin/app_admin/plugin.json

@@ -0,0 +1,20 @@
+{
+	// 应用名称，表示该插件用在什么应用里的
+	"app": "sys",
+	// 插件名称，插件的唯一标识
+	"name": "app_admin",
+	// 插件标题，用于检索和识别
+	"title": "应用管理插件",
+	// 插件描述，介绍改插件是做什么用的
+	"description": "用于管理应用，实现热拔插",
+	// 插件版本号，用于升级迭代
+	"version": "1.0",
+	// 插件语言包文件路径
+	"lang_path": "/sys/app_admin/lang/",
+	// 插件图标
+	"icon": "/sys/app_admin/img/logo.png",
+	// 插件指令，通过指令方式调用插件
+	"cmd": "sys.app_admin",
+	// 排序，表示多个插件时在应用下执行的先后顺序
+	"sort": 10
+}

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

@@ -0,0 +1,39 @@
+{
+	// 路由路径
+	"path": "/api/config",
+	// 名称, 用于动态增删改API配置
+	"name": "api_config",
+	// 标题, 用于开发文档显示
+	"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,
+		// 会员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"vip": 0,
+		// 管理员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"gm": 0,
+		// 商户/第三方权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"mc": 0,
+		// 用户组, 允许访问该接口的普通用户群体, 传ID数组，例如: [1,5]
+		"user_group": [],
+		// 管理组, 允许访问该接口的管理员群体, 传ID数组，例如: [1,5]
+		"user_admin": []
+	}
+}

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

@@ -0,0 +1,37 @@
+$.conf = {};
+/**
+ * 接口主函数
+ * @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 dict = {};
+	db.table = query.app + "_config";
+	db.size = 0;
+
+	// 操作sql模板
+	var list = await db.get();
+	for (var i = 0; i < list.length; i++) {
+		var o = list[i];
+		if (o.type === "number") {
+			dict[o.name] = Number(o.value || '0');
+		} else if (o.type === "boolean") {
+			dict[o.name] = Boolean(o.value || 'false');
+		} else if (o.type === "object" || o.type === "array") {
+			dict[o.name] = o.value.toJSON();
+		} else {
+			dict[o.name] = o.value;
+		}
+	}
+	$.cache.set("app_" + db.table, JSON.stringify(dict));
+	return $.ret.obj(dict);
+};
+
+exports.main = main;

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

@@ -0,0 +1,27 @@
+{
+	// 是否启用过滤, 启用过滤后, 不符合的参数会被过滤掉
+	"filter": true,
+	// 校验脚本文件, 可以使用脚本的方式加一步进行校验, 让传参更加安全
+	"func_file": "",
+	// get请求
+	"get": {
+		// 查询参数校验项
+		"query": [],
+		// 查询必填参数
+		"query_required": ["app"]
+	},
+	// 校验列表
+	"list": [{
+			"name": "app",
+			"title": "应用名称",
+			"type": "string",
+			// 字符串类型时设置
+			"string": {
+				// 格式
+				"format": "en",
+				// 传值范围，字符串时为限制字符长度
+				"range": [2, 16]
+			}
+		}
+	]
+}

package/demo/app/sys/plugin/main/api_client/config/sql.json

@@ -0,0 +1,70 @@
+{
+	// SQL模板标题
+	"title": "示例sql模板",
+	// 调用的数据表
+	"table": "user_account",
+	// 表主键，用于getObj查询时
+	"key": "user_id",
+	// 排序方式，{0}表示支持前端传值来排序，传值方式例如：orderby=user_id
+	"orderby": "{0}",
+	// 默认排序方式，当前端没有传值的情况下，采用默认传值方式
+	"orderby_default": "`user_id` desc",
+	// 查询列表时返回的字段，{0}表示支持前端传值
+	"field": "{0}",
+	// 查询对象时返回的字段
+	"field_obj": "{0}",
+	// 默认返回字段
+	"field_default": "`username`, `phone`",
+	// 需要过滤的字段，*代表泛匹配 前面*表示以xxx结尾，后面*表示以xxx开头，前后*表示包含xxx的过滤
+	"field_hide": ["*password*", "*token*"],
+	// 传值分隔符，如果允许多个值，可以通过这个来分割，如果不允许传多个值则设置为空
+	"separator": "|",
+	// 关键词，用于过滤掉这些值不会写到查询条件中，同时用来识别传的参数
+	"keyword": {
+		// 数据表名，当"table":"{0}", 允许识别表明
+		"table": "table",
+		// 排序方式
+		"orderby": "orderby",
+		// 查询的字段
+		"field": "field",
+		// 页码
+		"page": "page",
+		// 页面大小
+		"size": "size",
+		// 总计，返回查询结果总数
+		"count": "count",
+		// 调用方式
+		"method": "method"
+	},
+	// 调用方式 add增 del删 set改 get查 get_obj查一条 import导入 export导出, 支持什么方式就传什么值，支持多个用空格分隔
+	"method": "add del set get get_obj import export del_repeat sum count",
+	// 查询条件转换
+	"query": {
+		// 当username=xx时，转为`username` like '%xxx%'的SQL语法
+		"username": "`username` like '%{0}%'"
+	},
+	// 修改时的查询条件
+	"where": {
+		// 当修改查询条件出现user_id=xx时，转为`user_id` = 'xxx'的SQL语法
+		"user_id": "`user_id` = '{0}'"
+	},
+	// 修改时值转换
+	"update": {
+		// 当修改的正文中出现username是转换为指定格式
+		"username": "`username` = '{0}'"
+	},
+	// 默认查询条件
+	"query_dedefault": {
+		
+	},
+	// 默认添加项
+	"body_default": {
+		
+	},
+	// SQL执行脚本，当设置js文件名后, 执行该SQL还将调用这个脚本
+	"func_file": "",
+	// 导入导出格式，转换导入、导出Eexcel时字段名和字段值
+	"format": [],
+	// 去重条件，需要查重、并去重的字段在这里写
+	"del_repeat": {}
+}

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

@@ -0,0 +1,37 @@
+{
+	// 路由路径
+	"path": "/api/sys_lang",
+	// 名称, 用于动态增删改API配置
+	"name": "api_lang",
+	// 标题, 用于开发文档显示
+	"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,
+		// 会员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"vip": 0,
+		// 管理员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"gm": 0,
+		// 商户/第三方权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"mc": 0,
+		// 用户组, 允许访问该接口的普通用户群体, 传ID数组，例如: [1,5]
+		"user_group": [],
+		// 管理组, 允许访问该接口的管理员群体, 传ID数组，例如: [1,5]
+		"user_admin": []
+	}
+}

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

@@ -0,0 +1,27 @@
+/**
+ * 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+async function main(ctx, db) {
+	// 获取请求参数
+	var req = ctx.request;
+	var q = req.query;
+	var qpp = q["app"] || "cms";
+	db.table = qpp + "_lang";
+	db.size = 0;
+	var type = q["type"];
+	var arr = await db.get({}, "", "`key`" + ",`" + type + "`");
+	var dict = {};
+	if (arr.length) {
+		ctx.cookies.set('sys_lang', type);
+		for (var i = 0; i < arr.length; i++) {
+			var o = arr[i];
+			dict[o.key] = o[type];
+		}
+	}
+	return dict;
+};
+
+exports.main = main;

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

@@ -0,0 +1,22 @@
+{
+	// 是否启用过滤, 启用过滤后, 不符合的参数会被过滤掉
+	"filter": true,
+	// 校验脚本文件, 可以使用脚本的方式加一步进行校验, 让传参更加安全
+	"func_file": "",
+	// get请求
+	"get": {
+		// 查询参数校验项
+		"query": [],
+		// 查询必填参数
+		"query_required": ["type"]
+	},
+	// 校验列表
+	"list": [{
+		// 参数key名
+		"name": "type",
+		// 参数中文名
+		"title": "语言类型",
+		// 数据类型
+		"type": "string"
+	}]
+}

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

@@ -0,0 +1,15 @@
+{
+    "name": "nav",
+    "title": "导航信息",
+    "description": "获取指定app的导航链接和路由信息",
+    "path": "/api/sys_nav*",
+    "type": "api",
+    "func_file": "./index.js",
+    "func_name": "",
+    "method": "GET",
+    "cache": 0,
+    "client_cache": false,
+    "param_path": "./param.json",
+    "sql_path": "",
+    "check_param": true
+}

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

@@ -0,0 +1,39 @@
+/**
+ * @description 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+async function main(ctx, db) {
+	var req = ctx.request;
+	var query = req.query;
+	var scope = query['scope'] || 'admin';
+	
+	var nav = $.nav_admin(scope);
+	
+	if (query['update']) {
+		nav.update();
+		return $.ret.bl(true, '更新成功');
+	} else {
+		var {
+			name,
+			app,
+			type
+		} = query;
+		var n = app ? app : name;
+		var ret = await nav.run(n, type);
+		if (ret) {
+			if (ctx.path.endWith('.js')) {
+				ctx.type = "application/javascript; charset=utf-8";
+				ctx.set('Cache-Control', 'max-age=7200,immutable');
+				var code = JSON.stringify(ret);
+				return `define([], function() {"use strict"; return ${code} });`;
+			} else {
+				return $.ret.body(ret);
+			}
+		}
+	}
+	return null;
+};
+
+exports.main = main;

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

@@ -0,0 +1,87 @@
+{
+    "name": "nav",
+    "filter": true,
+    "method": "get",
+    "add": {
+        "body": [],
+        "body_required": []
+    },
+    "del": {
+        "query": [],
+        "query_required": []
+    },
+    "set": {
+        "query": [],
+        "query_required": [],
+        "body": [],
+        "body_required": [],
+        "body_not": []
+    },
+    "get": {
+        "query": [
+            "name",
+            "type"
+        ],
+        "query_required": []
+    },
+    "post": {
+        "query": [],
+        "query_required": [],
+        "body": [],
+        "body_required": [],
+        "body_not": []
+    },
+    "list": [
+        {
+            "splitter": "|",
+            "type": "string",
+            "string": {
+                "notEmpty": false,
+                "min": 2,
+                "max": 16,
+                "range": [],
+                "regex": "",
+                "identical": "",
+                "different": "",
+                "extension": "",
+                "format": ""
+            },
+            "number": {
+                "min": 0,
+                "max": 0,
+                "range": []
+            },
+            "name": "name",
+            "title": "应用名称",
+            "description": "用于查询是什么应用的导航",
+            "dataType": "varchar"
+        },
+        {
+            "splitter": "|",
+            "type": "string",
+            "string": {
+                "notEmpty": false,
+                "min": 2,
+                "max": 16,
+                "range": [],
+                "regex": "",
+                "identical": "",
+                "different": "",
+                "extension": "",
+                "format": ""
+            },
+            "number": {
+                "min": 0,
+                "max": 0,
+                "range": []
+            },
+            "name": "type",
+            "title": "类型",
+            "description": "用于获取指定类型的导航, 可以为空, 为空获取所有类型的导航",
+            "dataType": "varchar"
+        }
+    ],
+    "func_file": "",
+    "func_name": "",
+    "title": "导航信息获取接口"
+}

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * 查询
+ * @param {String} url 路由地址
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 查询结果
+ */
+async function get(url, ctx, db) {
+	var event_api = $.pool.event['api'];
+	var path = url.left('?', true);
+	var queryString = url.right('?');
+	var query = queryString ? queryString.toUrl() : {};
+	var ret = await event_api.run(path, Object.assign(ctx, {method: "GET", queryString, path, query}), Object.assign({}, db));
+	return ret;
+}
+
+/**
+ * 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+async function main(ctx, db) {
+	// 获取请求参数
+	var req = ctx.request;
+	var json = req.body;
+	var body = {};
+	for (var k in json) {
+		var url = json[k];
+		var ret = await get(url, ctx, db);
+		if(ret){
+			var res = ret.toJson();
+			if(res.error){
+				body = res;
+				body.key = k;
+				break;
+			}
+			else {
+				body[k] = res.result.list || res.result.obj;
+			}
+		}
+		else {
+			body[k] = null;
+		}
+	}
+	return body;
+};
+
+exports.main = main;

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

@@ -0,0 +1,37 @@
+{
+	// 路由路径
+	"path": "/api/sys_theme",
+	// 名称, 用于动态增删改API配置
+	"name": "api_theme",
+	// 标题, 用于开发文档显示
+	"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,
+		// 会员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"vip": 0,
+		// 管理员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"gm": 0,
+		// 商户/第三方权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"mc": 0,
+		// 用户组, 允许访问该接口的普通用户群体, 传ID数组，例如: [1,5]
+		"user_group": [],
+		// 管理组, 允许访问该接口的管理员群体, 传ID数组，例如: [1,5]
+		"user_admin": []
+	}
+}

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

@@ -0,0 +1,30 @@
+/**
+ * 接口主函数
+ * @param {Object} ctx HTTP上下文
+ * @param {Object} db 数据管理器,如: { next: async function{}, ret: {} }
+ * @return {Object} 执行结果
+ */
+async function main(ctx, db) {
+	// 获取请求参数
+	var req = ctx.request;
+	var q = req.query;
+	var color = q["color"];
+	var bl = false;
+	if (color) {
+		ctx.cookies.set('theme_color', color);
+		bl = true;
+	}
+
+	var style = q["style"];
+	if (style) {
+		ctx.cookies.set('theme_name', style);
+		bl = true;
+	}
+	if (bl) {
+		return $.ret.bl(true, "设置成功！");
+	} else {
+		return $.ret.bl(false, "设置失败！");
+	}
+};
+
+exports.main = main;

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

@@ -0,0 +1,31 @@
+{
+	// 是否启用过滤, 启用过滤后, 不符合的参数会被过滤掉
+	"filter": true,
+	// 校验脚本文件, 可以使用脚本的方式加一步进行校验, 让传参更加安全
+	"func_file": "",
+	// get请求
+	"get": {
+		// 查询参数校验项
+		"query": ["color", "style"],
+		// 查询必填参数
+		"query_required": []
+	},
+	// 校验列表
+	"list": [{
+			// 参数key名
+			"name": "color",
+			// 参数中文名
+			"title": "主题色",
+			// 数据类型
+			"type": "string"
+		},
+		{
+			// 参数key名
+			"name": "style",
+			// 参数中文名
+			"title": "主题样式",
+			// 数据类型
+			"type": "string"
+		}
+	]
+}

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

@@ -0,0 +1,39 @@
+{
+	// 路由路径
+	"path": "/api/sys_translate",
+	// 名称, 用于动态增删改API配置
+	"name": "api_translate",
+	// 标题, 用于开发文档显示
+	"title": "示例接口",
+	// 描述, 用于介绍该路由的作用
+	"description": "描述接口使用方法",
+	// 函数文件, 用于驱动脚本, 实现业务 
+	"func_file": "./index.js",
+	// 请求方法, 选填 GET, POST, ALL。 ALL指同时支持GET/POST
+	"method": "ALL",
+	// 开放域, 如果域未开放, 则只有特定的协议头才能访问该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,
+		// 会员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"vip": 0,
+		// 管理员权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"gm": 0,
+		// 商户/第三方权限级别, 如果小于该值, 则无法访问, 0为不限制
+		"mc": 0,
+		// 用户组, 允许访问该接口的普通用户群体, 传ID数组，例如: [1,5]
+		"user_group": [],
+		// 管理组, 允许访问该接口的管理员群体, 传ID数组，例如: [1,5]
+		"user_admin": []
+	}
+}