Nomenclatura Hierárquica Padronizada

Gramática estruturada de alta consistência via IA: [Dominio].[Modificador]*.[Acao]

Descrição do Componente ou Recurso Atalho: Ctrl + Enter

Exemplos rápidos:

Sufixo Técnico (Opcional) Padrão recomendado: limpo, sem redundância

Nome Canônico Corporativo

Bedrock DeepSeek V3

Decomposição de Níveis

Identificador de Código (Python / TS)

Recurso AWS (S3 / Dynamo / SQS)

Racional da Taxonomia:

Custo & Consumo da Consulta

DeepSeek V3

Custo (USD = R$ 5,16) - -

Tokens Entrada -

Tokens Saída -

Latência -

Motor: DeepSeek V3 (Amazon Bedrock) Região: us-east-1

Chamada de API Protegida (cURL)

POST GET (Docs)

/api/suggest

Especificação técnica completa e guia de integração para desenvolvedores.

Ver Schema JSON ↗

Finalidade do Endpoint

Extrai e gera nomenclaturas padronizadas seguindo a gramática corporativa: [Dominio-Entidade] . [Modificador-Processo]* . [Acao-Operacao]. Alimentado exclusivamente pelo modelo DeepSeek V3 no Amazon Bedrock.

Autenticação Obrigatória

✓ Header: x-api-key: SUA_CHAVE (Recomendado)
✓ Header: Authorization: Bearer SUA_CHAVE
✓ Query: ?key=SUA_CHAVE

Parâmetros do Payload JSON

Campo	Tipo	Obrigatório	Descrição & Comportamento
description	string	Sim	Texto livre em linguagem natural explicando o que o componente faz.
domain	string	Opcional	Força manualmente a entidade raiz (ex: `clientes`). Se omitido, a IA infere.
modifier	string	Opcional	Força qualificador de subprocesso ou recurso derivado (ex: `faturamento`).
action	string	Opcional	Força a operação (normalizada para infinitivo em português, ex: `consultar`).
resource_type	string	Opcional	Sufixo de tecnologia (ex: `lambda`, `fn`, `bucket`). Padrão: omitido.

Formatos de Saída Retornados

canonical (Pontos) clientes.faturamento.mensal.consultar

Padrão corporativo para tópicos, registros e documentação.

code_identifier (Duplo _) clientes__faturamento__mensal__consultar

Para nomes de funções, métodos e classes em código Python/JS.

aws_resource (Duplo -) clientes--faturamento--mensal--consultar

Para nomes de Lambdas, filas SQS, tópicos SNS e tabelas DynamoDB.

kebab_flat (Hífen Único) clientes-faturamento-mensal-consultar

Para nomes de diretórios, repositórios git e slugs de URL.

Exemplos Práticos para Integração

Clique em "Testar no Formulário" para experimentar

Exemplo 1

Sub-recurso de Entidade Raiz

Descrição: "servico para consultar faturamento mensal de clientes"

➔ clientes.faturamento.mensal.consultar

A entidade raiz é 'clientes'. O sub-recurso é 'faturamento', qualificado por 'mensal'. Ação: 'consultar'.

Exemplo 2

Ação Direta sobre Domínio Médico

Descrição: "uma funcao que pega procedimentos medicos uma tabela e classifica"

➔ procedimentos-medicos.classificar

Domínio composto por hífen. Ação normalizada para infinitivo sem termos genéricos.

Exemplo 3

Cálculo Fiscal Específico

Descrição: "calcular imposto de renda retido na fonte"

➔ imposto-renda.retido-fonte.calcular

Domínio 'imposto-renda', qualificador 'retido-fonte', ação direta 'calcular'.

Exemplo 4

Com Sufixo Técnico de Recurso

Descrição: "emissao de nota fiscal eletronica" | Sufixo: lambda

➔ nota-fiscal.eletronica.emitir.lambda

Quando solicitado expressamente, o tipo técnico é adicionado como último nível.