@steedos-labs/plugin-workflow 3.0.0-beta.5

package/main/default/routes/api_workflow_open_drafts.router.js

@@ -0,0 +1,183 @@
+/*
+ * @Author: sunhaolin@hotoa.com
+ * @Date: 2022-12-24 14:24:25
+ * @LastEditors: sunhaolin@hotoa.com
+ * @LastEditTime: 2022-12-24 14:52:07
+ * @Description: 
+ */
+'use strict';
+// @ts-check
+const express = require('express');
+const router = express.Router();
+const { requireAuthentication } = require("@steedos/auth");
+const _ = require('underscore');
+const Fiber = function(fun){console.log('TODO Fiber...')}
+const UUFlowManager = require('../manager/uuflow_manager');
+/**
+@api {post} /api/workflow/open/drafts 新建申请单
+
+@apiName createInstance
+
+@apiGroup service-workflow
+
+@apiPermission 工作区管理员
+
+@apiParam {String} access_token User API Token
+
+@apiHeader {String} X-Space-Id	工作区Id
+
+@apiHeaderExample {json} Header-Example:
+{
+    "X-Space-Id": "wsw1re12TdeP223sC"
+}
+
+@apiParamExample {json} Request Payload:
+{
+    "flow": 流程Id,
+    "applicant": 申请人Id,
+    "values": {
+        "fields1" : 字段值,
+        "fields2" : 字段值,
+        ...
+    }
+}
+
+@apiSuccessExample {json} Success-Response:
+{
+    "status": "success",
+    "data": {instance}
+}
+
+@apiErrorExample {json} error-Response:
+{
+    "status": "error",
+    "data": {...}
+}
+ */
+router.post('/api/workflow/open/drafts', requireAuthentication, async function (req, res) {
+    try {
+        let userSession = req.user;
+        const spaceId = userSession.spaceId;
+        const userId = userSession.userId;
+        const isSpaceAdmin = userSession.is_space_admin;
+        var hashData = req.body;
+        Fiber(async function () {
+            try {
+                var applicant, applicantInfo, applicant_id, applicant_username, approve, approves, current_user_info, e, flow, flow_id, hashData, instance_from_client, new_ins, new_ins_id, space_id, space_user, space_user_org_info, trace, traces, user_id;
+                user_id = userId;
+                current_user_info = db.users.findOne({
+                    _id: user_id
+                });
+                space_id = req.headers['x-space-id'];
+                if (!space_id) {
+                    throw new Error('need header x_space_id');
+                }
+                // 校验space是否存在
+                UUFlowManager.getSpace(space_id);
+                // 校验当前登录用户是否是space的管理员
+                UUFlowManager.isSpaceAdmin(space_id, current_user_info._id);
+                hashData = req.body;
+                if (!hashData["flow"]) {
+                    throw new Error('flow is null');
+                }
+                flow_id = hashData["flow"];
+                applicant_id = hashData["applicant"];
+                applicant_username = hashData["applicant_username"];
+                instance_from_client = new Object;
+                flow = db.flows.findOne({
+                    _id: flow_id
+                }, {
+                    fields: {
+                        space: 1,
+                        'current._id': 1
+                    }
+                });
+                if (!flow) {
+                    throw new Error('flow is not exists');
+                }
+                if (space_id !== flow.space) {
+                    throw new Error('flow is not belong to this space');
+                }
+                if (db.space_users.find({
+                    space: space_id,
+                    user: current_user_info._id
+                }).count() === 0) {
+                    throw new Error('auth_token is not a member of this space');
+                }
+                instance_from_client["space"] = space_id;
+                instance_from_client["flow"] = flow_id;
+                instance_from_client["flow_version"] = flow.current._id;
+                applicant = null;
+                if (applicant_id || applicant_username) {
+                    if (applicant_id) {
+                        applicant = db.users.findOne({
+                            _id: applicant_id
+                        }, {
+                            fields: {
+                                name: 1
+                            }
+                        });
+                        if (!applicant) {
+                            throw new Error('applicant is wrong');
+                        }
+                    } else if (applicant_username) {
+                        applicant = db.users.findOne({
+                            username: applicant_username
+                        }, {
+                            fields: {
+                                name: 1
+                            }
+                        });
+                        if (!applicant) {
+                            throw new Error('applicant_username is wrong');
+                        }
+                    }
+                    space_user = db.space_users.findOne({
+                        space: space_id,
+                        user: applicant._id
+                    });
+                    if (!space_user) {
+                        throw new Error('applicant is not a member of this space');
+                    }
+                    if (space_user.user_accepted !== true) {
+                        throw new Error('applicant is disabled in this space');
+                    }
+                    space_user_org_info = UUFlowManager.getSpaceUserOrgInfo(space_user);
+                    instance_from_client["applicant"] = applicant._id;
+                    instance_from_client["applicant_name"] = applicant.name;
+                    instance_from_client["applicant_organization"] = space_user_org_info["organization"];
+                    instance_from_client["applicant_organization_fullname"] = space_user_org_info["organization_fullname"];
+                    instance_from_client["applicant_organization_name"] = space_user_org_info["organization_name"];
+                }
+                applicantInfo = applicant || current_user_info;
+                traces = [];
+                trace = new Object;
+                approves = [];
+                approve = new Object;
+                approve["values"] = hashData["values"];
+                approves.push(approve);
+                trace["approves"] = approves;
+                traces.push(trace);
+                instance_from_client["traces"] = traces;
+                instance_from_client["inbox_users"] = [applicantInfo._id];
+                new_ins_id = UUFlowManager.create_instance(instance_from_client, applicantInfo);
+                new_ins = db.instances.findOne(new_ins_id);
+
+                res.status(200).send({
+                    status: "success",
+                    data: new_ins
+                });
+            } catch (e) {
+                console.error(e);
+                res.status(200).send({
+                    errors: [{ errorMessage: e.message }]
+                });
+            }
+        }).run()
+    } catch (e) {
+        res.status(200).send({
+            errors: [{ errorMessage: e.message }]
+        });
+    }
+});
+exports.default = router;

