https://github.com/sibeardev/magnhild
MVP: AI Project Tracker: FastAPI + React web app with Telegram bot for managing projects and tasks, featuring AI-generated reviews and roadmap creation
https://github.com/sibeardev/magnhild
fastapi javascript python react telegrambot
Last synced: 9 months ago
JSON representation
MVP: AI Project Tracker: FastAPI + React web app with Telegram bot for managing projects and tasks, featuring AI-generated reviews and roadmap creation
- Host: GitHub
- URL: https://github.com/sibeardev/magnhild
- Owner: sibeardev
- License: mit
- Created: 2025-09-12T14:57:23.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2025-09-12T15:04:03.000Z (10 months ago)
- Last Synced: 2025-09-12T17:59:55.120Z (10 months ago)
- Topics: fastapi, javascript, python, react, telegrambot
- Language: Python
- Homepage:
- Size: 75.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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. Клонирование репозитория
```bash
git clone https://github.com/sibeardev/magnhild.git
cd magnhild
```
### 2. Настройка окружения
Создайте файл `backend/.env` с параметрами:
```plaintext
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](https://ngrok.com/docs/getting-started/) или [tuna](https://tuna.am/docs/getting-started/))
Ключ для работы AI DeepSeek: [API key](https://openrouter.ai/deepseek/deepseek-chat-v3.1:free/api)
### 3. Запуск с Docker Compose
```bash
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 с рекомендациями для дальнейшей работы