Provides patterns and templates for technical documentation of ADVPL/TLPP code in TOTVS Protheus, including Protheus.doc headers, routine docs, and REST API endpoints.
From advpl-specialistnpx claudepluginhub thalysjuvenal/advpl-specialist --plugin advpl-specialistThis skill uses the workspace's default tool permissions.
Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
Patterns and templates for generating technical documentation from ADVPL/TLPP source code on TOTVS Protheus.
Standard documentation header following TOTVS conventions:
/*/{Protheus.doc} NomeFuncao
Descricao breve do que a funcao faz.
@type User Function | Static Function | Method
@author Nome do autor
@since DD/MM/YYYY
@version 1.0
@param cParam1, Character, Descricao do parametro 1
@param nParam2, Numeric, Descricao do parametro 2
@return Tipo, Descricao do retorno
@example
cResult := NomeFuncao("ABC", 123)
@see FuncaoRelacionada1, FuncaoRelacionada2
@obs Observacoes adicionais
@history DD/MM/YYYY, Autor, Descricao da alteracao
/*/
Fields:
# NomeDaRotina
## Objetivo
[O que essa rotina faz em 1-2 frases]
## Tipo
[User Function | Static Function | Class Method | Job | Entry Point]
## Modulo
[COM | FAT | FIN | EST | CTB | FIS | PCP | MNT]
## Tabelas
### Leitura
| Alias | Descricao | Campos usados |
|-------|-----------|---------------|
| SA1 | Clientes | A1_COD, A1_NOME, A1_CGC |
### Gravacao
| Alias | Descricao | Campos gravados |
|-------|-----------|-----------------|
| SC5 | Pedidos de venda | C5_NUM, C5_EMISSAO, C5_VALOR |
## Parametros MV_*
| Parametro | Descricao | Impacto |
|-----------|-----------|---------|
| MV_ESTADO | UF padrao | Define UF quando nao informada |
## Pontos de Entrada
| Nome | Momento | O que permite |
|------|---------|---------------|
| MT100LOK | Apos validacao do modelo | Validacao customizada |
## Fluxo de Execucao
1. Valida parametros de entrada
2. Posiciona na tabela SA1
3. Calcula valores
4. Grava na SC5
5. Retorna resultado
## Dependencias
| Funcao | Arquivo | Tipo |
|--------|---------|------|
| fCalcImposto | MATA461.prw | Static Function |
## Historico de Alteracoes
| Data | Autor | Descricao |
|------|-------|-----------|
| 01/01/2026 | Thalys Augusto | Criacao |
# API: NomeDoEndpoint
## Endpoint
`METHOD /api/v1/recurso`
## Autenticacao
Bearer Token (Authorization header)
## Parametros
### Path Parameters
| Nome | Tipo | Obrigatorio | Descricao |
|------|------|-------------|-----------|
### Query Parameters
| Nome | Tipo | Obrigatorio | Descricao |
|------|------|-------------|-----------|
### Request Body
```json
{
"campo1": "string",
"campo2": 0
}
```
## Response
### 200 OK
```json
{
"success": true,
"data": {}
}
```
### 400 Bad Request
```json
{
"success": false,
"error": "descricao do erro"
}
```