package/main/default/routes/api_workflow_open_get.router.js

@@ -0,0 +1,123 @@
+/*
+ * @Author: sunhaolin@hotoa.com
+ * @Date: 2022-12-24 14:29:57
+ * @LastEditors: sunhaolin@hotoa.com
+ * @LastEditTime: 2022-12-24 14:52:00
+ * @Description: 
+ */
+'use strict';
+// @ts-check
+const express = require('express');
+const router = express.Router();
+const { requireAuthentication } = require("@steedos/auth");
+const _ = require('underscore');
+const PermissionManager = require('../manager/permission_manager');
+const Fiber = function(fun){console.log('TODO Fiber...')}
+const UUFlowManager = require('../manager/uuflow_manager');
+/**
+@api {get} /api/workflow/open/get/:ins_id 查看申请单详情
+
+@apiName getInstance
+
+@apiGroup service-workflow
+
+@apiPermission 工作区的管理员
+
+@apiParam {String} ins_id 申请单Id
+@apiParam {String} access_token User API Token
+
+@apiHeader {String} X-Space-Id	工作区Id
+
+@apiHeaderExample {json} Header-Example:
+{
+    "X-Space-Id": "wsw1re12TdeP223sC"
+}
+
+@apiSuccessExample {json} Success-Response:
+{
+    "status": "success",
+    "data": {instance}
+}
+ */
+router.get('/api/workflow/open/get/:ins_id', requireAuthentication, async function (req, res) {
+    try {
+        let userSession = req.user;
+        const spaceId = userSession.spaceId;
+        const userId = userSession.userId;
+        const isSpaceAdmin = userSession.is_space_admin;
+        var hashData = req.body;
+        Fiber(async function () {
+            try {
+                var current_user, e, ins_id, instance, perm_users, permissions, space, space_id;
+                ins_id = req.params.ins_id;
+                current_user = userId;
+                space_id = req.headers['x-space-id'];
+                if (!space_id) {
+                    throw new Error('need header X_Space_Id');
+                }
+                // 校验space是否存在
+                UUFlowManager.getSpace(space_id);
+                // 校验当前登录用户是否是space的管理员
+                UUFlowManager.isSpaceAdmin(space_id, current_user);
+                instance = db.instances.findOne(ins_id);
+                if (!instance) {
+                    throw new Error('can not find instance');
+                }
+                if (db.space_users.find({
+                    space: instance.space,
+                    user: current_user
+                }).count() === 0) {
+                    throw new Error('auth_token is wrong');
+                }
+                // 权限：仅以下人员可以查看申请单详情：提交者、申请者、经手者、本流程的管理员、本流程的观察员、本工作区的管理员、本工作区的所有者。
+                perm_users = new Array;
+                perm_users.push(instance.submitter);
+                perm_users.push(instance.applicant);
+                if (instance.outbox_users) {
+                    perm_users = perm_users.concat(instance.outbox_users);
+                }
+                if (instance.inbox_users) {
+                    perm_users = perm_users.concat(instance.inbox_users);
+                }
+                space = db.spaces.findOne({
+                    _id: instance.space
+                }, {
+                    fields: {
+                        admins: 1
+                    }
+                });
+                perm_users = perm_users.concat(space.admins);
+                permissions = PermissionManager.getFlowPermissions(instance.flow, current_user);
+                if ((!perm_users.includes(current_user)) && (!permissions.includes("monitor")) && (!permissions.includes("admin"))) {
+                    throw new Error('no permission');
+                }
+                instance.attachments = cfs.instances.find({
+                    'metadata.instance': instance._id,
+                    'metadata.current': true,
+                    "metadata.is_private": {
+                        $ne: true
+                    }
+                }, {
+                    fields: {
+                        copies: 0
+                    }
+                }).fetch();
+
+                res.status(200).send({
+                    status: "success",
+                    data: instance
+                });
+            } catch (e) {
+                console.error(e);
+                res.status(200).send({
+                    errors: [{ errorMessage: e.message }]
+                });
+            }
+        }).run()
+    } catch (e) {
+        res.status(200).send({
+            errors: [{ errorMessage: e.message }]
+        });
+    }
+});
+exports.default = router;

