student_mvp 0.1.0

data/lib/models/students_list/students_list_file.rb

@@ -0,0 +1,134 @@
+require_relative '../student/student.rb'
+require_relative '../student_short/student_short.rb'
+require_relative '../data_list/data_list_student_short.rb'
+require_relative '../binary_tree/binary_tree.rb'
+require_relative './students_list_interface.rb'
+
+class Students_list_file < Students_list_interface
+    # constructor
+    def initialize(file_path, data_storage_strategy)
+        self.file_path = file_path
+        self.data_storage_strategy = data_storage_strategy
+        self.students = read
+    end
+
+    # read from data storage
+    def read
+        self.data_storage_strategy.read(self.file_path)
+    end
+
+    # write to data storage
+    def write
+        self.data_storage_strategy.write(self.file_path, self.students)
+    end
+
+    # get student by id
+    def get_student_by_id(id)
+        self.students.find { |student| student.id == id }
+    end
+
+    # get data_list_student_short of k n students
+    def get_k_n_student_short_list(k, n, filter = nil, data_list = nil)
+        start = (k - 1) * n
+        filtered = filter ? filter.apply(self.students) : self.students
+        selected = filtered[start, n] || []
+        students_short = selected.map { |student| Student_short.new_from_student_obj(student) }
+        data_list ||= Data_list_student_short.new(students_short)
+        data_list.index = start + 1
+        data_list.data = students_short
+        data_list
+    end
+
+    # sort by full name
+    def sort_by_full_name!
+        self.students.sort_by! { |student| student.get_full_name }
+        self.write
+    end
+
+    # add student
+    def add_student(student)
+        begin
+            check_unique_fileds(email: student.email, telegram: student.telegram, phone_number: student.phone_number, git: student.git)
+        rescue => e
+            raise e
+        end
+        max_id = self.students.map(&:id).max || 0
+        student.id = max_id + 1
+        self.students << student
+        self.write
+    end
+
+    # replace student by id
+    def replace_student(id, new_student)
+        index = self.students.find_index { |student| student.id == id }
+        raise IndexError, 'Unknown student id' if index.nil?
+        begin
+            check_unique_fileds(email: new_student.email, telegram: new_student.telegram, 
+                phone_number: new_student.phone_number, git: new_student.git, current_student: self.students[index])
+        rescue => e
+            raise e
+        end
+        new_student.id = id
+        self.students[index] = new_student
+        self.write
+    end
+
+    # delete student by id
+    def delete_student(id)
+        self.students.reject! { |student| student.id == id }
+        self.write
+    end
+
+    # get count of students
+    def get_student_short_count(filter = nil)
+        filter ? filter.apply(self.students).size : self.students.size
+    end
+
+    private
+    attr_accessor :file_path, :students, :data_storage_strategy
+
+    def check_unique_fileds(email: nil, telegram: nil, phone_number: nil, git: nil, current_student: nil)
+        if !email.nil? && (current_student.nil? || email != current_student.email) && !unique_email?(email)
+            raise 'Duplicate email'
+        end
+
+        if !telegram.nil? && (current_student.nil? || telegram != current_student.telegram) && !unique_telegram?(telegram)
+            raise 'Duplicate telegram'
+        end
+
+        if !phone_number.nil? && (current_student.nil? || phone_number != current_student.phone_number) && !unique_phone_number?(phone_number)
+            raise 'Duplicate phone number'
+        end
+
+        if !git.nil? && (current_student.nil? || git != current_student.git) && !unique_git?(git)
+            raise 'Duplicate git'
+        end
+    end
+
+    def unique_email?(email)
+        unique?(:email, email)
+    end
+
+    def unique_telegram?(telegram)
+        unique?(:telegram, telegram)
+    end
+
+    def unique_phone_number?(phone_number)
+        unique?(:phone_number, phone_number)
+    end
+
+    def unique_git?(git)
+        unique?(:git, git)
+    end
+
+    def unique?(key_type, key)
+        tree = Binary_tree.new
+        self.students.each do |student|
+            student.key_type = key_type
+            tree.add(student)
+        end
+
+        finded = tree.find(key)
+        return finded.nil?
+    end
+end

data/lib/models/students_list/students_list_file_adapter.rb

