https://github.com/algorithm-ssau/2026-6304-4-
https://github.com/algorithm-ssau/2026-6304-4-
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/algorithm-ssau/2026-6304-4-
- Owner: algorithm-ssau
- License: mit
- Created: 2026-03-02T13:39:47.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-05-20T05:59:35.000Z (about 1 month ago)
- Last Synced: 2026-05-20T09:26:52.967Z (about 1 month ago)
- Language: Python
- Size: 205 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FunPay AI Bot
Автоматизированный бот для FunPay с AI-ответами и Telegram управлением.
## Возможности
- 🤖 **AI-ответы**: Автоматическая генерация ответов клиентам через Ollama
- 📱 **Telegram управление**: Полное управление ботом через Telegram
- 🔔 **Уведомления**: Мгновенные уведомления о новых заказах
- 💾 **История сообщений**: Контекстные ответы на основе истории переписки
- 🔐 **Безопасность**: Защищённое хранение токенов
## Быстрый старт
### 1. Установка зависимостей
```bash
poetry install
```
После пофиксить баг в FunPayAPI:
account.py
1387
```
msg = parser.find("div", {"class": "message-text"})
if not msg:
msg = parser.find("div", {"class": "chat-msg-text"})
if not msg:
raise Exception("Couldn't parse message")
message_text = msg.text
```
### 2. Настройка окружения
Создайте файл `.env`:
```env
# AI сервис (Ollama)
AI_URL=http://localhost:11434
MODEL=llama3.2
# Чат бот
BOT_TOKEN=your_bot_token
# База данных (SQLite по умолчанию)
# DATABASE_URL=sqlite+aiosqlite:///./funpay_bot.db
# Окружение
ENVIRONMENT=dev
```
### 3. Применение миграций
```bash
cd src
poetry run alembic upgrade head
```
### 4. Запуск
```bash
poetry run python src/main.py
```
## Использование
### Через Мессенджер
1. Найдите вашего бота в мессенджере
2. Отправьте `/start`
3. Зарегистрируйтесь: `/register`
4. Отправьте ваш FunPay `golden_token`
5. Запустите воркера: `/start_worker`
## Архитектура
```
┌─────────────────┐
│ Bot │ ← Управление пользователями
└────────┬────────┘
│
┌────────▼────────┐
│ Task Manager │ ← Управление воркерами
└────────┬────────┘
│
┌────────▼────────┐
│ FunPay Worker │ ← Обработка событий
└─┬──────────────┬┘
│ │
▼ ▼
┌─────────┐ ┌─────────┐
│ AI API │ │ FunPay │
└─────────┘ └─────────┘
```
## Документация
- [EVENTS_HANDLING.md](EVENTS_HANDLING.md) - Обработка событий FunPay
- [CLAUDE.md](CLAUDE.md) - Документация для разработчиков
## Технологии
- **FastAPI** - веб-фреймворк
- **aiogram** - Чат bot framework
- **SQLAlchemy** - ORM
- **Ollama** - локальная AI модель
- **FunPayAPI** - интеграция с FunPay
- **SQLite/PostgreSQL** - база данных
## Разработка
### Структура проекта
```
src/
├── main.py # Entrypoint
├── config.py # Конфигурация
├── runtime.py # Singleton объекты
├── gateaway/ # Внешние интеграции
│ ├── ai_api.py # Ollama API
│ ├── funpay_api.py # FunPay API
│ └── chat_bot.py # чат бот
├── workers/ # Воркеры
│ └── funpay_worker.py # FunPay воркер
├── services/ # Бизнес-логика
│ └── task_manager.py # Управление воркерами
├── repositories/ # Работа с БД
├── models/ # ORM модели
```
### Команды разработки
```bash
# Создать миграцию
cd src && poetry run alembic revision --autogenerate -m "description"
# Применить миграции
cd src && poetry run alembic upgrade head
# Откатить миграцию
cd src && poetry run alembic downgrade -1
```
## Лицензия
MIT