package/main/default/routes/api_workflow_open_get_by_stepname.router.js

@@ -0,0 +1,136 @@
+/*
+ * @Author: sunhaolin@hotoa.com
+ * @Date: 2022-12-24 14:27:19
+ * @LastEditors: sunhaolin@hotoa.com
+ * @LastEditTime: 2022-12-24 14:52:04
+ * @Description: 
+ */
+'use strict';
+// @ts-check
+const express = require('express');
+const router = express.Router();
+const { requireAuthentication } = require("@steedos/auth");
+const _ = require('underscore');
+const Fiber = function(fun){console.log('TODO Fiber...')}
+const UUFlowManager = require('../manager/uuflow_manager');
+/**
+@api {post} /api/workflow/open/getbystepname 根据步骤名称获取申请单
+
+@apiName getInstanceByStepName
+
+@apiGroup service-workflow
+
+@apiPermission 工作区管理员
+
+@apiParam {String} access_token User API Token
+
+@apiHeader {String} X-Space-Id	工作区Id
+
+@apiHeaderExample {json} Header-Example:
+{
+    "X-Space-Id": "wsw1re12TdeP223sC"
+}
+
+@apiParamExample {json} Request Payload:
+{
+    "flow": 流程Id,
+    "stepname": 步骤名称
+}
+
+@apiSuccessExample {json} Success-Response:
+{
+    "status": "success",
+    "data": [
+        {
+            instance
+        },
+        {
+            instance
+        }
+    ]
+}
+ */
+router.post('/api/workflow/open/getbystepname', requireAuthentication, async function (req, res) {
+    try {
+        let userSession = req.user;
+        const spaceId = userSession.spaceId;
+        const userId = userSession.userId;
+        const isSpaceAdmin = userSession.is_space_admin;
+        var hashData = req.body;
+        Fiber(async function () {
+            try {
+                var current_user, current_user_info, e, flow, hashData, instances, space_id, stepname;
+                current_user = userId;
+                space_id = req.headers['x-space-id'];
+                if (!space_id) {
+                    throw new Error('need header X_Space_Id');
+                }
+                current_user_info = db.users.findOne(current_user);
+                if (!current_user_info) {
+                    throw new Error('can not find user');
+                }
+                // 校验space是否存在
+                UUFlowManager.getSpace(space_id);
+                // 校验当前登录用户是否是space的管理员
+                UUFlowManager.isSpaceAdmin(space_id, current_user);
+                hashData = req.body;
+                stepname = hashData["stepname"];
+                flow = hashData["flow"];
+                if (!stepname) {
+                    throw new Error('need stepname');
+                }
+                if (!flow) {
+                    throw new Error('need flow');
+                }
+                // 去掉{fields: {inbox_uers: 0, cc_users: 0, outbox_users: 0, traces: 0, attachments: 0}
+                instances = db.instances.find({
+                    space: space_id,
+                    flow: flow,
+                    state: 'pending',
+                    traces: {
+                        $elemMatch: {
+                            is_finished: false,
+                            name: stepname
+                        }
+                    }
+                }, {
+                    fields: {
+                        inbox_uers: 0,
+                        cc_users: 0,
+                        outbox_users: 0,
+                        attachments: 0,
+                        traces: 0
+                    }
+                }).fetch();
+                instances.forEach(function (instance) {
+                    return instance.attachments = cfs.instances.find({
+                        'metadata.instance': instance._id,
+                        'metadata.current': true,
+                        "metadata.is_private": {
+                            $ne: true
+                        }
+                    }, {
+                        fields: {
+                            copies: 0
+                        }
+                    }).fetch();
+                });
+
+                res.status(200).send({
+                    status: "success",
+                    data: instances
+                });
+            } catch (e) {
+                console.error(e);
+                res.status(200).send({
+                    errors: [{ errorMessage: e.message }]
+                });
+            }
+        }).run()
+    } catch (e) {
+        res.status(200).send({
+            errors: [{ errorMessage: e.message }]
+        });
+    }
+});
+exports.default = router;

