domovoy_bot/WEB_USER_MANAGEMENT.md
Admin cef2ac3714 v1.19 ИГ рассылка + объявления 14 дней + настройки
🔥 ОБЪЯВЛЕНИЯ:
• Срок действия: 7 → 14 дней

🎯 ИНИЦИАТИВНАЯ ГРУППА:
• Добавлена кнопка 'Рассылка ИГ' в меню
• Команда /ig_broadcast для членов ИГ
• Поддержка текста + фото + файлов
• Настройка лимита в веб-панели

⚙️ ВЕБ-ПАНЕЛЬ:
• Новая страница /settings
• Настройка лимита рассылки ИГ (секунды)
• Кнопки статистики фильтруют пользователей
• Индикатор активного фильтра

🎨 UI:
• Исправлен <font> → emoji (Telegram не поддерживает)
• Цветные заголовки через emoji

📁 ФАЙЛЫ:
• handlers/ads.py: 14 дней
• handlers/initiative_group.py: рассылка ИГ
• web/app.py: API настроек
• web/templates/settings.html: страница настроек
• utils/ui_styles.py: без <font> тегов
• database: settings table

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
2026-03-10 17:01:30 +00:00

153 lines
5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🖥️ ВЕБ-ПАНЕЛЬ: УПРАВЛЕНИЕ ПОЛЬЗОВАТЕЛЯМИ
**Обновлено:** 8 марта 2026
**Версия:** v1.18
**Статус:** ✅ РЕАЛИЗОВАНО
---
## 🎯 ЧТО ДОБАВЛЕНО
Теперь в веб-панели есть **полное управление пользователями**:
| Кнопка | Действие |
|--------|----------|
| ✏️ | Редактировать (квартира, телефон, рейтинг) |
| ✅ / ❌ | Верифицировать / Отозвать |
| 🚫 / 🔓 | Забанить / Разбанить |
| 🖤 | **Назначить админом** (НОВОЕ!) |
| 🩵 | **Добавить в ИГ** (НОВОЕ!) |
---
## 📊 КАК ВЫГЛЯДИТ ТАБЛИЦА
```
ID | Имя | Username | Квартира | Телефон | Вериф. | Бан | Рейтинг | ДЕЙСТВИЯ
--------|---------------|----------|----------|---------------|--------|------|---------|----------
197957361 | Александр | @admin | 152 | +7999... | ✅ Да | ❌ Нет | 500 | ✏️ 🖤 🩵
123456789 | Иван | @ivan | 45 | +7999... | ❌ Нет | ❌ Нет | 50 | ✏️ ✅ 🖤 🩵
```
---
## 🔘 НОВЫЕ КНОПКИ
### 1. 🖤 Назначить админом
**Нажми** → Подтверждение → Готово!
**Что делает:**
- ✅ Устанавливает `is_admin=True`
- ✅ Пользователь получает доступ к админке
- ✅ Видит кнопку "⚙️ Админ-панель"
**Обратная кнопка:** 🖤 (контур) — Снять админа
---
### 2. 🩵 Добавить в ИГ
**Нажми** → Подтверждение → Готово!
**Что делает:**
- ✅ Добавляет в `InitiativeGroup` с ролью `member`
- ✅ Пользователь видит кнопку "🎯 Инициативная группа"
- ✅ Имеет доступ к функциям ИГ
**Обратная кнопка:** 🩵 (контур) — Удалить из ИГ
---
## 🎯 ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ
### Сценарий 1: Назначить админа
1. Зайди на `/users`
2. Найди пользователя (поиск по имени/квартире)
3. Нажми 🖤 **Назначить админом**
4. Подтверди
5. ✅ Готово!
---
### Сценарий 2: Добавить в ИГ
1. Зайди на `/users`
2. Найди пользователя
3. Нажми 🩵 **Добавить в ИГ**
4. Подтверди
5. ✅ Готово!
---
### Сценарий 3: Полный цикл
**Дано:** Новый жилец, активист, хочет помочь
**Делаем:**
1. ✏️ Редактировать → Квартира: 45, Телефон: +7999...
2. ✅ Верифицировать
3. 🩵 Добавить в ИГ
4. (Опционально) 🖤 Назначить админом
**Результат:**
- ✅ Верифицирован
-В Инициативной Группе
- ✅ Имеет доступ ко всем функциям
---
## 🔧 API ENDPOINTS
| Endpoint | Метод | Описание |
|----------|-------|----------|
| `/api/user/{id}/make_admin` | POST | Назначить админом |
| `/api/user/{id}/remove_admin` | POST | Снять админа |
| `/api/user/{id}/add_to_ig` | POST | Добавить в ИГ |
| `/api/user/{id}/remove_from_ig` | POST | Удалить из ИГ |
---
## ✅ ПРОВЕРКА
### 1. Зайди в веб-админку:
```
http://0.0.0.0:8000/users
```
### 2. Проверь кнопки:
- [ ] 🖤 Назначить админом
- [ ] 🩵 Добавить в ИГ
- [ ] ✏️ Редактировать
- [ ] ✅ Верифицировать
### 3. Протестируй:
- Назначь админа → проверь в боте
- Добавь в ИГ → проверь в боте
---
## 💡 СОВЕТЫ
1. **Админов назначай осторожно** — это доступ ко всем функциям
2. **ИГ — только активные** — те кто реально помогает
3. **Проверяй перед назначением** — убедись что человек надёжный
4. **Веди список** — запиши кого и когда назначил
---
## 📊 СРАВНЕНИЕ: ВЕБ vs TELEGRAM
| Действие | Веб-панель | Telegram |
|----------|------------|----------|
| Назначить админа | ✅ 1 клик | ❌ Нет команды |
| Добавить в ИГ | ✅ 1 клик | ✅ `/ig_add` |
| Редактировать | ✅ Модалка | ✅ `/edit_user` |
| Верифицировать | ✅ 1 клик | ✅ `/verify` |
| Массовое | ❌ По одному | ❌ По одному |
---
**by MatrixHasYou** 🏠
**Полное управление пользователями в веб-панели!** 🖥️✅