Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 81 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
# 📝 Changelog

Все важные изменения в проекте Space SQL документируются в этом файле.

Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.0.0/),
и проект следует [семантическому версионированию](https://semver.org/lang/ru/).

## [Unreleased]

### Планируется
- 🔄 Система прогресса пользователей
- 🏆 Достижения и бейджи
- 📊 Аналитика выполнения заданий
- 🌍 Интернационализация (i18n)
- 🔍 Поиск по урокам

## [2.0.0] - 2025-01-09

### ✨ Добавлено
- 🎨 **Полный рефакторинг фронтенда** с единой дизайн-системой
- 🌌 **Космическая тема** с анимированными звездами и эффектами
- 🎭 **Framer Motion** для плавных анимаций и переходов
- 🎨 **Tailwind CSS** с кастомной конфигурацией
- 🧩 **Система UI компонентов**: Button, Card, Input, Loading
- 🚀 **CosmicNavigation** - новая навигация в космическом стиле
- ⚡ **Page Transitions** - анимированные переходы между страницами
- 📱 **Полная адаптивность** для всех устройств
- 📚 **Обновленная документация** с дизайн-системой

### 🔄 Изменено
- 🏠 **Главная страница** - новый дизайн с hero секцией
- 🔐 **Формы аутентификации** - космический стиль с анимациями
- 📚 **Страница уроков** - карточки с hover эффектами
- ⚡ **Практические задания** - улучшенный интерфейс
- 🎯 **Состояния загрузки** - единые компоненты Loading

### ❌ Удалено
- 🗑️ **Bootstrap** зависимости полностью удалены
- 🗑️ **Старые стили** заменены на Tailwind
- 🗑️ **Inline стили** заменены на компоненты

### 🐛 Исправлено
- ✅ Консистентность дизайна на всех страницах
- ✅ Производительность анимаций
- ✅ Адаптивность на мобильных устройствах
- ✅ Доступность компонентов

## [1.0.0] - 2024-12-15

### ✨ Добавлено
- 🚀 Первый релиз Space SQL
- ⚛️ React 18 фронтенд
- ☕ Spring Boot 3 бэкенд
- 🗄️ PostgreSQL база данных
- 🔐 JWT аутентификация
- 📚 Система уроков
- ⚡ Практические задания
- 🎯 Проверка SQL запросов

### 🛠️ Техническое
- 📡 REST API с Swagger документацией
- 🗄️ Liquibase для миграций БД
- 🔒 Spring Security конфигурация
- 📝 Базовая документация

---

## Типы изменений

- ✨ **Добавлено** - новые возможности
- 🔄 **Изменено** - изменения в существующей функциональности
- 🗑️ **Устарело** - функции, которые скоро будут удалены
- ❌ **Удалено** - удаленные функции
- 🐛 **Исправлено** - исправления ошибок
- 🔒 **Безопасность** - уязвимости

## Ссылки

- [Unreleased]: https://github.com/your-username/space-sql/compare/v2.0.0...HEAD
- [2.0.0]: https://github.com/your-username/space-sql/compare/v1.0.0...v2.0.0
- [1.0.0]: https://github.com/your-username/space-sql/releases/tag/v1.0.0
146 changes: 120 additions & 26 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,27 +2,44 @@

<div align="center">
<h1>🚀 Space SQL</h1>
<p>Интерактивная платформа для изучения SQL в игровой форме</p>
<p><em>Интерактивная платформа для изучения SQL в космическом стиле</em></p>

[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Java](https://img.shields.io/badge/Java-17%2B-orange.svg)](https://java.com/)
[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.x-6DB33F.svg)](https://spring.io/projects/spring-boot)
[![React](https://img.shields.io/badge/React-18.x-61DAFB.svg)](https://reactjs.org/)
[![Tailwind CSS](https://img.shields.io/badge/Tailwind%20CSS-3.x-38B2AC.svg)](https://tailwindcss.com/)
[![Framer Motion](https://img.shields.io/badge/Framer%20Motion-10.x-FF0055.svg)](https://www.framer.com/motion/)

[Документация](docs/README.md) | [Установка](#установка) | [Разработка](#разработка) | [Лицензия](#лицензия)
[📚 Документация](docs/README.md) | [⚡ Быстрый старт](#быстрый-старт) | [🎨 Дизайн-система](docs/DESIGN_SYSTEM.md) | [🧩 Компоненты](docs/COMPONENTS.md)
</div>

## 📋 О проекте

Space SQL - это интерактивная образовательная платформа, которая помогает изучить SQL в увлекательной игровой форме. Проект разработан для пользователей, которые хотят освоить основы SQL и улучшить свои навыки работы с базами данных.
Space SQL - это современная интерактивная образовательная платформа с космической тематикой для изучения SQL. Проект сочетает в себе мощный бэкенд на Spring Boot и красивый фронтенд на React с анимациями и космическим дизайном.

### 🎯 Основные возможности
### ✨ Особенности

- 📚 Интерактивные уроки по SQL
- 🎯 Практические задания с автоматической проверкой
- 🏆 Система достижений и прогресса
- 👥 Профили пользователей
- 🔐 Безопасная аутентификация
- 🌌 **Космический дизайн** - уникальная тематика с анимированными звездами и плавными переходами
- 📚 **Интерактивные уроки** - пошаговое изучение SQL от основ до продвинутых тем
- ⚡ **Практические задания** - реальные задачи с автоматической проверкой SQL запросов
- 🎭 **Современный UI** - кастомная дизайн-система на Tailwind CSS и Framer Motion
- 🔐 **Безопасная аутентификация** - JWT токены и защищенные API endpoints
- 📱 **Адаптивность** - полная поддержка мобильных устройств и планшетов

### 🛠️ Технологический стек

**Backend:**
- ☕ Java 17 + Spring Boot 3.x
- 🗄️ PostgreSQL + Liquibase
- 🔒 Spring Security + JWT
- 📡 REST API + Swagger

**Frontend:**
- ⚛️ React 18 + React Router
- 🎨 Tailwind CSS + кастомная дизайн-система
- 🎭 Framer Motion для анимаций
- 📡 Axios для API запросов

## 🚀 Быстрый старт

Expand Down Expand Up @@ -62,23 +79,40 @@ Space SQL - это интерактивная образовательная п

## 🛠️ Разработка

### Структура проекта
### 📁 Структура проекта

```
space-sql/
├── backend/ # Бэкенд на Spring Boot
│ ├── src/ # Исходный код
│ ├── pom.xml # Maven конфигурация
│ └── ...
├── frontend/ # Фронтенд на React
│ ├── public/ # Статические файлы
│ ├── src/ # Исходный код React
│ └── ...
├── docs/ # Документация
│ ├── api/ # API документация
│ ├── guides/ # Руководства
│ └── ...
└── README.md # Этот файл
├── src/ # Backend (Spring Boot)
│ ├── main/java/com/spacesql/
│ │ ├── controller/ # REST контроллеры
│ │ ├── service/ # Бизнес-логика
│ │ ├── repository/ # Data Access Layer
│ │ ├── entity/ # JPA сущности
│ │ ├── dto/ # Data Transfer Objects
│ │ ├── config/ # Конфигурация Spring
│ │ └── security/ # Безопасность и JWT
│ └── main/resources/
│ ├── db/changelog/ # Liquibase миграции
│ └── application.properties
├── frontend/ # Frontend (React)
│ ├── src/
│ │ ├── components/ # React компоненты
│ │ │ ├── ui/ # Базовые UI компоненты
│ │ │ └── layout/ # Компоненты макета
│ │ ├── pages/ # Страницы приложения
│ │ ├── contexts/ # React контексты
│ │ ├── services/ # API сервисы
│ │ └── styles/ # Стили и дизайн-система
│ ├── tailwind.config.js # Конфигурация Tailwind
│ └── package.json
├── docs/ # Документация
│ ├── FRONTEND.md # Документация фронтенда
│ ├── COMPONENTS.md # Документация компонентов
│ ├── DESIGN_SYSTEM.md # Дизайн-система
│ └── api/ # API документация
├── pom.xml # Maven конфигурация
└── README.md # Этот файл
```

### Сборка
Expand Down Expand Up @@ -111,11 +145,71 @@ npm test

## 📚 Документация

Подробная документация доступна в [документации проекта](docs/README.md).
### 📖 Полная документация

| Документ | Описание |
|----------|----------|
| [📚 Фронтенд](docs/FRONTEND.md) | Подробная документация по React приложению |
| [🧩 Компоненты](docs/COMPONENTS.md) | Описание всех UI компонентов и их API |
| [🎨 Дизайн-система](docs/DESIGN_SYSTEM.md) | Космическая дизайн-система и стили |
| [📡 API](docs/api/SPECIFICATION.md) | Спецификация REST API |
| [🗄️ База данных](docs/architecture/database.md) | Схема и архитектура БД |

### 🚀 Скриншоты

<details>
<summary>🏠 Главная страница</summary>

*Космическая главная страница с анимированным фоном и hero секцией*

</details>

<details>
<summary>🔐 Аутентификация</summary>

*Красивые формы входа и регистрации с космическими эффектами*

</details>

<details>
<summary>📚 Уроки</summary>

*Интерактивные карточки уроков с hover эффектами*

</details>

<details>
<summary>⚡ Практика</summary>

*SQL редактор с подсветкой синтаксиса и проверкой запросов*

</details>

## 🤝 Участие в разработке

Мы приветствуем вклад в проект!

### 🛠️ Как начать разработку

1. Форкните репозиторий
2. Создайте ветку для новой функции (`git checkout -b feature/amazing-feature`)
3. Следуйте [стандартам кодирования](#стандарты-кодирования)
4. Убедитесь, что все тесты проходят
5. Создайте Pull Request

### 📋 Стандарты кодирования

## 🤝 Участие
**Frontend:**
- Используйте функциональные компоненты с хуками
- Следуйте космической дизайн-системе
- Добавляйте анимации с Framer Motion
- Тестируйте на всех устройствах

Вклады приветствуются! Пожалуйста, прочитайте [руководство по участию](CONTRIBUTING.md) для получения подробной информации о процессе отправки запросов на включение.
**Backend:**
- Следуйте принципам SOLID
- Используйте Spring Boot best practices
- Покрывайте код тестами
- Документируйте API с помощью Swagger

## 📄 Лицензия

Expand Down
Loading