domovoy_bot/INITIATIVE_GROUP_GUIDE.md

# 🎯 ИНИЦИАТИВНАЯ ГРУППА — ИНСТРУКЦИЯ

**Обновлено:** 5 марта 2026
**Статус:** ✅ РЕАЛИЗОВАНО

---

## 📋 ЧТО ТАКОЕ ИНИЦИАТИВНАЯ ГРУППА (ИГ)?

**Инициативная группа** — это активные жильцы, которые помогают управлять домом.

### Уровни доступа:

| Уровень | Доступ |
|---------|--------|
| **Неверифицированный** | Только телефоны + правила |
| **Верифицированный** | Все функции бота |
| **Инициативная группа** | Всё + меню ИГ |
| **Админ** | Всё + админ-панель |

---

## ✅ НАЗНАЧЕНИЕ В ИГ

### Можешь ли назначать НЕзависимо от верификации?

**ДА!** ✅ Верификация **НЕ требуется** для вступления в ИГ!

### Как назначить в ИГ:

```bash
# Добавить пользователя в ИГ
/ig_add <user_id> [роль]

# Роли:
# - member (обычный участник)
# - admin (админ ИГ)
# - coordinator (координатор)
```

**Примеры:**
```bash
/ig_add 197957361 admin
/ig_add 123456789 member
/ig_add 987654321 coordinator
```

---

## 🎯 МЕНЮ ИНИЦИАТИВНОЙ ГРУППЫ

Кнопка **"🎯 Инициативная группа"** появляется в главном меню только у участников ИГ!

### Что видит участник ИГ:

```
🎯 Инициативная группа

Вы — участник инициативной группы!

Ваши возможности:
• 📊 Статистика активности
• 📋 Список участников
• 📣 Обращения к администрации
• 🗳️ Голосования ИГ

[📊 Моя статистика]
[📋 Список ИГ]
[🔙 Назад]
```

### Моя статистика:
```
📊 Ваша статистика в ИГ

👤 Александр MatrixHasYou
🏠 Квартира: 152

🎭 Роль: admin
📅 В группе с: 05.03.2026

📊 Ваша активность:
• Сообщений: 150
• Рейтинг: 250
• Уровень: Активист
```

### Список ИГ:
```
📋 Участники инициативной группы

👑 Админы
• Александр MatrixHasYou (кв. 152)

🎯 Координаторы
• Иван Петров (кв. 45)

👥 Участники
• Мария Сидорова (кв. 12А)
• Пётр Васильев (кв. 78)
```

---

## 🔧 КОМАНДЫ АДМИНА ДЛЯ ИГ

### Добавить в ИГ:
```bash
/ig_add <user_id> [роль]
```

### Удалить из ИГ:
```bash
/ig_remove <user_id>
```

### Список участников ИГ:
```bash
/ig_list
```

### Статистика ИГ:
```bash
/ig_stats
```

### Проверить участника:
```bash
/ig_check <user_id>
```

### Рассылка только ИГ:
```bash
/ig_broadcast
```

---

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

### 1. Назначить активного жильца в ИГ:

```bash
# Узнай ID пользователя (через веб-админку или /users)
/ig_add 123456789 member
```

### 2. Назначить координатора по подъезду:

```bash
/ig_add 987654321 coordinator
```

### 3. Посмотреть кто в ИГ:

```bash
/ig_list
```

Вывод:
```
📋 Участники инициативной группы

Всего: 5
Активных: 4

• member: 3
• coordinator: 1
• admin: 1
```

### 4. Рассылка только ИГ:

```bash
/ig_broadcast
```

Бот попросит отправить текст → отправь сообщение → оно уйдёт только участникам ИГ!

---

## 🎯 КАК НАЗНАЧИТЬ ЖИЛЬЦА В ИГ (ПОШАГОВО)

### Шаг 1: Найди ID жильца

**Способ 1:** Веб-админка → Пользователи → найди жильца → скопируй ID

**Способ 2:** Перешли сообщение жильца в `@userinfobot` → получишь ID

**Способ 3:** Команда `/users` в боте → список пользователей

### Шаг 2: Назначь в ИГ

```bash
/ig_add 123456789 member
```

### Шаг 3: Проверь

```bash
/ig_check 123456789
```

Ответ:
```
✅ Пользователь является участником ИГ
Роль: member
```

### Шаг 4: Готово!

Теперь у жильца появилась кнопка **"🎯 Инициативная группа"** в меню!

---

## ⚠️ ВАЖНО

1. **Верификация НЕ обязательна** — можешь назначать кого угодно
2. **ИГ ≠ Админ** — у ИГ нет прав админки, только доп. функции
3. **Можно удалить** — `/ig_remove` деактивирует участника
4. **Роли имеют значение** — для статистики и группировки

---

## 🆕 СЛЕДУЮЩИЕ ФИЧИ (В ПЛАНЕ)

- [ ] Голосования ИГ
- [ ] Обращения к администрации
- [ ] Задачи для ИГ
- [ ] Статистика активности ИГ
- [ ] Чат ИГ (отдельная тема)

---

**by MatrixHasYou** 🏠