New Page

Target release	Khảo sát
Epic	Khảo sát
Document status
Document owner
Designer
Tech lead
Technical writers
QA

ObjectiveCấu hình các mẫu khảo sát được sử dụng cho menu CTDA và app CRMSuccess metrics

Goal	Metric
Khảo sát	Có thể thực hiện trả lời khảo sát

Requirements

1.Màn list danh sách khảo sát

Web - Menu Danh sách khảo sát bao gồm 2 phần:
- Master: Quản lý danh sách tất cả các biểu mẫu khảo sát : Hiển thị all các khảo sát thuộc phân quyền
- Detail: Màn hình trả lời khảo sát

1. Màn tạo mới

STT	Tên tiếng Việt	Tên Tiếng Anh	Mô tả	Chức năng	Note
1	Tiêu đề *		Tiêu đề của khảo sát	Nhập text tối đa 50 ký tự	Trường bắt buộc
2	Đơn vị quản lý		Đơn vị quản lý tham gia khảo sát
3	Trạng thái		Chọn trạng thái cho khảo sát	Swtich on/off	Khi tạo mới mặc định là hoạt động Tắt/bật trạng thái.
4	Ngày bắt đầu		Ngày bắt đầu của khảo sát	Chọn 1 ngày từ lịch
5	Ngày kết thúc		Ngày kết thúc của khảo sát, tới ngày này khảo sát sẽ tự động chuyển trạng thái = Không hoạt động	Chọn 1 ngày từ lịch
6	Loại công trình		Dropdown list chọn loại công trình		Loại công trình hiển thị theo tên cấu hình hệ thống
	Nội dung khảo sát
7	Câu hỏi		Nội dung câu hỏi		Hiển thị khi thực hiện trả lời khảo sát
8	Các phương án lựa chọn hoặc nội dung		Câu hỏi chọn 1, chọn nhiều hoặc nhập text		Hiển thị khi thực hiện trả lời khảo sát

Block câu hỏi Bấm nút Thêm câu hỏi để thêm mới các câu hỏi theo 4 loại chính
1	Câu hỏi chọn một	Multiple_Choice	Có thể nhập câu hỏi Thêm các lựa chọn trả lời và khi trả lời chỉ được chọn 1 đáp án duy nhất. Các tính năng phụ trợ xem cụ thể trong Design
2	Câu hỏi chọn nhiều	Multiple_Select	Có thể nhập câu hỏi Thêm các lựa chọn trả lời và khi trả lời có thể chọn nhiều đáp án Các tính năng phụ trợ xem cụ thể trong Design
3	Câu hỏi Bảng chọn một	Multiple_Choice_Table	Có thể nhập câu hỏi Có thể nhập hàng và cột để hình thành bảng. Mối hàng và cột trong bảng chỉ được chọn 1 giá trị khi trả lời Các tính năng phụ trợ có thể xem cụ thể trong Design
4	Câu hỏi bảng chọn nhiều	Multiple_Select_Table	Có thể nhập câu hỏi Có thể nhập hàng và cột để hình thành bảng. Có thể chọn nhiều giá trị hàng và cột khi trả lời Các tính năng phụ trợ xem cụ thể trong Design
5	Câu hỏi dạng text	Text_Response	Nhập câu trả lời dạng free text, tối đa 500 ký tự

Trang View:

Tab Nội dung câu hỏi
Xem lại toàn bộ các câu hỏi và đáp án dưới dạng view,. Cụ thể trong design
Tab Trả lời
Hiển thị các phần trả lời của người được hỏi và tổng hợp. Câu hỏi được tổng hợp theo các đối tượng trả lời khác nhau: Đại lý, Cửa hàng cắm cờ, Khác. Số lượng câu hỏi hiện thị dạng link text, khi click vào link thì hiển thị màn hình danh sách phản hồi Template xuất Excel trả lời: Survey_Template.xlsx 23 Feb 2024, 10:47 am

Tab Nội dung câu hỏi

Xem lại toàn bộ các câu hỏi và đáp án dưới dạng view,. Cụ thể trong design

Tab Trả lời

Hiển thị các phần trả lời của người được hỏi và tổng hợp.
Câu hỏi được tổng hợp theo các đối tượng trả lời khác nhau: Đại lý, Cửa hàng cắm cờ, Khác. Số lượng câu hỏi hiện thị dạng link text, khi click vào link thì hiển thị màn hình danh sách phản hồi
Template xuất Excel trả lời:

Survey_Template.xlsx

23 Feb 2024, 10:47 am

