formulosity 다운로드 - formulosity 소스 코드 다운로드

formulosity

AI 소스 코드

v0.1.10

다운로드

포뮬러는 전통적인 설문 조사 빌더 대신 코드를 사용하여 설문 조사를 구축하고 배포하기위한 자체 주최 앱입니다.

이 접근법은 다음을 포함하여 여러 가지 장점을 제공합니다.

버전 제어 : 설문 조사 파일은 GitHub 저장소에 저장 될 수 있으므로 변경 사항을 쉽게 추적하고 다른 사람과 협력 할 수 있습니다.
재현성 : 설문 조사 파일을 쉽게 공유하고 재생할 수있어 설문 조사를 쉽게 재사용하거나 기존 설문 조사의 변형을 만들 수 있습니다.
자동화 : 설문 조사 파일을 사용하여 측량 생성 및 배포를 자동화하여 시간과 노력을 절약 할 수 있습니다.

포뮬러는 인간으로 읽을 수있는 선언적 언어를 사용합니다.

특징

실제로보기!

관리자 패널

참고 : user / pass 사용하여 콘솔 UI에 로그인하십시오.

설문 조사 구조

SURVEYS_DIR 의 각 디렉토리는 설문 조사입니다. 다른 SURVEYS_DIR env var를 설정하여 설문 조사 소스를 구성 할 수 있습니다.

surveys/
├── survey1/
│   ├── metadata.yaml
│   ├── questions.yaml
│   ├── security.yaml
│   ├── variables.yaml
│   └── ...
└── survey2/
    ├── metadata.yaml
    ├── questions.yaml
    └── ...

시작하려면 여러 예제가있는 ./surveys 폴더를 확인하십시오.

설문 조사 파일

메타 데이터 .yaml

이 파일이 필요합니다! 파일은 설문 조사를 설명하는 특정 속성이있는 YAML 객체로 구성됩니다.

제목 : 설문 조사가 시작될 때 사용자에게 표시되는 주요 제목입니다.
테마 : 이것은 설문 조사에 적용되는 시각적 테마를 지정합니다. 현재 지원되는 테마는 다음과 같습니다. 기본값.
소개 :이 텍스트는 첫 번째 질문 이전에 소개로 나타납니다.
Autro :이 텍스트는 마지막 질문 이후 결론으로 나타납니다.

 title : Survey Title
theme : default # or custom
intro : |
  This is the introduction to the survey.
  It can be multiple lines long.
outro : |
  Thank you for taking the survey.
  Your feedback is important to us.

Question.yaml

이 파일이 필요합니다! 파일은 질문 목록으로 구성되며 각각은 특정 속성을 가진 YAML 객체로 정의됩니다.

유형 : 이것은 질문의 유형을 지정합니다.
ID :이 질문에 대한 고유 식별자를 제공합니다. 분기 논리 또는 데이터 분석에서 특정 질문을 참조하는 데 유용합니다. 설문 조사의 모든 질문에서 ID는 고유해야합니다.
레이블 : 이것은 질문 자체로 사용자에게 표시되는 텍스트입니다.
설명 : 이것은 설명 또는 지침과 같은 사용자를위한 질문에 대한 추가 정보를 제공합니다.
옵션 :이 목록은 single-choice , multiple-choice 및 ranking 와 같은 질문 유형에 대한 사용 가능한 답변 선택을 정의합니다.
옵션 -FromVariable :이 속성은 별도의 변수로 정의 된 변수를 참조합니다. 변수에는 질문에 사용할 옵션 목록이 포함되어야합니다. 이를 통해 옵션 목록의 재사용 및 중앙 집중식 관리가 가능합니다.
유효성 검사 :이 속성은 특정 질문 유형에 대한 검증 규칙을 정의하는 데 사용됩니다.

 questions :
  - type : single-choice
    id : question1 # optional ID, must be unique across all questions
    label : What is the capital of Germany?
    description : You can select multiple options
    optionsFromVariable : german-city-options # defined in variables.yaml
    options :
      - Berlin
      - Munich
      - Paris
      - London
      - Hamburg
      - Cologne
    validation :
      min : 1
      max : 3

Security.yaml

이 파일은 선택 사항입니다. 파일은 설문 조사 보안 설정에 대한 특정 속성이있는 YAML 객체로 구성됩니다.

DuplicateProtection :이 속성은 플랫폼이 동일한 사용자의 중복 응답을 처리하는 방법을 정의합니다.

 duplicateProtection : cookie # cookie | ip

변수 .yaml

이 파일은 선택 사항입니다. 파일은 변수 목록으로 구성되며 각각은 특정 속성을 가진 YAML 객체로 정의됩니다.

ID :이 고유 식별자는 질문 내에서 변수를 참조합니다. ID는 파일에 정의 된 모든 변수에서 고유해야합니다.
유형 : 변수에 저장된 데이터 유형을 지정합니다. 현재 지원되는 유형은 다음과 같습니다.

 variables :
  - id : german-city-options # must be unique
    type : list
    options :
      - Berlin
      - Munich
      - Hamburg
      - Cologne

질문 유형

짧은 텍스트

간단한 서면 답변을 위해 사용자에게 프롬프트합니다.

- type : short-text
  label : What is the capital of Germany?
  # set min/max characters
  validation :
    min : 10
    max : 100

