Merge pull request 'dev' (#43) from dev into main

Reviewed-on: #43

.gitignore

@@ -1,2 +1,3 @@
 todo/target/
 .vscode/
+.lingma/

CHANGELOG.md

@@ -0,0 +1,24 @@
+Все заметные изменения проекта будут документироваться в этом файле.
+
+Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.0.0/),
+и этот проект придерживается [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
+
+## [2.1.0] - 2025-06-01
+
+### Добавлено
+- Команда `search <текст>` для поиска задач по тексту (реализован класс `SearchCommand`)
+- Метод `search(String query)` в `TaskService` для поддержки поиска задач
+- Рефакторинг: вынесение общего функционала отображения задач в отдельный метод `formatWithTable()` в классе `ListCommand`
+
+### Изменено
+- Обновлены внутренние зависимости между компонентами CLI (`SearchCommand`, `ListCommand`) и моделью данных (`Task`, `SimpleTask`)
+- Добавлена обработка минимальной длины поискового запроса (3 символа) в `SearchCommand`# Журнал изменений
+
+
+## [2.0.0] - 2025-05-29
+
+### Добавлено
+- Базовая функциональность для управления задачами
+- Команды: create, list, delete
+- Консольный интерфейс для взаимодействия с приложением
+- In-memory хранилище задач

README.md

@@ -1,73 +1,35 @@
 # TodoApp
 
-Консольное приложение для управления списком задач, разработанное на Java в процессе изучения языка.
+## Описание
+TodoApp - это консольное приложение для управления списком задач, разработанное на Java в качестве учебного проекта. Приложение позволяет создавать, просматривать, отмечать как выполненные и удалять задачи через интерфейс командной строки.
 
-## Описание проекта
+## Требования
+- Java 24 или выше
+- Maven 3.8.x или выше
 
-Todo App — это консольное приложение, которое позволяет пользователю создавать, просматривать и управлять списком задач. Приложение поддерживает полный цикл работы с задачами: создание новых задач, изменение их статуса (начать выполнение, отметить как завершенные или отмененные) и просмотр полного списка задач.
+## Установка и запуск
+```bash
+cd ./todo
+mvn clean package
+java -jar ./target/todo.jar
+```
 
-## Возможности
-
-- Создание новых задач с названием и описанием
-- Управление статусом задач:
-  - Новая задача
-  - В процессе выполнения
-  - Завершена
-  - Отменена
-- Просмотр списка всех задач
-- Цветовая индикация статуса задач в консоли
-- Защита от некорректного ввода пользователя
+### Доступные команды
+- `create <название_задачи>` - Создать новую задачу
+- `list` - Показать список всех задач
+- `complete <id>` - Отметить задачу как выполненную
+- `delete <id>` - Удалить задачу
+- `search <текст>` - Найти задачи по тексту
+- `exit` - Выйти из приложения
 
 ## Структура проекта
+- `model` - Модели данных (Task, SimpleTask)
+- `repo` - Репозитории для хранения задач
+- `service` - Бизнес-логика
+- `cli` - Компоненты интерфейса командной строки
 
-Проект организован на основе Maven и содержит следующие классы:
-
-- **TodoApp** — основной класс приложения с главным методом, пользовательским интерфейсом и менеджером задач
-- **Task** — класс, представляющий задачу, с методами для управления её статусом
-- **TaskStatus** — перечисление (enum) доступных статусов задачи с возможностью цветового оформления
-
-## Технологии
-
-- Java 24
-- Maven для управления сборкой проекта
-
-## Запуск приложения
-
-### Требования
-- JDK 24 или выше
-- Maven 3.6+
-
-### Компиляция и запуск
-
-```bash
-# Клонировать репозиторий
-git clone https://github.com/kamask/todo-app.git
-cd todo-app
-
-# Скомпилировать проект
-mvn clean package
-
-# Запустить приложение
-java -jar target/todo-1.0-SNAPSHOT.jar
-```
-
-## Использование
-
-После запуска приложения вы увидите главное меню:
-
-```
-┌──────────────────────────┐
-|  [1] Добавить дело       |
-|  [2] Список дел          |
-|                          |
-|  [0] Выйти из программы  |
-└──────────────────────────┘
-```
-
-- Выберите **1** для создания новой задачи
-- Выберите **2** для просмотра списка всех задач
-- Выберите **0** для выхода из программы
+## Версии
+Актуальная версия: 2.1
 
 ## Лицензия
-
-Этот проект распространяется под лицензией MIT. 
+[MIT](LICENSE)

todo/CHANGELOG.md

@@ -1,14 +0,0 @@
-# Журнал изменений
-
-Все заметные изменения проекта будут документироваться в этом файле.
-
-Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.0.0/),
-и этот проект придерживается [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [2.0.0] - 2025-05-29
-
-### Добавлено
-- Базовая функциональность для управления задачами
-- Команды: create, list, delete
-- Консольный интерфейс для взаимодействия с приложением
-- In-memory хранилище задач 

todo/README.md

@@ -1,27 +0,0 @@
-# TodoApp
-
-## Описание
-TodoApp - это консольное приложение для управления списком задач, разработанное на Java в качестве учебного проекта. Приложение позволяет создавать, просматривать, отмечать как выполненные и удалять задачи через интерфейс командной строки.
-
-## Требования
-- Java 24 или выше
-- Maven 3.8.x или выше
-
-### Доступные команды
-- `create <название_задачи>` - Создать новую задачу
-- `list` - Показать список всех задач
-- `complete <id>` - Отметить задачу как выполненную
-- `delete <id>` - Удалить задачу
-- `exit` - Выйти из приложения
-
-## Структура проекта
-- `model` - Модели данных (Task, SimpleTask)
-- `repo` - Репозитории для хранения задач
-- `service` - Бизнес-логика
-- `cli` - Компоненты интерфейса командной строки
-
-## Версии
-Актуальная версия: 2.0
-
-## Лицензия
-[MIT](LICENSE) 

todo/pom.xml

@@ -6,10 +6,40 @@
 
     <groupId>ru.kamask.pet</groupId>
     <artifactId>todo</artifactId>
-    <version>2.0-SNAPSHOT</version>
+    <version>2.1</version>
 
     <properties>
         <maven.compiler.release>24</maven.compiler.release>
+        <maven.compiler.target>24</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     </properties>
 
+    <build>
+        <finalName>todo</finalName>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-jar-plugin</artifactId>
+                <version>3.4.2</version>
+                <configuration>
+                    <archive>
+                        <manifest>
+                            <mainClass>ru.kamask.pet.todo.TodoApp</mainClass>
+                        </manifest>
+                    </archive>
+                </configuration>
+            </plugin>
+
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.14.0</version>
+                <configuration>
+                    <source>24</source>
+                    <target>24</target>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
 </project>

todo/src/main/java/ru/kamask/pet/Task.java

@@ -1,85 +0,0 @@
-package ru.kamask.pet;
-
-import java.time.LocalDate;
-
-class Task {
-    static int taskCount = 0;
-
-    enum TaskIdGenerator {
-        INSTANCE;
-
-        private int currentId = 1;
-
-        int nextId() {
-            return currentId++;
-        }
-    }
-
-    private int id;
-    private String title;
-    private String description;
-    private TaskStatus status;
-    private LocalDate createdAt;
-
-    Task(String title, String description) {
-        id = TaskIdGenerator.INSTANCE.nextId();
-        status = TaskStatus.NEW;
-        createdAt = LocalDate.now();
-        taskCount++;
-
-        this.title = title;
-        this.description = description;
-    };
-
-    static void printTotalTasksCreated() {
-        System.out.println("Колличество дел: " + taskCount);
-    }
-
-    int getId() {
-        return id;
-    }
-
-    String getTitle() {
-        return title;
-    }
-
-    boolean isCompleted() {
-        return status == TaskStatus.COMPLETED;
-    }
-
-    void markCompleted() {
-        status = TaskStatus.COMPLETED;
-    }
-
-    void markInProgress() {
-        status = TaskStatus.IN_PROGRESS;
-    }
-
-    void markCanceled() {
-        status = TaskStatus.CANCELLED;
-    }
-
-    TaskStatus getStatus() {
-        return status;
-    }
-
-    static class TaskPrinter {
-        static void print(Task task) {
-            String template = """
-
-                    ──────────────────────────────
-                    Номер: %-3d
-                    Дата создания: %s
-                    Статус: %s
-                    Название: %-20s
-                    ------------------------------
-                    %s
-
-                    """;
-            ;
-            String stringCompleted = task.status.getColorCode() + task.status.getDescription() + "\u001B[0m";
-            System.out.printf(template, task.id, task.createdAt, stringCompleted, task.title, task.description);
-        }
-    }
-
-}

todo/src/main/java/ru/kamask/pet/TaskStatus.java

@@ -1,41 +0,0 @@
-package ru.kamask.pet;
-
-public enum TaskStatus {
-    NEW("новое") {
-        @Override
-        String getColorCode() {
-            return "\u001B[34m";
-        }
-    },
-    IN_PROGRESS("в работе") {
-        @Override
-        String getColorCode() {
-            return "\u001B[35m";
-        }
-    },
-    COMPLETED("сделано") {
-        @Override
-        String getColorCode() {
-            return "\u001B[32m";
-        }
-    },
-    CANCELLED("отменено") {
-        @Override
-        String getColorCode() {
-            return "\u001B[31m";
-        }
-    };
-
-    abstract String getColorCode();
-
-    private final String description;
-
-    TaskStatus(String description) {
-        this.description = description;
-    }
-
-    String getDescription() {
-        return description;
-    }
-
-}

todo/src/main/java/ru/kamask/pet/TodoApp.java

@@ -1,250 +0,0 @@
-package ru.kamask.pet;
-
-import java.util.Scanner;
-
-public class TodoApp {
-
-    private static TaskManager taskManager;
-    private static Task[] tasks = new Task[10];
-    private static int tasksCounter = 0;
-    private static Scanner scanner = new Scanner(System.in);
-
-    public static void main(String[] args) {
-
-        TodoApp app = new TodoApp();
-        taskManager = app.new TaskManager();
-
-        app.run();
-
-    }
-
-    private void run() {
-        while (true) {
-            Task.printTotalTasksCreated();
-            String menu = """
-
-                    ┌──────────────────────────┐
-                    |  [1] Добавить дело       |
-                    |  [2] Список дел          |
-                    |                          |
-                    |  [0] Выйти из программы  |
-                    └──────────────────────────┘
-
-                    Введите номер пункта меню:""";
-
-            switch (requestIntFromInput(menu, new int[] { 0, 1, 2 })) {
-                case 1 -> displayCreateTask();
-                case 2 -> displayTasks();
-                case 0 -> {
-                    scanner.close();
-                    System.exit(0);
-                }
-            }
-        }
-    }
-
-    private static void displayCreateTask() {
-
-        if (Task.taskCount >= 9) {
-            System.out.println("\nОшибка: Достигнут лимит в 10 дел.\n");
-            return;
-        }
-
-        String title;
-        String description;
-
-        do {
-            System.out.print("\nНапишите название дела (3–20 символов): ");
-            title = scanner.nextLine().trim();
-            if (title.length() >= 3 && title.length() <= 20)
-                break;
-
-            System.out.print("\nОшибка: Название должно содержать от 3 до 20 символов.\nПопробуйте снова: ");
-        } while (true);
-
-        System.out.print("\nНaпишите описание дела: ");
-        description = scanner.nextLine().trim();
-
-        taskManager.addTask(new Task(title, description));
-    }
-
-    private static void displayTask(Task task) {
-        Task.TaskPrinter.print(task);
-
-        String firstOption = switch (task.getStatus()) {
-            case NEW, CANCELLED -> "Начать";
-            case IN_PROGRESS -> "Выполнено";
-            case COMPLETED -> "Доделать";
-        };
-
-        int input = requestIntFromInput("[1]" + firstOption + " [2]Отменить [0]Главное меню\n\nВвод:",
-                new int[] { 0, 1, 2 });
-
-        switch (input) {
-            case 0:
-                return;
-            case 1: {
-                switch (task.getStatus()) {
-                    case NEW, CANCELLED, COMPLETED -> taskManager.markInProgress(task.getId());
-                    case IN_PROGRESS -> taskManager.markCompleted(task.getId());
-                }
-                break;
-            }
-            case 2:
-                taskManager.markCanceled(task.getId());
-        }
-
-        displayTask(task);
-    }
-
-    private static void displayTasks() {
-
-        if (tasksCounter == 0) {
-            int input = requestIntFromInput("""
-
-                    Список дел пуст.
-
-                    [1] Добавить дело
-                    [0] Выйти из программы
-
-                    Введите номер пункта:""", new int[] { 0, 1 });
-
-            if (input == 1) {
-                displayCreateTask();
-            } else
-                System.exit(0);
-        }
-
-        System.out.println("""
-                Список дел:
-
-                """);
-
-        taskManager.printTasks();
-
-        int[] variantsInput = new int[tasksCounter + 1];
-        for (int i = 0; i < tasksCounter; i++)
-            variantsInput[i] = tasks[i].getId();
-        variantsInput[tasksCounter] = 0;
-
-        int input = requestIntFromInput("""
-
-                Введите номер дела или 0 для возврата в меню:""", variantsInput);
-
-        if (input == 0)
-            return;
-
-        displayTask(getTaskById(input));
-
-    }
-
-    private static Task getTaskById(int id) {
-        for (int i = 0; i < Task.taskCount; i++) {
-            if (tasks[i].getId() == id)
-                return tasks[i];
-        }
-        return null;
-    }
-
-    private static int requestIntFromInput(String template, int[] allowedInts) {
-        do {
-            System.out.print(template);
-            int input;
-            do {
-                if (scanner.hasNextInt()) {
-                    input = scanner.nextInt();
-                    scanner.nextLine();
-                    break;
-                } else {
-                    scanner.next();
-                    System.out.print("Ошибка: используйте цифры.\nПовторите ввод:");
-                }
-            } while (true);
-
-            for (int i : allowedInts)
-                if (i == input)
-                    return input;
-            System.out.print("Ошибка: укажите номер выбранного пункта.\nПовторите ввод:");
-        } while (true);
-    }
-
-    interface TaskAction {
-        default void execute(Task task) {
-        };
-
-        default void start(Task task) {
-        };
-
-        default void cancel(Task task) {
-        };
-    }
-
-    private class TaskManager {
-        void addTask(Task task) {
-            tasks[tasksCounter++] = task;
-        }
-
-        boolean markCompleted(int id) {
-            for (int i = 0; i < tasksCounter; i++)
-                if (tasks[i].getId() == id) {
-                    TaskAction action = new TaskAction() {
-                        @Override
-                        public void execute(Task task) {
-                            task.markCompleted();
-                        }
-                    };
-                    action.execute(tasks[i]);
-                    return true;
-                }
-            return false;
-        }
-
-        boolean markInProgress(int id) {
-            for (int i = 0; i < tasksCounter; i++)
-                if (tasks[i].getId() == id) {
-                    TaskAction action = new TaskAction() {
-                        @Override
-                        public void start(Task task) {
-                            task.markInProgress();
-                        }
-                    };
-                    action.start(tasks[i]);
-                    return true;
-                }
-            return false;
-        }
-
-        boolean markCanceled(int id) {
-            for (int i = 0; i < tasksCounter; i++)
-                if (tasks[i].getId() == id) {
-                    TaskAction action = new TaskAction() {
-                        @Override
-                        public void cancel(Task task) {
-                            task.markCanceled();
-                        }
-                    };
-                    action.cancel(tasks[i]);
-                    return true;
-                }
-            return false;
-        }
-
-        void printTasks() {
-            class ShortTaskPrinter {
-                void print(Task task) {
-                    int id = task.getId();
-                    String title = task.getTitle();
-                    TaskStatus status = task.getStatus();
-
-                    String stringCompleted = status.getColorCode() + status.getDescription() + "\u001B[0m";
-                    System.out.printf("%-3d | %-20s | %s\n", id, title, stringCompleted);
-                }
-            }
-
-            ShortTaskPrinter printer = new ShortTaskPrinter();
-            for (int i = 0; i < Task.taskCount; i++)
-                printer.print(tasks[i]);
-        }
-
-    }
-}

todo/src/main/java/ru/kamask/pet/todo/TodoApp.java

@@ -0,0 +1,17 @@
+package ru.kamask.pet.todo;
+
+import java.io.IOException;
+
+import ru.kamask.pet.todo.cli.CliEngine;
+import ru.kamask.pet.todo.repo.InMemoryTaskRepository;
+import ru.kamask.pet.todo.service.TaskService;
+
+public class TodoApp {
+    public static void main(String[] args) throws IOException {
+        var service = new TaskService(new InMemoryTaskRepository());
+        var cli = new CliEngine(service);
+
+        cli.start();
+    }
+
+}

todo/src/main/java/ru/kamask/pet/todo/cli/CliEngine.java

@@ -21,7 +21,7 @@ public class CliEngine {
     }
 
     public void start() throws IOException {
-        System.out.println("\nДобро пожаловать в Список задач 2.0!");
+        System.out.println("\nДобро пожаловать в Список задач 2.1!");
         System.out.println("Введите help для просмтора доступных команд или exit для выхода.");
         while (true) {
             System.out.print("\ntodo> ");
@@ -46,6 +46,7 @@ public class CliEngine {
         registerCommand(new CreateCommand());
         registerCommand(new ListCommand());
         registerCommand(new CompleteCommand());
+        registerCommand(new SearchCommand());
         registerCommand(new DeleteCommand());
     }
 

todo/src/main/java/ru/kamask/pet/todo/cli/ListCommand.java

@@ -1,5 +1,6 @@
 package ru.kamask.pet.todo.cli;
 
+import java.util.List;
 import java.util.Optional;
 
 import ru.kamask.pet.todo.model.SimpleTask;
@@ -17,18 +18,8 @@ public class ListCommand implements Command {
         if (args.length > 0)
             return Optional.of(Command.errorMessage);
 
-        String template = "%-2s | %-30s | %s\n";
-        String res = "";
-        res += String.format(template, "ID", "Название задачи", "Статус");
-        res += "-".repeat(50) + "\n";
+        var res = formatWithTable(service.list(), "Список задач пуст.");
         
-        if (service.list().size() == 0)
-            return Optional.of(res + "\nСписок задач пуст.");
-
-        for (Task task : service.list()) {
-            SimpleTask.Data data = ((SimpleTask) task).data();
-            res += String.format(template, data.id(), data.title(), data.done() ? "выполнено" : "не выполнено");
-        }
         return Optional.of(res);
     }
 
@@ -36,4 +27,21 @@ public class ListCommand implements Command {
     public String usage() {
         return String.format(templateUsage, name(), "Список всех задач.");
     }
+
+    String formatWithTable(List<Task> tasks, String msgIfEmpty){
+        String template = "%-2s | %-30s | %s\n";
+        String res = "";
+        res += String.format(template, "ID", "Название задачи", "Статус");
+        res += "-".repeat(50) + "\n";
+
+        if (tasks.size() == 0)
+            return res + "\n" + msgIfEmpty;
+
+        for (Task task : tasks) {
+            SimpleTask.Data data = ((SimpleTask) task).data();
+            res += String.format(template, data.id(), data.title(), data.done() ? "выполнено" : "не выполнено");
+        }
+
+        return  res;
+    }
 }

todo/src/main/java/ru/kamask/pet/todo/cli/SearchCommand.java

@@ -0,0 +1,30 @@
+package ru.kamask.pet.todo.cli;
+
+import java.util.Optional;
+
+import ru.kamask.pet.todo.service.TaskService;
+
+public class SearchCommand implements Command {
+    @Override
+    public String name() {
+        return "search";
+    }
+
+    @Override
+    public String usage() {
+        return String.format(templateUsage, name() + " <текст>", "Поиск задач по тексту (минимум 3 символа)");
+    }
+
+    @Override
+    public Optional<String> handle(String[] args, TaskService service) {
+        if (args.length != 1)
+            return Optional.of(Command.errorMessage);
+        if (args[0].length() < 3)
+            return Optional.of("Длина запроса должна быть не менее 3 символов.");
+
+        var matchTask = service.search(args[0]);
+        var res = new ListCommand().formatWithTable(matchTask, "Не найдено задач, соответствующих запросу.");
+
+        return Optional.of(res);
+    }
+}

todo/src/main/java/ru/kamask/pet/todo/model/DataBuilder.java

@@ -0,0 +1,5 @@
+package ru.kamask.pet.todo.model;
+
+public interface DataBuilder<T> {
+    T data();
+}

todo/src/main/java/ru/kamask/pet/todo/model/SimpleTask.java

@@ -0,0 +1,35 @@
+package ru.kamask.pet.todo.model;
+
+public class SimpleTask extends Task implements DataBuilder<SimpleTask.Data> {
+    private boolean done = false;
+
+    public SimpleTask(String title) {
+        super(title);
+    }
+
+    @Override
+    public void markAsCompleted() {
+        done();
+    }
+
+    @Override
+    public boolean isCompleted() {
+        return isDone();
+    }
+
+    void done() {
+        done = true;
+    }
+
+    boolean isDone() {
+        return done;
+    }
+
+    @Override
+    public Data data() {
+        return new Data(id, title, done);
+    }
+
+    public record Data(int id, String title, boolean done) {
+    }
+}

todo/src/main/java/ru/kamask/pet/todo/model/Task.java

@@ -0,0 +1,27 @@
+package ru.kamask.pet.todo.model;
+
+public abstract class Task {
+    private static int nextId = 1;
+
+    protected int id;
+    protected String title;
+
+    Task(String title) {
+        this.id = nextId++;
+        this.title = title;
+    }
+
+    public int id() {
+        return id;
+    }
+
+    @Override
+    public String toString() {
+        return String.format("Задача: id - %d, title: \"%s\"", id, title);
+    }
+
+    abstract public void markAsCompleted();
+
+    abstract public boolean isCompleted();
+
+}

todo/src/main/java/ru/kamask/pet/todo/service/TaskService.java

@@ -42,4 +42,10 @@ public class TaskService {
     public boolean has(int id) {
         return repo.has(id);
     }
+
+    public List<Task> search(String query) {
+        return repo.findAll().stream()
+                .filter(task -> ((SimpleTask) task).data().title().contains(query))
+                .toList();
+    }
 }