improved description

Ilia_Isakhin · Ilia_Isakhin · commit 3b60d100712a · 2019-10-16T15:44:58.000+04:00
diff --git a/README.md b/README.md
@@ -1 +1,11 @@
-java-oop-template
+# Шаблон для практической работы по теме Object Oriented Programming
+
+### Задание №1
+Вы проектируете систему управления проектом. В проекте может быть команда разработки и один техлид. Имплементируйте 
+необходимые методы и убедитесь, что функция main работает корректно 
+
+### Задание №2
+Вы проектируете сервис по работе с книгами (библиотека). Сервис обязан производить валидацию передаваемых книг. 
+Имплементируйте необходимые методы в классах SimpleBookRepository и SimpleBookService. Если нужно, реализуйте 
+дополнительный функционал. В методе main напишите небольшое демо, которые демострирует работу всех методов сервиса и 
+репозитория
diff --git a/src/main/java/ru/izh/online/course/task1/Main.java b/src/main/java/ru/izh/online/course/task1/Main.java
@@ -1,7 +1,8 @@
 package ru.izh.online.course.task1;
 
 import ru.izh.online.course.task1.entity.Developer;
-import ru.izh.online.course.task1.entity.Project;
+import ru.izh.online.course.task1.entity.project.Project;
+import ru.izh.online.course.task1.entity.project.SimpleProject;
 
 public class Main {
 
@@ -26,18 +27,24 @@ static void printProjectTeamSkills(Project project) {
         //TODO
     }
 
+    /**
+     * @return команду разработки (1 тестировщик, 2 бекендера и 3 фронтендера)
+     */
     static Developer[] getDevTeam() {
-        //TODO
-        return null;
+        return null; //TODO
     }
 
+    /**
+     * @return техлида. Имеет уровень 5
+     */
     static Developer getTechLead() {
-        //TODO
-        return null;
+        return null; //TODO
     }
 
+    /**
+     * @return предзаполненный {@link SimpleProject}
+     */
     static Project getProject() {
-        //TODO
-        return null;
+        return null; //TODO
     }
 }
diff --git a/src/main/java/ru/izh/online/course/task1/entity/Developer.java b/src/main/java/ru/izh/online/course/task1/entity/Developer.java
@@ -4,4 +4,5 @@
  * Абстрактный разработчик. Должен иметь поля: имя, фамилию, уровень, список скиллов, опыт работы.
  */
 public abstract class Developer {
+    //TODO
 }
diff --git a/src/main/java/ru/izh/online/course/task1/entity/Level.java b/src/main/java/ru/izh/online/course/task1/entity/Level.java
@@ -3,7 +3,7 @@
 /**
  * Уровень разработчика, есть поля название и численная ценность (1-5)
  *
- * Возможные значения:
+ * Возможные значения: //TODO
  * Студент
  * Джуниор
  * Миддл
diff --git a/src/main/java/ru/izh/online/course/task1/entity/Project.java b/src/main/java/ru/izh/online/course/task1/entity/Project.java
diff --git a/src/main/java/ru/izh/online/course/task1/entity/SimpleProject.java b/src/main/java/ru/izh/online/course/task1/entity/SimpleProject.java
diff --git a/src/main/java/ru/izh/online/course/task1/entity/dev/AutomatedTester.java b/src/main/java/ru/izh/online/course/task1/entity/dev/AutomatedTester.java
@@ -3,7 +3,7 @@
 import ru.izh.online.course.task1.entity.Developer;
 
 /**
- * Автотестировщик, должен иметь поле среднее количество найденных багов в час
+ * Автотестировщик, должен иметь поле среднее количество найденных багов в час //TODO
  */
 public class AutomatedTester extends Developer {
 }
diff --git a/src/main/java/ru/izh/online/course/task1/entity/dev/BackendDeveloper.java b/src/main/java/ru/izh/online/course/task1/entity/dev/BackendDeveloper.java
@@ -3,7 +3,7 @@
 import ru.izh.online.course.task1.entity.Developer;
 
 /**
- * Бэк-разработчкик, должен иметь поле любимая база данных
+ * Бэк-разработчкик, должен иметь поле любимая база данных //TODO
  */
 public class BackendDeveloper extends Developer {
 }
