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

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

---

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

### 📖 [ДОКУМЕНТАЦИЯ.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!** 📮

---

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

### 1. Установка

**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

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