@@ -0,0 +1,45 @@
+require_relative '../student/student.rb'
+require_relative '../student_short/student_short.rb'
+require_relative '../data_list/data_list_student_short.rb'
+require_relative '../binary_tree/binary_tree.rb'
+require_relative './students_list_interface.rb'
+
+class Students_list_file_adapter < Students_list_interface
+    # constructor
+    def initialize(adaptee)
+        self.adaptee = adaptee
+    end
+
+    # get student by id
+    def get_student_by_id(id)
+        self.adaptee.get_student_by_id(id)
+    end
+
+    # get data_list_student_short of k n students
+    def get_k_n_student_short_list(k, n, filter = nil, data_list = nil)
+        self.adaptee.get_k_n_student_short_list(k, n, filter, data_list)
+    end
+
+    # add student
+    def add_student(student)
+        self.adaptee.add_student(student)
+    end
+
+    # replace student by id
+    def replace_student(id, new_student)
+        self.adaptee.replace_student(id, new_student)
+    end
+
+    # delete student by id
+    def delete_student(id)
+        self.adaptee.delete_student(id)
+    end
+
+    # get count of students
+    def get_student_short_count(filter = nil)
+        self.adaptee.get_student_short_count(filter)
+    end
+
+    private
+    attr_accessor :adaptee
+end

data/lib/models/students_list/students_list_interface.rb

@@ -0,0 +1,25 @@
+class Students_list_interface
+    def get_student_by_id(id)
+        raise NotImplementedError
+    end
+
+    def get_k_n_student_short_list(k, n, filter = nil, data_list = nil)
+        raise NotImplementedError
+    end
+
+    def add_student(student)
+        raise NotImplementedError
+    end
+
+    def replace_student(id, new_student)
+        raise NotImplementedError
+    end
+
+    def delete_student(id)
+        raise NotImplementedError
+    end
+
+    def get_student_short_count(filter = nil)
+        raise NotImplementedError
+    end
+end

data/lib/presenters/base_presenters/base_presenter.rb

@@ -0,0 +1,26 @@
+require_relative '../../logger/logger.rb'
+
+# == Base_presenter
+# Базовый класс для презентеров.
+# Управляет основными атрибутами и логикой взаимодействия между представлениями и данными.
+class Base_presenter
+  # Инициализация базового презентера.
+  # 
+  # @param view [Base_view_interface] Объект представления, с которым работает презентер.
+  def initialize(view)
+    self.view = view
+    self.logger = App_logger.instance
+  end
+  
+  protected
+
+  # @!attribute [rw] view
+  #   @return [Base_view_interface] Объект представления.
+  # @!attribute [rw] entities_list
+  #   @return [Students_list, nil] Список сущностей.
+  # @!attribute [rw] data_list
+  #   @return [Data_list, nil] Список данных.
+  # @!attribute [rw] logger
+  #   @return [App_logger] Логгер для записи событий.
+  attr_accessor :view, :entities_list, :data_list, :logger
+end

data/lib/presenters/base_presenters/student_list_presenter.rb