diff --git a/src/main/java/ru/izh/online/course/task1/entity/dev/FrontendDeveloper.java b/src/main/java/ru/izh/online/course/task1/entity/dev/FrontendDeveloper.java
@@ -3,7 +3,7 @@
 import ru.izh.online.course.task1.entity.Developer;
 
 /**
- * Фронт-разработчик - должен иметь поле любимый JS-фреймворк
+ * Фронт-разработчик - должен иметь поле любимый JS-фреймворк //TODO
  */
 public class FrontendDeveloper extends Developer {
 }
diff --git a/src/main/java/ru/izh/online/course/task1/entity/project/Project.java b/src/main/java/ru/izh/online/course/task1/entity/project/Project.java
@@ -0,0 +1,16 @@
+package ru.izh.online.course.task1.entity;
+
+/**
+ * Проект
+ */
+public interface Project {
+
+    boolean assignTechLead(Developer developer);
+
+    boolean addTeam(Developer[] developers);
+
+    boolean addDeveloper(Developer developer);
+
+    boolean isDeveloperFits(Developer developer);
+
+}
diff --git a/src/main/java/ru/izh/online/course/task1/entity/project/SimpleProject.java b/src/main/java/ru/izh/online/course/task1/entity/project/SimpleProject.java
@@ -0,0 +1,47 @@
+package ru.izh.online.course.task1.entity;
+
+/**
+ * Сущность проект. У проекта есть id, техлид (разработчик уровня 5), команда разработки(бек-девелоперы, тестеры,
+ * фронт-девелоперы), заказчик, дата старта, предположительная дата окончания, список необходимых скиллов
+ */
+public class SimpleProject implements Project{
+
+    /**
+     * Метод, назначающий техлида на текущий проект
+     * @param developer - должен быть уровня L5
+     * @return удалось назначить техлида или нет
+     */
+    public boolean assignTechLead(Developer developer) {
+        return false; //TODO
+    }
+
+    /**
+     * Проверяет, удовлетворяет ли разработчик проекту: количество совпадающих скиллов должно быть больше 50%
+     * @param developer
+     * @return
+     */
+    public boolean isDeveloperFits(Developer developer) {
+        return false; //TODO
+    }
+
+    /**
+     * Назначает всю команду в проект. Должен вызывать метод addDeveloper
+     * @param developers
+     */
+    public boolean addTeam(Developer[] developers) {
+        return false; //TODO
+    }
+
+    /**
+     * Назначает разработчика на проект. Должен вызывать метод isDeveloperFits
+     * @param developer
+     * @return
+     */
+    public boolean addDeveloper(Developer developer) {
+        return false; //TODO
+    }
+
+    public String toString() {
+        return ""; //TODO
+    }
+}
diff --git a/src/main/java/ru/izh/online/course/task2/Main.java b/src/main/java/ru/izh/online/course/task2/Main.java
@@ -1,13 +1,9 @@
 package ru.izh.online.course.task2;
 
-import ru.izh.online.course.task2.service.BookService;
-import ru.izh.online.course.task2.service.SimpleBookService;
-
 public class Main {
 
     public static void main(String[] args) {
-        BookService bookService = new SimpleBookService();
-
 
     }
+
 }
diff --git a/src/main/java/ru/izh/online/course/task2/repository/BookRepository.java b/src/main/java/ru/izh/online/course/task2/repository/BookRepository.java
@@ -6,39 +6,14 @@
 
 public interface BookRepository {
 
-    /**
-     * Должен возвращать сущность типа книга по его id, если такой книги нет, то возвратить null.
-     * @param id ид книги.
-     * @return удалось добавить книгу или нет.
-     */
     Book get(long id);
 
-    /**
-     * Должен добавлять в массив книг новую книгу.
-     * @param book сущность книга.
-     * @return true если книга была добавлена.
-     */
     boolean add(Book book);
 
-    /**
-     * Должен удалять из массива книг книгу по названию.
-     * @param name название книги
-     * @return true если книга была удалена
-     */
     boolean remove(String name);
 
-    /**
-     * Должен возвращать из массива книг все книги с автором authorName
-     * @param authorName
-     * @return Массив книг
-     */
     Book[] getAll(String authorName);
 
-    /**
-     * Должен возвращать из массива книг все книги которые были изданы в publishDate
-     * @param publishDate
-     * @return Массив книг
-     */
     Book[] getAll(Date publishDate);
 
 }
diff --git a/src/main/java/ru/izh/online/course/task2/repository/SimpleBookRepository.java b/src/main/java/ru/izh/online/course/task2/repository/SimpleBookRepository.java
@@ -32,28 +32,53 @@ public static long getNextId() {
             new Book(getNextId(), "Introduction to Algorithms", 1292  , AUTHORS[2], of(2009, 7, 31))
     };
 