package/main/default/routes/api_workflow_open_pending.router.js

@@ -0,0 +1,252 @@
+/*
+ * @Author: sunhaolin@hotoa.com
+ * @Date: 2022-12-24 14:32:08
+ * @LastEditors: sunhaolin@hotoa.com
+ * @LastEditTime: 2022-12-24 14:51:58
+ * @Description: 
+ */
+'use strict';
+// @ts-check
+const express = require('express');
+const router = express.Router();
+const { requireAuthentication } = require("@steedos/auth");
+const _ = require('underscore');
+const Fiber = function(fun){console.log('TODO Fiber...')}
+const UUFlowManager = require('../manager/uuflow_manager');
+/**
+@api {get} /api/workflow/open/pending 获取待办文件
+
+@apiDescription 获取当前用户的待办事项列表
+
+@apiName getInbox
+
+@apiGroup service-workflow
+
+@apiParam {String} access_token User API Token
+
+@apiHeader {String} X-Space-Id	工作区Id
+
+@apiHeaderExample {json} Header-Example:
+    {
+        "X-Space-Id": "wsw1re12TdeP223sC"
+    }
+
+@apiSuccessExample {json} Success-Response:
+    {
+        "status": "success",
+        "data": [
+            {
+                "id": "g7wokXNkR9yxHvA4D",
+                "start_date": "2017-11-23T02:28:53.164Z",
+                "flow_name": "正文流程",
+                "space_name": "审批王",
+                "name": "正文流程 1",
+                "applicant_name": null,
+                "applicant_organization_name": "审批王",
+                "submit_date": "2017-07-25T06:36:48.492Z",
+                "step_name": "开始",
+                "space_id": "kfDsMv7gBewmGXGEL",
+                "modified": "2017-11-23T02:28:53.164Z",
+                "is_read": false,
+                "values": {}
+            },
+            {
+                "id": "WqKSrWQoywgJaMp9k",
+                "start_date": "2017-08-17T07:38:35.420Z",
+                "flow_name": "正文\n",
+                "space_name": "审批王",
+                "name": "正文\n 1",
+                "applicant_name": "殷亮辉",
+                "applicant_organization_name": "审批王",
+                "submit_date": "2017-06-27T10:26:19.468Z",
+                "step_name": "开始",
+                "space_id": "kfDsMv7gBewmGXGEL",
+                "modified": "2017-08-17T07:38:35.421Z",
+                "is_read": true,
+                "values": {}
+            }
+        ]
+    }
+ */
+router.get('/api/workflow/open/pending', requireAuthentication, async function (req, res) {
+    try {
+        let userSession = req.user;
+        const spaceId = userSession.spaceId;
+        const userId = userSession.userId;
+        const isSpaceAdmin = userSession.is_space_admin;
+        var hashData = req.body;
+        Fiber(async function () {
+            try {
+                var attach, e, is_read, limit, no_limit_count, query, ref, ref1, ref2, ref3, ref4, ref5, result_instances, space, space_id, space_names, special_user_id, start_date, u, uid, user_id, userid, username, workflow_categories;
+
+                space_id = req.headers['x-space-id'] || ((ref = req.query) != null ? ref.spaceId : void 0);
+                if (!space_id) {
+                    throw new Error('need space_id');
+                }
+                user_id = userId;
+                if (!user_id) {
+                    throw new Error('Not logged in');
+                }
+                if (db.users.find({
+                    _id: user_id
+                }).count() === 0) {
+                    throw new Error('can not find user');
+                }
+                limit = ((ref1 = req.query) != null ? ref1.limit : void 0) || 500;
+                limit = parseInt(limit);
+                username = (ref2 = req.query) != null ? ref2.username : void 0;
+                userid = (ref3 = req.query) != null ? ref3.userid : void 0;
+                attach = (ref4 = req.query) != null ? ref4.attach : void 0;
+                workflow_categories = (ref5 = req.query) != null ? ref5.workflow_categories : void 0;
+                // 校验space是否存在
+                space = UUFlowManager.getSpace(space_id);
+                // 如果当前用户是工作区管理员，则通过查看url上是否有username\userid ，
+                // 如果有，则返回username\userid对应的用户，否则返回当前用户待办。
+                // username\userid都存在时，userid优先
+                special_user_id;
+                if (space.admins.includes(user_id)) {
+                    if (userid) {
+                        if (db.users.find({
+                            _id: userid
+                        }).count() < 1) {
+                            throw new Error(`can not find user by userid: ${userid}`);
+                        }
+                        special_user_id = userid;
+                    } else if (username) {
+                        u = db.users.findOne({
+                            username: username
+                        }, {
+                            fields: {
+                                _id: 1
+                            }
+                        });
+                        if (_.isEmpty(u)) {
+                            throw new Error(`can not find user by username: ${username}`);
+                        }
+                        special_user_id = u._id;
+                    }
+                }
+                result_instances = new Array;
+                is_read = false;
+                start_date = '';
+                uid = user_id;
+                query = {
+                    $or: [
+                        {
+                            inbox_users: user_id
+                        },
+                        {
+                            cc_users: user_id
+                        }
+                    ]
+                };
+                if (special_user_id) {
+                    uid = special_user_id;
+                    query = {
+                        space: space_id,
+                        $or: [
+                            {
+                                inbox_users: special_user_id
+                            },
+                            {
+                                cc_users: special_user_id
+                            }
+                        ]
+                    };
+                }
+                if (workflow_categories) {
+                    query.category = {
+                        $in: workflow_categories.split(',')
+                    };
+                }
+                space_names = {};
+                space_names[space._id] = space.name;
+                if (limit > 0) {
+                    db.instances.find(query, {
+                        sort: {
+                            modified: -1
+                        },
+                        limit: limit
+                    }).forEach(function (i) {
+                        var h, ref6, ref7;
+                        if ((ref6 = i.inbox_users) != null ? ref6.includes(uid) : void 0) {
+                            _.each(i.traces, function (t) {
+                                if (t.is_finished === false) {
+                                    return _.each(t.approves, function (a) {
+                                        if (a.user === uid && a.type !== 'cc' && !a.is_finished) {
+                                            is_read = a.is_read;
+                                            return start_date = a.start_date;
+                                        }
+                                    });
+                                }
+                            });
+                        } else {
+                            _.each(i.traces, function (t) {
+                                if (!start_date && t.approves) {
+                                    return _.each(t.approves, function (a) {
+                                        if (!start_date && a.user === uid && a.type === 'cc' && !a.is_finished) {
+                                            is_read = a.is_read;
+                                            return start_date = a.start_date;
+                                        }
+                                    });
+                                }
+                            });
+                        }
+                        if (!space_names[i.space]) {
+                            space_names[i.space] = (ref7 = db.spaces.findOne(i.space, {
+                                fields: {
+                                    name: 1
+                                }
+                            })) != null ? ref7.name : void 0;
+                        }
+                        h = new Object;
+                        h["id"] = i["_id"];
+                        h["start_date"] = start_date;
+                        h["flow_name"] = i.flow_name;
+                        h["space_name"] = space_names[i.space];
+                        h["name"] = i["name"];
+                        h["applicant_name"] = i["applicant_name"];
+                        h["applicant_organization_name"] = i["applicant_organization_name"];
+                        h["submit_date"] = i["submit_date"];
+                        h["step_name"] = i.current_step_name;
+                        h["space_id"] = i.space;
+                        h["modified"] = i["modified"];
+                        h["is_read"] = is_read;
+                        h["values"] = i["values"];
+                        if (attach === 'true') {
+                            h.attachments = cfs.instances.find({
+                                'metadata.instance': i._id,
+                                'metadata.current': true,
+                                "metadata.is_private": {
+                                    $ne: true
+                                }
+                            }, {
+                                fields: {
+                                    copies: 0
+                                }
+                            }).fetch();
+                        }
+                        return result_instances.push(h);
+                    });
+                }
+                no_limit_count = db.instances.find(query).count();
+
+                res.status(200).send({
+                    status: "success",
+                    data: result_instances,
+                    count: no_limit_count
+                });
+            } catch (e) {
+                console.error(e);
+                res.status(200).send({
+                    errors: [{ errorMessage: e.message }]
+                });
+            }
+        }).run()
+    } catch (e) {
+        res.status(200).send({
+            errors: [{ errorMessage: e.message }]
+        });
+    }
+});
+exports.default = router;