Stratws

USE ESTA TOOL sempre que precisar da fórmula de cálculo de um indicador ou dos itens do desdobramento dele. Esses dados NÃO existem em indicator_list — lá só há os sinalizadores hasCalculationFormula e availableDrilldownTypes, que dizem se vale a pena chamar esta tool. Retorna, para uma lista de indicadores, os desdobramentos de cada um e as chaves dos indicadores relacionados — como explicar de onde vem o número de um indicador. Cada desdobramento tem um tipo: 'Formula' traz a expressão matemática (campo expression, com placeholders [Item N]) e os operandos em items; 'PorCesta' compõe o resultado do indicador por média ponderada, sem expressão — o peso de cada item vem em items[].weight (1 a 100); 'PorItens' é apenas um agrupamento organizacional. ATENÇÃO: um item de 'PorItens' NÃO é necessariamente uma parcela do indicador pai — confira affectsParentCalculation antes de somar os filhos, ou você reportará divergências inexistentes. Retorna UM nível: para descer na hierarquia, chame novamente com os items[].indicatorUid retornados. availableDrilldownTypes lista todos os tipos que o indicador possui, incluindo 'Hierarquico' e 'Dimensoes', que NÃO vêm expandidos aqui. Prefira identificar os indicadores por indicatorUids (o campo uid de indicator_list); indicatorIds, com o id numérico, segue aceito para compatibilidade. Cada item retornado traz indicatorUid, managementUnitName e measurementUnit do indicador relacionado, então dá para reusar o uid direto em indicator_list_values sem voltar ao indicator_list.

Responde "quais indicadores têm valor lançado no período e NÃO têm evidência (arquivo) anexada" — a pendência de comprovação que trava o fechamento de ciclo em processos de remuneração variável. Respeita a permissão do usuário atual (comum vê só sua UG, administrador vê a hierarquia, super usuário vê tudo no tenant) e nunca expõe nome de arquivo fora desse escopo. DEFINIÇÃO DE EVIDÊNCIA, importante para não reportar divergência como se fosse erro: conta apenas ARQUIVO anexado ao PRÓPRIO indicador. Link externo (Google Drive, URL) NÃO conta, e anexo feito no indicador base (template) NÃO é herdado pelos indicadores das unidades — a tela do indicador soma esses dois casos, então um indicador pode aparecer aqui como pendente e exibir anexo na tela. Isso é intencional: para auditoria, cada unidade comprova o seu resultado. NÃO AVALIE O CONTEÚDO: a tool informa que o anexo existe, o nome e a data — nunca conclua nem reporte que a evidência é válida, adequada ou suficiente; hasEvidence=true pode ser um arquivo irrelevante, e isso está fora do que o Stratws sabe. LEIA OS CONTADORES ANTES DE CONCLUIR: se indicatorsWithLaunchedValues vier 0, NADA foi avaliado — normalmente a frequência está errada (confira monthlyFrequency/weeklyFrequency/dailyFrequency em indicator_list) ou o painel informado não tem indicadores vinculados; nesse caso responda que nada foi avaliado, e JAMAIS que todos os indicadores têm evidência. Para agrupar por painel não é preciso segunda chamada: cada indicador já traz o campo panels. Para filtrar por painel use panelIds, obtendo os identificadores em results_program_list_panels — que exige resultsProgramId, vindo por sua vez de results_program_list. São duas chamadas antes desta, nessa ordem; pular a primeira faz a segunda falhar por parâmetro obrigatório ausente. AO APRESENTAR O RESULTADO, use sempre as mesmas colunas, na mesma ordem, seja a pergunta por UG, por painel ou por responsável: o indicador, se tem evidência e, para cada anexo, o nome do arquivo (fileName), QUEM ANEXOU (authorUserName), a DATA DE ENVIO (uploadedAt) e a quantidade (evidenceCount). Autor e data de envio são obrigatórios e não podem ser omitidos para encurtar a resposta: em auditoria eles são os dois eixos da rastreabilidade — sem a data não se sabe se a comprovação entrou no prazo do ciclo, e sem o autor não se sabe a quem recorrer sobre o arquivo. Anexo legado pode ter uploadedAt ou authorUserName nulo — nesse caso escreva "sem data registrada" / "autor não registrado" e mantenha a coluna, nunca estime a data a partir do período consultado nem atribua o anexo ao responsável do indicador. Não use includeAttachments=false quando a resposta for detalhar anexo: nesse modo attachments vem vazia e evidenceCount vem nulo por construção, e não há como cumprir o formato acima.

