domovoy_bot/ВЕБ-АДМИНКА_2.0.md
Admin 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>
2026-03-01 20:00:56 +00:00

5.6 KiB
Raw Blame History

🌐 ВЕБ-АДМИНКА 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 авторизация
  • Пароль в конфиге
  • Только для админов
  • Логи всех действий

🚀 ЗАПУСК

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

./start.sh

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

  • WEB_ADMIN_LOGIN
  • WEB_ADMIN_PASSWORD

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

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

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

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

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

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

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 🏠