✅ Регистрация и верификация жильцов ✅ Рейтинг активности (уровни) ✅ Детект шпионов (Score 0-100) ✅ Анти-мат система (3 предупреждения → бан) ✅ Админ-панель с рассылкой ✅ Учёт квартир (несколько жильцов) ✅ Телефоны экстренных служб и мастеров ✅ Еженедельный экспорт JSON ✅ Прокси (socks5) для обхода РКН Бекап: backups/versions/v1.0_mvp_2026-02-26/ Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
242 lines
5.7 KiB
Markdown
242 lines
5.7 KiB
Markdown
# 📱 Управление телефонами
|
||
|
||
## ✅ Что добавлено:
|
||
|
||
### 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`
|
||
- При нажатии — **открывается набор номера**
|
||
- Удобно с мобильного!
|
||
|
||
---
|
||
|
||
**Теперь телефоны всегда под рукой!** 📱🚀
|