API

Моковые эндпоинты для прототипа

Все данные отдаются в JSON. Локальный сервер на Python без сторонних зависимостей.

Ресурсы

Основные эндпоинты

Base URL: http://localhost:8000/api

Роли и сотрудники

GET
  • /api/roles — справочник 9 ролей Белбина.
  • /api/employees — список сотрудников (без распределения ролей).
  • /api/employees/{id} — карточка сотрудника с ролями и рекомендациями.

Команды и проекты

GET
  • /api/teams — список команд, индекс эффективности, история проектов.
  • /api/teams/{id} — детальная команда.
  • /api/projects — проекты/квесты с требуемыми ролями и метриками.
  • /api/projects/{id} — детальный проект.

Дэшборд и аналитика

GET
  • /api/dashboard — агрегированная нагрузка для фронта (проекты, команды, сотрудники, роли, уведомления, пайплайн, прогнозы задач).
  • /api/pipeline/status — статус ETL/ML пайплайна.
  • /api/admin/integrations — состояние интеграций.

Прогнозы задач

GET
  • /api/task-profiles — роль-профиль задач с предлагаемой командой.

Схемы

Структуры ответов

Employee

JSON
  • id, name, position, team, location
  • roles: { role: weight } (доля 0–1 по 9 ролям)
  • dominant — ТОП-3 роли, load — загрузка 0–1
  • active_projects, focus, recommendations, burnout_risk

Project

JSON
  • id, name, type, difficulty, status
  • efficiency_index, incidents, deadline_shift
  • required_roles: { role: weight }
  • metrics: lead_time, deploy_freq, mttr

Task profile

JSON
  • id, summary, project, type, risk
  • predicted_roles: { role: weight }
  • suggested_team: [employee_id]

Pipeline

JSON
  • schedule, last_run, freshness, success_rate
  • steps: name, status, delta, duration
  • logs: time, source, message