domovoy_bot/EDIT_USER_FEATURE.md

# 📱 УПРАВЛЕНИЕ ПРОФИЛЕМ ЖИЛЬЦА

**Обновлено:** 7 марта 2026  
**Версия:** v1.17  
**Статус:** ✅ РЕАЛИЗОВАНО

---

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

1. ✅ **Веб-панель** — кнопка "Редактировать" работает
2. ✅ **Telegram бот** — команда `/edit_user` для админа
3. ✅ **API endpoint** — `/api/user/{user_id}` для загрузки данных

---

## 📱 СПОСОБ 1: Telegram бот (БЫСТРО!)

### Команда для админа:

```bash
/edit_user <user_id> [квартира] [телефон]
```

### Примеры:

**Установить квартиру и телефон:**
```bash
/edit_user 123456789 45 +79991234567
```

**Только телефон:**
```bash
/edit_user 123456789 phone:+79991234567
```

**Только квартира:**
```bash
/edit_user 123456789 apt:45
```

**С префиксами (понятнее):**
```bash
/edit_user 123456789 apt:45 phone:+79991234567
```

---

### Ответ бота:

```
✅ Профиль обновлён!

👤 Александр Петров
🔖 ID: 123456789

Обновлено:
• квартира: 45
• телефон: +79991234567
```

---

## 🖥️ СПОСОБ 2: Веб-панель (УДОБНО!)

### Пошагово:

1. **Зайди на** `http://0.0.0.0:8000/users`
2. **Найди жильца** в списке (можно через поиск)
3. **Нажми** ✏️ **Редактировать**
4. **Откроется окно:**
   ```
   Редактировать пользователя
   
   Квартира: [45      ]
   Телефон: [+7999... ]
   Рейтинг: [0        ]
   
   [Отмена] [Сохранить]
   ```
5. **Впиши данные**
6. **Нажми** "Сохранить"
7. **Готово!** ✅

---

## 🔍 КАК УЗНАТЬ USER_ID

### Вариант 1: Веб-админка
1. Зайди на `/users`
2. Найди жильца
3. Скопируй ID из таблицы

### Вариант 2: Пересылка сообщения
1. Перешли сообщение жильца в `@userinfobot`
2. Бот покажет ID

### Вариант 3: Команда в боте
```bash
/users
```
(если есть такая команда админа)

---

## 📊 ФОРМАТЫ ДАННЫХ

### Квартира:
- ✅ `45`
- ✅ `12А`
- ✅ `100-1`
- ✅ `45А`

### Телефон:
- ✅ `+79991234567`
- ✅ `+7 (999) 123-45-67`
- ✅ `+79990001122`

**Неправильно:**
- ❌ `89991234567` (нет +)
- ❌ `123` (короткий)

---

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

### Пример 1: Знакомый жилец из 45 квартиры

**Дано:**
- Жилец: Иван из 45 квартиры
- Телефон: +79991234567
- User ID: 123456789

**Команда:**
```bash
/edit_user 123456789 45 +79991234567
```

---

### Пример 2: Нужно только телефон

**Дано:**
- Жилец знает всех в подъезде
- Хочет помочь с телефонами

**Команда:**
```bash
/edit_user 123456789 phone:+79991234567
```

---

### Пример 3: Массовое обновление

**Сценарий:** ИГ собрала телефоны подъезда

**Команды:**
```bash
/edit_user 111111111 apt:45 phone:+79991111111
/edit_user 222222222 apt:46 phone:+79992222222
/edit_user 333333333 apt:47 phone:+79993333333
```

---

## 🛠️ ТЕХНИЧЕСКАЯ ЧАСТЬ

### Изменённые файлы:

| Файл | Изменения |
|------|-----------|
| `web/app.py` | GET `/api/user/{user_id}` |
| `handlers/users.py` | Команда `/edit_user` |
| `web/templates/users.html` | Модалка редактирования |

### API endpoint:

**GET** `/api/user/{user_id}`

**Ответ:**
```json
{
  "user": {
    "id": 123456789,
    "username": "ivan",
    "first_name": "Иван",
    "last_name": "Петров",
    "apartment": "45",
    "phone": "+79991234567",
    "verified": true,
    "rating": 150,
    "message_count": 500,
    "is_banned": false
  }
}
```

---

## ✅ ПРОВЕРКА

### 1. Веб-панель:
- [ ] Зайти на `/users`
- [ ] Нажать ✏️ на любом пользователе
- [ ] Изменить квартиру/телефон
- [ ] Сохранить
- [ ] Проверить что обновилось

### 2. Telegram бот:
- [ ] Написать `/edit_user 123456789 45 +79991234567`
- [ ] Получить подтверждение
- [ ] Проверить через "Моя квартира"

---

## 💡 СОВЕТЫ

1. **Инициативная группа** может собирать телефоны
2. **Админ** быстро вносит через `/edit_user`
3. **Веб-панель** удобна для массового редактирования
4. **Проверяй** данные перед сохранением

---

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

- [ ] Массовое редактирование (выбрать несколько)
- [ ] Экспорт телефонов (CSV)
- [ ] Импорт телефонов (CSV)
- [ ] Поиск по телефону
- [ ] История изменений профиля

---

**by MatrixHasYou** 🏠  
**Теперь редактирование профилей доступно везде!** 📱🖥️