Trang trả lời câu hỏi

Tab Nội dung câu hỏi
Tùy thuộc vào thời gian bắt đầu/ kết thúc mà người dùng có thể nhìn thấy và trả lời cho các câu hỏi khảo sát này. (Trước và sau thời điểm kết thúc thì không thể nhìn thấy khảo sát). Xem lại danh sách câu hỏi và thực hiện trả lời cho câu hỏi đó, submit khi chọn Gửi câu hỏi. Cụ thể trong design. Có bản responsive cho mobile. Khi gửi câu hỏi cần valildate các thông tin sau: Trường hợp câu hỏi bắt buộc: Phải bắt buộc có câu trả lời cho những câu hỏi đó. Câu hỏi dạng bảng: các dòng phải có ít nhất 1 tích chọn Sau khi gửi câu trả lời, phải đánh dấu cho câu hỏi đó để không thể xóa những câu hỏi đã có câu trả lời này. Câu trả lời được thực hiện ở mobile và được chia theo các đối tượng: Đại lý, Cửa hàng cắm cờ, Đối tượng khác. Sau khi chọn các đối tượng khác nhau, hệ thống sẽ xử lý như sau: Đại lý: cho chọn Đại lý từ danh sách đại lý thuộc ĐVQL của người dùng, sau khi chọn đại lý thì hiển thị thông tin Mã - Tên đại lý, Số điện thoại, Địa chỉ Cửa hàng cắm cờ: chọn Cửa hàng cắm cờ từ danh sách thuộc ĐVQL của người dùng, sau khi chọn cửa hàng cắm cờ thì hiển thị thông tin Mã - Tên cửa hàng, Số điện thoại, Địa chỉ Đối tượng khác: cho phép người dùng nhập: Họ và Tên, Email, Số điện thoại, Địa chỉ

Tab Nội dung câu hỏi

Tùy thuộc vào thời gian bắt đầu/ kết thúc mà người dùng có thể nhìn thấy và trả lời cho các câu hỏi khảo sát này. (Trước và sau thời điểm kết thúc thì không thể nhìn thấy khảo sát).

Xem lại danh sách câu hỏi và thực hiện trả lời cho câu hỏi đó, submit khi chọn Gửi câu hỏi. Cụ thể trong design. Có bản responsive cho mobile.

Khi gửi câu hỏi cần valildate các thông tin sau: Trường hợp câu hỏi bắt buộc:

Phải bắt buộc có câu trả lời cho những câu hỏi đó.
Câu hỏi dạng bảng: các dòng phải có ít nhất 1 tích chọn

Sau khi gửi câu trả lời, phải đánh dấu cho câu hỏi đó để không thể xóa những câu hỏi đã có câu trả lời này.

Câu trả lời được thực hiện ở mobile và được chia theo các đối tượng: Đại lý, Cửa hàng cắm cờ, Đối tượng khác. Sau khi chọn các đối tượng khác nhau, hệ thống sẽ xử lý như sau:
- Đại lý: cho chọn Đại lý từ danh sách đại lý thuộc ĐVQL của người dùng, sau khi chọn đại lý thì hiển thị thông tin Mã - Tên đại lý, Số điện thoại, Địa chỉ
- Cửa hàng cắm cờ: chọn Cửa hàng cắm cờ từ danh sách thuộc ĐVQL của người dùng, sau khi chọn cửa hàng cắm cờ thì hiển thị thông tin Mã - Tên cửa hàng, Số điện thoại, Địa chỉ
- Đối tượng khác: cho phép người dùng nhập: Họ và Tên, Email, Số điện thoại, Địa chỉ

Danh sách API