Retorna, em lote, os valores (real, meta, farol, percentual de atingimento) de uma lista de indicadores em um período/frequência — os indicadores retornados por indicator_list. Prefira identificá-los por indicatorUids (o campo uid); indicatorIds, com o id numérico, segue aceito para compatibilidade. Revalida a permissão de cada indicador: os que estiverem fora do que o usuário pode ver são silenciosamente excluídos do resultado.

Lista as unidades de medida cadastradas pela empresa no Stratws, com id e nome (ex.: Percentual, Reais, Toneladas, Dias). Chame esta tool quando o usuário citar uma unidade pelo nome e você precisar do identificador dela para filtrar indicadores por unidade de medida em indicator_list, e use o campo id — não o nome, que é traduzível e editável. Não tem parâmetro activeOnly: a unidade de medida não tem marcação de ativo; ela existe ou não existe.

Lista as áreas de resultado da empresa no Stratws, com id e nome (ex.: Financeiro, Clientes, Processos, Pessoas). A área de resultados é o agrupamento temático dos indicadores, cadastrado pelo cliente. Chame esta tool quando o usuário citar uma área pelo nome e você precisar do identificador dela, e use o campo id — não o nome, que é traduzível e editável. Use searchText para achar a área pelo termo que o usuário falou.

Lista os tipos de indicador cadastrados pela empresa no Stratws, com id, sigla e nome. O tipo é um cadastro do cliente, não uma entidade fixa do sistema: cada empresa registra os seus (ex.: PEX, PPR), e podem ser centenas — por isso a busca por texto e a paginação. Chame esta tool ANTES de indicator_list quando o usuário citar um tipo pelo nome ou pela sigla, e use o id retornado no filtro de indicator_list. Não tente adivinhar o id nem passar a sigla como filtro: a sigla é traduzível, editável pelo cliente e não é única. Não confunda com a natureza do indicador (quantitativo, qualitativo, cronograma), que é um atributo fixo do sistema e tem filtro próprio em indicator_list.

Lista os planos de gestão ativos do tenant do Stratws — use para descobrir o managementPlanId exigido por indicator_list, indicator_list_values e management_unit_list.

Lista as Unidades Gerenciais (UGs) que o usuário atual do Stratws pode ver em um plano de gestão — usuário comum vê só a UG vinculada, administrador vê a hierarquia, super usuário vê todas. Por padrão consulta o plano de gestão do ano atual; para anos anteriores, informe managementPlanId explicitamente (ver management_plan_list). Use para descobrir o managementUnitId a passar para indicator_list.

Cria um novo 1:1 com um colaborador em relação hierárquica direta (chefe/subordinado).

Edita um 1:1 existente — a lista de tópicos enviada substitui totalmente a lista atual.

Consulta o catálogo GENÉRICO de tópicos de pauta sugeridos pelo Stratws, por papel (líder/liderado) — as mesmas categorias para qualquer usuário, úteis para inspirar uma pauta nova. NÃO é o histórico de um 1:1 específico: para saber o que foi conversado ou combinado num encontro real, use meetings_get_topics.

Lê o CONTEÚDO de um 1:1 específico: os tópicos de pauta de cada participante com a anotação registrada em cada um (o que foi efetivamente conversado), mais a nota privada do próprio usuário autenticado. Use esta tool para responder o que foi combinado, tratado ou prometido num 1:1. Obtenha o meetingId por meetings_list. A nota privada de um participante nunca é visível ao outro.

Lista, de forma paginada, os 1:1s dos quais o usuário autenticado participa — tanto como liderado (Follower) quanto como líder/organizador de outro colaborador (Leader). Cada item traz OrganizerId/GuestId (quem agendou e quem foi convidado) e LeaderId/FollowerId (a hierarquia) — são eixos diferentes: um liderado pode agendar o 1:1 com o próprio chefe.

