Wiki AdvPL e TLPP

Material de referência versionado, citado e checável sobre AdvPL e TLPP no ecossistema TOTVS Protheus.

Este repositório carrega, além do wiki, a coleção de 27 skills de AdvPL/TLPP em skills/ — usadas por agentes de código (Claude Code, Hermes) para gerar, migrar e revisar fontes seguindo os padrões TOTVS.

Regra do repositório

Uma afirmação sem fonte é tratada como lacuna declarada, não como texto. Toda linha factual carrega uma citação [n] que aponta para a lista de fontes.

Mapa de conteúdo

Seção	Escopo	Status
Fundamentos de AdvPL	Escopo de variáveis, funções, BEGIN SEQUENCE, workareas DBF, convenções	🟡 parcial
TLPP	tlpp-core, matriz TLPP × AdvPL, versão mínima por recurso, Try/Catch	🟡 parcial
MVC no Protheus	ModelDef/ViewDef/MenuDef/BrowseDef, FWFormModel/FWFormView	🟡 parcial
REST e APIs	Endpoints por anotação, oRest, OpenAPI nativa, cliente FWRest, Bearer	🟡 parcial
Pontos de Entrada	PE do MVC, PARAMIXB, IDs de momento, retorno	🟡 parcial
Dicionário de Dados (SX)	Mapa das tabelas SX, SIX, campos de controle, regras de leitura	🟡 parcial
Build e Compilação	CP-1252, includes, appserver.ini, Protheus em Docker	🟡 parcial
Migração AdvPL → TLPP	Migração mecânica, StaticCall, MVC por release, quando não migrar	🟡 parcial
Boas Práticas e Qualidade	Regras impostas pela TOTVS, workarea, segurança, ferramentas	🟡 parcial
Receitas	Ler/gravar tabela, PE MVC, endpoint REST, Bearer, JSON, CP-1252	🟡 parcial

Legenda: 🔴 pendente · 🟡 parcial · 🟢 ok

O que já está firme, e o que não está

Firme — 102 afirmações verificadas contra 52 fontes (40 em TDN ou domínios TOTVS): escopo de variáveis, matriz TLPP × AdvPL com a versão mínima de cada recurso, anatomia do MVC, REST por anotação, PE do MVC, mapa do dicionário, portão CP-1252 e a regra de StaticCall na migração.

Não está — e aparece marcado como > **Lacuna:** na própria seção, nunca como texto plausível:

• Parâmetros variadic em TLPP: sem fonte oficial.
• "Padrões TTALK": sem fonte primária.
• Detalhamento coluna a coluna de SX2, SX3, SX5, SX6, SX7, SX1, SX9 e SXB.
• RDMake passo a passo e depuração no SmartClient/Webapp.
• Exportação .xlsx, prevenção de SQL injection e SonarQube.

Como o conteúdo é produzido

1. A seção nasce com escopo declarado e nada afirmado (pendente).
2. Uma passada de pesquisa coleta evidência com URL por lane.
3. Um portão de verificação confere se a evidência sustenta a afirmação.
4. A síntese escreve a prosa com citações, e o status sobe para parcial/ok.

Os 102 fatos verificados estão em report.md; as regras e as lacunas, em Pesquisa.

Onde começar

• Escrever código AdvPL/TLPP → comece pelas skills em skills/; o mapa "qual skill usar" está no README.md de skills/.
• Entender o framework → MVC (telas) e REST e APIs.
• Trabalhar com dados → Dicionário SX antes de qualquer SQL.
• Levar código legado adiante → Migração e Boas Práticas.