@@ -0,0 +1,273 @@
+require 'mysql2'
+require_relative '../../models/students_list/students_list.rb'
+require_relative '../../models/students_list/students_list_DB'
+require_relative '../../models/data_list/data_list_student_short'
+require_relative '../../models/students_list/students_list_file_adapter'
+require_relative '../../models/students_list/students_list_file'
+require_relative '../../models/data_storage_strategy/JSON_storage_strategy'
+require_relative '../../models/student/student.rb'
+require_relative './base_presenter'
+require_relative '../../models/filter/filter.rb'
+require_relative '../../models/filter/student_filters/field_filter_decorator.rb'
+require_relative '../../models/filter/student_filters/full_name_filter_decorator.rb'
+require_relative '../../models/filter/student_filters/has_not_field_filter_decorator.rb'
+require_relative '../../models/filter/student_filters/contact_sort_decorator.rb'
+require_relative '../../models/filter/student_filters/git_sort_decorator.rb'
+require_relative '../../models/filter/student_filters/full_name_sort_decorator.rb'
+
+# == Student_list_presenter
+# Презентер для управления списком студентов.
+# Отвечает за логику отображения, фильтрации и сортировки данных о студентах.
+class Student_list_presenter < Base_presenter
+
+  # Инициализация презентера списка студентов.
+  # Настраивает список студентов, фильтры и порядок сортировки.
+  # 
+  # @param view [Base_view_interface] Представление, отображающее список студентов.
+  def initialize(view)
+    super(view)
+    self.logger.debug("Инициализация Student_list_presenter")
+    begin
+      self.logger.debug("Инициализация Students_list")
+      self.entities_list = Students_list.new(Students_list_DB.new)
+      # self.entities_list = Students_list.new(Students_list_file_adapter.new(Students_list_file.new('./students.json', JSON_storage_strategy.new)))
+      self.logger.debug("Инициализация Data_list_student_short")
+      self.data_list = Data_list_student_short.new([])
+      self.filters = Filter.new
+      self.sort_order = {
+        order: :asc,
+        col_index: 0
+      }
+    rescue StandardError => e
+      error_msg = "Ошибка при получении доступа к файлу: #{e.message}"
+      self.logger.error(error_msg)
+      self.view.show_error(error_msg)
+    end
+  end
+
+  # Обновление данных в таблице студентов.
+  # Выполняет сброс фильтров, применяет новые фильтры и обновляет представление.
+  def refresh_data
+    self.logger.info "Обновление таблицы студентов"
+    self.data_list.clear_selected
+    self.reset_filters
+    self.apply_filters
+    begin
+      self.logger.info "Поиск студентов в хранилище"
+      self.data_list = self.entities_list.get_k_n_student_short_list(self.view.current_page, self.view.rows_per_page, self.filters, self.data_list)
+      self.data_list.count = self.entities_list.get_student_short_count
+      self.view.update_view({ columns: self.data_list.get_names, total_count: self.data_list.count, table_data: self.data_list.retrieve_data })
+    rescue => e
+      error_msg = "Ошибка при получении данных: #{e.message}"
+      self.logger.error error_msg
+      self.view.show_error(error_msg)
+    end
+    
+    self.logger.info "Таблица студентов обновлена"
+  end
+
+  # Добавление нового студента.
+  # 
+  # @param student [Student] Объект студента для добавления.
+  def add_student(student)
+    self.logger.info "Добавление студента в хранилище"
+    self.logger.debug "Данные студента: #{student.to_line_s}"
+    self.entities_list.add_student(student)
+    self.logger.info "Студент добавлен в хранилище"
+    self.refresh_data
+  end
+
+  # Выбор строки таблицы.
+  # 
+  # @param number [Integer] Индекс строки для выбора.
+  def select(number)
+    begin
+      self.data_list.select(number)
+      self.logger.info "Выделена строка: #{number}"
+      self.view.update_button_states
+    rescue
+      self.logger.error "Ошибка при выделении строки: #{number}"
+    end
+  end
+
+  # Удаление выделения строки таблицы.
+  # 
+  # @param number [Integer] Индекс строки для удаления выбора.
+  def deselect(number)
+    begin
+      self.data_list.deselect(number)
+      self.logger.info "Выделение со строки: #{number} убрано"
+      self.view.update_button_states
+    rescue
+      self.logger.error "Ошибка при удалении выделения строки: #{number}"
+    end
+  end
+
+  # Получение списка ID выбранных студентов.
+  # 
+  # @return [Array<Integer>] Список ID выбранных студентов.
+  def get_selected
+    selected = self.data_list.get_selected
+    self.logger.debug "Выделенные студенты: #{selected}"
+    selected
+  end
+
+  # Получение объекта студента по ID.
+  # 
+  # @return [Student] Объект студента.
+  def get_student(id)
+    self.logger.info "Получение студента по id: #{id}"
+    student = self.entities_list.get_student_by_id(id)
+    self.logger.debug "Студент: #{student.to_line_s}"
+    student
+  end
+
+  # Изменение студента.
+  # 
+  # @param student [Student] Объект студента для изменения.
+  def replace_student(student)
+    self.logger.info "Замена студента с id: #{student.id}"
+    self.logger.debug "Замена студента: #{student.to_line_s}"
+    self.entities_list.replace_student(student.id, student)
+    self.refresh_data
+  end
+
+  # Удаление выбранных студентов в таблице студентов.
+  def delete_student
+    ids = self.get_selected
+    begin
+      ids.each do |id|
+        self.logger.info "Удаление студента с id: #{id}"
+        self.entities_list.delete_student(id)
+      end
+    rescue => e
+      error_msg = "Ошибка при удалении: #{e.message}"
+      self.logger.error error_msg
+      self.view.show_error(error_msg)
+    ensure
+      self.refresh_data
+      self.check_and_update_page
+    end
+  end
+
+  # Проверка и, если нужно, смена страницы в таблице.
+  # Используется после удаления студента.
+  def check_and_update_page()
+    if self.view.current_page > self.view.total_pages
+      switch_page(-1)
+    end
+  end
+
+  # Изменение текущей страницы в таблице.
+  # 
+  # @param direction [Integer] Направление для изменения страницы.
+  def switch_page(direction)
+    new_page = self.view.current_page + direction
+    if new_page < 1 || new_page > self.view.total_pages
+      return
+    end
+    self.logger.info "Переключение страницы на: #{new_page}"
+    self.view.current_page = new_page
+    self.refresh_data
+  end
+
+  # Применение фильтров.
+  def apply_filters
+    self.logger.info "Установка фильтров"
+    self.apply_full_name_filter
+    self.apply_git_filter
+    self.apply_email_filter
+    self.apply_phone_number_filter
+    self.apply_telegram_filter
+    self.apply_sort
+  end
+
+  # Сброс фильтров
+  def reset_filters
+    self.logger.info "Сброс фильтров"
+    self.filters = Filter.new
+  end
+
+  #  Установка порядка сортировки и сортировка данных в таблице.
+  #  
+  #  @param column_index [Integer] Индекс столбца, по которому выполняется сортировка.
+  def set_sort_order(column_index)
+    if self.sort_order[:col_index] == column_index
+      self.sort_order[:order] = self.sort_order[:order] == :asc ? :desc : :asc 
+    else
+      self.sort_order[:col_index] = column_index
+      self.sort_order[:order] = :asc
+    end
+    self.refresh_data
+  end
+
+  private
+  # @!attribute [rw] filters
+  #   @return [Filter] Объект фильтра.
+  # @!attribute [rw] sort_order
+  #   @return [Hash<Symbol, Object>, nil] Порядок сортировки.
+  attr_accessor :filters, :sort_order
+
+  # Устанавливка фильтра по полю ФИО.
+  def apply_full_name_filter
+    self.logger.info "Установка фильтра по ФИО: #{self.view.filters['name'][:text_field].text}"
+    name = self.view.filters['name'][:text_field].text
+    self.filters = Full_name_filter_decorator.new(self.filters, self.view.filters['name'][:text_field].text) unless name.nil? || name.empty?
+  end
+
+  # Устанавливка фильтра по полю.
+  # 
+  # @param field_key [String] Ключ фильтра из view.
+  # @param filter_field [String] Имя поля.
+  # @param filter_type [Symbol] Тип поля.
+  def apply_field_filter(field_key, filter_field, filter_type = :text_field)
+    filter_config = self.view.filters[field_key]
+    flag = filter_config[:combo].currentItem
+    text = filter_config[filter_type].text.strip if filter_type == :text_field
+  
+    case flag
+    when 0
+      return
+    when 1
+      self.logger.info "Установка фильтра по #{field_key} #{text}" unless text.nil? || text.empty?
+      self.filters = Field_filter_decorator.new(self.filters, filter_field, text) unless text.nil? || text.empty?
+    when 2
+      self.logger.info "Установка фильтра по #{field_key}: нет значения"
+      self.filters = Has_not_field_filter_decorator.new(self.filters, filter_field)
+    end
+  end
+
+  # Устанавливка фильтра по git.
+  def apply_git_filter
+    apply_field_filter('Git:', 'git')
+  end
+  
+  # Устанавливка фильтра по email.
+  def apply_email_filter
+    apply_field_filter('Email:', 'email')
+  end
+  
+  # Устанавливка фильтра по телефону.
+  def apply_phone_number_filter
+    apply_field_filter('Телефон:', 'phone_number')
+  end
+  
+  # Устанавливка фильтра по telegram.
+  def apply_telegram_filter
+    apply_field_filter('Telegram:', 'telegram')
+  end
+
+  # Устанавливка сортировки.
+  def apply_sort
+    case self.sort_order[:col_index]
+    when 1
+      self.filters = Full_name_sort_decorator.new(self.filters, self.sort_order[:order])
+    when 2
+      self.filters = Git_sort_decorator.new(self.filters, self.sort_order[:order])
+    when 3
+      self.filters = Contact_sort_decorator.new(self.filters, self.sort_order[:order])
+    else
+      self.filters
+    end
+  end
+end

