/trivia_quiz

Primary LanguageShell

TRIVIA_QUIZ

Test task.

Task:

  1. С помощью Docker (предпочтительно - docker-compose) развернуть образ с любой опенсорсной СУБД (предпочтительно - PostgreSQL). Предоставить все необходимые скрипты и конфигурационные (docker/compose) файлы для развертывания СУБД, а также инструкции для подключения к ней. Необходимо обеспечить сохранность данных при рестарте контейнера (то есть - использовать volume-ы для хранения файлов СУБД на хост-машине.

  2. Реализовать на Python3 простой веб сервис (с помощью FastAPI или Flask, например), выполняющий следующие функции:

  • В сервисе должно быть реализовано REST API, принимающее на вход POST запросы с содержимым вида {"questions_num": integer} ;

  • После получения запроса сервис, в свою очередь, запрашивает с публичного API (англоязычные вопросы для викторин) https://jservice.io/api/random?count=1 указанное в полученном запросе количество вопросов.

  • Далее, полученные ответы должны сохраняться в базе данных из п. 1, причем сохранена должна быть как минимум следующая информация (название колонок и типы данный можете выбрать сами, также можете добавлять свои колонки): 1. ID вопроса, 2. Текст вопроса, 3. Текст ответа, 4. - Дата создания вопроса. В случае, если в БД имеется такой же вопрос, к публичному API с викторинами должны выполняться дополнительные запросы до тех пор, пока не будет получен уникальный вопрос для викторины.

  • Ответом на запрос из п.2.a должен быть предыдущей сохранённый вопрос для викторины. В случае его отсутствия - пустой объект.

  1. В репозитории с заданием должны быть предоставлены инструкции по сборке докер-образа с сервисом из п. 2., его настройке и запуску. А также пример запроса к POST API сервиса.

  2. Желательно, если при выполнении задания вы будете использовать docker-compose, SqlAalchemy, пользоваться аннотацией типов.

INSTALLATION

Prerequisites:

  • docker
  • docker-compose
  • git

Simply clone this repo:

git clone https://github.com/faked86/trivia_quiz.git
cd trivia_quiz

USAGE

  1. Run docker-compose up or docker compose up in terminal.

API Server

  • POST localhost:8000/questions - Send JSON in form like {"questions_num": integer} via Postman for example or
curl -X POST -H "Content-Type: application/json" -d '{"questions_num": 1}' localhost:8000/questions

Database

To connect to database I used PGadmin 4

  • Login: pg
  • Password: pass
  • Database: quiz
  • URL: localhost:5432