Readme

README.md

@@ -1,28 +1,100 @@
-# Hackathon React - Team Portfolio 🚀
+# Hackathon React - Team Portfolio
 
-Сайт-портфолио команды из 6 разработчиков с использованием **FSD (Feature-Sliced Design)** архитектуры.
+Сайт-портфолио команды из 6 разработчиков с использованием **Feature-Sliced Design (FSD)** архитектуры.
 
-## 🛠 Технологический стек
+## Особенности проекта
 
-- **React 18** - основной фреймворк
+- **Командная разработка** - 6 разработчиков работали над разными частями проекта
+- **Современная архитектура** - использование FSD для масштабируемости и поддержки
+- **Интерактивные элементы** - слайдер, избранное, переключение видов
+- **Responsive дизайн** - адаптация под все устройства
+
+## Технологический стек
+
+- **React 19** - основной фреймворк
 - **Vite** - сборщик и dev-сервер
 - **SCSS** - стили (без модулей)
 - **React Router DOM** - роутинг
 - **PropTypes** - типизация
 - **FSD Architecture** - архитектура проекта
 
+## Демо
 
-## Посмотреть сайт:
-
-[https://karez79.github.io/hackathon-react/](https://karez79.github.io/hackathon-react/)
-
+**Посмотреть сайт:** [https://hackathon-react-mocha.vercel.app/](https://hackathon-react-mocha.vercel.app/)
 
 ## Инструкции по установке и запуску:
 
 1. Клонируйте репозиторий: `git clone git@github.com:Karez79/hackathon-react.git`
 2. Перейдите в директорию проекта: `cd hackathon-react`
 3. Установите зависимости: `npm install`
 4. Запустите проект: `npm run dev`
-5. В браузере открываем `http://localhost:5173/hackathon-react/`
+5. В браузере открываем `http://localhost:5173/`
+
+## Наша команда
+
+### [Иван](https://github.com/Karez79) - Frontend Developer
+**Контакты:** [GitHub](https://github.com/Karez79)
+
+Создал основные страницы приложения, настроил маршрутизацию и организовал структуру проекта согласно FSD архитектуре. Отвечал за главную страницу, страницу избранного и общую координацию команды.
+
+---
+
+### [Никита](https://github.com/NekitMir) - Frontend Developer
+**Контакты:** [GitHub](https://github.com/NekitMir)
+
+Разрабатывал переиспользуемые компоненты и базовые UI-элементы. Создавал модульные решения для команды и отвечал за визуальные компоненты карточек участников.
+
+---
+
+### [Илья](https://github.com/Desair1) - Frontend Developer
+**Контакты:** [GitHub](https://github.com/Desair1)
+
+Разработал карточки участников на главной странице и систему лейблов. Отвечал за интерактивные элементы интерфейса и их визуальное представление.
+
+---
+
+### [Александр](https://github.com/alexander2555) - Frontend Developer
+**Контакты:** [GitHub](https://github.com/alexander2555)
+
+Создал цветовую тему всего приложения и разработал детальную страницу участников. Работал с дизайн-системой и обеспечивал визуальную целостность проекта.
+
+---
+
+### [Егор](https://github.com/Madakalov-front) - Frontend Developer
+**Контакты:** [GitHub](https://github.com/Madakalov-front)
+
+Создал слайдер для просмотра участников, реализовал работу с Local Storage для сохранения избранного и разработал переключатель между слайдером и сеткой карточек.
+
+---
+
+### [Дамир](https://github.com/damaxGmail) - Frontend Developer
+**Контакты:** [GitHub](https://github.com/damaxGmail)
+
+Создал страницу 404 и реализовал Error Boundary для корректной обработки ошибок в приложении, обеспечив стабильность пользовательского опыта.
+
+## Архитектура проекта
+
+Проект построен на основе **Feature-Sliced Design (FSD)** архитектуры, что обеспечивает:
+
+- **Масштабируемость** - легкое добавление новых функций
+- **Поддержка** - понятная структура для всех участников команды
+- **Переиспользование** - модульные компоненты и утилиты
+- **Тестируемость** - изолированные слои приложения
+
+## Основной функционал
+
+### Главная страница
+- Отображение всех участников команды в виде карточек
+- Переключение между слайдером и сеткой
+- Добавление участников в избранное
+
+### Страница участника
+- Подробная информация о каждом разработчике
+- Технологический стек
+- Контактная информация
+- Интересные факты
 
+### Избранное
+- Сохранение выбранных участников в Local Storage
 
+Этот проект стал результатом слаженной работы команды из 6 разработчиков, каждый из которых внес свой уникальный вклад в создание современного и функционального веб-приложения. Мы продемонстрировали навыки командной разработки, следования архитектурным принципам и создания качественного пользовательского опыта.