AI Project Tracker

Описание

AI Project Tracker — это веб-приложение на FastAPI и React для отслеживания пользователей, проектов и задач с поддержкой AI Review. Проект включает backend, frontend и интеграцию с Telegram ботом для удобного взаимодействия.

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

backend/   # FastAPI backend + Telegram bot
frontend/  # React frontend
docker-compose.yml

Установка и запуск

1. Клонирование репозитория

git clone https://github.com/sibeardev/magnhild.git
cd magnhild

2. Настройка окружения

Создайте файл backend/.env с параметрами:

TELEGRAM_TOKEN=  # Telegram API Token from BotFather
MONGODB_URL=mongodb://mongo:27017  # MongoDB connection URL
WEBHOOK_URL= # Webhook URL
DS_TOKEN= # DeepSeek api key
SECRET_KEY=super_secret

Локально Webhook можно получить у (ngrok или tuna)

Ключ для работы AI DeepSeek: API key

3. Запуск с Docker Compose

docker-compose up --build

После запуска:

• Backend доступен по адресу: http://localhost:8000
• Frontend доступен по адресу: http://localhost:5173

Для администратора:

• Регистрация нового пользователя через /admin/auth/register
• Вход в систему через /admin/auth/login

Возможности

Для администратора:

• CRUD пользователей, проектов и задач
• Отметка выполнения задач через чекбоксы
• AI Review проектов

Для пользователей доступен Telegram бот

• /start — регистрация пользователя (имя + email)
• /idea — пользователь отправляет идею, AI генерирует описание и roadmap из 5–7 задач
• /projects — список идей пользователя
• /update <номер задачи> <статус> — обновление статуса задачи
• /report — отчёт: процент выполненных задач и комментарий от AI с рекомендациями для дальнейшей работы