EasyForms_NET.vb

Клон Google Форм

Этот проект представляет собой простой клон Google Forms, который позволяет пользователям создавать и просматривать материалы. Он демонстрирует использование внутреннего сервера для обработки данных и внешнего приложения для взаимодействия с пользователями. Бэкэнд построен с использованием Node.js и Express, а внешний интерфейс — с использованием Visual Basic в Visual Studio.

Оглавление

• Введение
• Архитектура
• Структура проекта
• Установка
• Настройка серверной части
• Настройка внешнего интерфейса
• Запуск проекта
• Конечные точки API
• Использование
• Содействие
• Лицензия
• Предварительный просмотр

Введение

Цель

Цель этого проекта — предоставить простую систему отправки форм, в которой пользователи могут создавать новые отправки и просматривать существующие. Он служит примером интеграции внешнего приложения с внутренним сервером.

Функции

• Создавайте новые формы с данными пользователя и временем секундомера.
• Просматривайте существующие материалы, перемещайтесь по ним с помощью кнопок «Далее» и «Предыдущее».
• Сохранение данных с использованием файла JSON в качестве базы данных.

Архитектура

Бэкэнд

• Node.js и Express используются для создания простого REST API.
• Модуль fs используется для чтения и записи данных в файл JSON ( db.json ).

Внешний интерфейс

• Visual Basic в Visual Studio используется для создания внешнего приложения.
• Фронтенд-приложение состоит из двух основных форм: CreateSubmissionForm и ViewSubmissionsForm .

Структура проекта

гугл-формы-клон/
│
├── Скользко/
│ ├── расст/
│ │ ├── server.js
│ ├── источник/
│ │ ├── db.json
│ │ ├── server.ts
│ ├── node_modules/
│ ├── package.json
│ ├── tsconfig.json
│ └── README.md
│ └── VisualStudioProject/
├── CreateSubmissionForm.vb
├── ViewSubmissionsForm.vb
├── Program.vb
└── VisualStudioProject.sln

• Slidely : содержит внутренний код.

  • dist : скомпилированные файлы JavaScript.
  • src : исходные файлы TypeScript и файл JSON базы данных.
  • node_modules : зависимости Node.js.
  • package.json : конфигурация проекта Node.js.
  • tsconfig.json : конфигурация TypeScript.

• VisualStudioProject : содержит код внешнего интерфейса.

  • CreateSubmissionForm.vb : Форма для создания новой отправки.
  • ViewSubmissionsForm.vb : форма для просмотра существующих материалов.
  • Program.vb : Основной файл программы.
  • VisualStudioProject.sln : файл решения Visual Studio.

Установка

Предварительные условия

• Node.js
• НПМ
• Visual Studio с поддержкой .NET

Настройка серверной части

1. Клонируем репозиторий:

   git clone https://github.com/yourusername/google-forms-clone.git
   cd google-forms-clone/Slidely

2. Установите необходимые зависимости:

   npm install

3. Скомпилируйте файлы TypeScript:

   tsc

Настройка внешнего интерфейса

1. Откройте решение VisualStudioProject в Visual Studio.

2. Убедитесь, что установлены все необходимые пакеты NuGet. Возможно, вам придется восстановить пакеты NuGet, если они отсутствуют.

Запуск проекта

Запуск внутреннего сервера

1. Перейдите в каталог Slidely :

    cd google-forms-clone/Slidely

2. Запустите сервер:

   node dist/server.js

   Вы должны увидеть сообщение:

    Server is running on http://localhost:3000
   

Запуск фронтенда

1. Откройте решение в Visual Studio.

2. При необходимости установите форму запуска CreateSubmissionForm или ViewSubmissionsForm .

3. Запустите проект, нажав F5 или кнопку Start в Visual Studio.

Конечные точки API

ОТПРАВИТЬ/отправить

• Описание : Отправляет новую запись формы.
• Тело запроса :

  {
    "name" : " John Doe " ,
    "email" : " [email protected] " ,
    "phone" : " 1234567890 " ,
    "github_link" : " https://github.com/johndoe " ,
    "stopwatch_time" : " 00:05:00 "
  }

• Ответ :

  {
    "success" : true
  }

ПОЛУЧИТЬ/прочитать

• Описание : Извлекает запись формы по ее индексу.
• Параметры запроса :
  • index : Индекс отправляемого материала для извлечения.
• Ответ :

  {
    "submission" : {
      "name" : " John Doe " ,
      "email" : " [email protected] " ,
      "phone" : " 1234567890 " ,
      "githubLink" : " https://github.com/johndoe " ,
      "stopwatchTime" : " 00:05:00 "
    }
  }

Использование

Создание отправки

1. Откройте CreateSubmissionForm в Visual Studio.
2. Введите необходимые данные, такие как имя, адрес электронной почты, телефон, ссылку на GitHub, и запустите секундомер.
3. Нажмите кнопку Submit , чтобы сохранить отправку.
   • Данные формы отправляются на внутренний сервер через запрос POST к /submit .
   • Если отправка прошла успешно, отображается подтверждающее сообщение.

Просмотр материалов

1. Откройте ViewSubmissionsForm в Visual Studio.
2. Нажмите кнопки Next или Previous , чтобы перемещаться по материалам.
   • Форма извлекает данные с внутреннего сервера через запрос GET на /read с текущим индексом в качестве параметра запроса.
   • Детали отправки отображаются в полях формы.

Содействие

Вклады приветствуются! Пожалуйста, создайте форк репозитория и создайте запрос на включение с вашими изменениями. Убедитесь, что ваш код соответствует стандартам кодирования и включает соответствующие тесты.

1. Форкните репозиторий.
2. Создайте новую ветку для своей функции.
3. Зафиксируйте изменения в ветке.
4. Создайте запрос на включение с подробным описанием ваших изменений.

Предварительный просмотр

Домашняя страница

Посмотреть отправку

Создать отправку

Лицензия

Этот проект распространяется по лицензии MIT. Дополнительную информацию смотрите в файле LICENSE.