Grava a nota privada do usuário autenticado num 1:1. PRIVADA: nem o outro participante nem o RH têm acesso — é o caderno pessoal de preparação e impressões. Substitui a nota anterior por inteiro. Para o registro compartilhado do que foi conversado, use meetings_set_topic_notes.

Registra a anotação dos tópicos do usuário autenticado num 1:1 — o que foi conversado em cada ponto da pauta. NÃO altera data, horário, link nem local. Substitui integralmente a lista de tópicos do usuário: chame meetings_get_topics antes e reenvie os tópicos que devem permanecer, senão eles são removidos. Registre o que a pessoa disse, não um resumo seu — esta anotação é o registro da conversa. Visível ao outro participante.

Consulta o detalhamento de uma Solução de Problema do Stratws pelo seu identificador Guid, incluindo os campos do formulário (que variam conforme a classificação e o método) e os Planos de Ação vinculados com suas tarefas (actionPlanUids). Use o id retornado por problem_solutions_list, ou problem_solutions_get_detail_by_number quando o usuário informar o número em vez do Guid. IMPORTANTE ao inserir uma tarefa: se actionPlanUids tiver mais de um Guid, pergunte ao usuário em qual plano a tarefa deve entrar antes de chamar tasks_create — NUNCA escolha um por conta própria. Se tiver exatamente um, use-o diretamente sem perguntar. Se estiver vazio, use action_plan_list_available_steps e action_plan_create para criar o primeiro plano.

Consulta o detalhamento de uma Solução de Problema do Stratws pelo número (com ou sem o ano, ex. "1234" ou "1234/2026"), incluindo os campos do formulário e os Planos de Ação vinculados com suas tarefas. Use quando o usuário identificar a solução pelo número em vez do Guid — não é necessário chamar problem_solutions_list antes só para descobrir o Guid. Quando o número casar com mais de uma solução, a resposta orienta o próximo passo (informar o ano, ou buscar por descrição em problem_solutions_list e usar o id).

Lista as Soluções de Problema do Plano de Gestão atual às quais o usuário autenticado tem acesso, de forma paginada, com filtro opcional por unidade gerencial, intervalo de abertura, plano de gestão, busca textual na descrição (searchText) e número.

Consulta um Projeto do Stratws pelo identificador (Guid) OU pelo número, e devolve — além dos dados do projeto — o identificador do cronograma em scheduleUid, todos os planos de ação em actionPlanUids (essa lista JÁ INCLUI o scheduleUid, quando existir — não são conjuntos separados), as seções dinâmicas do formulário do projeto (sections — variam conforme classificação e método, igual ao OnePage) e os participantes (participants, só presente quando o método configura exibição de participantes). PARA VER TAREFAS (tasks_list): se o usuário pedir "as tarefas do projeto" de forma genérica, use scheduleUid (é onde elas normalmente ficam); use a lista completa de actionPlanUids quando ele quiser tudo, de todos os planos. PARA CRIAR UMA TAREFA (tasks_create): NUNCA infira que é no cronograma. Trate actionPlanUids como o conjunto completo de destinos possíveis (o cronograma é só mais um item dessa lista, sem prioridade sobre os demais). Se actionPlanUids tiver mais de um Guid, pergunte ao usuário em qual plano a tarefa deve entrar antes de chamar tasks_create — inclusive quando um deles é o cronograma. Só prossiga sem perguntar quando actionPlanUids tiver exatamente um Guid. scheduleUid vem nulo quando o projeto ainda não tem cronograma, o que é normal em fase inicial — nesse caso informe que não há cronograma em vez de tratar como erro. Para criar um plano novo (fora dos que já existem em actionPlanUids), use action_plan_list_available_steps e action_plan_create. Informe projectId OU projectNumber, nunca os dois. Prefira o número quando o usuário disser algo como "o projeto 1234/2026". ATENÇÃO: o número não é garantidamente único, nem dentro do mesmo ano — quando houver mais de uma correspondência a resposta orienta o próximo passo; siga a orientação ou pergunte ao usuário, nunca escolha um por conta própria.

