# MC Panel - Панель управления Minecraft серверами

**Версия:** 1.0.0  
**Дата:** 15 января 2026

---

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

### 🎉 [ПРОЕКТ_ЗАВЕРШЁН.md](ПРОЕКТ_ЗАВЕРШЁН.md)
**Полный обзор проекта**

Comprehensive overview всего проекта:
- ✅ Все выполненные задачи (11 шт.)
- 📊 Статистика проекта
- 🎯 Основные возможности
- 🚀 Быстрый старт (3 варианта)
- 🏆 Достижения

**Начните отсюда для общего понимания!** 🌟

### 📋 [ФИНАЛЬНЫЙ_СПИСОК.md](ФИНАЛЬНЫЙ_СПИСОК.md)
**Полный список всех файлов**

Детальный список всех файлов проекта:
- 📁 Структура проекта (60+ файлов)
- 📊 Статистика кода (~20,000 строк)
- 📚 Навигация по документации
- 🎯 Выполненные задачи (14 шт.)
- 🏆 Достижения

**Полная карта проекта!** 🗺️

### ✅ [CHECKLIST.md](CHECKLIST.md)
**Финальный Checklist**

Проверка завершения всех работ:
- ✅ Все задачи (14/14 - 100%)
- ✅ Все файлы (65+)
- ✅ Вся функциональность
- ✅ Вся документация
- 🚀 Production Ready

**Подтверждение готовности!** ✔️

---

### 📖 [ДОКУМЕНТАЦИЯ.md](ДОКУМЕНТАЦИЯ.md)
**Полная документация проекта**

Содержит всю информацию о проекте:
- 🚀 Быстрый старт
- ⚙️ Установка и настройка
- 🎮 Функциональность
- 🔔 Система уведомлений
- 🎨 Дизайн и темы
- 📁 Файловый менеджер
- 🎫 Система тикетов
- 👤 Личный кабинет
- 🔐 OpenID Connect
- 👥 Роли пользователей
- 🔒 Безопасность
- 🔧 Troubleshooting

**Начните отсюда!** 👈

---

### 🌐 [API.md](API.md)
**Документация API**

Полное описание REST API:
- 📋 Все эндпоинты (37 шт.)
- 🔐 Аутентификация
- 👥 Управление пользователями
- 🖥️ Управление серверами
- 📁 Управление файлами
- 🎫 Тикеты
- 💡 Примеры интеграции (Python, JavaScript, cURL)
- 📦 Postman коллекция

**Для разработчиков!** 👨‍💻

---

### 📦 [MC_Panel_API.postman_collection.json](MC_Panel_API.postman_collection.json)
**Postman коллекция**

Готовая коллекция для тестирования API:
- 40+ готовых запросов
- Автоматическое сохранение токена
- Переменные окружения
- Примеры тел запросов

**Импортируйте в Postman!** 📮

---

### 🐳 [DOCKER.md](DOCKER.md)
**Docker и CI/CD**

Полная документация по контейнеризации и деплою:
- 🐳 Dockerfile (multi-stage build)
- 🔧 Docker Compose
- 🚀 CI/CD с Drone
- 🌐 Nginx конфигурация
- 📦 Production deployment
- 🔒 Безопасность

**Для деплоя на сервер!** 🚀

### 📋 [DOCKER_COMMANDS.md](DOCKER_COMMANDS.md)
**Docker команды - Quick Reference**

Быстрый справочник по Docker командам:
- 🚀 Запуск и остановка
- 📊 Логи и мониторинг
- 🔧 Обслуживание и обновление
- 🐛 Troubleshooting
- 💡 Полезные алиасы

**Шпаргалка по командам!** 📝

### 🔧 [INSTALL_DOCKER.md](INSTALL_DOCKER.md)
**Установка Docker на Windows**

Пошаговая инструкция по установке Docker:
- 📋 Системные требования
- 🚀 Установка Docker Desktop
- 🔧 Настройка WSL 2
- ✅ Проверка работы
- 🐛 Troubleshooting

