hac_ 🚀

AI-ассистент для образования с генерацией расписания, конспектов, изображений и автоматизацией через Telegram-бота.

🎯 О проекте

hac_ - это комплексное решение для автоматизации учебного процесса, которое помогает студентам:

• 📅 Генерировать персональное расписание занятий
• 📝 Создавать конспекты, планы уроков и карточки для запоминания
• 🎨 Генерировать учебные иллюстрации, мемы и схемы
• 🤖 Получать ежедневные дайджесты через Telegram
• 💬 Общаться с AI-ассистентом для помощи в учебе

🏗️ Архитектура

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Frontend  │────▶│   Backend   │────▶│     AI      │
│  (Next.js)  │     │  (FastAPI)  │     │  (OpenAI/   │
│             │     │             │     │   Mistral)  │
└─────────────┘     └─────────────┘     └─────────────┘
                            │
                            ▼
                    ┌─────────────┐
                    │     n8n     │────▶ Telegram Bot
                    │ (Automation)│
                    └─────────────┘

🛠️ Технологии

Frontend

• Next.js - React фреймворк
• TailwindCSS - Utility-first CSS
• shadcn/ui - Современные UI компоненты
• Clerk/Auth.js - Авторизация

Backend

• FastAPI - Современный Python веб-фреймворк
• SQLite/Postgres - База данных
• Docker - Контейнеризация

AI & Интеграции

• OpenAI GPT / Mistral - Текстовая генерация
• Flux / DALL-E - Генерация изображений
• n8n - Автоматизация и workflows
• Telegram Bot API - Интеграция с Telegram

📚 Документация

• 📋 ТЗ для команды - Детальные задачи для каждого участника
• ⏱ Чекпоинты по времени - Таймлайн и контрольные точки
• 🚀 Инструкция по запуску - Быстрый старт и настройка

🚀 Быстрый старт

1. Клонирование

git clone https://github.com/Rafaildavar/-_-.git
cd "ХАКАТОН ДИЗАЙН"

2. Настройка

cp .env.example .env
# Добавьте ваши API ключи в .env

3. Запуск

docker-compose up -d

4. Доступ

• Backend API: http://localhost:8000/docs
• n8n: http://localhost:5678
• Frontend: http://localhost:3000

Подробная инструкция: SETUP_GUIDE.md

📁 Структура проекта

hac_/
├── frontend/          # Next.js приложение
├── backend/           # FastAPI сервер
│   ├── app/
│   │   ├── api/      # API эндпоинты
│   │   └── services/ # AI сервисы
├── n8n/              # n8n workflows
├── docs/             # Документация
│   ├── TEAM_TASKS.md
│   ├── CHECKPOINTS.md
│   └── SETUP_GUIDE.md
└── docker-compose.yml

🎯 API Эндпоинты

• POST /api/assistant - Диалог с AI-ассистентом
• POST /api/schedule - Генерация расписания
• POST /api/lesson - Генерация урока/конспекта/карточек
• POST /api/image - Генерация изображений
• POST /api/tg/send - Отправка в Telegram
• POST /api/n8n/webhook - Webhook для n8n

Полная документация: http://localhost:8000/docs

👥 Команда

• Тимлид/Архитектор - Общая координация, Docker, интеграции
• Фронтенд Lead - Next.js интерфейс, UI/UX
• Бэкенд разработчик - FastAPI, AI интеграции
• Интеграции - n8n workflows, Telegram бот
• Дизайнер/QA/Pitch - Дизайн, тестирование, презентация

🎤 Питч (5 минут)

1. Проблема - Студенты тратят много времени на рутинные задачи
2. Решение - AI-ассистент с автоматизацией
3. Демонстрация - Показать все фичи
4. Архитектура - Техническая реализация
5. Выгоды - Экономичность, скорость, масштабируемость

🏆 Критерии успеха

• ✅ Все заявленные фичи работают
• ✅ Современный и привлекательный UI
• ✅ Чистая архитектура и масштабируемость
• ✅ Четкий питч и хорошее демо
• ✅ Инновационное использование AI

📝 Лицензия

Проект создан для хакатона.

---

Сделано с ❤️ командой hac_