Lista os Projetos do Stratws que o usuário pode ver, com busca opcional por descrição e filtro opcional por unidade gerencial. Cada projeto vem com a fase do workflow, a unidade gerencial, o líder e — o dado mais útil para avaliar execução — o percentual previsto contra o realizado. Use esta tool para BUSCAR ou NAVEGAR pelo portfólio (por nome/descrição, ou por unidade) — não para resolver um número específico: quando o usuário já der o NÚMERO de um projeto (ex.: "o projeto 1234/2026"), chame project_get diretamente. O número de um Projeto é definido por unidade gerencial/empresa/ano, nunca por plano de gestão, então repetir esta lista variando managementPlanId não é uma forma confiável de achá-lo — project_get já resolve isso corretamente (um resultado, "não encontrado", ou orientação de desambiguação quando o número não é único). Depois de identificar o projeto, o caminho para tarefas é project_get (que devolve o identificador do cronograma), depois tasks_list. Prefira este caminho a action_plan_list quando a pergunta partir do projeto, porque action_plan_list só encontra planos em que o próprio usuário tem tarefa — e quem gerencia um projeto normalmente não tem nenhuma. O campo hasSchedule diz se vale seguir para as tarefas: projeto em fase inicial pode ainda não ter cronograma. Para percorrer tudo, chamar repetidamente incrementando skip até esgotar totalCount.

Detalhe de notas, blocos e indicadores de uma janela já APURADA de um Programa de Resultados (RV) — o que o gestor vê ao abrir o painel de RV de um subordinado. USE SEMPRE 'results_program_list_apurations' PRIMEIRO: é lá que se descobre resultsProgramId, startDate e finishDate da janela apurada que você quer detalhar. Retorna só os titulares (usuários ou Unidades Gerenciais) que o usuário atual pode ver — nunca mais do que ele já veria no produto; um gestor comum recebe seus subordinados (árvore completa, não só diretos). Cada painel traz panelScore (decimal, para ordenar/comparar) e panelScoreFormatted (texto com a máscara do programa — use este ao responder ao usuário, nunca reformate o decimal por conta própria). Bloco sem nota (score nulo) significa que o programa não exibe nota numérica de bloco — não é ausência de dado. Gatilhos aparecem como um bloco chamado 'Gatilhos'. Se a mesma janela foi apurada mais de uma vez, usa automaticamente a execução mais recente; só falha pedindo apurationDate no caso raro em que nem isso resolve a ambiguidade com segurança. Nunca dispara apuração nem recalcula nota: lê só o que já está materializado. NOMENCLATURA e FORMATAÇÃO dos números são idênticas à tela, nunca use os termos internos do domínio nem invente símbolo: real e meta (indicador e bloco) usam esses mesmos nomes na tela — nunca chame de 'referência'/'resultado' ou 'actual'/'target' ao responder ao usuário. Ambos são grandezas cruas — mostre com separador de milhar e 2 casas decimais, SEM '%', mesmo que o indicador meça algo em percentual (o '(%)' no nome do indicador é a unidade de medida, não instrução de formatação). Só performanceAccumulatedValue e performanceValue (bloco) são percentuais de atingimento — esses sim multiplique por 100 e mostre com '%'.

Lista os Programas de Resultados (Remuneração Variável) de um plano de gestão que o usuário pode acessar — use para descobrir o resultsProgramId exigido por results_program_list_panels. Retorna apenas programas do novo modelo de painéis, com o tipo (usuário ou unidade gerencial) e os donos contratados.

Lista os Programas de Resultados (RV) que o usuário atual acessa em um ano, com os períodos que já foram APURADOS em cada um. Use como PRIMEIRO passo para responder qualquer pergunta sobre NOTAS ou RESULTADOS de apuração: é aqui que se descobre o programa e o período a consultar. ATENÇÃO — não confunda com results_program_list_panels, que lista a CONFIGURAÇÃO dos painéis (período contratado, blocos, pesos e quais indicadores compõem cada bloco) e NÃO retorna nota nenhuma: use aquela para saber o que foi combinado, e esta linha de tools para saber quanto a pessoa tirou. Retorna apenas os programas que o usuário já acessa no Stratws — não concede visibilidade adicional. Cada programa traz holderType ('User' ou 'ManagementUnit'), indicando se o titular do painel é uma pessoa ou uma Unidade Gerencial. A lista de apurações vazia significa que o programa existe e é acessível mas ainda NÃO foi apurado — nesse caso informe que a apuração precisa ser executada por um administrador no produto, e não tente apurar. Esta tool nunca executa apuração.