Tên API	Chức năng	Thông tin vào	Payload	Thông tin ra	Note
/rpc/crm/survey/count	Đếm các khảo sát trong danh sách các khảo sát			Số mẫu khảo sát trong danh sách mẫu khảo sát
/rpc/crm/survey/list	Đưa ra danh sách các khảo sát			Danh sách các mẫu khảo sát
/rpc/crm/survey/get	Lấy ra mẫu khảo sát đã tạo	Id	{"id": 1}	Mẫu khảo sát có id = 1
/rpc/crm/survey/create	Tạo mẫu khảo sát bao gồm cả các câu hỏi trong khảo sát	Title,code,description, startAt, endAt, statusId, creatorId, organizationId, surveyQuestions{surveyOption}	"title": "string", "code": "string", "description": "string", "used": true, "startAt": "2024-03-05T03:02:45.647Z", "endAt": "2024-03-05T03:02:45.647Z", "statusId": 0, "creatorId": 0, "organizationId": 0, "percentage": 0, "resultCounter": 0, "surveyQuestions": [ { "informations": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "warnings": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "errors": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "disabled": { "additionalProp1": true, "additionalProp2": true, "additionalProp3": true }, "id": 0, "surveyId": 0, "content": "string", "surveyQuestionTypeId": 0, "isMandatory": true, "surveyQuestionType": { "informations": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "warnings": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "errors": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "disabled": { "additionalProp1": true, "additionalProp2": true, "additionalProp3": true }, "id": 0, "code": "string", "name": "string" }, "surveyOptions": [ { "informations": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "warnings": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "errors": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "disabled": { "additionalProp1": true, "additionalProp2": true, "additionalProp3": true }, "id": 0, "surveyId": 0, "content": "string", "surveyOptionTypeId": 0, "isWritable": true, "surveyOptionType": { "informations": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "warnings": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "errors": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "disabled": { "additionalProp1": true, "additionalProp2": true, "additionalProp3": true }, "id": 0, "code": "string", "name": "string" } } ],	Tạo ra mẫu khảo sát gồm những thông tin đã nhập
/rpc/crm/survey/update	Sửa mẫu khảo sát bao gồm cả các câu hỏi trong khảo sát	Id,Title,code,description, startAt, endAt, statusId, creatorId, organizationId, surveyQuestions*{surveyOption}	{ "id": 0, "title": "string", "code": "string", "description": "string", "used": true, "startAt": "2024-03-05T03:02:45.647Z", "endAt": "2024-03-05T03:02:45.647Z", "statusId": 0, "creatorId": 0, "organizationId": 0, "percentage": 0, "resultCounter": 0, "surveyQuestions": [ { "informations": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "warnings": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "errors": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "disabled": { "additionalProp1": true, "additionalProp2": true, "additionalProp3": true }, "id": 0, "surveyId": 0, "content": "string", "surveyQuestionTypeId": 0, "isMandatory": true, "surveyQuestionType": { "informations": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "warnings": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "errors": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "disabled": { "additionalProp1": true, "additionalProp2": true, "additionalProp3": true }, "id": 0, "code": "string", "name": "string" }, "surveyOptions": [ { "informations": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "warnings": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "errors": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "disabled": { "additionalProp1": true, "additionalProp2": true, "additionalProp3": true }, "id": 0, "surveyId": 0, "content": "string", "surveyOptionTypeId": 0, "isWritable": true, "surveyOptionType": { "informations": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "warnings": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "errors": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "disabled": { "additionalProp1": true, "additionalProp2": true, "additionalProp3": true }, "id": 0, "code": "string", "name": "string" } } ], } ] }	Cập nhật mẫu khảo sát gồm những thông tin đã nhập
/rpc/crm/survey/delete	Xóa đi mẫu khảo sát	Id	{"id": 0,}	Xóa đi mẫu khảo sát có id = 0
/rpc/crm/survey/filter-list-status	Tìm kiếm theo trạng thái hoạt động	Id or code or name	{ }	Danh sách các mẫu khảo sát theo loại câu hỏi
/rpc/crm/survey/filter-list-survey-question-type	Tìm kiếm theo loại câu hỏi	Id or code or name	{ }	Danh sách các mẫu khảo sát theo loại câu hỏi
/rpc/crm/survey/filter-list-survey-option-type	Tìm kiếm theo kiểu loại câu hỏi	Id or code or name	{ }	Danh sách các mẫu khảo sát theo kiểu loại câu hỏi
/rpc/crm/survey/filter-list-organization	Tìm kiếm theo đơn vị phụ trách	Id or code or name	{ }	Danh sách các mẫu khảo sát theo đơn vị phụ trách
/rpc/crm/survey/single-list-survey-question-type	Danh sách các loại câu hỏi	Id or code or name	{ }	Danh sách các loại câu hỏi
/rpc/crm/survey/single-list-app-user	Danh sách các người dùng	Id or code or name	{ }	Danh sách các người dùng
/rpc/crm/survey/single-list-status	Danh sách các trạng thái hoạt động	Id or code or name	{ }	Danh sách các trạng thái hoạt động
/rpc/crm/survey/single-list-survey-option-type	Danh sách các kiểu loại câu hỏi	Id or code or name	{ }	Danh sách các kiểu loại câu hỏi
/rpc/crm/survey/single-list-organization	Danh sách các đơn vị phụ trách	Id or code or name	{ }	Danh sách các đơn vị phụ trách