О проекте:

Реализованная функциональность

Путеводитель по сайту
Голосовые подсказки
Чат, где можно задать вопрос

Особенности проекта

Легко встраивается в существующее решение
Легко расширяется
Легко поддерживается
Голосовой ввод вопросов
Озвучивание ответов
Нейросеть для классификации вопросов
Несколько десятков вопросов с ответами, которые легко могут быть дополнены

Основной стек технологий:

TypeScript
JavaScript
Git
Node.js

Развертывание проекта:

Проект предполагает 3 части: бэкенд, фронтенд и инжектор

все действия выполнять после установки репозитория в соответствующих папках

Для работы понадобится иметь установленным NPM

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

папка frontent

открываем папку из консоли,

выполняем npm i

в случае возникновения проблем на предыдущем этапе воспользоваться поисковыми сервисами для решения.

выполняем npm run start

Запуск бэкенда

папка api

Предварительно:
ставим при необходимости pg db по гайду https://winitpro.ru/index.php/2019/10/25/ustanovka-nastrojka-postgresql-v-windows/
составляем "connection url" по гайду https://www.prisma.io/dataguide/postgresql/short-guides/connection-uris#providing-the-database-name
получаем токен REST API grants.myrosmol.ru по инструкции в самом низу.

открываем папку из консоли

выполняем npm i

создаём файл .env

Структура .env:

api_token = token
DATABASE_URL="url"

token - это токен для rest api сайта grants.myrosmol.ru

url - это "connection url" базы данных postgres

далее открываем папку prisma через консоль и выполняем npx prisma db push. Это зальёт схему в pg базу.

Из папки prisma возвращаемся в папку api

далее выполняем npm run start

Инжектирование в сайт grants.myrosmol.ru

Нужно открыть страницу сайта grants.myrosmol.ru

открыть инструменты разработчика в браузере (обычно F12),

Скопировать текст из папки injection файла index.js

открыть в инструменте разработчика консоль, вставить туда скопированный текст и нажать enter

Решение ошибок

Решение основных проблем описаны здесь https://github.com/AlexC-ux/hackatoshi/issues В случае вознекновения других ошибок обращаться сюда: https://t.me/+st6xhfvtcxUwYjli

Получение токена REST API grants.myrosmol.ru

Открываем grants.myrosmol.ru
Далее открываем инструменты разработчика в браузере, нажам кнопку F12
Далее открываем открываем вкладку сеть (network)
Далее проходим авторизацию, если она не выполнена
Далее нажимаем F5
Далее ищем строчку, начинающуюся со слова regions как показано на этом скриншоте
Далее выбираем вкладку заголовки(обозначена цифрой 1) и копируем токен(обозначен цифрой 2) как на скришоте

Полученный текст - и есть искомый токен

AlexC-ux / hackatoshi