Lista os painéis de um Programa de Resultados, com o período contratado, os blocos e seus pesos, e os itens (indicadores/objetivos/metas) de cada bloco com seus pesos — use para saber o que já existe antes de criar ou alterar painéis em massa. Cada item traz o id do KPI (kpiId, e kpiLegacyId numérico no caso de indicador corporativo) e o nome (kpiName); o indicador corporativo traz também a unidade gerencial e o tipo cadastrado. Atenção aos dois ids distintos: o de cada painel (Panels[].Id) e o de cada contratação (Panels[].Contracts[].Id) — é o da **contratação** que alimenta contractIds em results_program_panel_bulk_add_block; passar o id do painel ali resulta em 'contratação não encontrada'.

Insere UM bloco (com seus indicadores) em várias contratações já existentes de um mesmo Programa de Resultados numa única chamada. **A operação não é transacional**: a resposta traz o resultado por contratação, com o motivo de cada recusa; relate ao usuário quais receberam o bloco e quais não. Máximo de 200 contratações por chamada.

Vincula VÁRIOS indicadores corporativos a blocos já existentes numa única chamada — create-only: um indicador já vinculado ao bloco falha o item (use results_program_panel_bulk_update_indicator_weight para atualizar o peso). **A operação não é transacional**: a resposta traz o resultado por item, com o motivo de cada recusa. Máximo de 200 itens por chamada.

Cria painéis em massa (contratação, e opcionalmente blocos e indicadores) para vários alvos (usuários ou unidades gerenciais) de um mesmo Programa de Resultados, todos com o mesmo período de contrato. Um evaluatedId que já tem painel neste programa falha só para aquele alvo — **a operação não é transacional**: a resposta traz o resultado por alvo, com o motivo de cada recusa; relate ao usuário quais foram criados e quais não. Máximo de 200 alvos por chamada. **Só funciona para Programas de Resultados SEM uma State Machine configurada** — se o programa informado tiver uma, a chamada inteira é rejeitada com uma mensagem de erro clara (nenhum painel é criado); nesse caso, informe ao usuário que a criação em massa não está disponível para esse programa e que os painéis precisam ser criados pela tela. Cada alvo criado com sucesso devolve DOIS ids distintos: PanelId (o painel, usado em results_program_list_panels) e ContractId (a contratação) — é o **ContractId** que alimenta contractIds em results_program_panel_bulk_add_block; passar o PanelId ali resulta em 'contratação não encontrada'.

Cria uma tarefa em um Plano de Ação ou Cronograma do Stratws. Só o plano, a descrição e o fim previsto são obrigatórios. O responsável pode ser um usuário do tenant (responsibleId) ou um terceiro sem usuário no sistema, informado por nome e e-mail juntos. Informe parentTaskId para criar a tarefa como subtarefa de outra. A tarefa nasce igual a uma criada pela tela, inclusive nas notificações. Repetir a chamada com a mesma descrição, responsável e datas no mesmo plano devolve a tarefa que já existe, sem criar outra.

Registra a execução (progresso) de uma tarefa de Plano de Ação, Cronograma ou Solução de Problemas do Stratws — o mesmo que a tela faz ao 'executar' uma tarefa. dataRealizada e comentario são OBRIGATÓRIOS, a mesma regra da tela (RealizarAtividadeModel exige os dois campos); se o usuário não informar algum dos dois, pergunte antes de chamar a tool, não invente valor. Quando percentualConcluido for 100, dataRealizada representa a CONCLUSÃO da tarefa (fim realizado) — pergunte 'quando a tarefa foi concluída', não 'qual a data de execução'. Para vincular uma tag no momento da execução, use tagNomes (não é preciso chamar tasks_update antes). Reenviar a mesma chamada (mesma tarefa, data, percentual e comentário) é seguro: não cria um segundo registro de histórico. 100% de conclusão encerra a tarefa, sujeito às mesmas regras da tela (aprovação de conclusão, tag obrigatória etc.).

