# 📞 ПРОФИЛЬ ЖИЛЬЦА — ИНСТРУКЦИЯ

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

---

## 📋 ЧТО ДОБАВЛЕНО

### 1. ✅ Изменение квартиры и телефона

**Доступно ВСЕМ пользователям** (не только ИГ!)

### 2. ✅ Команды для редактирования

| Команда | Описание |
|---------|----------|
| `/setapt 45` | Изменить квартиру |
| `/setapt 12А` | Квартира с буквой |
| `/setphone +79991234567` | Изменить телефон |

---

## 🎯 ИНИЦИАТИВНАЯ ГРУППА — МЕНЮ

Кнопка **"🎯 Инициативная группа"** → меню:

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

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

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

[📊 Моя статистика]
[📋 Список ИГ] [👤 Мой профиль]
[🔙 Назад]
```

### Мой профиль (кнопка):

```
👤 Ваш профиль

🏠 Квартира: 152
📞 Телефон: не указан

Что хотите изменить?

[🏠 Изменить квартиру]
[📞 Изменить телефон]
[🔙 Назад]
```

---

## 📱 КАК ИЗМЕНИТЬ ПРОФИЛЬ

### Способ 1: Через кнопки (ИГ)

1. Нажми **"🎯 Инициативная группа"**
2. Нажми **"👤 Мой профиль"**
3. Выбери **"🏠 Изменить квартиру"** или **"📞 Изменить телефон"**
4. Бот покажет команду
5. Отправь команду с новым значением

### Способ 2: Командами (все)

**Изменить квартиру:**
```bash
/setapt 45
```

**Изменить телефон:**
```bash
/setphone +79991234567
```

### Способ 3: Через "Моя квартира"

1. Нажми **"🔍 Моя квартира"** в главном меню
2. Увидишь текущие данные
3. Бот подскажет команды для изменения

---

## ✅ ВАЛИДАЦИЯ

### Квартира:
- ✅ `45`
- ✅ `12А`
- ✅ `100-1`
- ✅ `45А`
- ❌ `abc`
- ❌ `` (пусто)

### Телефон:
- ✅ `+79991234567`
- ✅ `+7 (999) 123-45-67`
- ❌ `89991234567` (нет +)
- ❌ `123` (короткий)

---

## 🔒 КОНФИДЕНЦИАЛЬНОСТЬ

### Кто видит телефон?

| Кто | Видит телефон |
|-----|---------------|
| **Админ** | ✅ Да (в веб-админке) |
| **Инициативная группа** | ❌ Нет (только свой) |
| **Обычные жильцы** | ❌ Нет |

### Где показывается телефон?

- ✅ В профиле пользователя (только владелец)
- ✅ В веб-админке (для админов)
- ❌ В общем чате — **НИКОГДА**
- ❌ В списке ИГ — **НЕТ**

---

## 💡 ВСЁ ЛИЧНОЕ ОБЩЕНИЕ — В ЛИЧКЕ!

### ✅ Бот общается только в личных сообщениях!

**Никакого завала в общем чате!**

- Верификация → в личке
- Изменение профиля → в личке
- Команды → в личке
- Уведомления → в личке

### В общий чат бот отправляет:

- 📢 Объявления (по команде админа)
- 📅 Напоминания о отключениях
- 💰 Напоминания о платежах
- 🏆 Объявления жильцов (`/ad`)

---

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

### Пример 1: Изменить квартиру

```
User: /setapt 45
Bot: ✅ Квартира обновлена!
     Ваша квартира: 45
```

### Пример 2: Изменить телефон

```
User: /setphone +79991234567
Bot: ✅ Телефон обновлён!
     Ваш телефон: +79991234567
```

### Пример 3: Посмотреть профиль (ИГ)

```
1. User нажимает: 🎯 Инициативная группа
2. User нажимает: 👤 Мой профиль

Bot: 👤 Ваш профиль
     
     🏠 Квартира: 152
     📞 Телефон: не указан
     
     Что хотите изменить?
     
     [🏠 Изменить квартиру]
     [📞 Изменить телефон]
     [🔙 Назад]
```

---

## 📊 СТРУКТУРА БАЗЫ ДАННЫХ

### Таблица `users`:

| Поле | Тип | Описание |
|------|-----|----------|
| `user_id` | BigInteger | ID Telegram |
| `username` | String | @username |
| `first_name` | String | Имя |
| `last_name` | String | Фамилия |
| `apartment` | String | **Квартира** (изменяется) |
| `phone` | String | **Телефон** (изменяется) |
| `verified` | Boolean | Верифицирован |
| ... | ... | ... |

---

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

- [ ] Экспорт телефонов ИГ (для админа)
- [ ] Поиск жильца по телефону (админ)
- [ ] Приватность телефона (скрыть/показать)
- [ ] Фото профиля в ИГ
- [ ] Должность в ИГ (координатор, старший подъезда)

---

**by MatrixHasYou** 🏠