data/lib/presenters/edit_student/add_student_presenter.rb

@@ -0,0 +1,46 @@
+require 'date'
+require_relative '../../models/student/student.rb'
+require_relative './edit_contacts_presenter'
+
+# == Add_student_presenter
+# Презентер для добавления нового студента.
+class Add_student_presenter < Edit_student_presenter
+
+  # Операция добавления нового студента.
+  #
+  # @param student_data [Hash] Данные студента.
+  def operation(student_data)
+    begin
+      self.logger.debug "Создание объекта студента: #{student_data.to_s}"
+      new_student(student_data)
+      self.parent_presenter.add_student(self.student)
+      self.view.close
+    rescue => e
+      error_msg = "Ошибка при добавлении студента: #{e.message}"
+      self.logger.error error_msg
+      self.view.show_error_message(error_msg)
+    end
+  end
+
+  # Заполнение полей интерфейса пустыми данными для нового студента.
+  def populate_fields
+    data = {
+    "first_name" => "",
+    "name" => "",
+    "patronymic" => "",
+    "birthdate" => "",
+  }
+    self.view.update_view data
+  end
+
+  # Проверка валидности данных студента при добавлении.
+  #
+  # @param student_data [Hash] Данные студента.
+  # @return [Boolean] Возвращает true, если данные валидны.
+  def valid_data?(student_data)
+    self.logger.debug "Проверка валидности данных: #{student_data.to_s}"
+    res = super(student_data)
+    self.logger.info "Валидность данных: #{res}"
+    res
+  end
+end

