Estrutura inicial, ambiente IA

2026-05-14 09:54:24 -03:00
commit 48095a3c64
49 changed files with 4596 additions and 0 deletions
@@ -0,0 +1,33 @@
+---
+name: vitruvio-form-review
+description: "Revise e ajuste formularios e processos Vitruvio em XML ou BPMN. Use para validar namespace, skeleton, bind com defaultValue, eventos como initScript, valueChange, onClickScript, itemChange, scripts CDATA em Rhino ES5 e compatibilidade com componentes Vitruvio."
+argument-hint: "Descreva o formulario, componente ou regra que precisa revisar."
+---
+
+# Revisao de Formulario Vitruvio
+
+## Quando usar
+- Ajustes ou revisao de arquivos `.xml` e `.bpmn` do Vitruvio.
+- Erros de bind, evento, componente, namespace ou estrutura do formulario.
+- Duvidas sobre em qual evento implementar uma regra de negocio.
+
+## Objetivo
+Revisar a estrutura do formulario antes da alteracao, aplicar apenas mudancas compativeis com Vitruvio e confirmar que o script Rhino esta encaixado no evento certo.
+
+## Procedimento
+1. Identifique se o artefato e formulario web, mobile ou XML de processo. Se a demanda for claramente mobile-only, prefira o agente especialista de mobile.
+2. Confira a estrutura base: namespace oficial, `schemaLocation`, `descriptorScript`, `form`, `name`, `initScript`, `validators` e `buttons`.
+3. Valide os blocos de `bind`; todo `parameter` deve conter `defaultValue`.
+4. Mapeie o comportamento pedido para o evento correto usando o [checklist de revisao](./references/checklist.md).
+5. Confirme componentes e IDs existentes antes de adicionar novos atributos ou trocar a hierarquia do XML.
+6. Se houver script em `CDATA`, aplique Rhino ES5: `var`, concatenacao incremental de SQL e HTML, e comparacoes com Java usando `==` ou `!=`.
+7. Reaproveite padroes existentes no repositorio antes de criar estruturas novas.
+8. Ao concluir, explique o que foi alterado, o evento escolhido e qualquer risco residual de runtime.
+
+## Saida esperada
+- XML ou BPMN ajustado com mudancas minimas e compativeis com producao.
+- Explicacao curta do motivo do evento e da estrutura escolhida.
+- Registro claro do que foi validado na revisao.
+
+## Recursos
+- [Checklist de revisao](./references/checklist.md)
@@ -0,0 +1,29 @@
+# Checklist de Revisao
+
+## Estrutura base
+- Preserve o namespace `http://www.davinti.com.br/vitruvio/form` e o `schemaLocation` oficial na raiz quando o artefato for formulario Vitruvio.
+- Confirme a presenca e a ordem logica dos blocos `descriptorScript`, `form`, `name`, `initScript`, `validators` e `buttons` quando o tipo de arquivo usar esse skeleton.
+- Mantenha IDs e nomes existentes sempre que possivel para evitar quebra de bind e scripts acoplados.
+
+## Bind e dados
+- Em `bind`, todo `parameter` precisa de `defaultValue`, inclusive para `string`, `number` e `date`.
+- Reuse parametros ja existentes antes de criar novos binds paralelos.
+- Se a alteracao depende de variavel de processo, confira se ela sai de `execution.getVariable` ou se precisa ser registrada no `initScript`.
+
+## Escolha de evento
+- `initScript`: inicializacao de globais, filtros padrao, datas iniciais e estado de tela.
+- `valueChange`: recarga de campos dependentes e widgets quando filtros mudam.
+- `itemChange`: persistencia e validacao de celulas editaveis em `DBTable`.
+- `onClickScript`: acoes principais como gerar, enviar, processar ou abrir fluxo auxiliar.
+- `TabChangeScript`: alternancia de abas e atualizacao de widgets dependentes da aba atual.
+
+## Script embarcado
+- Use apenas sintaxe compativel com Rhino ES5.
+- Monte SQL e HTML com concatenacao incremental.
+- Use `engine.getField`, `engine.getLabel`, `engine.getWidget` e `engine.setGlobalVariable` seguindo os padroes do repositorio.
+- Evite criar validacoes redundantes para componentes que ja existem em tela.
+
+## Fontes internas do workspace
+- `Vitruvio/Documentação/eventos-vitruvio.md`
+- `Vitruvio/Documentação/Componentes/README.md`
+- `Vitruvio/Documentação/Componentes/*.ts`