Тестовое задание (eComCharge)

Система решения математических уравнений. 


Система должна состоять из 2х основных компонентов:

Фронтенд сервер.
Основной функционал
 RoR приложение должно предоставлять:
 	а) Выбор типа уравнения (по умолчанию линейное и квадратное)
	б) Форму ввода параметров для решения уравнения
	в) Передачу параметров уравнения на Бэкенд сервер в формате JSON
	г) Получение и отображение результата в “дружественном” виде.

Дополнительные пожелания
	а) Использование CSS на формах / страницах Выбор, Вввод, Результат
	б) Использование JS / Ajax  на формах / страницах Выбор, Ввод, Результат
	в) Использование тестовых фреймворков TestUnit / RSpec / Cucumber (один или несколько)
	г) Обеспечить валидацию параметров и обработку исключительных ситуаций (500 от бэкенда, ввод буквенных параметров, ввод дробных параметров и тд)
	

Бэкенд сервер

Основной функционал
Допустимо использование приложения на Sinatra или подобном фреймворке. Приложение должно:
	а) Предоставить точку входа для получения параметров уравнения
	б) Обеспечить решение уравнения
	в) Предоставить ответ в формате JSON

Дополнительные пожелания
	а) Использование наследования при решении различных типов уравнения (единый интерфейс для решения любого типа уравнения)
	б) Обеспечение валидации параметров и обработки исключительных ситуаций (недостаточное количество параметров, неверный тип уравнения, неверный тип аргументов и тд)
	б) Использование TestUnit / RSpec / Cucumber
	г)  Использование аутентификации при приеме запроса.

ВАРИАНТ РЕШЕНИЯ – VLASOV – 09-05-2026 +
Система решения математических уравнений.
Система должна состоять из 2х основных компонентов:
Фронтенд сервер. Основной функционал RoR приложение должно предоставлять: а) Выбор типа уравнения (по умолчанию линейное и квадратное) б) Форму ввода параметров для решения уравнения в) Передачу параметров уравнения на Бэкенд сервер в формате JSON г) Получение и отображение результата в “дружественном” виде.
Дополнительные пожелания а) Использование CSS на формах / страницах Выбор, Вввод, Результат б) Использование JS / Ajax на формах / страницах Выбор, Ввод, Результат в) Использование тестовых фреймворков TestUnit / RSpec / Cucumber (один или несколько) г) Обеспечить валидацию параметров и обработку исключительных ситуаций (500 от бэкенда, ввод буквенных параметров, ввод дробных параметров и тд)
Бэкенд сервер
Основной функционал Допустимо использование приложения на Sinatra или подобном фреймворке. Приложение должно: а) Предоставить точку входа для получения параметров уравнения б) Обеспечить решение уравнения в) Предоставить ответ в формате JSON
Дополнительные пожелания а) Использование наследования при решении различных типов уравнения (единый интерфейс для решения любого типа уравнения) б) Обеспечение валидации параметров и обработки исключительных ситуаций (недостаточное количество параметров, неверный тип уравнения, неверный тип аргументов и тд) б) Использование TestUnit / RSpec / Cucumber г) Использование аутентификации при приеме запроса.

Перед началом разработки системы важно чётко представить себе общую структуру проекта и взаимодействие фронтенда и бэкенда. Фронтенд-сервер будет реализован на Ruby on Rails и должен обеспечивать удобный выбор типа уравнения (линейное или квадратное), простую форму для ввода параметров, передачу введённых данных на бэкенд в формате JSON, получение и наглядное отображение результата. Для улучшения внешнего вида интерфейса потребуется применение CSS-стилей, а для повышения интерактивности и удобства пользователей — использование JavaScript и AJAX-технологий. Важно предусмотреть тестирование с использованием популярных фреймворков вроде TestUnit, RSpec или Cucumber, а также реализовать надёжную валидацию входящих данных и грамотную обработку возможных ошибок, таких как неправильный ввод параметров или сбои на стороне сервера.
Бэкенд-сервер планируется разработать на Sinatra или похожем легком веб-фреймворке. Его основной задачей станет предоставление API-эндпоинта для приёма параметров уравнения, выполнение расчётов и возврат результата в формате JSON. Здесь тоже важна тщательная валидация поступающих данных и обработка потенциальных ошибок. Архитектуру решений удобно организовать с применением наследования классов, чтобы обеспечить единый интерфейс для различных видов уравнений. Тестирование бэкенда желательно проводить с помощью тех же инструментов, что и на фронте. Дополнительно потребуется реализовать базовую систему аутентификации запросов, возможно, через простой токен или HTTP Basic Auth.
Теперь, когда общая картина ясна, можно переходить непосредственно к разработке. Начну с настройки окружения и установки необходимых библиотек и зависимостей для обоих частей системы. Затем приступлю к созданию базовой структуры приложений на Rails и Sinatra, постепенно реализуя ключевые компоненты и функциональность.

Разработка системы решения математических уравнений
Разработка такой системы требует внимательного подхода к проектированию архитектуры и реализации функционала. Ниже представлено подробное руководство по каждому компоненту системы.

1. Фронтенд Сервер (Ruby on Rails)
   Основной Функционал
   a) Выбор типа уравнения
   Создаем контроллер и представление для выбора типа уравнения:
   ruby
   Копировать
   class EquationsController < ApplicationController
   def index
   @types = ['linear', 'quadratic']
   end
   end
   Представление:
   html
   Копировать

Choose Equation Type

<%= form_tag equations_path do %> Type: <% @types.each do |type| %> <%= type.capitalize %> <% end %> <% end %> b) Форма ввода параметров Формы для каждого типа уравнения: html Копировать A:

B:

c) Передача параметров в JSON Использование AJAX для отправки формы: javascript Копировать $(document).ready(function() { $('form').on('submit', function(e) { e.preventDefault(); var data = $(this).serializeArray().reduce(function(obj, item) { obj[item.name] = parseFloat(item.value); return obj; }, {});

$.ajax({
  url: '/solve',
  type: 'POST',
  contentType: 'application/json',
  data: JSON.stringify(data),
  success: function(response) {
    // Отображение результата
  }
});

});
});
d) Отображение результата
Контроллер обрабатывает ответ и рендерит результат:
ruby
Копировать
def solve
response = RestClient.post("#{ENV['BACKEND_URL']}/solve", params.to_json, content_type: :json)
render json: response.body
rescue => e
render json: { error: e.message }, status: 500
end
Дополнительные Пожелания
a) Стилизация с CSS
Применяем стилизацию к формам и страницам:
css
Копировать
body {
font-family: Arial, sans-serif;
}

form {
max-width: 300px;
margin: auto;
}

input[type='submit'] {
background-color: #4CAF50;
color: white;
padding: 10px 20px;
border-radius: 5px;
}