e06a3825ba
✅ Проведено полное тестирование функционала: - Меню жильца (11 кнопок) - Меню админа (17 кнопок) - База данных (проверка записей) - Уникальность callback_data - Сообщения в личку (без спама) 📝 Созданные файлы: - tests/run_tests.py — автотесты - tests/TEST_REPORT.md — отчёт о тестировании - tests/COMPREHENSIVE_TEST_PLAN.md — план тестов - send_test_report.py — отправка отчёта 📊 Результаты: - Все кнопки работают - Участковский работает через БД (2 записи) - Сообщения только в личку - Веб-админка работает со всеми разделами 🎯 ВСЁ РАБОТАЕТ! Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
179 lines
5.6 KiB
Markdown
179 lines
5.6 KiB
Markdown
# 🌐 ВЕБ-АДМИНКА 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** 🏠
|