Состав команды:
-
Мария Лисок, группа 8381.
-
Дмитрий Перелыгин, группа 8381.
-
Почаев Никита, группа 8381.
Распределение ролей:
Важность ролей и % участия распределяются по нисходящей: чем раньше идёт роль, тем большее участие в ней принимает участник.
-
Никита: лидер, алгоритмист, документация;
-
Мария: алгоритмист, тестировщик, документация;
-
Дмитрий: фронтенд, документация, тестировщик.
-
Работы с UML ведётся на Google Drive.
-
Таблица с успеваемостью.
Визуализируется разрез земли (2д сбоку) с рудами (а-ля майнкрафт). Человечек стоит сверху с определённого вида инструментом (или с несколькими). Требуется найти минимальный путь от текущего положения человечка до портала в ад (выделяется на карте специальнным образом), передвигаясь при этом только между жилами руд. При нажатии на кнопку визулизируется путь на начала к порталу, есть возможность пошагово просмотреть ход движения человечка. Другая кнопка подсвечивает найденные на карте жилы каким-либо образом.
Ресуры появляются в виде жил. Жила - блоки одинковой руды, транзитивно соприкасающиеся друг с другом хотя бы одной стороной. Расстоние от жилы до жилы: минимальное расстояние между ближайшими блоками соотвествующих жил (при наличии диагонали - лесенка). Таким образом каждая жила представляется в виде веришины, а расстояние между ними - ребро с весом. Граф получится полным. Карты хранятся в виде файлов с массивами данных. Нахождение жил и расстония требуется находить.
-
Определение пользователем различных инструментов и влияния на возможность добычи этой руды (например, каменная кирка не добывает алмазы -> мы не учитваем алмазные жилы при постронении графа)
-
При нажатии на жилу в начальном состоянии визуализируются кратчайшие пути от неё до других жил
-
Добавление режима создания случайной карты
-
Сохранение/загрузка/редактирование карт
-
Между блоками могут генерироваться непроходимые блоки (в этом случае придётся искать кратчайшие пути между жилами не вычитанием координат, а алгоритмом поиска).
Для одного логического фрагмента работы создаём отдельный commit. Работы над каждым task'ом ведётся в отдельной ветке и затем проходит code review от других членов команды.
В данном разделе находится roadmap проекта и текущий процесс работы в формате канбан доски.
У каждой задачи есть:
-
Текущее состояние (прогресс).
-
Тег выполнения, полный список которых можно увидеть в выпадающем списке при редактировании. Их можно использовать для сортировки, а также для того, чтобы взять задачу по своей зоне ответсвенности.
-
Участником, которые уже занимаются выполнением данной задачи.
Для создания новой задачи необходимо зайти в разде Issue (1) и создать новый экземпляр (2).
При создании новой задачи необходимо указать следующие параметры:
-
Заголовок, где кратко описать выполняемую задачу
-
Тело задачи с более подробным описанием.
-
Участники, которые принимают / должны принять участие.
-
Лейблы данной задачи. Пожалуйста, выставляйте их внимательно.
-
Выбрать проект, к которому принадлежить данная задача. В нашем случае это всего Miner.
-
Если к данной задаче был создан pull request, содержащий изменений для данной задаче, то его необходимо прикрепить к текущей задачи. (Это также автоматизирует процесс закрытия task'а при закрытии pull request)
При написании комментариев придерживаемся стандартов Oracle для Javadoc Tool. Описание пишем к каждому создаваемому классу.
Для надписей изпользуем шрифт Roboto (Google Fonts). В случае его отстутсвия подключается из блока слева.
В разделе готовых блоков есть раздел UML используем его.
Для классов описываем все методы.
Для ознакомления про Git Flow.
Основные ветки:
maser- стабильная версия проекта (релиз)
Дополнительные:
-
Ветки функциональностей (Feature branches) - создаём для каждой задачи.
-
Ветки именуются согласно номеру task'и(Пример: branch#12)
-
Ветки исправлений (Hotfix branches)
Название имеет вид
hotfix-*(* - номер task'и). Если в текущей стабильной версии проекта (которая хранится вmaster) выявляется баг, который требует немедленного исправления, создаётся ветка багфикса (исправления), порождённая отmaster. После удачного исправления бага вливается вmaster.