Техническая документация

Подробная информация об архитектуре, API, интеграциях и технических требованиях Spexus.ai

Архитектура системы

Схема архитектуры

🏗️

Интерактивная диаграмма архитектуры

(Mermaid диаграмма будет добавлена)

Frontend

• React 18 с TypeScript
• Next.js 14 App Router
• Tailwind CSS
• Zustand для состояния
• React Query для API

Backend

• Node.js с Express
• PostgreSQL база данных
• Prisma ORM
• JWT аутентификация
• WebSocket для real-time

Интеграции

• Model Context Protocol
• OpenAI API
• GitHub/GitLab
• Jira/Linear
• Slack/Teams

API документация

Основные endpoints

GET/api/epics

Получить список всех эпиков

POST/api/epics

Создать новый эпик

GET/api/stories/:epicId

Получить истории для эпика

GET/api/mcp/context/:storyId

Получить контекст для MCP-сервера

Пример запроса

curl -X POST https://api.spexus.ai/api/epics \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "title": "Система аутентификации",
    "description": "Реализация входа и регистрации пользователей",
    "priority": "high",
    "status": "planning"
  }'

Пример ответа

{
  "id": "epic_123",
  "title": "Система аутентификации",
  "description": "Реализация входа и регистрации пользователей",
  "priority": "high",
  "status": "planning",
  "createdAt": "2025-01-06T10:00:00Z",
  "updatedAt": "2025-01-06T10:00:00Z",
  "stories": []
}

Интеграция с MCP

Model Context Protocol

Spexus.ai поддерживает стандарт MCP для передачи контекста AI-агентам. Это обеспечивает автоматическую синхронизацию требований с вашими AI-инструментами.

Поддерживаемые AI-агенты:

• Claude (Anthropic)
• GPT-4 (OpenAI)
• Cursor IDE
• GitHub Copilot
• Любые MCP-совместимые инструменты

Пример MCP конфигурации

{
  "mcpServers": {
    "spexus-ai": {
      "command": "npx",
      "args": ["@spexus/mcp-server"],
      "env": {
        "SPEXUS_API_KEY": "your_api_key",
        "SPEXUS_PROJECT_ID": "your_project_id"
      }
    }
  }
}

Системные требования

Минимальные требования

ОС: Windows 10, macOS 10.15, Ubuntu 18.04+
RAM: 4 GB
Диск: 1 GB свободного места
Сеть: Стабильное интернет-соединение
Браузер: Chrome 90+, Firefox 88+, Safari 14+

Варианты развертывания

☁️

Cloud SaaS

Готовое решение в облаке с автоматическими обновлениями

• Быстрый старт
• Автоматическое масштабирование
• 99.9% uptime SLA

🏢

On-Premise

Установка на собственных серверах для максимального контроля

• Полный контроль данных
• Кастомизация
• Интеграция с AD/LDAP

🐳

Docker

Контейнеризованное решение для любой инфраструктуры

• Простое развертывание
• Kubernetes поддержка
• CI/CD интеграция

Нужна помощь с интеграцией или есть технические вопросы?

Связаться с техподдержкой Попробовать демо