Add initial project structure and documentation for Java learning project "java_09"

Author: stden

CLAUDE.md

@@ -0,0 +1,138 @@
+# 🎓 Учебный Java-проект: от JDBC до веб-приложений ("java_09")
+
+Этот проект — практическая песочница для изучения ключевых технологий Java-разработки. Вы пройдете путь от основ работы с базами данных до создания полноценного многомодульного веб-приложения.
+
+-----
+
+## 🎯 Цель и философия проекта
+
+Главная цель — не просто показать, *как* работает технология, а *почему* выбрано именно такое решение. Проект спроектирован так, чтобы наглядно продемонстрировать эволюцию подходов к хранению данных и построению веб-архитектуры. Он идеально подходит для:
+
+  * **Начинающих Java-разработчиков**, желающих увидеть, как теория применяется на практике.
+  * **Студентов**, изучающих базы данных, веб-технологии и многопоточность.
+  * **Всех, кто хочет освежить знания** по классическому стеку Java (Servlets, JDBC) перед изучением современных фреймворков вроде Spring.
+
+-----
+
+## 🏗️ Архитектура и структура модулей
+
+Проект построен на **Apache Maven** и разделен на независимые модули. Это позволяет изучать каждую технологию изолированно, не отвлекаясь на сложность всего приложения.
+
+### 📦 Модули проекта
+
+Каждый модуль — это отдельный мини-проект со своей задачей.
+
+  * **`01_JDBC`** — **Основы работы с базами данных**
+
+      * **Ключевые концепции**: Прямое взаимодействие с PostgreSQL через **JDBC**.
+      * **Что внутри**:
+          * `PreparedStatement` для безопасной работы с SQL-запросами и защиты от инъекций.
+          * **Пул соединений (Connection Pool)** для оптимизации производительности.
+          * Простейший веб-интерфейс (JSP + Servlets) для CRUD-операций (Create, Read, Update, Delete).
+          * Тесты на **JUnit** и **Cucumber** для проверки логики работы с БД.
+
+  * **`webapp`** — **Центральный модуль: веб-приложение "База резюме"**
+
+      * **Ключевые концепции**: Архитектура веб-приложения, паттерн "Strategy", эволюция хранилищ данных.
+      * **Что внутри**:
+          * **Модель данных**: Классы `Resume`, `Contact`, `Organization` и др.
+          * **Слой хранения (Storage Layer)**:
+              * Интерфейс `IStorage` определяет контракт для всех видов хранилищ.
+              * **Примитивные реализации (в памяти)**: `ArrayStorage` и `MapStorage` для демонстрации базовых коллекций.
+              * **Файловые реализации**: `FileStorage` (сериализация), `XmlStorage` (JAXB), `JsonStorage` (GSON/Jackson) — показывают разные способы персистентности.
+              * **База данных**: `SqlStorage` — наиболее "боевая" реализация на PostgreSQL.
+          * **Веб-слой**: Классические **Servlets** в роли контроллеров и **JSP** в роли представлений.
+          * **Тестирование**: Полное покрытие тестами всех реализаций `IStorage`.
+
+  * **`02_SwingThreads`** — **Многопоточность в GUI**
+
+      * **Ключевые концепции**: Проблема "замораживания" UI и её решение с помощью фоновых потоков (`SwingWorker`).
+      * **Что внутри**: Простое десктопное приложение на **Swing**, выполняющее долгую операцию без блокировки интерфейса.
+
+  * **`WebCalc`** и **`NetworkInterfaces`**
+
+      * **Ключевые концепции**: Микро-примеры для демонстрации базовой работы сервлетов и сетевых API Java.
+
+-----
+
+## 🛠️ Технологический стек
+
+  * **☕ Язык**: Java 21
+  * **📦 Сборка**: Apache Maven
+  * **🗄️ База данных**: PostgreSQL
+  * **🌐 Веб**: Java Servlets, JSP
+  * **🧪 Тестирование**: JUnit 5, Cucumber
+  * **📄 Работа с файлами**: JAXB (для XML), Java Serialization
+  * **🖥️ GUI**: Swing
+
+-----
+
+## 🚀 Быстрый старт и запуск
+
+Следуйте этим шагам, чтобы запустить проект локально.
+
+### 1\. Предварительные требования
+
+  * **Java 21 JDK**
+  * **Apache Maven**
+  * **PostgreSQL** (рекомендуется версия 13+)
+  * **Git**
+  * **IDE** (например, IntelliJ IDEA) с поддержкой Maven и сервера приложений (Tomcat).
+
+### 2\. Настройка базы данных
+
+Выполните следующие SQL-команды, чтобы создать базу данных и пользователя.
+
+```sql
+CREATE DATABASE resumes;
+CREATE USER topjava WITH PASSWORD 'password';
+GRANT ALL PRIVILEGES ON DATABASE resumes TO topjava;
+```
+
+### 3\. Конфигурация проекта
+
+Скопируйте файлы-примеры конфигурации и укажите в них свои данные для подключения к БД:
+
+  * В модуле `01_JDBC`: скопируйте `db.properties.template` в `db.properties`.
+  * В модуле `webapp`: скопируйте `webapp.properties.template` в `webapp.properties`.
+
+### 4\. Сборка и тестирование
+
+Откройте терминал в корневой папке проекта и выполните:
+
+```bash
+# Сборка всех модулей и запуск тестов
+mvn clean install
+```
+
+### 5\. Запуск веб-приложения (`webapp`)
+
+Проще всего запустить приложение из вашей IDE:
+
+1.  Настройте конфигурацию запуска для **Apache Tomcat**.
+2.  Добавьте артефакт `webapp.war` (или `webapp:war exploded`) в деплоймент.
+3.  Запустите сервер. Приложение будет доступно по адресу `http://localhost:8080/webapp`.
+
+-----
+
+## 📐 Ключевые концепции и принципы
+
+Этот проект — не просто набор кода, а демонстрация важных инженерных практик.
+
+  * **Модульность**: Разделение на независимые компоненты упрощает понимание и переиспользование кода.
+  * **Принцип подстановки Барбары Лисков (LSP из SOLID)**: Благодаря интерфейсу `IStorage` мы можем легко заменить хранилище в памяти на хранилище в БД без изменения бизнес-логики.
+  * **Паттерн "Стратегия"**: Разные реализации `IStorage` — это и есть стратегии хранения данных.
+  * **Тестирование**: Проект показывает, как писать юнит-тесты (JUnit) для проверки отдельных классов и BDD-тесты (Cucumber) для проверки поведения всей системы.
+  * **CI/CD**: В репозитории есть готовые конфигурационные файлы для **GitHub Actions** и **GitLab CI**, включающие сборку, тестирование и анализ покрытия кода с помощью **JaCoCo**.
+
+-----
+
+## 🌱 Возможные доработки и вклад в проект
+
+Этот проект можно и нужно развивать! Вот несколько идей:
+
+1.  **Рефакторинг на Spring**: Переписать `webapp` с использованием Spring Boot/MVC/Data JPA, чтобы сравнить классический подход с современным.
+2.  **Добавить REST API**: Реализовать REST-контроллеры для управления резюме и "оживить" их с помощью простого фронтенда на JavaScript.
+3.  **Контейнеризация**: Добавить `Dockerfile` и `docker-compose.yml` для запуска всего приложения (веб-сервер + база данных) в один клик.
+4.  **Улучшить UI**: Заменить JSP на более современный шаблонизатор (например, Thymeleaf) или создать полноценный SPA-фронтенд (React/Vue).
+5.  **Добавить новые реализации `IStorage`**: Например, для работы с MongoDB или другим NoSQL-хранилищем.