From 3f41915ab894f7003002437592e45cb2bcd7e3d1 Mon Sep 17 00:00:00 2001
From: Dmitry Belan <dima0409081@gmail.com>
Date: Wed, 1 Jul 2026 13:50:04 +0300
Subject: [PATCH] Add comprehensive README with project description and Git
 practice tasks

---
 README.md | 166 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 165 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index ea8ec69..dfd7bc0 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,166 @@
-# Igor-kr
+# 🌱 Farm Automation System
 
+Учебный проект для практики работы с Git: слияние конфликтов и интерактивный ребейз.
+
+## Описание проекта
+
+Простая система автоматизации гидропонной фермы на Python с использованием ООП:
+
+- **BioCulture** — класс биокультуры со стадиями роста ("Зеленый" → "Красный")
+- **HydroponicModule** — модуль, управляющий несколькими культурами
+- **FarmAgent** — агент-оператор для управления модулем и сбора урожая
+
+## Структура проекта
+
+```
+Igor-kr/
+├── main.py              # Точка входа
+├── farm_core/
+│   ├── __init__.py
+│   ├── module.py        # Классы BioCulture и HydroponicModule
+│   └── agent.py         # Класс FarmAgent
+└── README.md
+```
+
+## Ветки
+
+- **main** — базовая заготовка со "сломанным" методом `grow()` (вызывает `NotImplementedError`)
+- **feature-api** — рабочая реализация метода `grow()` и новая функция `harvest()`
+
+## 🎯 Практические задания
+
+### Задание 1: Разрешение конфликтов при слиянии
+
+**Цель:** Научиться разрешать merge conflicts.
+
+**Шаги:**
+
+1. Убедитесь, что вы на ветке `main`:
+   ```bash
+   git checkout main
+   ```
+
+2. Попытайтесь слить ветку `feature-api`:
+   ```bash
+   git merge feature-api
+   ```
+
+3. **Ожидаемый результат:** Конфликт в файле `farm_core/module.py` в методе `grow()`:
+   - В `main`: `raise NotImplementedError("Рост не реализован в main!")`
+   - В `feature-api`: `self._stage = "Красный"`
+
+4. Откройте файл `farm_core/module.py` и разрешите конфликт:
+   - Удалите маркеры конфликта (`<<<<<<<`, `=======`, `>>>>>>>`)
+   - Оставьте рабочую реализацию из `feature-api`
+
+5. Завершите слияние:
+   ```bash
+   git add farm_core/module.py
+   git commit -m "Resolve merge conflict in grow() method"
+   ```
+
+### Задание 2: Интерактивный ребейз (очистка истории)
+
+**Цель:** Научиться объединять "мусорные" коммиты в один чистый коммит.
+
+**Шаги:**
+
+1. Переключитесь на ветку `feature-api`:
+   ```bash
+   git checkout feature-api
+   ```
+
+2. Посмотрите на историю коммитов:
+   ```bash
+   git log --oneline -5
+   ```
+
+   Вы увидите три мусорных коммита:
+   ```
+   9ae915a done
+   930b346 fix2
+   f358639 fix
+   eaafccb Implement grow method and harvest function
+   ```
+
+3. Запустите интерактивный ребейз для последних 3 коммитов:
+   ```bash
+   git rebase -i HEAD~3
+   ```
+
+4. В открывшемся редакторе измените команды:
+   ```
+   pick f358639 fix
+   squash 930b346 fix2
+   squash 9ae915a done
+   ```
+   (Или используйте `fixup` вместо `squash`, чтобы отбросить сообщения коммитов)
+
+5. Сохраните и закройте редактор. В следующем редакторе напишите новое сообщение коммита:
+   ```
+   Clean up: remove debug comments
+   ```
+
+6. Проверьте результат:
+   ```bash
+   git log --oneline -3
+   ```
+
+   Теперь вместо трех мусорных коммитов — один чистый коммит.
+
+### Задание 3 (дополнительно): Проверка работы кода
+
+1. Переключитесь на `main` после успешного слияния
+2. Допишите в `main.py` цикл для проверки работы:
+   ```python
+   for culture in module.cultures:
+       culture.grow()
+   
+   print(f"Готово к сбору: {agent.harvest()} культур(ы)")
+   ```
+
+3. Запустите код:
+   ```bash
+   python main.py
+   ```
+
+**Ожидаемый вывод:**
+```
+Инструкция: pH 6.0
+Готово к сбору: 3 культур(ы)
+```
+
+## 📚 Полезные команды Git
+
+```bash
+# Просмотр статуса
+git status
+
+# Просмотр истории
+git log --oneline --graph --all
+
+# Просмотр изменений
+git diff
+
+# Отмена изменений (до коммита)
+git restore <file>
+
+# Просмотр веток
+git branch -a
+
+# Создание новой ветки
+git checkout -b <branch-name>
+```
+
+## ✅ Критерии успешного выполнения
+
+- [ ] Конфликт в `module.py` успешно разрешен
+- [ ] Метод `grow()` работает корректно (изменяет стадию на "Красный")
+- [ ] Три мусорных коммита объединены в один
+- [ ] История коммитов чистая и понятная
+- [ ] Код запускается без ошибок
+
+---
+
+**Автор:** Dmitry Belan  
+**Дата:** 2026-07-01