domovoy_bot/PROFILE_FEATURE.md
Admin cef2ac3714 v1.19 ИГ рассылка + объявления 14 дней + настройки
🔥 ОБЪЯВЛЕНИЯ:
• Срок действия: 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>
2026-03-10 17:01:30 +00:00

214 lines
5.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

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.

# 📞 ПРОФИЛЬ ЖИЛЬЦА — ИНСТРУКЦИЯ
**Обновлено:** 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** 🏠