xiaoju-survey/README.md
2024-08-06 23:46:39 +08:00

9.7 KiB
Raw Blame History


XIAOJUSURVEY是一套轻量、安全的问卷系统基座,提供面向个人和企业的一站式产品级解决方案,快速满足各类线上调研场景。

  内部系统已沉淀 40+种题型,累积精选模板 100+,适用于市场调研、客户满意度调研、在线考试、投票、报道、测评等众多场景。数据能力上,经过上亿量级打磨,沉淀了分题统计、交叉分析、多渠道分析等在线报表能力,快速满足专业化分析。

  开源项目以打造调研基座为核心,围绕平台能力工程架构研发体系进行建设,大家可以「快速」打造「专属」问卷系统:快速了解生态发展理念

功能简介

  • 问卷管理:创、编、投、收、数据分析

  • 多样化题型:单行输入框、多行输入框、单项选择、多项选择、判断题、评分、投票、...

  • 用户管理:登录、注册、权限管理

  • 数据安全:传输加密、脱敏等

更全的建设请查阅 官方 Feature

(个人和企业用户均可快速构建特定领域的调研类解决方案。)

技术

Web 端Vue3 + ElementPlusC 端多端渲染(规划中)

Server 端Nestjs + MongoDBJava在建欢迎加入共建

智能化基座:(规划中)

项目优势

一、具备全面的综合性和专业性

  • 制定了问卷标准化协议规范

    领域标准保障概念互通,是全系统的基础和核心。基于实际业务经验,沉淀了两大类:

    • 业务描述:问卷协议、题型协议
    • 物料描述:题型物料协议,包含题型和设置器
  • 制定了问卷 UI/UX 规范

    设计语言是系统灵活性、一致性的基石,保障系统支撑的实际业务运转拥有极高的用户体验。包含两部分:

    • 设计规范:灵活、降噪、统一
    • 交互规范:遵循用户行为特征,遵循产品定位,遵循成熟的用户习惯
  • 所见即所得,搭建渲染一致性高

    实际业务使用上包含问卷生成和投放使用,即对于系统的搭建端和渲染端。我们将题型场景化设计,以满足一份问卷从加工生产到投放应用的高度一致。

  • 题型物料化设计,自由定制扩展

    题型是问卷最核心的组成部分,而题型可配置化能力决定了上层业务可扩展的场景以及系统自身可复用的场景。 题型架构设计上,主打每一类题型拥有通用基础能力,每一种题型拥有原子化特性能力,并保障高度定制化。

  • 合规建设沉淀积累,安全能力拓展性高

    数据加密传输、敏感信息精细化检测、投票防刷等能力,保障问卷发布、数据回收链路安全性。

二、轻量化设计,快速接入、灵活扩展

快速启动

Node 版本 >= 18.x 查看环境准备指导

复制工程

git clone git@github.com:didi/xiaoju-survey.git

服务端启动

方案一、快速启动,无需安装数据库

便于快速预览工程,对于正式项目需要使用方案二。

1、安装依赖

cd server
npm install

2、启动

npm run local

服务运行依赖 mongodb-memory-server

1、数据保存在内存中重启服务会更新数据。
2、启动内存服务器新实例时如果找不到 MongoDB 二进制文件会自动下载,因此首次可能需要一些时间。

方案二、(生产推荐)

1、配置数据库

项目使用 MongoDB需要提前准备请查看如何拥有 MongoDB 指南

配置数据库信息,查看MongoDB 配置

2、安装依赖

cd server
npm install

3、启动

npm run dev

前端启动

安装依赖

cd web
npm install

启动

npm run serve

访问

问卷管理端

http://localhost:8080/management

问卷投放端

创建并发布问卷。

http://localhost:8080/render/:surveyPath



微信交流群(推荐)

官方群会发布项目最新消息、建设计划和社区活动,欢迎你的加入。任何问题和合作可以联系小助手:

QQ 交流群

官方群会发布项目最新消息、建设计划和社区活动,欢迎你的加入:

Star

开源不易,如果该项目对你有帮助,请 star 一下 ❤️❤️❤️,你的支持是我们最大的动力。

Star History Chart

记录

如果你使用了该项目,请记录反馈:我在使用,你的支持是我们最大的动力。

贡献

如果你想成为贡献者或者扩展技术栈,请查看:贡献者指南,你的加入使我们最大的荣幸。

Future Tasks

1、官方 Feature

2、WIP

CHANGELOG

关注重大变更:MAJOR CHANGELOG

文章分享

1、掘金、2、CSDN、3、InfoQ、4、知乎

欢迎共建