> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter o painel de execuções do projeto

> Consolida o tempo trabalhado no projeto: total investido, número de sessões, duração média, distribuição por funil e etapa e o ranking de pessoas por tempo — indicando quem está executando no momento. Todos os tempos são em segundos.



## OpenAPI

````yaml /api-reference/openapi.json get /api/management/projects/{project}/project-executions/dashboard
openapi: 3.0.0
info:
  title: Olie API
  version: 1.0.0
  description: >
    # Introdução 👋


    Olá! Esta é a documentação oficial da API da [olie.ai](https://olie.ai/).
    Aqui você encontra as referências e exemplos de uso dos nossos endpoints.


    Para uma visão completa, recomendamos fortemente que você leia a
    [documentação oficial](https://docs.olie.ai/api-reference/introduction). Lá
    estão detalhados tópicos essenciais como
    [autenticação](https://docs.olie.ai/api-reference/introduction/authentication),
    [estrutura de
    respostas](https://docs.olie.ai/api-reference/general/response-structure),
    [paginação](https://docs.olie.ai/api-reference/general/pagination) e outros
    guias de integração.


    No Postman, esta coleção foca nas informações específicas de cada requisição
    (endpoints, parâmetros e exemplos), servindo como apoio rápido para testes e
    desenvolvimento.
servers:
  - url: https://api.olie.ai
security:
  - BearerAuth: []
paths:
  /api/management/projects/{project}/project-executions/dashboard:
    parameters:
      - name: project
        in: path
        required: true
        description: ID (UUID) do projeto.
        schema:
          type: string
        example: '{{project_id}}'
    get:
      tags:
        - projects
        - Execuções
      summary: Obter o painel de execuções do projeto
      description: >-
        Consolida o tempo trabalhado no projeto: total investido, número de
        sessões, duração média, distribuição por funil e etapa e o ranking de
        pessoas por tempo — indicando quem está executando no momento. Todos os
        tempos são em segundos.
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                description: Painel de execuções do projeto.
                type: object
                properties:
                  response:
                    type: boolean
                    description: Sempre true quando a operação é concluída.
                  dashboard:
                    type: object
                    description: Consolidação do tempo trabalhado no projeto.
                    properties:
                      total_time_invested:
                        type: integer
                        description: Tempo total investido no projeto, em segundos.
                      total_sessions:
                        type: integer
                        description: Quantidade de execuções registradas.
                      average_duration:
                        type: integer
                        description: Duração média de cada execução, em segundos.
                      distribution_by_funnel:
                        type: array
                        description: Distribuição do tempo por funil.
                        items:
                          description: Tempo por funil.
                          type: object
                          properties:
                            funnel_id:
                              type: integer
                              description: ID do funil.
                            funnel_name:
                              type: string
                              description: Nome do funil.
                            steps:
                              type: array
                              description: Distribuição do tempo por etapa.
                              items:
                                description: Tempo por etapa.
                                type: object
                                properties:
                                  step_id:
                                    type: integer
                                    description: ID da etapa.
                                  step_name:
                                    type: string
                                    description: Nome da etapa.
                                  time:
                                    type: integer
                                    description: Tempo acumulado na etapa, em segundos.
                                  percentage:
                                    type: number
                                    description: >-
                                      Participação da etapa no total, em
                                      percentual.
                      top_users_by_time:
                        type: array
                        description: Pessoas ordenadas por tempo dedicado.
                        items:
                          description: Tempo por pessoa.
                          type: object
                          properties:
                            user_id:
                              type: string
                              description: ID (UUID) da pessoa.
                              format: uuid
                            user_name:
                              type: string
                              description: Nome da pessoa.
                            time:
                              type: integer
                              description: Tempo dedicado por ela, em segundos.
                            percentage:
                              type: number
                              description: Participação dela no total, em percentual.
                            is_currently_executing:
                              type: boolean
                              description: Indica se ela está executando o projeto agora.
                            current_execution_id:
                              type: string
                              description: Execução em andamento dela, quando houver.
                              format: uuid
                            steps:
                              type: array
                              description: Distribuição do tempo por etapa.
                              items:
                                description: Tempo por etapa.
                                type: object
                                properties:
                                  step_id:
                                    type: integer
                                    description: ID da etapa.
                                  step_name:
                                    type: string
                                    description: Nome da etapa.
                                  time:
                                    type: integer
                                    description: Tempo acumulado na etapa, em segundos.
                                  percentage:
                                    type: number
                                    description: >-
                                      Participação da etapa no total, em
                                      percentual.
                required:
                  - response
                  - dashboard
              example:
                response: true
                dashboard:
                  total_time_invested: 14352
                  total_sessions: 6
                  average_duration: 2392
                  distribution_by_funnel:
                    - funnel_id: 36
                      funnel_name: Obras
                      steps:
                        - step_id: 181
                          step_name: Execução
                          time: 10120
                          percentage: 70.51
                        - step_id: 182
                          step_name: Conferência
                          time: 4232
                          percentage: 29.49
                  top_users_by_time:
                    - user_id: 019c1e87-63f4-71dd-a4e3-6eaea0619c2f
                      user_name: Ana Souza
                      time: 9840
                      percentage: 68.56
                      is_currently_executing: true
                      current_execution_id: a14afcbd-38b1-4b97-8950-02c09547611a
                      steps:
                        - step_id: 181
                          step_name: Execução
                          time: 9840
                          percentage: 100
                    - user_id: 019c1e88-2d70-71aa-9f04-6b5c1d8e4a37
                      user_name: Bruno Lima
                      time: 4512
                      percentage: 31.44
                      is_currently_executing: false
                      current_execution_id: null
                      steps:
                        - step_id: 182
                          step_name: Conferência
                          time: 4512
                          percentage: 100
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````