domovoy_bot/ТЕЛЕФОНЫ.md
Admin ba4676b0af v1.0 MVP - Инициализация проекта 🏠
 Регистрация и верификация жильцов
 Рейтинг активности (уровни)
 Детект шпионов (Score 0-100)
 Анти-мат система (3 предупреждения → бан)
 Админ-панель с рассылкой
 Учёт квартир (несколько жильцов)
 Телефоны экстренных служб и мастеров
 Еженедельный экспорт JSON
 Прокси (socks5) для обхода РКН

Бекап: backups/versions/v1.0_mvp_2026-02-26/

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
2026-02-27 10:54:16 +00:00

242 lines
5.7 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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.

# 📱 Управление телефонами
## ✅ Что добавлено:
### 1⃣ **Админ может добавить телефон пользователю**
**Команда:** `/add_phone <ID> <телефон>`
**Пример:**
```bash
/add_phone 123456789 +7 (999) 123-45-67
```
### 2⃣ **Админ может изменить телефон**
**Команда:** `/edit_phone <ID> <телефон>`
**Пример:**
```bash
/edit_phone 123456789 +7 (999) 999-99-99
```
### 3⃣ **Админ может удалить телефон**
**Команда:** `/remove_phone <ID>` или `/del_phone <ID>`
**Пример:**
```bash
/remove_phone 123456789
```
### 4⃣ **Жилец может добавить свой телефон сам**
**Команда:** `/myphone <телефон>`
**Пример:**
```bash
/myphone +7 (999) 123-45-67
```
### 5⃣ **Показ телефонов в списке пользователей**
**Команда:** `/users` или кнопка «👥 Пользователи»
**Теперь показывает:**
```
✅ 123456789 — Петр Петров
└─ кв. 88 | 📱 +7 (999) 123-45-67
```
---
## 📋 Все команды:
| Команда | Кто | Описание | Пример |
|---------|-----|----------|--------|
| `/add_phone <ID> <тел>` | Админ | Добавить телефон | `/add_phone 123456789 +7...` |
| `/edit_phone <ID> <тел>` | Админ | Изменить телефон | `/edit_phone 123456789 +7...` |
| `/remove_phone <ID>` | Админ | Удалить телефон | `/remove_phone 123456789` |
| `/phone <ID>` | Админ | Показать телефон | `/phone 123456789` |
| `/myphone <тел>` | Жилец | Добавить свой | `/myphone +7...` |
| `/myphone` | Жилец | Показать свой | `/myphone` |
---
## 🎯 Сценарии использования:
### Сценарий 1: Админ добавляет телефон жильцу
**Проблема:** Нужно связаться с жильцом, а телефона нет.
**Решение:**
```bash
# 1. Находим ID через /users:
123456789 — Петр @petr
# 2. Спрашиваем телефон у жильца (в чате или личке)
# 3. Добавляем:
/add_phone 123456789 +7 (999) 123-45-67
# 4. Готово! Теперь телефон в базе
```
---
### Сценарий 2: Жилец добавляет телефон сам
**Жилец пишет боту в личку:**
```bash
/myphone +7 (999) 123-45-67
```
**Бот отвечает:**
```
✅ Телефон сохранён
+7 (999) 123-45-67
Теперь соседи могут связаться с вами!
```
---
### Сценарий 3: Изменение телефона
**Проблема:** Жилец сменил номер.
**Решение:**
```bash
# Жилец сам:
/myphone +7 (999) 999-99-99
# Или админ:
/edit_phone 123456789 +7 (999) 999-99-99
```
---
### Сценарий 4: Удаление телефона
**Проблема:** Жилец уехал, телефон не актуален.
**Решение:**
```bash
/remove_phone 123456789
```
---
## 📊 Как выглядит в списке:
**Команда:** `/users`
**Теперь показывает:**
```
👥 Пользователи (50):
✅ 123456789 — Петр Петров @petr
└─ кв. 88 | 📱 +7 (999) 123-45-67
✅ 987654321 — Анна Петрова @anna
└─ кв. 88 | 📱 📭
⏳ 456789123 — Иван Сидоров
└─ кв. 45 | 📱 +7 (999) 000-00-00
```
**📭** — телефон не указан
**📱 +7...** — телефон указан (можно кликнуть!)
---
## 💡 Преимущества:
| Было | Стало |
|------|-------|
| Телефоны в блокноте | **В базе бота** |
| Нельзя кликнуть | **Кликабельный tel:** |
| Админ добавляет | **Жилец может сам!** |
| Не видно в списке | **Показывается в /users** |
---
## 🔍 Форматы телефонов:
**Поддерживаются:**
- `+7 (999) 123-45-67`
- `8 (999) 123-45-67`
- `+79991234567`
- `89991234567`
- `999-12-34`
**Бот автоматически нормализует к:** `+7 (999) 123-45-67`
---
## 🧪 Протестируй:
### Тест 1: Жилец добавляет телефон
```bash
# В личку боту:
/myphone +7 (999) 123-45-67
# Ожидай:
✅ Телефон сохранён
```
### Тест 2: Админ добавляет телефон
```bash
# Найди ID:
/users
# Добавь телефон:
/add_phone 123456789 +7 (999) 123-45-67
# Проверь:
/users
```
### Тест 3: Изменение телефона
```bash
/edit_phone 123456789 +7 (999) 999-99-99
```
### Тест 4: Удаление телефона
```bash
/remove_phone 123456789
```
---
## ⚠️ Важно:
### Телефоны видны только админу!
**В `/users`:**
- Админ видит телефоны всех
- Жильцы не видят телефоны других
### Жилец может добавить только свой!
**Команда `/myphone`:**
- Работает только в личке
- Добавляет телефон только себе
---
## 📞 Кликабельные телефоны:
**В Telegram:**
- Номер телефона — это ссылка `tel:+79991234567`
- При нажатии — **открывается набор номера**
- Удобно с мобильного!
---
**Теперь телефоны всегда под рукой!** 📱🚀