+    /**
+     * Должен возвращать сущность типа книга по его id, если такой книги нет, то возвратить null.
+     * @param id ид книги.
+     * @return удалось добавить книгу или нет.
+     */
     @Override
     public Book get(long id) {
-        return null;
+        return null; //TODO
     }
 
+    /**
+     * Должен добавлять в массив книг новую книгу.
+     * @param book сущность книга.
+     * @return true если книга была добавлена.
+     */
     @Override
     public boolean add(Book book) {
-        return false;
+        return false; //TODO
     }
 
+    /**
+     * Должен удалять из массива книг книгу по названию.
+     * @param name название книги
+     * @return true если книга была удалена
+     */
     @Override
     public boolean remove(String name) {
-        return false;
+        return false; //TODO
     }
 
+    /**
+     * Должен возвращать из массива книг все книги с автором authorName
+     * @param authorName
+     * @return Массив книг
+     */
     @Override
     public Book[] getAll(String authorName) {
-        return new Book[0];
+        return new Book[0]; //TODO
     }
 
+    /**
+     * Должен возвращать из массива книг все книги которые были изданы в publishDate
+     * @param publishDate
+     * @return Массив книг
+     */
     @Override
     public Book[] getAll(Date publishDate) {
-        return new Book[0];
+        return new Book[0]; //TODO
     }
 }
diff --git a/src/main/java/ru/izh/online/course/task2/service/BookService.java b/src/main/java/ru/izh/online/course/task2/service/BookService.java
@@ -6,39 +6,14 @@
 
 public interface BookService {
 
-    /**
-     * Должен получать книгу по Id из репозитория.
-     * @param id
-     * @return Книгу если найдена. В противном случае печатать в консоль сообщение с ошибкой
-     */
     Book get(long id);
 
-    /**
-     * Должен получать добавлять книгу в репозиторий.
-     * @param book
-     * @return true если добавлена. В противном случае печатать в консоль сообщение с ошибкой
-     */
     boolean add(Book book);
 
-    /**
-     * Должен удалять книгу по названию из репозитория.
-     * @param name
-     * @return true если удалена. В противном случае печатать в консоль сообщение с ошибкой
-     */
     boolean remove(String name);
 
-    /**
-     * Должен получать все книги автора из репозитория.
-     * @param authorName
-     * @return Книги если найдены. В противном случае печатать в консоль сообщение с ошибкой
-     */
     Book[] getAll(String authorName);
 
-    /**
-     * Должен получать книгу по Id из репозитория.
-     * @param publishDate
-     * @return Книги если найдены. В противном случае печатать в консоль сообщение с ошибкой
-     */
     Book[] getAll(Date publishDate);
 
 }
diff --git a/src/main/java/ru/izh/online/course/task2/service/SimpleBookService.java b/src/main/java/ru/izh/online/course/task2/service/SimpleBookService.java

Original file line number	Diff line number	Diff line change
`@@ -4,4 +4,5 @@`
`4`	`4`	`* Абстрактный разработчик. Должен иметь поля: имя, фамилию, уровень, список скиллов, опыт работы.`
`5`	`5`	`*/`
`6`	`6`	`public abstract class Developer {`
	`7`	`+ //TODO`
`7`	`8`	`}`
Original file line number	Diff line number	Diff line change
`@@ -3,7 +3,7 @@`
`3`	`3`	`/**`
`4`	`4`	`* Уровень разработчика, есть поля название и численная ценность (1-5)`
`5`	`5`	`*`
`6`		`- * Возможные значения:`
	`6`	`+ * Возможные значения: //TODO`
`7`	`7`	`* Студент`
`8`	`8`	`* Джуниор`
`9`	`9`	`* Миддл`
Original file line number	Diff line number	Diff line change
`@@ -3,7 +3,7 @@`
`3`	`3`	`import ru.izh.online.course.task1.entity.Developer;`
`4`	`4`
`5`	`5`	`/**`
`6`		`- * Автотестировщик, должен иметь поле среднее количество найденных багов в час`
	`6`	`+ * Автотестировщик, должен иметь поле среднее количество найденных багов в час //TODO`
`7`	`7`	`*/`
`8`	`8`	`public class AutomatedTester extends Developer {`
`9`	`9`	`}`