CRM Telegram Bot
**CRM-система в формате Telegram-бота + веб-админка для малого бизнеса.** Управление контактами, сделками, задачами и документами прямо из мессенджера.
### Возможности
* **Контакты и сделки:** создание/редактирование/поиск, пагинация. Воронка продаж с этапами, привязка к контактам, история изменений.
* **Задачи:** приоритеты, дедлайны, привязка к сделкам/контактам. Фильтр «мои/все», автоматические напоминания.
* **AI/OCR:** фото визитки/счёта/чека → OpenAI Vision извлекает данные → в 1 клик создаётся контакт или сделка.
* **Отчёты:** экспорт в Excel и PDF (поддержка кириллицы), графики. Интеграция с Google Sheets (экспорт/импорт).
* **Inline-режим:** быстрый поиск контактов и сделок из любого чата Telegram.
* **Автоматизация:** утренний дайджест, напоминания о задачах, автоочистка файлов.
* **Веб-админка:** SQLAdmin с авторизацией для управления данными через браузер + клиентская документация.
* **Роли (4 уровня):** User → Manager → Admin → Super Admin.
* **Трекинг:** Telegram-уведомления при посещении админки и документации.
### Стек
Python 3.12, aiogram 3.24, FastAPI, SQLAlchemy 2 (async), Alembic, PostgreSQL 16, Redis 7, OpenAI Vision API, Docker Compose, Nginx, SSL, VPS.
### Безопасность
Валидация данных, rate limiting, connection pooling, защита от race conditions, security headers, non-root Docker, структурированное логирование, централизованный error handler.
### Возможности
* **Контакты и сделки:** создание/редактирование/поиск, пагинация. Воронка продаж с этапами, привязка к контактам, история изменений.
* **Задачи:** приоритеты, дедлайны, привязка к сделкам/контактам. Фильтр «мои/все», автоматические напоминания.
* **AI/OCR:** фото визитки/счёта/чека → OpenAI Vision извлекает данные → в 1 клик создаётся контакт или сделка.
* **Отчёты:** экспорт в Excel и PDF (поддержка кириллицы), графики. Интеграция с Google Sheets (экспорт/импорт).
* **Inline-режим:** быстрый поиск контактов и сделок из любого чата Telegram.
* **Автоматизация:** утренний дайджест, напоминания о задачах, автоочистка файлов.
* **Веб-админка:** SQLAdmin с авторизацией для управления данными через браузер + клиентская документация.
* **Роли (4 уровня):** User → Manager → Admin → Super Admin.
* **Трекинг:** Telegram-уведомления при посещении админки и документации.
### Стек
Python 3.12, aiogram 3.24, FastAPI, SQLAlchemy 2 (async), Alembic, PostgreSQL 16, Redis 7, OpenAI Vision API, Docker Compose, Nginx, SSL, VPS.
### Безопасность
Валидация данных, rate limiting, connection pooling, защита от race conditions, security headers, non-root Docker, структурированное логирование, централизованный error handler.