data/lib/presenters/edit_student/edit_contacts_presenter.rb

@@ -0,0 +1,36 @@
+require 'date'
+require_relative '../../models/student/student.rb'
+require_relative './edit_contacts_presenter'
+
+# == Edit_contacts_presenter
+# Презентер для редактирования контактной информации студента.
+class Edit_contacts_presenter < Edit_student_presenter
+
+  # Заполнение полей интерфейса текущими контактами студента.
+  def populate_fields
+    self.get_student
+    data = {
+      "telegram" => self.student.telegram,
+      "email" => self.student.email,
+      "phone_number" => self.student.phone_number,
+    }
+    self.view.update_view data
+  end
+
+  # Проверка валидности контактных данных студента.
+  #
+  # @param student_data [Hash] Контактные данные студента.
+  # @return [Boolean] Возвращает true, если данные валидны.
+  def valid_data?(student_data)
+    data = student_data.transform_values { |value| value.strip }
+    self.logger.debug "Проверка валидности данных: #{data.to_s}"
+    valid = Student.valid_phone_number?(data["phone_number"]) && Student.valid_email?(data["email"]) &&
+      Student.valid_telegram?(data["telegram"])
+    unchanged = self.student.telegram == data["telegram"] &&
+      self.student.email == data["email"] &&
+      self.student.phone_number == data["phone_number"]
+    res = valid && !unchanged
+    self.logger.info "Валидность данных: #{res}"
+    res
+  end
+end

data/lib/presenters/edit_student/edit_git_presenter.rb

@@ -0,0 +1,28 @@
+require_relative '../../models/student/student.rb'
+require_relative './edit_contacts_presenter'
+
+# == Edit_git_presenter
+# Презентер для редактирования информации о GitHub аккаунте студента.
+class Edit_git_presenter < Edit_student_presenter
+
+  # Заполнение полей интерфейса текущими данными о Git студента.
+  def populate_fields
+    self.get_student
+    data = {
+      "git" => self.student.git,
+    }
+    self.view.update_view data
+  end
+
+  # Проверка валидности данных о Git.
+  #
+  # @param student_data [Hash] Данные о Git.
+  # @return [Boolean] Возвращает true, если данные валидны.
+  def valid_data?(student_data)
+    data = student_data.transform_values { |value| value.strip }
+    self.logger.debug "Проверка валидности данных: #{data.to_s}"
+    res = Student.valid_git?(data["git"]) && self.student.git != data["git"]
+    self.logger.info "Валидность данных: #{res}"
+    res
+  end
+end