梅沙表单收集系统1.0

工作

阅读索引

• 需求背景概述
• 整体架构流程图
• 使用常量定义
• 数据表设计
  
  • e-r图
  • 表字段设计
• 复杂逻辑字段定义说明
• 功能实现
• 辅助功能实现

需求背景概述

应对公司各个业务系统的收集需求

整体架构流程图

使用常量定义

数据表设计

数据库整体设计e-r图

表字段设计

表单表 tb_form

表单统计数据中间表 tb_form_statistical

模版表 tb_template

tb_question 自定义问题

tb_public_question

tb_aggregation_public_question 公共题目聚合表

tb_form_question_relation 关联题目表

tb_paper 收集的答卷

tb_paper_detail收集答卷详情

tb_paper_draft 草稿表

tb_admin_operation_log

复杂逻辑字段定义说明

问题

问题统一字段定义如下:

{
    "name":"名称",
    "note":"备注",
    "type":"题目类型，1单选题。2多选题。3填空题。4量表题。5附件题",
    "isWrite":"是否必填",
    "config":"问题配置",
    "content":"问题详细内容"
}

分题型设置config与content字段

• 单选题

  {
      "config":{},
      "content":[
          {"optionData":"","score":"得分","description":"描述"}
      ]
  }

• 多选题

  {
      "config":{
          "choiceUpper":"选择上限",
          "choiceLower":"选择下限"
      },
      "content":[
          {"optionData":"","score":"得分","description":"描述"}
      ]
  }

• 填空题

  {
      "config":{
          "contentRestrict":"内容限制",
          "minCount":"",
          "maxCount":""
      }
      "content":""
  }

  • 限制内容
    

• 量表题

{
    "config":{
        "stepSize":"步长"
    },
    "content":{
        "startDesc":"起始描述",
        "startNmber":"起始数值",
        "endDesc":"结尾描述",
        "endNumber":"结尾数值"
    }
}

• 附件题

    "config":{
        "uploadType":""
    },
    "content":"url"

问题内部实现结构

功能实现

商户筛选

• 功能页面
  

• 涉及api

  • /api/admin/form/get_user_company 获取用户所属商户信息
  • /api/admin/form/get_company_child 获取子级团队

  • 返回字段结构

        [{
            "id":"团队id",
            "name":"团队名称"
        }]

  • 逻辑图说明

表单配置筛选

• 功能页面
  

• 涉及api

  • /api/admin/form/get_company_info 获取团队信息

  • 返回字段结构

        [{
            "id":"团队id",
            "name":"团队名称"
        }]

表单列表

• 功能页面
  

• 涉及api

  • /api/admin/form/get_list

  • 请求字段结构

    [
        {
            "status":"0暂停，1发布",
            "userCompanyIds":"用户团队",
            "formCompanyIds":"表单团队",
            "type":"表单类型",
            "searchType":"1按id搜索，2标题",
            "searchField":""
        }
    ]

  • 返回字段结构

    [
        {
            "id":"表单id",
            "name":"表单名称",
            "type":"表单类型",
            "companyName":"团队名称",
            "updateTime":"修改时间",
            "paperCount":"答卷数",
            "status":"表单状态",
            "viewCount":"查看次数",
            "reRate":"回收率"
            }
    ]

创建表单

• 功能页面
  

• 涉及api

  • /api/admin/form/create 创建表单

  • 请求字段结构

    [
        {
            "name":"表单名称",
            "templateId":"模版id",
            "type":"表单类型"
        }
    ]

  • 返回字段结构

        {
            "id":"表单id"
        }

  • 接口逻辑图

  • /api/admin/form/template/get_list_info 获取模版信息

  • 请求字段结构

  • 返回字段结构

    [{
        "id":"模版id",
        "instruction":"说明",
        "createCompanyName":"创建团队名称"
    }]

公共题目获取

• 功能页面
  

• 涉及接口

  • /api/admin/question/get_public

  • 请求字段

    {"type":"表单类型"}

  • 返回字段

    [{
        "aggregationName":"聚合名称",
        "aggregationDesc":"聚合描述"
        "list":[
            {
                "id":"问题id",
                "name":"问题标题"
            }
        ]            
    }]

