Questionnaire Design

questionnaire srs

MRD

教务员或者相关人员可以创建一个问卷调查，并收集调查结果。从而以此调查结果为依据，改进教学质量(调查问卷的创建，调查结果的查看，可以不再eeap平台上面)

PRD

教务员：
    1. CRUD（创建，预览，编辑，删除）试题
    1. CRUD（创建，预览，编辑，删除）调查问卷
    2. 发布调查问卷
    3. 查看调查问卷统计信息

被调查者：
    1. 查看，填写调查问卷，并提交

Typical user case

• 创建调查问卷

  1. 南航，计算机专业教务员，登录eeap，并点击：持续改进-->调查问卷
  2. 进入我们的weplatform管理平台
     
     1. 到了weplatform之后自行登录？
     2. 由eeap这边的url链接带入用户名跟密码？
     3. 调查问卷按钮，显示进入一个假页面，这个页面的域名跟weplatform一样（CORS），假页面JS负责登录？
  3. 点击：应用中心-->调查问卷-->题目管理，然后在这个页面CRUD题目（单选，多选，填空题）
  4. 点击：应用中心-->调查问卷-->问卷管理，然后在这个页面CRUD问卷（题目从题库中选）
  5. 点击问卷管理中的某一个问卷，选择发布，则返回一个URL
     
  6. 也可以在二维码中关联问卷，通过微信发布出去。
     
  7. 问卷的学校，年级属性，让教务员自己填相应的属性就行了？？？

• 填写调查问卷

  1. 互联网用户点击上面返回的URL，填写调查问卷，并点击提交
  2. 显示感谢词
     
• 查看调查问卷结果
  
  1. 教务员点击问卷管理中的某个问卷，选择“统计”，显示该问卷的统计信息
     

SRS

问卷内容

1. 只支持单选，多选，填空三种类型的题目

发布问卷

1. 生成一个固定连接，类容就是生成预览时生成的html网页

issue

1. find a questionnaire django app, but can not make it run

   • questionnaire django app
   • http://stackoverflow.com/questions/20584478/how-do-i-setup-virtualenv-environments-for-python-2-4-and-2-5-versions-on-window
   • https://djangopackages.org/grids/g/survey-questionnaire/

2. QQ questionnaire use CKEditor, find a django-ckeditor

DB schema

Questionnaire(can be divided to QuestionnaireSet and Questionnaire)

Question

tag

Choice

Answer

Operation

Question

Create, Update question
URL:    /api/v1/questions/
Method: POST
Data:   {
            choices: [
                {
                    id: 0,                                        // used when update
                    desc: 'choice description',
                    value: none,
                    is_used: 0
                },
            ],
            q_id: 0,                                             // used when update
            type: 0,
            is_mandatory: 0,
            desc: 'question content',
            is_used: 0,
            tags: [
                'tag1',
                'tag2'
            ]
        }
ret:    {
            status: 200
            data: {
                c_ids: [0, 1, 2],
                q_id: 0,
                type: 0,
                is_mandatory: 0,
                desc: 'question content',
                is_used: 0,
                tags: [0, 1],
                owner: 0
             }
        }
        {
            status: 400,
            data: {
                msg: 'create question error'
             }
        }
----------------------------------------------------------------------------------------
Delete question
URL:    /api/v1/questions/
Method: POST
Data:   {
            q_id: 0,
        }
ret:    {
            status: 400/200,
            data: {
                msg: 'create question error / delete success'
             }
        }
----------------------------------------------------------------------------------------
Get question info
URL:    /api/v1/questions/:qid/
Method: GET
ret:    {
            status: 200
            data: {
                c_ids: [0, 1, 2],
                q_id: 0,
                type: 0,
                is_mandatory: 0,
                desc: 'question content',
                is_used: 0,
                tags: [0, 1],
                owner: 0
             }
        }
        {
            status: 400,
            data: {
                msg: 'get question info error'
             }
        }
----------------------------------------------------------------------------------------
Get question list
URL:    /api/v1/questions/
Method: GET
ret:    {
            status: 200
            data: {
                q_ids: [0, 1, 2],
             }
        }
        {
            status: 400,
            data: {
                msg: 'get questions error'
             }
        }

Questionnaire

Create, Update
URL:    /api/v1/questionnaires/
Method: POST
Data:   {
            id: 0,                                                    // used when update
            q_ids: [0, 1, 2],
            name: 'questionnaire-1',
            desc: 'why i create this questionnaire',
            valid_num: 0,
            is_pub: 0
        }
ret:    {
            status: 200
            data: {
                id: 0,                                                  // used when update
                q_ids: [0, 1, 2],
                name: 'questionnaire-1',
                desc: 'why i create this questionnaire',
                valid_num: 0,
                is_pub: 0
                pub_url: 'http:xxxxxxxx',
                pub_url: 'http:xxxxxxxx'
             }
        }
        {
            status: 400,
            data: {
                msg: 'create questionnaire error'
             }
        }
----------------------------------------------------------------------------------------
Delete
URL:    /api/v1/questionnaires/
Method: POST
Data:   {
            qn_id: 0,
        }
ret:    {
            status: 400/200,
            data: {
                msg: 'create question error / delete success'
             }
        }
----------------------------------------------------------------------------------------
Get questionnaires info
URL:    /api/v1/questionnaires/:qnid/
Method: GET
ret:    {
            status: 200
            data: {
                id: 0,                                                  // used when update
                q_ids: [0, 1, 2],
                name: 'questionnaire-1',
                desc: 'why i create this questionnaire',
                valid_num: 0,
                is_pub: 0
                pub_url: 'http:xxxxxxxx',
                pub_url: 'http:xxxxxxxx'
             }
        }
        {
            status: 400,
            data: {
                msg: 'get question info error'
             }
        }
----------------------------------------------------------------------------------------
Get questionnaires list
URL:    /api/v1/questionnaires/
Method: GET
ret:    {
            status: 200
            data: {
                qn_ids: [0, 1, 2],
             }
        }
        {
            status: 400,
            data: {
                msg: 'get questionnaires error'
             }
        }

submit questionnaire

submit questionnaire
URL:    /api/v1/answers/
Method: POST
Data:   {
            qn_id: 0,
            owner: 0,
            answers: [
                {
                    q_id: 0,
                    q_type: 0,
                    c_id: [0, 1],
                    text: 'this is just for completion'
                },
            ]
        }
ret:    {
            status: 200
            data: {
                 msg: 'submit success'
             }
        }
        {
            status: 400,
            data: {
                msg: 'get questionnaires error'
             }
        }

report of questionnaire

report of questionnaire
URL:    /api/v1/report/:qn_id/
Method: GET
ret:    {
            status: 200
            data: {
                 answers: [
                    {
                        q_id: 0,
                        a_ids: [0, 1, 2]
                    }
                 ]
             }
        }
        {
            status: 400,
            data: {
                msg: 'get questionnaires error'
             }
        }