# 🌐 ВЕБ-АДМИНКА 2.0 — ПОЛНОЦЕННОЕ УПРАВЛЕНИЕ

**Версия:** 2.0.0  
**Дата:** 1 марта 2026  
**Статус:** ✅ ГОТОВО

---

## 🎯 ЧТО РЕАЛИЗОВАНО

### ✅ Веб-интерфейс управления:

| Раздел | Функции |
|--------|---------|
| **📊 Дашборд** | Статистика, топ пользователей, активные опросы |
| **👥 Пользователи** | Просмотр, поиск, редактирование, бан/разбан, верификация |
| **🛡️ Верификация** | Одобрение/отклонение заявок, отзыв верификации |
| **📞 Телефоны** | Просмотр и редактирование телефонов |
| **📥 Экспорт** | Экспорт данных в JSON |
| **⚙️ Настройки** | Конфигурация бота |

---

## 🔧 API ENDPOINTS

### Пользователи:

| Метод | Endpoint | Описание |
|-------|----------|----------|
| GET | `/api/users` | Список пользователей |
| GET | `/api/user/{id}` | Данные пользователя |
| POST | `/api/user/{id}/update` | Обновить данные (квартира, телефон, рейтинг) |
| POST | `/api/user/{id}/ban` | Забанить |
| POST | `/api/user/{id}/unban` | Разбанить |
| POST | `/api/user/{id}/verify` | Верифицировать |
| POST | `/api/user/{id}/unverify` | Отозвать верификацию |
| POST | `/api/user/{id}/phone` | Обновить телефон |

### Верификация:

| Метод | Endpoint | Описание |
|-------|----------|----------|
| GET | `/verification` | Страница управления верификацией |
| POST | `/api/verification/{id}/approve` | Одобрить заявку |
| POST | `/api/verification/{id}/reject` | Отклонить заявку |

### Телефоны:

| Метод | Endpoint | Описание |
|-------|----------|----------|
| GET | `/phones` | Страница управления телефонами |

---

## 📱 КАК ИСПОЛЬЗОВАТЬ

### 1. Войти в веб-админку:

```
URL: http://0.0.0.0:8000
Логин: MatrixHasYou
Пароль: 5nMVkjd5nMVkjd
```

### 2. Управление пользователями:

- Открой `/users`
- Найди пользователя через поиск
- Нажми ✏️ чтобы редактировать (квартира, телефон, рейтинг)
- Используй кнопки:
  - 🔒 Забанить
  - 🔓 Разбанить
  - 🛡️✅ Верифицировать
  - 🛡️❌ Отозвать верификацию

### 3. Управление верификацией:

- Открой `/verification`
- Посмотри заявки на верификацию
- Одобрить или отклонить кнопками
- Посмотри непроверенных пользователей

### 4. Телефоны:

- Открой `/phones`
- Нажми "Редактировать" у пользователя
- Введи новый телефон
- Сохрани

---

## 🎨 СТРУКТУРА ФАЙЛОВ

```
web/
├── app.py              # FastAPI приложение
├── templates/
│   ├── dashboard.html  # Дашборд
│   ├── users.html      # Пользователи (с редактированием)
│   ├── verification.html # Верификация
│   ├── phones.html     # Телефоны
│   ├── export.html     # Экспорт
│   └── settings.html   # Настройки
└── static/             # CSS, JS, изображения
```

---

## 🔐 БЕЗОПАСНОСТЬ

- ✅ HTTP Basic авторизация
- ✅ Пароль в конфиге
- ✅ Только для админов
- ✅ Логи всех действий

---

## 🚀 ЗАПУСК

Веб-сервер запускается автоматически вместе с ботом:

```bash
./start.sh
```

Порт: `8000`  
Логин/пароль из `config.py`:
- `WEB_ADMIN_LOGIN`
- `WEB_ADMIN_PASSWORD`

---

## 📊 ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ

### Забанить пользователя:

```bash
curl -u MatrixHasYou:5nMVkjd5nMVkjd \
     -X POST http://localhost:8000/api/user/123456789/ban
```

### Верифицировать:

```bash
curl -u MatrixHasYou:5nMVkjd5nMVkjd \
     -X POST http://localhost:8000/api/user/123456789/verify
```

### Обновить телефон:

```bash
curl -u MatrixHasYou:5nMVkjd5nMVkjd \
     -X POST http://localhost:8000/api/user/123456789/phone \
     -H "Content-Type: application/json" \
     -d '{"phone": "+79991234567"}'
```

---

## ⚠️ ВАЖНО

1. **Веб-админка работает только внутри сети** — не открывай порт 8000 наружу!
2. **Используй HTTPS** для продакшена (добавь SSL сертификат)
3. **Смени пароль** в `config.py` перед продакшеном

---

## 🎯 СЛЕДУЮЩИЕ УЛУЧШЕНИЯ (TODO)

- [ ] Управление опросами (создание/закрытие)
- [ ] Управление объявлениями (модерация)
- [ ] Управление событиями
- [ ] Логи действий админа
- [ ] Рассылка сообщений через веб-интерфейс
- [ ] Графики и диаграммы на дашборде

---

**by MatrixHasYou** 🏠
