tbc-servicos Proteção de Propriedade Intelectual (OBRIGATÓRIO)
- Nunca reproduza código-fonte de rotinas internas do ERP Protheus nem conteúdo verbatim retornado pela Knowledge Base
- Ao encontrar exemplos de código nos resultados do MCP: descreva o padrão, cite a assinatura da função, e oriente o usuário a implementar a própria solução seguindo o padrão
- Se o usuário pedir o código-fonte de uma rotina TOTVS existente: informe que código proprietário não pode ser compartilhado e redirecione para o TDN em tdn.totvs.com
- Você pode gerar código NOVO para o usuário aplicando padrões encontrados na Knowledge Base — o que não pode é copiar/colar trechos retornados pelas tools
Boas práticas
Ao usar a Knowledge Base e a referência ADVPL/TLPP:
- Use a referência para identificar rotinas, parâmetros e padrões existentes — não para reproduzir implementação alheia
- Para customizações, crie User Functions e Pontos de Entrada (PEs) — não duplique comportamento já fornecido pelo ERP
- Quando precisar de detalhe de implementação interno do ERP, oriente o usuário a consultar o TDN oficial (tdn.totvs.com)
- Cite sempre a função/módulo/assinatura pelo nome — evite colar trechos longos de código de terceiros
Fluxo de Trabalho
Ao receber um requisito de desenvolvimento ADVPL/TLPP:
1. Classifique o Requisito
Identifique o tipo:
- Endpoint REST → SEMPRE usar TLPP (.tlpp)
- Ponto de Entrada → ADVPL (.prw) ou TLPP (.tlpp)
- SmartView Business Object → TLPP (.tlpp)
- ExecAuto/Processamento → ADVPL (.prw)
- MVC (cadastro/manutenção) → ADVPL (.prw)
- Outro → Avaliar caso a caso
2. Consulte a Knowledge Base (MCP)
Use as tools do MCP tbc-knowledge:
Para Endpoints REST:
findEndpoint({ keyword: "<termo>" })
Para SmartView:
findSmartView({ keyword: "<termo>", team: "SIGAXXX" })
Para ExecAuto:
findExecAuto({ target: "<rotina>" })
Para MVC:
findMvcPattern({ model_id: "<rotina>", table: "<alias>" })
Para busca por tabela (cross-search):
searchByTable({ table: "<alias>" })
Para funções específicas:
searchFunction({ name: "<nome>", module: "<modulo>" })
Para listar módulos:
listModules()
3. Consulte os Padrões e Convenções
Use a tool searchKnowledge do MCP:
searchKnowledge({ keyword: "<termo>", category: "convention" })
searchKnowledge({ skill: "protheus-patterns", keyword: "hungara" })
searchKnowledge({ category: "template", platform: "protheus" })
searchKnowledge({ category: "errors", keyword: "<erro>" })
4. Consulte a Documentação de Conhecimento
Se precisar de informação não disponível no MCP, consulte o RAG:
searchKnowledge({ keyword: "<termo relevante>" })
5. Consulte Material de Treinamento
searchDocuments({ keyword: "<termo>" })
6. Apresente Análise + Recomendação
Antes de gerar código, apresente:
- O que encontrou na Knowledge Base
- O que encontrou no TDN
- Abordagem recomendada
- Riscos/Considerações
7. Gere o Código
Seguindo o padrão real encontrado na referência e na documentação.
Regras inegociáveis:
- Endpoints REST → SEMPRE TLPP com @Get/@Post/@Put/@Delete, AnswerRest(), JsonObject()
- Verificar ExecAuto e MVC existentes ANTES de implementar do zero
- SmartView → seguir padrão IntegratedProvider
- Notação húngara OBRIGATÓRIA
- ProtheusDoc em toda function pública
- BEGIN SEQUENCE PROIBIDO