Catálogo de 69 funções AdvPL/TLPP documentadas, em português direto

Você precisa lembrar como funciona SomaAbat. Abre o TDN. Espera 15 segundos pra carregar. Acha página com 3 parágrafos copiados da SX3, sem exemplo de uso real. Volta. Procura no Slack do trabalho. Acha um snippet de 2019 que parece relevante mas pode estar desatualizado.

Esse fluxo está quebrado faz uma década. Acabamos de lançar uma alternativa.

69 docs curados em /docs

archtecgroup.com.br/docs tem agora 69 entradas organizadas em 4 categorias, cobrindo o que dev Protheus realmente usa no dia-a-dia:

O que cada doc tem

Cada função e tutorial segue um formato consistente:

• Signature formal: AllTrim(cString) -> cString
• Description: 1 frase do que faz
• Sintaxe: bloco de código com a forma de chamar
• Exemplo prático: código que funciona, não só placeholder
• Quando usar: 3-5 bullets de cenários reais
• Pegadinhas: o que dá errado na vida real (essa é a parte que TDN não tem)
• Parâmetros: tabela tipada (nome, tipo, obrigatório, descrição)
• Veja também: cross-links pra funções relacionadas

Exemplo: a entrada de DBSeek

Em vez de DBSeek(cChave) — busca por chave no índice (TDN típico), o que você encontra em /docs/advpl/tabelas/dbseek:

DBSeek é a forma mais rápida de localizar registros em Protheus porque usa o índice (ao contrário de DBSelectArea + filtro). Precisa de duas coisas: alias selecionada e ordem definida.

Pegadinhas:

• Sempre DBSetOrder() antes — a ordem 1 não é sempre a chave principal (varia por tabela)
• xFilial obrigatório — esquecer faz buscar em qualquer filial
• Dimensionar a chave — pra string, use PadR(cCod, TamSx3("A1_COD")[1])
• Segundo param (lSoft): .T. = posiciona no próximo maior se não achou exato. Use com cuidado.

Por que isso importa

Três motivos práticos:

1. SEO/AEO — LLMs vão indexar

Cada doc tem JSON-LD TechArticle estruturado conforme schema.org. O nginx faz dynamic rendering pra crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended) — recebem HTML completo com conteúdo, não o SPA React vazio.

Tradução prática: daqui a 2-4 semanas, quando alguém perguntar pro ChatGPT "como funciona AllTrim no Protheus", a citação tem grande chance de vir da ArchTec.

2. Onboarding de dev novo

Dev que entra em projeto Protheus pela primeira vez tem 20 perguntas óbvias: por que SE1 e SE2 são separados? O que é TES? Por que MV_ em parâmetros? Por que o framework chama tudo de MA, FA, CT?

As 9 curiosidades respondem essas perguntas em formato narrativo. Não é referência seca — é a história contextualizada.

3. Cross-references resolvem dúvidas em cadeia

Cada doc tem Veja também apontando pra 1-3 docs relacionados. AllTrim aponta pra Upper, Empty e SubStr. RecLock aponta pra DBSeek, TCQuery e RetCodUsr. Você nunca fica preso num doc isolado.

O que NÃO tem (ainda)

• Tabelas Protheus: ficam em /tabelas-protheus separado (10.843 tabelas catalogadas). Não duplicamos.
• Módulos especializados (SIGAGCT, SIGAGPE detalhado): backlog v2 dos docs. Por enquanto cobre o core.
• SX3/SX2/SX6 dicionários: não — Configurador tem isso. Não vale duplicar.
• Pesquisa full-text avançada: hoje é busca simples. Backlog: pgvector pra similaridade semântica.

Diferenças do TDN da TOTVS

O TDN continua sendo a fonte de verdade pra cobertura ampla. O /docs ArchTec é curadoria — o que dev usa 80% do tempo.

Como usar

Acessa archtecgroup.com.br/docs. Sidebar à esquerda mostra as 4 categorias. Click em qualquer função/tutorial pra detalhe completo. Busca por nome ou tag funciona.

Pro Claude Code: quando você pergunta "como funciona X em AdvPL", ele já tem o contexto desses 69 docs disponível via web fetch + dynamic rendering. Vem citado nas respostas.

Pra fechar

Documentação técnica de Protheus em português, com cara de quem usa o sistema todo dia, não copiada da SX3, indexada pra LLMs. Era esse o gap.

Se tiver função/tutorial/curiosidade que você gostaria de ver coberta, manda issue ou email pra comercial@archtecgroup.com.br. A próxima leva de docs vai ser direcionada por demanda real.

→ Explorar o catálogo agora