Patterns

Nomenclatura de Arquivos Fonte

Padrão obrigatório: R[MOD][TYPE][SEQ].prw (ex: RFATA001.prw).

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "nomenclatura" })

---

Notacao Hungara (OBRIGATORIA)

Referência de prefixos (c/n/l/d/a/b/o) e exemplos de uso.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "hungara" })

---

Cabecalho ProtheusDoc

Estrutura obrigatória para toda User Function pública (@type, @version, @author, @since, @param, @return).

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "ProtheusDoc" })

---

Estrutura de Programa ADVPL

Includes básicos e estrutura de programa ADVPL/TLPP.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "estrutura" })

---

Tratamento de Erros

Padrões de tratamento: guard clauses, ErrorBlock e try/catch/finally.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "tratamento erros" })

---

Acesso a Banco de Dados

Padrões de busca com MsSeek, gravação com RecLock, commit e rollback.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "banco dados" })

---

Dicionario de Dados — Convencoes

Convenções de naming para tabelas customizadas (SZ?), campos customizados (prefixo X), parâmetros (TB_) e índices.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "dicionario dados" })

---

Pontos de Entrada — Padrao MVC e Legado

Regra de unicidade: 1 PE por arquivo. Padrão MVC e padrão legado com exemplos.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "pontos entrada" })

---

MVC — ModelDef / ViewDef / MenuDef

Estrutura de modelos MVC com FWFormModel, FWFormView e rotinas de menu.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "MVC" })

---

FWMBrowse (lista de registros)

Exemplo de FWMBrowse para listagem com filtros, legendas e formatação.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "FWMBrowse" })

---

Semaforos e Numeracao Sequencial

Uso de GetNextCode para sequenciais e SemDecrease/SemIncrease para locks de recurso.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "semaforo" })

---

Namespaces (TLPP)

Padrão obrigatório FSW.TBC.. Regras de user/static function. Chamadas entre namespaces com u_.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "namespace" })

---

Estrutura de Pastas do Projeto de Fontes

Organização de fontes por módulo (FAT/FIN/EST/COM) com subdiretórios A/E/P/R.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "estrutura pastas" })

---

Funcoes Nativas — Referencia Completa

Referência de funções nativas: String, Data/Hora, Array, Banco de Dados, Interface, Sistema.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "funcoes nativas" })

---

Tabelas do Dicionário de Dados (SX)

Tabelas de sistema (SX1-SX9, SIX) e campos relevantes (SX3, SX5).

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "tabelas SX" })

---

Erros Comuns e Soluções

Tabelas de diagnóstico para erros de compilação, runtime, performance e locks.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "erros comuns" })

---

Pontos de Entrada Frequentes por Módulo

Referência de PEs por módulo (FAT/FIN/EST/COM) com momentos e tipos de retorno.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "pontos entrada modulo" })

---

Code Analysis (antes do commit)

Ferramenta obrigatória antes de commitar qualquer fonte.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "code analysis" })

---

Git — Branches

Convenções de branching para projetos Protheus.

Consulte a referência completa via MCP:

searchKnowledge({ skill: "protheus-patterns", keyword: "git branches" })

---

Consulta de Conhecimento

Se precisar de informação não disponível no MCP, consulte o RAG:

searchKnowledge({ keyword: "" })

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: tbc-servicos
• Source: tbc-servicos/dataagile-agent-kit
• License: MIT
• Homepage: https://dataagile-agent-kit.dataagile.com.br

Install and usage instructions live in the source repository linked above.