🔥 ОБЪЯВЛЕНИЯ: • Срок действия: 7 → 14 дней 🎯 ИНИЦИАТИВНАЯ ГРУППА: • Добавлена кнопка 'Рассылка ИГ' в меню • Команда /ig_broadcast для членов ИГ • Поддержка текста + фото + файлов • Настройка лимита в веб-панели ⚙️ ВЕБ-ПАНЕЛЬ: • Новая страница /settings • Настройка лимита рассылки ИГ (секунды) • Кнопки статистики фильтруют пользователей • Индикатор активного фильтра 🎨 UI: • Исправлен <font> → emoji (Telegram не поддерживает) • Цветные заголовки через emoji 📁 ФАЙЛЫ: • handlers/ads.py: 14 дней • handlers/initiative_group.py: рассылка ИГ • web/app.py: API настроек • web/templates/settings.html: страница настроек • utils/ui_styles.py: без <font> тегов • database: settings table Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
214 lines
5.7 KiB
Markdown
214 lines
5.7 KiB
Markdown
# 📞 ПРОФИЛЬ ЖИЛЬЦА — ИНСТРУКЦИЯ
|
||
|
||
**Обновлено:** 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** 🏠
|