긴 텍스트

자세한 서면 답변으로 사용자에게 프롬프트합니다.

- type : long-text
  label : What is the capital of Germany?
  # set min/max characters
  validation :
    min : 10
    max : 100

단일 선택

옵션 목록에서 하나의 정답만으로 질문을 제시합니다.

- type : single-choice
  label : What is the capital of Germany?
  options :
    - Berlin
    - Munich
    - Paris
    - London
    - Hamburg
    - Cologne

객관식

사용자가 여러 답변을 선택할 수있는 질문을 제시합니다 (제한 사항). 유효성 검사 섹션에서 최소 및 최대 허용 선택을 사용자 정의 할 수 있습니다.

- type : multiple-choice
  label : Which of the following are cities in Germany?
  description : You can select multiple options
  validation :
    min : 1
    max : 3
  options :
    - Berlin
    - Munich
    - Paris
    - London
    - Hamburg
    - Cologne

날짜

사용자에게 특정 날짜를 입력하도록 요청합니다.

- type : date
  label : When was the Berlin Wall built?

평가

사용자가 사전 정의 된 범위에서 무언가를 평가할 수있는 척도를 제공합니다.

- type : rating
  label : How much do you like Berlin?
  min : 1
  max : 5

순위

사용자에게 주어진 기준에 따라 옵션 순위를 매기도록 요청합니다.

- type : ranking
  label : Rank the following cities by population
  optionsFromVariable : german-city-options

예/아니오

사용자가 "예"또는 "아니오"에만 대답 할 수있는 질문을 제시합니다.

- type : yes-no
  label : Is Berlin the capital of Germany?

이메일

사용자에게 이메일을 입력하도록 프롬프트합니다

- type : email
  label : Please enter your email.

파일

주어진 형식과 최대 업로드 크기에 따라 파일을 업로드하도록 사용자에게 프롬프트합니다.

- type : file
  label : Upload a Berlin Image
  validation :
    formats :
      - .jpg
      - .png
    max_size_bytes : 5*1024*1024 # 5 MB

응답

응답은 UI에 표시 될 수 있으며 JSON으로 내보낼 수 있습니다. 또는 REST API를 사용하여 Survey Resposnes를 얻을 수 있습니다.

curl -XGET 
http://localhost:9900/app/surveys/{SURVEY_ID}/sessions ? limit=100 & offset=0 & sort_by=created_at & order=desc

여기서 {SURVEY_ID} id 주어진 설문 조사의 uuid입니다.

스크린 샷

설치 및 배포

 docker-compose up -d --build

http : // localhost : 3000에서 UI에 액세스 할 수 있어야합니다 (기본 기본 인증 : user:pass ).

모든 클라우드 제공 업체에 개별 서비스를 배포하거나 자체 호스트 할 수 있습니다.

백엔드로 가십시오. Docker 컨테이너로 포장되어 있으며 어디서나 배포 할 수 있습니다.
다음 .js 프론트 엔드. 도커 컨테이너로도 포장되어 있지만 예를 들어 Vercel에도 배포 할 수도 있습니다.
[선택 사항] Postgres 데이터베이스. 관리되는 Postgres 서비스를 사용하거나 직접 배포 할 수 있습니다.

데모 서비스 (위의 링크)는 Fly.io (Go, Sqlite) 및 Vercel (Next.js)에 배포되며 자유 계층 아래에 있습니다.

백엔드 개발 설정

여기에서 공기를 로컬로 설치하십시오

공기 설치 후 다음 명령을 실행하십시오

 cd api
air

이 명령은 air 사용하여 API에서 변경 될 때마다 라이브 재 장전에 도움이됩니다. air.toml 파일을 수정하여 사용자 정의 구성을 설정할 수 있습니다

환경 변수

API :

DATABASE_TYPE sqlite 또는 postgres
DATABASE_URL Postgres 또는 Sqlite Connection String
LOG_LEVEL 로그 레벨, 예를 들어 info
SURVEYS_DIR 설문 조사가있는 디렉토리, 예 : /root/surveys . 이 디렉토리에는 장착 볼륨을 사용하는 것이 좋습니다.

UI :

CONSOLE_API_ADDR go 백엔드의 공개 주소. 브라우저에서 액세스 할 수 있어야합니다.
CONSOLE_API_ADDR_INTERNAL go backend의 내부 주소, 예를 들어 http://api:8080 ( CONSOLE_API_ADDR 과 동일 할 수 있음).
IRON_SESSION_SECRET 세션 암호화를위한 비밀
HTTP_BASIC_AUTH 형식 : user:pass (선택 사항)

기술 스택

백엔드 : Go, (Postgres 또는 Sqlite)
UI : Next.js, Tailwind CSS

새로운 SQLITE/POSTGRES 마이그레이션을 만듭니다

먼저 이동 이민을 설치하십시오.

 cd api
migrate create -dir migrations/postgres -ext sql -seq name
migrate create -dir migrations/sqlite -ext sql -seq name

GO 테스트를 실행하십시오

 cd api
make test

기고 가이드 라인

요청, 버그 보고서 및 기타 모든 형태의 기여도를 환영하고 강력히 권장합니다!

확장하다

추가 정보

버전 v0.1.10
유형 AI 소스 코드
업데이트 시간 2025-08-18
크기 984.62KB
출처 Github