# MVP План - Краткая сводка
## ⏱️ Временные рамки: 1 неделя (32 часа работы)
## ✅ Что будет работать после MVP:
1. ✅ Данные сохраняются в PostgreSQL (не теряются при перезапуске)
2. ✅ Rate limiting работает через Redis
3. ✅ MCP протокол: `tools/list` и `tools/call` работают
4. ✅ Создание и получение задач через API
5. ✅ Базовая аутентификация через API ключи
6. ✅ Health checks показывают реальный статус сервисов
## ❌ Что НЕ входит в MVP (отложено):
- ❌ Реальная интеграция с LLM (оставляем симуляцию)
- ❌ Меж-агентная коммуникация через message bus
- ❌ Интеграция Frontend с Backend
- ❌ Система миграций БД
- ❌ Все MCP методы (только tools)
---
## 📅 Расписание по дням
### День 1-2: Инфраструктура (12 часов)
**Результат:** БД и Redis подключены, данные сохраняются
**Задачи:**
1. Подключение к PostgreSQL (6ч)
- Модуль database.py
- Минимальные модели (Task, Tool)
- Обновление TaskOrchestrator
2. Подключение к Redis (4ч)
- Модуль redis_client.py
- Обновление RateLimitingMiddleware
3. Валидация config и health checks (2ч)
### День 3-4: Функционал (10 часов)
**Результат:** MCP протокол работает, задачи создаются
**Задачи:**
1. Реализация MCP tools/list и tools/call (6ч)
- Обновление ToolRegistry для БД
- Реализация handlers в main.py
2. Исправление Agent Registry (2ч)
- Генерация ID до создания
- Безопасная работа с current_task
3. Базовая безопасность (2ч)
- API ключи через env переменные
### День 5: Тестирование (8 часов)
**Результат:** Все работает, баги исправлены
**Задачи:**
- Тестирование всех endpoints
- Проверка сохранения данных
- Исправление найденных проблем
- Обновление документации
---
## 🎯 Критерии успеха MVP
### Обязательные:
- [ ] Сервер запускается без ошибок
- [ ] Health check показывает статус БД и Redis
- [ ] Задачи сохраняются в БД и не теряются при перезапуске
- [ ] MCP endpoint `/mcp` отвечает на `tools/list` и `tools/call`
- [ ] Rate limiting работает (можно проверить через curl)
- [ ] API требует аутентификацию (кроме health)
### Желательные:
- [ ] Нет критических ошибок в логах
- [ ] Базовые тесты проходят
- [ ] Документация обновлена
---
## 📝 Файлы для создания/изменения
### Новые файлы (7):
1. `mcp_server/app/core/database.py`
2. `mcp_server/app/core/redis_client.py`
3. `mcp_server/app/core/models/db_models.py`
### Изменяемые файлы (8):
1. `mcp_server/app/main.py` - инициализация БД/Redis
2. `mcp_server/app/config.py` - валидация SECRET_KEY
3. `mcp_server/app/core/services/task_orchestrator.py` - работа с БД
4. `mcp_server/app/core/services/tool_registry.py` - работа с БД
5. `mcp_server/app/core/services/agent_registry.py` - исправление багов
6. `mcp_server/app/middleware/rate_limiting.py` - Redis
7. `mcp_server/app/middleware/auth.py` - API ключи
8. `mcp_server/app/api/v1/health.py` - реальные проверки
---
## 🚀 Быстрый старт
```bash
# 1. Создать .env
cat > .env << EOF
DATABASE_URL=postgresql+asyncpg://postgres:password@localhost:5432/mcp_db
REDIS_URL=redis://localhost:6379
SECRET_KEY=$(python -c "import secrets; print(secrets.token_urlsafe(32))")
API_KEY=mcp-api-key-12345
EOF
# 2. Запустить инфраструктуру
docker-compose up -d postgres redis
# 3. Установить зависимости
cd mcp_server
pip install -r requirements.txt
# 4. Запустить сервер
uvicorn app.main:app --reload
```
---
## ⚠️ Важные решения для MVP
1. **LLM остается симуляцией** - реальная интеграция займет +8-10 часов
2. **Frontend не трогаем** - моки работают, интеграция не критична
3. **Используем init-db.sql** - миграции отложены
4. **Упрощенная аутентификация** - API ключи в env, не в БД
5. **Минимальные модели БД** - только Task и Tool, остальное позже
---
## 📊 Оценка времени
| День | Задачи | Часы | Результат |
|------|--------|------|-----------|
| 1-2 | БД + Redis | 12 | Данные сохраняются |
| 3-4 | MCP + Фиксы | 10 | Протокол работает |
| 5 | Тесты | 8 | Все стабильно |
| **ИТОГО** | | **30** | **MVP готов** |
**Резерв:** 2 часа на непредвиденные проблемы
---
## ✅ Чеклист готовности
Перед началом:
- [ ] PostgreSQL запущен и доступен
- [ ] Redis запущен и доступен
- [ ] .env файл создан с правильными значениями
- [ ] Зависимости установлены
После завершения:
- [ ] Все endpoints работают
- [ ] Данные сохраняются в БД
- [ ] Rate limiting работает
- [ ] MCP протокол отвечает
- [ ] Нет критических ошибок
---
## 🎓 Следующие шаги после MVP
После завершения MVP можно добавить:
1. Реальную интеграцию с LLM (+8-10ч)
2. Message bus для агентов (+4-6ч)
3. Frontend интеграцию (+6-8ч)
4. Полную систему миграций (+4-6ч)
5. Расширенную безопасность (+4-6ч)
Но это уже не критично для MVP!