编辑表单

• 功能页面
  
  

• 涉及api

  • /api/admin/form/edit 编辑

    • 请求字段:

      {
          "name":"",
          "instruction":""
      }

  • /api/admin/form/save 保存表单

    • 请求字段：

      {
          "anyOne":"0,不设置,1设置",
          "reUser":"1设置,0不设置",
          "sysUser":"1设置，0不设置",
          "isShowQuesNumber":"1设置，0不设置",
          "endTime":""
      }

    • /api/admin/form/update_status 编辑表单状态

    • 请求字段：

      {
          "formId":"表单id",
          "status":"状态"
      }

获取表单详情

• 涉及api

  • /api/admin/form/detail

    • 请求字段:

        {
            "formId":"表单id"
        }

    • 返回字段

    {
        "formId":"表单id",
        "setting":{
            "anyOne":"0,不设置,1设置",
            "reUser":"1设置,0不设置",
            "sysUser":"1设置，0不设置",
            "isShowQuesNumber":"1设置，0不设置",
            "endTime":""
        },
        "questionList":[],
        "name":"表单标题",
        "instruction":"说明"
    }

题目相关操作

• 涉及操作
  增加，删除，修改

• 涉及api

  • /api/admin/question/create 创建问题
    请求字段：

    {
        "formId":"表单id",
        "id":"问题id，仅公共题目有"
        "name":"问题名称",
        "type":"问题类型",
        "isWrite":"是否必填写",
        "config":"配置信息",
        "content":"详细内容，区分类型"
    }

  • /api/admin/question/edit 编辑问题
    请求字段:

    {
        "id":"问题id"
        "name":"问题名称",
        "type":"问题类型",
        "isWrite":"是否必填写",
        "config":"配置信息",
        "content":"详细内容，区分类型"
    }

  • /api/admin/question/delete 删除问题
    请求字段:

    {
        "id":"问题id"
    }

表单填写

• 功能页面
  

• 涉及api

  • /api/h5/form/get_form_answer 获取表单信息填写情况

    • 请求字段

    {
        "formId":"表单id"
    }

    • 返回字段

    {
        "formName":"表单名称",
        "formDesc":"表单描述",
        "questionList":[
            {
                "id":"",
                "name":"",
                "type":"",
                "config":"",
                "content":"",
                "answer":"",
            }
        ]
    }

    • 请求逻辑结构
      

  • /api/h5/question/edit_answer 填写问题答案

  • /api/h5/form/commit 提交

    • 请求字段

          {
              "formId":"表单id",
              "id":"问题id",
              "answer":""
          }

          {
              "formId":"表单id",
          }

    • 填写逻辑

回收统计

• 功能页面
  

• 涉及接口

  • /api/admin/recycle/get_statistical_data 获取统计数据

    • 请求字段

    {
        "formId":"表单id"
    }

    • 返回字段

    {
        "clickNumber":"浏览量",
        "reNumber":"回收量",
        "reRate":"回收率"
    }

  • /api/admin/recycle/get_list 获取数据list

    • 请求字段

    {
        "formId":"表单id"
    }

    • 返回字段

    {
        "count":"数据量",
        "currentPage":"当前页面",
        "head":[{"key":"","value"}],
        "lastPage":"上个页面",
        "list":[
            "number":"",
            ....题目
        ]
    }

  • /api/admin/recycle/export_list 获取数据list

    • 请求字段

    {
        "ids":[“导出选中”]
    }

导入表单

• 功能页面
  

• 涉及接口

  • /api/admin/form/get_info 获取表单信息

  • 请求字段:

    {
        "formId":"表单id"
    }

  • 返回字段:

    {
        "name":"问卷名称",
        "id":"id",
        "createUserName":"创建用户名称",
        "type":"类型",
        "updateTime":"更新时间"
    }

  • /api/admin/form/excel/download_template 下载excel导入模版

  • /api/admin/form/excel/parse_excel_data 解析用户导入数据
  • /api/admin/form/batch_add 批量添加表单

辅助功能实现

正则校验

针对填空题中对于电话，邮箱，等校验逻辑。统一使用util类，写正则表达式进行校验。

登录

后端登录分为，普通登录与微信中分享登录。