Executa VÁRIAS tarefas numa única chamada — use no lugar de repetir tasks_execute quando o usuário está reportando progresso de várias tarefas do mesmo plano. dataRealizada e comentario são obrigatórios em cada item (mesma regra da tela); tagNomes é opcional por item, para vincular tag no momento da execução. Máximo 50 tarefas por chamada, sem repetir a mesma tarefa. **Não é transacional**: itens recusados não impedem os outros — relate ao usuário quais foram aplicadas e quais não, nunca assuma sucesso total.

Consulta o detalhe de uma tarefa do Stratws pelo seu Guid. Além do que a listagem já traz, devolve o 5W2H completo (causa, onde, por que, como, quanto previsto e realizado), código, criticidade, se é marco, os comentários da tarefa — incluindo os registrados na execução — e as subtarefas com responsável, datas, percentual e status. A tarefa e cada subtarefa trazem url, o link que abre a tela do Stratws — ofereça-o ao usuário. O Guid vem do campo id de tasks_list.

Lista as tarefas de um ou mais Planos de Ação ou Cronogramas do Stratws, identificados por Guid. Cada tarefa retorna com o plano a que pertence, o tipo desse plano (solução de problemas, cronograma, indicador, reunião etc.) e a entidade dona com sua descrição — não existe consulta separada de planos, a origem vem junto da tarefa. Uma mesma entidade costuma ter vários planos (uma solução de problemas tem um plano por ferramenta), por isso informe todos os identificadores de interesse de uma vez. Para percorrer tudo, chamar repetidamente incrementando skip até esgotar totalCount. Cada tarefa traz url, o link que abre a tarefa na tela do Stratws — ofereça-o ao usuário.

Altera campos de uma tarefa de Plano de Ação ou Cronograma do Stratws. Informe APENAS os campos que devem mudar: campo omitido não é alterado, e nunca é apagado. Aceita a descrição, os campos do 5W2H, as metas prevista e realizada, o início e o fim previstos (o fim é o prazo) e a troca de responsável — esta última exige justificativa. Respeita as mesmas regras da tela: em cronograma de projeto o nome da tarefa não é editável, plano que exige reprogramação recusa mudança direta de data, e tarefa finalizada ou com subtarefas tem restrições próprias. A resposta traz updatedFields, os campos que o Stratws aceitou aplicar — relate esses, e não o que foi pedido, porque uma regra pode ter recusado parte do pedido. Reenviar o mesmo patch é seguro: reaplica os mesmos valores sem criar histórico novo.

Altera VÁRIAS tarefas numa única chamada — use esta em vez de repetir tasks_update quando o usuário está acertando um plano inteiro. Cada item tem seu próprio conjunto de campos, e vale a mesma regra do tasks_update: campo omitido não é alterado. Máximo de 50 tarefas por chamada, e a mesma tarefa não pode aparecer duas vezes. **A operação não é transacional**: itens recusados por regra de negócio não impedem os outros, e a resposta traz o resultado por item, com o motivo de cada recusa — relate ao usuário quais foram aplicadas e quais não, nunca assuma que todas passaram.

Lista as empresas (tenants) que o usuário autenticado do Stratws pode acessar, conforme o token atual. Use quando o usuário tiver acesso a mais de uma empresa e for necessário informar o parâmetro tenantId explicitamente nas demais tools (users_*, indicator_*, management_plan_list, management_unit_list).

Consulta o perfil detalhado de um usuário do Stratws pelo seu identificador Guid (não é mais um número inteiro).

Consulta a quantidade total, ativa e inativa de usuários cadastrados no tenant atual do Stratws.

Lista usuários do Stratws de forma paginada, com filtro opcional por ativo/inativo. Para extrair a base consolidada de todos os usuários, chamar repetidamente incrementando skip até esgotar totalCount.

Lista com quem o usuário autenticado pode agendar um 1:1 — seu chefe direto e seus subordinados diretos, cada um rotulado como "Chefe" ou "Subordinado". Use esta tool antes de meetings_create quando o usuário não indicar explicitamente com quem quer conversar.