**Для новичков в Docker!** 🐳

### ❓ [FAQ.md](FAQ.md)
**Часто задаваемые вопросы**

Ответы на популярные вопросы:
- 📋 Общие вопросы
- 🚀 Установка и запуск
- 🐳 Docker
- 🔐 Аутентификация
- 🖥️ Серверы и файлы
- 🐛 Troubleshooting

**Решение проблем!** 💡

---

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

> **⚡ Хотите запустить за 5 минут?** Читайте [QUICKSTART.md](QUICKSTART.md)

### Вариант 1: Docker (рекомендуется) 🐳

```bash
# 1. Настройте переменные окружения
cp .env.example .env
# Отредактируйте .env файл

# 2. Запустите
docker-compose up -d

# 3. Откройте http://localhost:8000
```

**Подробнее:** [DOCKER.md](DOCKER.md)

### Вариант 2: Локальная установка

**Backend:**
```bash
cd backend
pip install -r requirements.txt
python main.py
```

**Frontend:**
```bash
cd frontend
npm install
npm run dev
```

### 2. Первый вход

1. Откройте `http://localhost:3000`
2. Зарегистрируйтесь (первый пользователь = admin)
3. Создайте сервер
4. Загрузите `server.jar`
5. Запустите сервер!

**Учетные данные по умолчанию:**
- Логин: `Root`
- Пароль: `Admin`

---

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

- 🖥️ **Управление серверами** - запуск, остановка, мониторинг
- 📁 **Файловый менеджер** - полное управление файлами
- 💬 **Консоль** - команды и логи в реальном времени
- 📊 **Статистика** - CPU, RAM, диск
- 🎫 **Тикеты** - система поддержки
- 👥 **Пользователи** - роли и права доступа
- 🔐 **OpenID Connect** - интеграция с ZITADEL
- 🎨 **6 тем** - включая современную темную
- 🔔 **Уведомления** - о всех событиях
- 👤 **Личный кабинет** - профиль и статистика

---

## 🛠️ Технологии

**Backend:**
- FastAPI (Python)
- JWT аутентификация
- WebSocket
- Authlib (OpenID Connect)

**Frontend:**
- React 18
- Tailwind CSS
- Axios
- Lucide React

---

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

```
mc-panel/
├── backend/
│   ├── main.py              # FastAPI приложение
│   ├── oidc_config.py       # OpenID Connect
│   ├── requirements.txt     # Зависимости
│   └── servers/            # Папка серверов
├── frontend/
│   ├── src/
│   │   ├── App.jsx         # Главный компонент
│   │   ├── components/     # React компоненты
│   │   └── themes.js       # Темы
│   └── package.json        # npm зависимости
├── ДОКУМЕНТАЦИЯ.md          # Документация проекта
├── API.md                  # API документация
├── MC_Panel_API.postman_collection.json  # Postman
└── README.md               # Этот файл
```

---

## 🔒 Безопасность

- JWT токены (7 дней)
- Bcrypt хеширование паролей
- Проверка прав доступа
- Защита файловой системы
- OpenID Connect поддержка

**Для production:**
1. Измените `SECRET_KEY` в `backend/main.py`
2. Используйте HTTPS
3. Настройте CORS
4. Используйте базу данных вместо JSON

---

## 📞 Поддержка

- **Документация:** [ДОКУМЕНТАЦИЯ.md](ДОКУМЕНТАЦИЯ.md)
- **API:** [API.md](API.md)
- **Тикеты:** Используйте систему тикетов в панели
- **GitHub:** [Ссылка на репозиторий]

---

## 📝 Лицензия

MIT License - свободное использование

---

## 🙏 Благодарности

Спасибо за использование MC Panel!

Если у вас есть вопросы или предложения:
1. Прочитайте документацию
2. Проверьте API документацию
3. Создайте тикет в системе

---

**Версия:** 1.0.0  
**Дата:** 15 января 2026

**Приятного использования!** 🎮