@fontdata/ai-harness 4.3.1 → 4.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +2 -2
- package/README.md +154 -3
- package/dist/cli.js +1 -0
- package/dist/config/config.js +45 -3
- package/dist/delphi/catalogo.js +299 -0
- package/dist/delphi/classificar.js +21 -0
- package/dist/delphi/command.js +144 -2
- package/dist/delphi/encoding.js +112 -0
- package/dist/doctor/checks.js +19 -1
- package/dist/init.js +16 -2
- package/dist/install/perfis.js +21 -0
- package/dist/install/plan.js +29 -2
- package/dist/install/settings.js +40 -3
- package/dist/mapa/extratores/pascal.js +1 -1
- package/dist/update/update.js +126 -7
- package/package.json +1 -1
- package/templates/CLAUDE.md +2 -1
- package/templates/catalog.json +11 -3
- package/templates/hooks/comentarios/check.mjs +62 -5
- package/templates/hooks/hooks.json +2 -1
- package/templates/hooks/lib/config.mjs +1 -0
- package/templates/hooks/padroes-proibidos.mjs +68 -0
- package/templates/perfis/delphi/hooks/encoding.mjs +317 -0
- package/templates/perfis/delphi/rules/build-e-verificacao.md +59 -0
- package/templates/perfis/delphi/rules/dados/cnpj-alfanumerico-nao-extrair-so-numeros.md +65 -0
- package/templates/perfis/delphi/rules/dados/data-hora-sql-nunca-round-trip-textual.md +78 -0
- package/templates/perfis/delphi/rules/dados/datestyle-sessao-firedac-postgres.md +60 -0
- package/templates/perfis/delphi/rules/dados/ddl-tabela-nova-exige-trigger-de-log.md +68 -0
- package/templates/perfis/delphi/rules/dados/divisao-e-conversao-numerica.md +53 -0
- package/templates/perfis/delphi/rules/dados/fieldbyname-value-variant-cru-em-aritmetica.md +73 -0
- package/templates/perfis/delphi/rules/dados/filtro-condicional-sql-par-add-parambyname.md +72 -0
- package/templates/perfis/delphi/rules/dados/firedac.md +51 -0
- package/templates/perfis/delphi/rules/dados/macro-firedac-exige-entrada-macrodata.md +96 -0
- package/templates/perfis/delphi/rules/dados/sql-qualificacao-colunas.md +36 -0
- package/templates/perfis/delphi/rules/dados/tmeminifile-getstrings-nao-limpa-destino.md +89 -0
- package/templates/perfis/delphi/rules/encoding-eol.md +130 -0
- package/templates/perfis/delphi/rules/linguagem/dataset-nao-se-le-depois-do-laco-eof.md +56 -0
- package/templates/perfis/delphi/rules/linguagem/existencia-nunca-se-testa-por-campo-formatado.md +60 -0
- package/templates/perfis/delphi/rules/linguagem/float-nunca-comparado-por-igualdade-com-literal.md +55 -0
- package/templates/perfis/delphi/rules/linguagem/literal-enum-de-dfm-exige-unit-no-uses.md +84 -0
- package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +172 -0
- package/templates/perfis/delphi/rules/linguagem/sem-clipboard-debug.md +43 -0
- package/templates/perfis/delphi/rules/linguagem/validacao-em-onexit-nao-protege-a-gravacao.md +65 -0
- package/templates/perfis/delphi/rules/linguagem/variavel-inline-sai-de-escopo-ao-envolver-bloco.md +69 -0
- package/templates/perfis/delphi/rules/telas/foco-decisao-por-canfocus-nao-tabstop.md +40 -0
- package/templates/perfis/delphi/rules/telas/form-dinamico-liberar-em-toda-saida.md +80 -0
- package/templates/perfis/delphi/rules/telas/heranca-de-form-e-grade-de-selecao.md +58 -0
- package/templates/perfis/delphi/rules/threads-e-timers.md +131 -0
- package/templates/perfis/delphi/rules/try-finally-e-vazamento.md +109 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +70 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/ATRIBUICAO.md +29 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/acbr-nfce-integracao.md +60 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/build-via-bat-com-log.md +86 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/class-var-vaza-para-campos-de-instancia.md +73 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/componentes-designer-vs-runtime.md +47 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/console-writeln-sem-flush-nao-loga.md +47 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/conversao-numerica-locale.md +47 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/delphi13-breaking-changes.md +41 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/dpr-uses-project-manager.md +62 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-dcc-debuginformation-nao-booleano.md +78 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-projectguid-valido.md +38 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/firedac-registro-drivers.md +94 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/horse-gbswagger-rotas-jwt.md +61 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/msb6003-command-line-too-long.md +52 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/recursos-rcdata.md +67 -0
- package/templates/perfis/delphi-fiscal/rules/campo-novo-acbr-preenchimento-explicito.md +61 -0
- package/templates/perfis/delphi-fiscal/rules/retorno-de-evento-nfe-pelo-cstat.md +51 -0
- package/templates/perfis/delphi-fiscal/rules/sucesso-de-webservice-fiscal-nao-prova-documento.md +100 -0
- package/templates/perfis/delphi-fiscal/rules/total-tributo-acbr-soma-itens.md +63 -0
- package/templates/perfis/delphi-fiscal/skills/diagnosticar-rejeicao-nfse/SKILL.md +155 -0
- package/templates/perfis/delphi-fiscal/skills/patch-acbr/SKILL.md +143 -0
- package/templates/skills/auditar-performance/SKILL.md +9 -0
- package/templates/skills/auditar-performance/references/pontos-quentes.md +8 -0
- package/templates/skills/auditar-seguranca/SKILL.md +55 -14
- package/templates/skills/auditar-seguranca/templates/relatorios/TECNICO.md +5 -0
- package/templates/skills/auditar-ui/SKILL.md +18 -3
- package/templates/skills/auditar-ui/references/ATRIBUICAO.md +44 -0
- package/templates/skills/auditar-ui/references/web-interface-guidelines.md +191 -0
- package/templates/skills/harness/references/validar-ideia.md +7 -6
- package/templates/skills/security-audit/AI-AND-LLM.md +83 -0
- package/templates/skills/security-audit/ATTACK-CLASSES.md +130 -0
- package/templates/skills/security-audit/CLIENT-SIDE.md +83 -0
- package/templates/skills/security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
- package/templates/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
- package/templates/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
- package/templates/skills/security-audit/HUNTING.md +251 -0
- package/templates/skills/security-audit/LICENSE +21 -0
- package/templates/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
- package/templates/skills/security-audit/ORIGEM.md +51 -0
- package/templates/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
- package/templates/skills/security-audit/RECONNAISSANCE.md +156 -0
- package/templates/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
- package/templates/skills/security-audit/SKILL.md +192 -0
- package/templates/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
- package/templates/skills/security-audit/VALIDATION-AND-REPORTING.md +186 -0
- package/templates/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
- package/templates/skills/security-audit/report-schema.json +461 -0
- package/templates/skills/security-audit/validate-coverage-ledger.cjs +872 -0
- package/templates/skills/security-audit/validate-findings.cjs +773 -0
- package/templates/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
- package/templates/skills/supabase-postgres-best-practices/LICENSE +21 -0
- package/templates/skills/supabase-postgres-best-practices/ORIGEM.md +43 -0
- package/templates/skills/supabase-postgres-best-practices/SKILL.md +64 -0
- package/templates/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
- package/templates/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
- package/templates/skills/supabase-postgres-best-practices/references/_template.md +34 -0
- package/templates/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
- package/templates/skills/vercel-react-best-practices/AGENTS.md +3810 -0
- package/templates/skills/vercel-react-best-practices/ORIGEM.md +39 -0
- package/templates/skills/vercel-react-best-practices/README.md +123 -0
- package/templates/skills/vercel-react-best-practices/SKILL.md +149 -0
- package/templates/skills/vercel-react-best-practices/metadata.json +15 -0
- package/templates/skills/vercel-react-best-practices/rules/_sections.md +46 -0
- package/templates/skills/vercel-react-best-practices/rules/_template.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
- package/templates/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
- package/templates/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
- package/templates/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
- package/templates/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
- package/templates/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
- package/templates/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
- package/templates/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
- package/templates/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
- package/templates/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
- package/templates/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
- package/templates/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
- package/templates/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
- package/templates/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
- package/templates/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
- package/templates/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
- package/templates/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
- package/templates/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
- package/templates/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
- package/templates/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
- package/templates/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
- package/templates/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
- package/templates/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
- package/templates/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
- package/templates/skills/vercel-react-native-skills/AGENTS.md +2897 -0
- package/templates/skills/vercel-react-native-skills/ORIGEM.md +39 -0
- package/templates/skills/vercel-react-native-skills/README.md +165 -0
- package/templates/skills/vercel-react-native-skills/SKILL.md +121 -0
- package/templates/skills/vercel-react-native-skills/metadata.json +16 -0
- package/templates/skills/vercel-react-native-skills/rules/_sections.md +86 -0
- package/templates/skills/vercel-react-native-skills/rules/_template.md +28 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
- package/templates/skills/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
- package/templates/skills/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
- package/templates/skills/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-images.md +53 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
- package/templates/skills/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
- package/templates/skills/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
- package/templates/skills/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
- package/templates/skills/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
- package/templates/skills/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
- package/templates/skills/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
- package/templates/skills/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
- package/templates/skills/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-menus.md +174 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-pressable.md +61 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-styling.md +87 -0
package/templates/perfis/delphi/rules/linguagem/existencia-nunca-se-testa-por-campo-formatado.md
ADDED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
---
|
|
2
|
+
descricao: "Regra incondicional: existência de registro nunca se testa por campo formatado para exibição"
|
|
3
|
+
paths:
|
|
4
|
+
- "**/*.pas"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.dpk"
|
|
7
|
+
- "**/*.inc"
|
|
8
|
+
- "**/*.dfm"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Regra incondicional: existência de registro nunca se testa por campo formatado para exibição
|
|
12
|
+
|
|
13
|
+
Aplica-se a toda guarda que decide **se um registro relacionado existe** antes de fazer UPDATE,
|
|
14
|
+
DELETE, reabertura ou conversão a partir dele — documento de origem, nota principal, título
|
|
15
|
+
financeiro, ordem vinculada, e afins.
|
|
16
|
+
|
|
17
|
+
## O que é proibido
|
|
18
|
+
|
|
19
|
+
Testar existência pelo `.Text` de um controle preenchido com zeros à esquerda (ou qualquer
|
|
20
|
+
formatação de exibição):
|
|
21
|
+
|
|
22
|
+
```pascal
|
|
23
|
+
// PROIBIDO: completar '' com 9 zeros dá '000000000' — este teste é sempre True
|
|
24
|
+
EditNumeroVinculado.Text := CompletarZeros(FieldByName('numero_vinculado').AsString, 9);
|
|
25
|
+
...
|
|
26
|
+
if EditNumeroVinculado.Text <> '' then
|
|
27
|
+
ParamByName('cod_filial').AsInteger := StrToInt(FilialVinculada); // StrToInt('')
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
O `LEFT OUTER JOIN` devolve NULL, `AsString` devolve `''`, e a formatação de exibição **apaga a
|
|
31
|
+
diferença entre "não existe" e "existe com valor zero"**. A guarda deixa de guardar.
|
|
32
|
+
|
|
33
|
+
## O que fazer
|
|
34
|
+
|
|
35
|
+
A existência se testa pela **chave vinda do dataset**, antes de qualquer formatação:
|
|
36
|
+
|
|
37
|
+
```pascal
|
|
38
|
+
if (StrToIntDef(FilialVinculada, 0) > 0) and (Trim(SerieVinculada) <> '') then
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Se o campo de origem for opcional (`LEFT JOIN`, coluna anulável), prefira `FieldByName(...).IsNull`
|
|
42
|
+
ou a chave crua. E use `StrToIntDef(..., 0)` em vez de `StrToInt` ao converter qualquer valor que
|
|
43
|
+
possa vir de coluna anulável — `StrToInt('')` derruba o fluxo inteiro com uma mensagem que não diz
|
|
44
|
+
nada ao usuário ("'' is not a valid integer value").
|
|
45
|
+
|
|
46
|
+
## Por que escapa da revisão
|
|
47
|
+
|
|
48
|
+
O teste `<> ''` parece defensivo — é exatamente o que se espera ver ali. A falha só aparece quando
|
|
49
|
+
o registro relacionado **não existe**, e o desenvolvedor testa com o caso em que ele existe. O erro
|
|
50
|
+
costuma chegar pelo suporte, e o mesmo padrão pode estar latente em outro ramo, disparando um UPDATE
|
|
51
|
+
com chave zero em vez de uma exceção.
|
|
52
|
+
|
|
53
|
+
## Antes de fechar a alteração
|
|
54
|
+
|
|
55
|
+
- Para cada `if <Controle>.Text <> ''` numa guarda de existência, verifique **onde aquele `.Text`
|
|
56
|
+
foi atribuído**. Se houver preenchimento com zeros, `Format` ou máscara no caminho, a guarda está
|
|
57
|
+
quebrada.
|
|
58
|
+
- Teste os **dois** casos: com e sem o registro relacionado. O fluxo feliz não distingue os dois.
|
|
59
|
+
- `grep -n "StrToInt(" <unit>.pas` nos blocos tocados: nenhuma conversão de coluna anulável pode
|
|
60
|
+
usar `StrToInt` sem default.
|
package/templates/perfis/delphi/rules/linguagem/float-nunca-comparado-por-igualdade-com-literal.md
ADDED
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
---
|
|
2
|
+
descricao: "Regra: valor Double nunca é comparado por igualdade com literal decimal — comparar em inteiros ou com tolerância"
|
|
3
|
+
paths:
|
|
4
|
+
- "**/*.pas"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.dpk"
|
|
7
|
+
- "**/*.inc"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra incondicional: valor `Double` nunca é comparado por igualdade com literal decimal
|
|
11
|
+
|
|
12
|
+
Aplica-se a toda comparação de alíquota, percentual, quantidade ou valor lido como `Double` (`AsFloat`, campo
|
|
13
|
+
`Double` de classe, retorno de função) contra um número com casas decimais: `= 0.65`, `= 1.65`, `<> 7.6`, `in`.
|
|
14
|
+
|
|
15
|
+
## O defeito
|
|
16
|
+
|
|
17
|
+
No dcc32 Win32, o literal `0.65` é avaliado como `Extended` (80 bits). O `Double` lido do banco é a aproximação de 64
|
|
18
|
+
bits do mesmo número. Os dois não são iguais, e a comparação dá falso **sempre**, mesmo com a coluna `numeric(8,2)`
|
|
19
|
+
guardando exatamente `0.65`:
|
|
20
|
+
|
|
21
|
+
```pascal
|
|
22
|
+
// PROIBIDO: nunca é verdadeiro em Win32 quando Percentual vem de AsFloat
|
|
23
|
+
if (Self.Percentual = 0.65) or (Self.Percentual = 1.65) then
|
|
24
|
+
Result := '01'
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
O código compila, o ramo errado roda em silêncio e o resultado parece regra de negócio, não bug. Um defeito assim
|
|
28
|
+
pode passar anos em produção gerando o valor errado para todo registro com aquele número exato.
|
|
29
|
+
|
|
30
|
+
## Padrão obrigatório
|
|
31
|
+
|
|
32
|
+
Compare em inteiros, na escala da coluna, ou com tolerância explícita:
|
|
33
|
+
|
|
34
|
+
```pascal
|
|
35
|
+
// CERTO: centésimos inteiros (coluna com 2 casas)
|
|
36
|
+
var LPercentualCentesimos := Round(Self.Percentual * 100);
|
|
37
|
+
if (LPercentualCentesimos = 65) or (LPercentualCentesimos = 165) then
|
|
38
|
+
|
|
39
|
+
// CERTO: tolerância explícita
|
|
40
|
+
if SameValue(Self.Percentual, 0.65, 0.0001) then // System.Math
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
- A comparação com **zero** é segura, porque zero é exato nos dois tipos.
|
|
44
|
+
- `Currency` é decimal de ponto fixo e não tem o problema, mas só quando os **dois** lados são `Currency`.
|
|
45
|
+
- Uma função de arredondamento que devolve `Double` não resolve: arredondar e depois comparar com literal mantém o
|
|
46
|
+
defeito.
|
|
47
|
+
|
|
48
|
+
## Antes de fechar a alteração
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
grep -nE "(AsFloat|Percentual|Aliquota|Valor)[A-Za-z]*\)? *(=|<>) *[0-9]+\.[0-9]" <unit>.pas
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Toda ocorrência entre `Double` e literal decimal usa o padrão acima. Teste com o valor exato do literal, como 0,65, e
|
|
55
|
+
não só com valores vizinhos.
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
---
|
|
2
|
+
descricao: "Regra incondicional: valor de enum lido no `.dfm` NÃO prova que o identificador está visível — localize a unit que o declara"
|
|
3
|
+
paths:
|
|
4
|
+
- "**/*.pas"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.dpk"
|
|
7
|
+
- "**/*.inc"
|
|
8
|
+
- "**/*.dfm"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Regra incondicional: valor de enum lido no `.dfm` NÃO prova que o identificador está visível — localize a unit que o declara
|
|
12
|
+
|
|
13
|
+
Aplica-se a toda edição de `.pas` que passe a **atribuir em código** um valor de enumerado (ou
|
|
14
|
+
constante) que até então só era conhecido por aparecer num `.dfm` — típico ao começar a preencher em
|
|
15
|
+
runtime uma propriedade de componente de terceiro (ACBr, ReportBuilder, Rx) que estava definida
|
|
16
|
+
apenas em design-time.
|
|
17
|
+
|
|
18
|
+
## O `.dfm` guarda o identificador como TEXTO e resolve por RTTI em runtime
|
|
19
|
+
|
|
20
|
+
Quando um `.dfm` traz uma linha como:
|
|
21
|
+
|
|
22
|
+
```
|
|
23
|
+
Cedente.PIX.TipoChavePIX = tchNenhuma
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
isso **não** significa que `tchNenhuma` seja alcançável a partir do `uses` daquela unit. O streaming
|
|
27
|
+
da VCL grava o nome do valor como **string** e o converte para o ordinal via **RTTI, em tempo de
|
|
28
|
+
execução** — a unit que **declara** o enum precisa apenas estar **linkada no executável** (o que
|
|
29
|
+
acontece transitivamente, pelo `uses` do próprio componente), **nunca** no `uses` da unit que hospeda
|
|
30
|
+
o `.dfm`.
|
|
31
|
+
|
|
32
|
+
Ou seja: o `.dfm` prova que o valor **existe em algum lugar do projeto**; não prova **nada** sobre
|
|
33
|
+
visibilidade em tempo de compilação. Na primeira linha de código que usar o literal, o build acusa:
|
|
34
|
+
|
|
35
|
+
```
|
|
36
|
+
[dcc32 Error] E2003 Undeclared identifier: 'tchNenhuma'
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
O engano é convidativo porque o raciocínio parece sólido ("está no `.dfm` desta unit, logo compila
|
|
40
|
+
aqui") e porque **o erro só aparece na compilação** — nenhuma leitura de código o revela.
|
|
41
|
+
|
|
42
|
+
## Procedimento obrigatório
|
|
43
|
+
|
|
44
|
+
**Antes** de escrever a primeira atribuição, localize a unit que **declara** o identificador nos
|
|
45
|
+
fontes da biblioteca — não deduza pelo nome da unit "irmã" mais óbvia:
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
# macOS/Linux (com os fontes da biblioteca acessíveis):
|
|
49
|
+
grep -rn "tchNenhuma" "<pasta-dos-fontes-da-biblioteca>" --include="*.pas"
|
|
50
|
+
|
|
51
|
+
# Windows:
|
|
52
|
+
findstr /S /C:"tchNenhuma" <pasta-dos-fontes-da-biblioteca>\*.pas
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Acrescente **essa** unit ao `uses` — na `implementation`, se os literais só aparecem no corpo dos
|
|
56
|
+
métodos (o caso normal); na `interface` apenas se o tipo entrar em alguma assinatura.
|
|
57
|
+
|
|
58
|
+
> **Exemplo:** no ACBr, `TACBrPIXTipoChave = (tchNenhuma, tchEmail, tchCPF, tchCNPJ, tchCelular,
|
|
59
|
+
> tchAleatoria)` é declarado em **`ACBrPIXBase.pas`** — **não** em `ACBrBoletoConversao`, que seria o
|
|
60
|
+
> palpite natural por ser a unit de conversões do `ACBrBoleto` e já estar no `uses`. A propriedade que o
|
|
61
|
+
> consome é `TACBrCedentePIX.TipoChavePIX: TACBrPIXTipoChave`, em `ACBrBoleto.pas`.
|
|
62
|
+
|
|
63
|
+
## Ao adicionar a unit, confirme que os OUTROS builds continuam compilando
|
|
64
|
+
|
|
65
|
+
Quando o mesmo `.pas` é compilado por mais de um projeto (sob `{$ifdef ...}` ou com search paths
|
|
66
|
+
próprios), antes de acrescentar um `uses` **incondicional** verifique se a unit nova já é dependência
|
|
67
|
+
de algo que aqueles projetos inevitavelmente compilam:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
grep -n "ACBrPIXBase" "<pasta-dos-fontes-da-biblioteca>/ACBrBoleto/ACBrBoleto.pas"
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Se o **próprio componente** já faz `uses` dela, todo projeto que compila o componente já tem a unit no
|
|
74
|
+
search path → a inclusão é segura **sem guarda de define**. Se **não** for esse o caso, coloque o
|
|
75
|
+
`uses` sob a mesma guarda condicional usada pelos vizinhos, ou o build de outro projeto quebra sem
|
|
76
|
+
que nada neste repositório o denuncie.
|
|
77
|
+
|
|
78
|
+
## O sintoma quando esta regra é ignorada
|
|
79
|
+
|
|
80
|
+
Um ciclo de build desperdiçado: a análise de impacto passa, a revisão de código aprova (o identificador
|
|
81
|
+
"existe", afinal), e o `E2003` só aparece quando o usuário compila na IDE — no fim da tarefa, quando
|
|
82
|
+
tudo já parecia entregue. Se o erro citar **todos** os literais de um mesmo enum (e não um ou outro
|
|
83
|
+
nome divergente), a causa é **esta** — falta a unit no `uses` —, e não nome de literal errado por
|
|
84
|
+
diferença de versão da biblioteca.
|
package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md
ADDED
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
---
|
|
2
|
+
descricao: "Regra incondicional: antes de criar qualquer rotina utilitária, PROCURE nas bibliotecas compartilhadas e no próprio sistema"
|
|
3
|
+
paths:
|
|
4
|
+
- "**/*.pas"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.dpk"
|
|
7
|
+
- "**/*.inc"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra incondicional: antes de criar qualquer rotina utilitária, PROCURE nas bibliotecas compartilhadas e no próprio sistema
|
|
11
|
+
|
|
12
|
+
Aplica-se a toda criação de `function`/`procedure` **utilitária** — validação de formato, extração,
|
|
13
|
+
máscara, conversão, cálculo de dígito, manipulação de string/data/arquivo — em qualquer `.pas` do
|
|
14
|
+
projeto, seja como método privado de um form, seja como rotina de DataModule. Complementa
|
|
15
|
+
[../dados/cnpj-alfanumerico-nao-extrair-so-numeros.md](../dados/cnpj-alfanumerico-nao-extrair-so-numeros.md).
|
|
16
|
+
|
|
17
|
+
## A busca é obrigatória e vem ANTES da primeira linha do corpo
|
|
18
|
+
|
|
19
|
+
Escrever o helper leva dois minutos, e é exatamente por isso que ele é escrito sem busca. O custo
|
|
20
|
+
não está na escrita: está no **segundo lugar da verdade** que passa a existir para a mesma pergunta
|
|
21
|
+
— e que ninguém mantém junto quando a regra muda.
|
|
22
|
+
|
|
23
|
+
Ordem obrigatória, do compartilhado para o local:
|
|
24
|
+
|
|
25
|
+
1. **Mapa do projeto.** Se o `CLAUDE.md`, o `harness-projeto.md` ou outra documentação do projeto lista
|
|
26
|
+
as bibliotecas utilitárias da casa e o que cada uma cobre, comece por ali.
|
|
27
|
+
2. **Bibliotecas compartilhadas** (units utilitárias usadas por vários sistemas, no search path do
|
|
28
|
+
projeto):
|
|
29
|
+
```bash
|
|
30
|
+
grep -rnE "^\s*(class )?(function|procedure) [A-Za-z]*<termo>" <pasta-das-bibliotecas> --include="*.pas"
|
|
31
|
+
```
|
|
32
|
+
3. **O próprio sistema — como as outras telas resolvem ISTO?**
|
|
33
|
+
```bash
|
|
34
|
+
grep -rn "<termo>" --include="*.pas" . | head -30
|
|
35
|
+
```
|
|
36
|
+
4. **A RTL do Delphi** (`System.SysUtils`, `System.StrUtils`, `System.DateUtils`, `System.Math`,
|
|
37
|
+
`System.IOUtils`, `System.Character`): muita "rotina utilitária" já existe ali.
|
|
38
|
+
|
|
39
|
+
Procure por sinônimos (`SomenteNumeros`, `ExtrairNumeros`, `ApenasDigitos`, `OnlyNumbers`) e em
|
|
40
|
+
português e inglês. O passo 3 é o mais revelador e o mais pulado: mesmo sem função pronta, o
|
|
41
|
+
projeto costuma já ter um **idioma consagrado** para a pergunta, repetido em várias units.
|
|
42
|
+
Reproduzi-lo vale mais do que inventar uma variação.
|
|
43
|
+
|
|
44
|
+
> **Se a unit já tem uma biblioteca utilitária no `uses`, a busca nela é obrigatória sem qualquer
|
|
45
|
+
> desculpa.** A capacidade costuma estar a uma linha de distância, na unit já referenciada.
|
|
46
|
+
|
|
47
|
+
## Código novo usa as bibliotecas `Fontdata.*`, nunca `BibMarco`
|
|
48
|
+
|
|
49
|
+
Vale para projetos que usam as bibliotecas `Fontdata` (confira se `Fontdata.Utils` ou `Fontdata.MessageDialog`
|
|
50
|
+
aparece no `uses` de alguma unit). Unit nova, e trecho novo dentro de unit legada (handler, rotina, método),
|
|
51
|
+
**não** chamam a `BibMarco`. O equivalente está nas bibliotecas `Fontdata`:
|
|
52
|
+
|
|
53
|
+
| `BibMarco` (legado) | Código novo |
|
|
54
|
+
|---|---|
|
|
55
|
+
| `Mensagem(msg, mtWarning, [mbOk], 0)` | `TMessageDialog.Warning(msg)` |
|
|
56
|
+
| `Mensagem(msg, mtInformation, [mbOk], 0)` | `TMessageDialog.Info(msg)` |
|
|
57
|
+
| `Mensagem(msg, mtError, [mbOk], 0)` | `TMessageDialog.Error(msg)` |
|
|
58
|
+
| `Mensagem(msg, mtConfirmation, [mbYes, mbNo], 0) = mrYes` | `TMessageDialog.Question(msg)` (`Boolean`) |
|
|
59
|
+
| `CompletaZeros(valor, n)` | `TUtils.CompletarZeros(valor, n)` |
|
|
60
|
+
| `ExtrairNumeros(texto)` | `TUtils.ExtrairNumeros(texto)` |
|
|
61
|
+
|
|
62
|
+
- `TMessageDialog` vem de `Fontdata.MessageDialog`, e `TUtils` de `Fontdata.Utils`. Os dois entram no `uses` da
|
|
63
|
+
`implementation`.
|
|
64
|
+
- O legado de uma unit existente **não** é migrado por tabela: só o trecho que a task cria ou reescreve segue o
|
|
65
|
+
padrão novo. A `BibMarco` continua no `uses` enquanto o legado da unit a usar.
|
|
66
|
+
- Função da `BibMarco` sem equivalente em `Fontdata.*` vira pergunta ao usuário. Não recrie a função na unit
|
|
67
|
+
nova.
|
|
68
|
+
|
|
69
|
+
## Helpers de componente das bibliotecas `Fontdata`
|
|
70
|
+
|
|
71
|
+
Vale para projetos que já têm `Bibliotecas\Helpers` no search path do `.dproj`. Confira antes:
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
grep -n "Bibliotecas\\\\Helpers" *.dproj
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
As units de helper fazem `uses Fontdata.Utils`, então `Bibliotecas\Utils` também precisa estar no search path.
|
|
78
|
+
Se algum dos caminhos não aparece, **não** acrescente ao `.dproj` por conta própria: pergunte ao usuário.
|
|
79
|
+
|
|
80
|
+
Uma unit por framework (`Fontdata.Helpers.VCL`, `Fontdata.Helpers.FMX`, `Fontdata.Helpers.UniGUI`), no `uses` da
|
|
81
|
+
`implementation`.
|
|
82
|
+
|
|
83
|
+
**Consulte o catálogo antes de escrever.** O que cada unit `Fontdata.*` do search path declara (helpers, classes,
|
|
84
|
+
rotinas, com a assinatura) está em `.claude/skills/conhecimento-delphi/references/bibliotecas-fontdata.md`. O
|
|
85
|
+
arquivo é gerado no projeto, não vem no pacote: se ele não existir, gere com
|
|
86
|
+
`npx @fontdata/ai-harness delphi catalogo`, e rode o comando de novo quando as units mudarem (o `doctor` avisa).
|
|
87
|
+
|
|
88
|
+
Label só tem helper na VCL. `TSwitch` só na FMX. `Replace` só existe na VCL (edit e label); FMX e UniGUI não têm.
|
|
89
|
+
|
|
90
|
+
| Código manual | Helper | Semântica exata |
|
|
91
|
+
|---|---|---|
|
|
92
|
+
| `StrToCurrDef(Edit.Text, 0)` / `StrToFloat(...)` | `Edit.AsCurrency` / `Edit.AsFloat` | `TUtils.ConverterValor(Text)`: tira `R`, `$` e `%` em qualquer posição, os espaços só das pontas e **todos** os `.`; qualquer `(`, em qualquer posição, torna o valor negativo; vazio vira `0`; depois `StrToFloat` (ver armadilhas) |
|
|
93
|
+
| `StrToIntDef(Edit.Text, 0)` | `Edit.AsInteger` | `StrToIntDef(TUtils.ExtrairNumeros(Text), 0)` |
|
|
94
|
+
| `Edit.Text := CurrToStr(v)` (e `FloatToStr`, `IntToStr`, `DateToStr`, `TimeToStr`, `DateTimeToStr`) | `Edit.AsCurrency := v` (e `AsFloat`, `AsInteger`, `AsDate`, `AsTime`, `AsDateTime`) | o setter chama exatamente essa função da RTL |
|
|
95
|
+
| `StrToDateDef(Edit.Text, Date)` | `Edit.AsDate` | `StrToDateDef(Text, DateOf(Now))` |
|
|
96
|
+
| `StrToTimeDef(Edit.Text, Time)` | `Edit.AsTime` | `StrToTimeDef(Text, TimeOf(Now))` |
|
|
97
|
+
| `StrToDateTimeDef(Edit.Text, Now)` | `Edit.AsDateTime` | `StrToDateTimeDef(Text, Now)` |
|
|
98
|
+
| `Edit.Text = ''` | `Edit.IsEmpty` / `Edit.NotIsEmpty` | compara o texto **sem** `Trim` |
|
|
99
|
+
| `Trim(Edit.Text) = ''` | `Edit.Trim = ''` | **não** é `Edit.IsEmpty`: `' '` não é vazio para `IsEmpty` |
|
|
100
|
+
| `TUtils.ExtrairNumeros(Edit.Text)` | `Edit.ExtractNumbers` | a mesma chamada |
|
|
101
|
+
| `QuotedStr(Edit.Text)` | `Edit.QuotedString` | `String.QuotedString` (aspas simples, duplicando as internas) |
|
|
102
|
+
| `Edit.Text = 'X'` / `Pos('X', Edit.Text) > 0` | `Edit.Equals('X')` / `Edit.Contains('X')` (e `NotEquals`, `NotContains`) | diferencia maiúsculas de minúsculas |
|
|
103
|
+
| `UpperCase`, `LowerCase`, `Copy`, `Length` sobre o texto | `Edit.ToUpper`, `Edit.ToLower`, `Edit.Substring(i[, n])`, `Edit.Length` | métodos de `String`; `Substring` começa em **0**, `Copy` em 1 |
|
|
104
|
+
| `if CheckBox.Checked then 'S' else 'N'` (e o inverso) | `CheckBox.Value` (FMX: também `Switch.Value`) | leitura devolve `'S'`/`'N'`; escrita marca só com `'S'` exato |
|
|
105
|
+
| `StrToCurrDef(Label.Caption, 0)` e afins (só VCL) | `Label.AsCurrency`, `Label.IsEmpty`... | os mesmos métodos do edit, sobre `Caption` |
|
|
106
|
+
|
|
107
|
+
### Armadilhas
|
|
108
|
+
|
|
109
|
+
- **`AsDate`, `AsTime` e `AsDateTime` não validam.** Texto inválido ou vazio devolve a data de hoje, a hora atual
|
|
110
|
+
ou `Now`, sem erro. Nunca use para validar entrada: valide antes (`TryStrToDate` ou a validação da tela) e só
|
|
111
|
+
depois leia pelo helper.
|
|
112
|
+
- **`AsCurrency` e `AsFloat` levantam exceção.** Ao contrário do que o `Def` do código manual sugere, texto não
|
|
113
|
+
numérico (`'abc'`) gera `EConvertError` do `StrToFloat`; só o vazio vira `0`. E `AsCurrency` passa por `Double`.
|
|
114
|
+
- **Dependem do locale.** `ConverterValor` remove todo `.` (milhar no padrão brasileiro) e deixa a vírgula para o
|
|
115
|
+
`StrToFloat` com o `DecimalSeparator` da máquina: `'1.50'` vira `150`, e numa máquina com separador `.` o
|
|
116
|
+
`'1,50'` falha. Os setters (`CurrToStr`, `DateToStr`...) e `AsDate`/`AsTime` também seguem as configurações
|
|
117
|
+
regionais.
|
|
118
|
+
- **`AsInteger` extrai dígitos antes de converter.** `'-5'` vira `5`, `'1,50'` vira `150`, `'abc'` vira `0`. Não
|
|
119
|
+
serve para número com sinal ou decimal.
|
|
120
|
+
- **`CheckBox.Value := 's'` desmarca.** A comparação com `'S'` diferencia maiúsculas.
|
|
121
|
+
- **Só um class helper por classe vale num escopo**: o da última unit do `uses` vence. Um segundo helper de
|
|
122
|
+
`TCustomEdit` (ou de `TCheckBox`, `TCustomLabel`) no projeto desliga este, e os métodos "somem" sem aviso claro. Um helper de classe descendente (ex.: `TEdit`) também esconde o de
|
|
123
|
+
`TCustomEdit` nas variáveis daquele tipo.
|
|
124
|
+
Antes de criar helper próprio para essas classes, procure os existentes (`grep -rn "class helper for" --include="*.pas" .`).
|
|
125
|
+
- **Nomes que coincidem com outros.** `Edit.Equals('X')` compara texto, não é o `TObject.Equals(Obj)`;
|
|
126
|
+
`Edit.Length` e `Edit.Trim` são do helper e devolvem o tamanho / o texto aparado, não alteram o componente.
|
|
127
|
+
Dentro de um método do form, `Trim(...)` e `Length(...)` sem qualificador continuam sendo da RTL. Leia com atenção.
|
|
128
|
+
|
|
129
|
+
O legado **não** é migrado: só código novo ou reescrito usa o helper, como na tabela de `Fontdata.*` acima. Antes
|
|
130
|
+
de trocar uma conversão manual, compare o caso de borda (vazio, inválido, negativo) conforme a seção seguinte.
|
|
131
|
+
|
|
132
|
+
## Reaproveitar não é copiar a chamada — é preservar a SEMÂNTICA
|
|
133
|
+
|
|
134
|
+
A rotina existente quase nunca tem exatamente o contrato do helper que você ia escrever. **Compare
|
|
135
|
+
os casos de borda antes de substituir**, um a um: string vazia, `nil`, zero, negativo, acento,
|
|
136
|
+
valor fora de faixa.
|
|
137
|
+
|
|
138
|
+
O caso de borda que costuma divergir é o **vazio**:
|
|
139
|
+
|
|
140
|
+
```pascal
|
|
141
|
+
// helper local removido: False para vazio
|
|
142
|
+
Result := ATexto <> '';
|
|
143
|
+
if not Result then Exit;
|
|
144
|
+
|
|
145
|
+
// ExtrairNumeros(''): devolve '' — logo ExtrairNumeros(T) = T é TRUE para vazio
|
|
146
|
+
// -> o guard de vazio faz parte da substituição, não é redundância:
|
|
147
|
+
if (Texto <> '') and (ExtrairNumeros(Texto) = Texto) then
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
Sem esse cuidado, a "simplificação" muda o comportamento em silêncio — e o caminho quebrado é
|
|
151
|
+
justamente o do campo em branco, que o teste do fluxo feliz nunca exercita.
|
|
152
|
+
|
|
153
|
+
## Quando criar é a resposta certa
|
|
154
|
+
|
|
155
|
+
Criar rotina nova é legítimo quando a busca **foi feita** e mostrou que nada cobre o caso. Nesse
|
|
156
|
+
caso, decida **onde** ela mora antes de escrevê-la:
|
|
157
|
+
|
|
158
|
+
| A rotina serve... | Mora em |
|
|
159
|
+
|---|---|
|
|
160
|
+
| só a esta tela, e depende do estado dela | método privado do próprio form |
|
|
161
|
+
| a este módulo (fiscal, estoque, financeiro) | o DataModule ou a unit do módulo |
|
|
162
|
+
| a qualquer sistema da casa, sem depender deste | a biblioteca compartilhada — **se for outro repositório, exige aprovação do usuário** |
|
|
163
|
+
|
|
164
|
+
Um helper genérico (sem nenhuma dependência do form) nascendo como método privado de um form é
|
|
165
|
+
sinal de que a pergunta de "onde mora" não foi feita.
|
|
166
|
+
|
|
167
|
+
## Antes de fechar a alteração
|
|
168
|
+
|
|
169
|
+
- Para **cada** rotina nova declarada no diff, registre na resposta **qual busca foi feita** e o que
|
|
170
|
+
ela retornou. "Não encontrei nada" só vale acompanhado do comando que produziu o vazio.
|
|
171
|
+
- Se a rotina nova reproduz um idioma que já existe em outras units, **use o idioma existente** — a
|
|
172
|
+
consistência vale mais que a marginal elegância da versão nova.
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
---
|
|
2
|
+
descricao: "Regra incondicional: nunca deixar escrita de debug no Clipboard em código de produção"
|
|
3
|
+
paths:
|
|
4
|
+
- "**/*.pas"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.dpk"
|
|
7
|
+
- "**/*.inc"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra incondicional: nunca deixar escrita de debug no Clipboard em código de produção
|
|
11
|
+
|
|
12
|
+
Aplica-se a toda unit `.pas` do projeto. É proibido deixar, em código entregue, escrita no
|
|
13
|
+
clipboard usada como apoio de depuração — tipicamente o SQL de uma `TFDQuery` copiado para a
|
|
14
|
+
área de transferência durante a montagem/execução de uma consulta.
|
|
15
|
+
|
|
16
|
+
## O que é proibido
|
|
17
|
+
|
|
18
|
+
Linhas como estas, dentro de rotinas de montagem/execução de query (ou qualquer fluxo de
|
|
19
|
+
negócio), são **debug** e não podem ser commitadas:
|
|
20
|
+
|
|
21
|
+
```pascal
|
|
22
|
+
Clipboard.AsText := SQL.Text; // copia o SELECT para o clipboard — PROIBIDO em produção
|
|
23
|
+
Clipboard.SetTextBuf(...); // idem, qualquer escrita de depuração no clipboard
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
- Elas sobrescrevem silenciosamente o que o usuário tinha copiado — o cliente cola o SELECT
|
|
27
|
+
sem entender o porquê. O erro só aparece em runtime, para o usuário final.
|
|
28
|
+
- O sintoma típico: o usuário digita num campo de filtro de uma tela e, sem pedir, o texto do
|
|
29
|
+
SELECT montado vai parar no clipboard.
|
|
30
|
+
|
|
31
|
+
## O que continua permitido
|
|
32
|
+
|
|
33
|
+
Escrita/limpeza de clipboard que faz parte de uma **funcionalidade real** pedida pelo usuário
|
|
34
|
+
(ex.: botão "Copiar chave", `Clipboard.Clear` para proteger um dado sensível). O critério é:
|
|
35
|
+
a operação de clipboard pertence ao fluxo de negócio (acionada por um controle/intenção do
|
|
36
|
+
usuário) e não a uma inspeção de SQL/variável de desenvolvimento.
|
|
37
|
+
|
|
38
|
+
## Antes de fechar a alteração
|
|
39
|
+
|
|
40
|
+
- Faça `Grep` (sem diferenciar caixa) por `Clipboard.AsText :=` e `Clipboard.SetTextBuf` na unit
|
|
41
|
+
alterada e confirme que nenhuma escrita de clipboard foi introduzida como apoio de debug.
|
|
42
|
+
- Se precisar inspecionar o SQL durante o desenvolvimento, use o debugger/log temporário e
|
|
43
|
+
**remova antes do commit** — nunca o clipboard.
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
---
|
|
2
|
+
descricao: "Regra incondicional: validação no `OnExit` NÃO protege a gravação — revalide no ponto de gravação o que não pode ser gravado"
|
|
3
|
+
paths:
|
|
4
|
+
- "**/*.pas"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.dpk"
|
|
7
|
+
- "**/*.inc"
|
|
8
|
+
- "**/*.dfm"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Regra incondicional: validação no `OnExit` NÃO protege a gravação — revalide no ponto de gravação o que não pode ser gravado
|
|
12
|
+
|
|
13
|
+
Aplica-se a toda validação de campo-chave de documento feita no `OnExit` (série, filial, número,
|
|
14
|
+
código fiscal, fornecedor) que **impede** um documento inválido: série de outra filial, série
|
|
15
|
+
desativada, combinação de tipos incompatível, etc. Complementa
|
|
16
|
+
[../telas/foco-decisao-por-canfocus-nao-tabstop.md](../telas/foco-decisao-por-canfocus-nao-tabstop.md).
|
|
17
|
+
|
|
18
|
+
## O `Exit` do handler só sai do handler
|
|
19
|
+
|
|
20
|
+
Várias telas preenchem outra tela **por código**, chamando os eventos dela em sequência:
|
|
21
|
+
|
|
22
|
+
```pascal
|
|
23
|
+
FormDocumento.DocumentoProprio := True;
|
|
24
|
+
FormDocumento.EditSerie.Text := EditSerieOrigem.Text;
|
|
25
|
+
FormDocumento.EditSerieExit(Self); // mostra "Série não permitida" e dá Exit...
|
|
26
|
+
FormDocumento.EditNumeroExit(Self); // ...e o chamador segue normalmente
|
|
27
|
+
// lança itens, ShowModal — a série bloqueada continua no campo
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
A mensagem aparece, o teste manual "vê o bloqueio" e dá o caso por aprovado. O documento **grava
|
|
31
|
+
mesmo assim**, porque:
|
|
32
|
+
|
|
33
|
+
- o `Exit` não se propaga para quem chamou o evento;
|
|
34
|
+
- o estado que o bloqueio desfaz na digitação manual (ex.: `DocumentoProprio := False`) costuma
|
|
35
|
+
ser **preservado de propósito** no fluxo automatizado (`if not FLancamentoAutomatico then`);
|
|
36
|
+
- o botão de gravar confia que o `OnExit` já validou.
|
|
37
|
+
|
|
38
|
+
## Padrão obrigatório
|
|
39
|
+
|
|
40
|
+
1. **Toda validação que impede documento inválido é repetida no ponto de gravação**, antes de
|
|
41
|
+
`StartTransaction` e de qualquer reserva de número. A validação no `OnExit` serve para dar
|
|
42
|
+
feedback ao usuário. A barreira de verdade fica na gravação.
|
|
43
|
+
2. **Antes de fechar**, procure quem chama o handler por código:
|
|
44
|
+
`grep -rn "<Form>\.<Campo>Exit(" --include="*.pas" .`. Se houver chamador, a revalidação na
|
|
45
|
+
gravação é obrigatória. Se possível, valide também **no chamador**, antes de criar a tela.
|
|
46
|
+
3. **`SetFocus` em validação de handler que pode rodar por código** exige `CanFocus`: o chamador
|
|
47
|
+
costuma disparar o evento antes do `ShowModal`.
|
|
48
|
+
4. **O roteiro de teste do fluxo automatizado vai até a gravação.** "A mensagem apareceu" não
|
|
49
|
+
prova nada: confirme que o documento **não foi gravado** e que a numeração não avançou.
|
|
50
|
+
|
|
51
|
+
## Caso irmão: `OnColExit` de `TDBGrid`
|
|
52
|
+
|
|
53
|
+
A validação no `OnColExit` só roda quando muda a **coluna**. O ENTER costuma passar por ela, mas a seta muda de
|
|
54
|
+
**linha** e o `TDBGrid` faz o `Post` implícito sem `ColExit`. A trava de verdade fica no `BeforePost` do dataset (com
|
|
55
|
+
`Abort`) e é repetida no OK da tela. Teste ENTER, seta, clique em outra linha e OK.
|
|
56
|
+
|
|
57
|
+
## Caso recorrente: restrição por filial
|
|
58
|
+
|
|
59
|
+
Quando um cadastro auxiliar (série, tabela de preço, depósito) pode ser restrito a uma filial, toda
|
|
60
|
+
tela que o usa compara a filial do cadastro com a do documento, no mesmo idioma que o projeto já usa
|
|
61
|
+
para isso. Uma pesquisa (F2/lookup) que não filtra filial não substitui essa validação.
|
|
62
|
+
|
|
63
|
+
E a restrição só vale onde faz sentido: se o campo pode guardar um dado de terceiro (a série da nota
|
|
64
|
+
do fornecedor, por exemplo), bloqueie a outra filial só quando o documento for **próprio**, senão um
|
|
65
|
+
documento de terceiro com código coincidente é barrado.
|
package/templates/perfis/delphi/rules/linguagem/variavel-inline-sai-de-escopo-ao-envolver-bloco.md
ADDED
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
---
|
|
2
|
+
descricao: "Regra incondicional: envolver código existente num bloco novo muda o escopo das variáveis inline"
|
|
3
|
+
paths:
|
|
4
|
+
- "**/*.pas"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.dpk"
|
|
7
|
+
- "**/*.inc"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra incondicional: envolver código existente num bloco novo muda o escopo das variáveis inline
|
|
11
|
+
|
|
12
|
+
Aplica-se a toda edição que **envolve trecho já existente** de um `.pas` num bloco novo — `try..finally`
|
|
13
|
+
para uma flag, `try..except`, `begin..end` de um `if`, laço `for`/`while` — em units que usam
|
|
14
|
+
**variáveis inline** (`var LX := …`, Delphi 10.3 em diante).
|
|
15
|
+
|
|
16
|
+
## A variável inline vive até o `end` do bloco onde foi DECLARADA
|
|
17
|
+
|
|
18
|
+
Uma variável da seção `var` da rotina vale no corpo inteiro. Uma **inline** vale só do ponto da
|
|
19
|
+
declaração até o fim do **bloco que a contém**. Envolver um trecho num bloco novo muda o dono
|
|
20
|
+
dessa declaração sem mudar nenhuma linha dela:
|
|
21
|
+
|
|
22
|
+
```pascal
|
|
23
|
+
// ANTES — compila: LQuantidadeGerada pertence ao begin..end do if
|
|
24
|
+
begin
|
|
25
|
+
...
|
|
26
|
+
var LQuantidadeGerada := 0;
|
|
27
|
+
... Inc(LQuantidadeGerada) ...
|
|
28
|
+
if LQuantidadeGerada > 0 then ...
|
|
29
|
+
end;
|
|
30
|
+
|
|
31
|
+
// DEPOIS — E2003: a declaração passou a pertencer ao try..finally
|
|
32
|
+
begin
|
|
33
|
+
FSuspenderAtualizacao := True;
|
|
34
|
+
try
|
|
35
|
+
...
|
|
36
|
+
var LQuantidadeGerada := 0;
|
|
37
|
+
... Inc(LQuantidadeGerada) ...
|
|
38
|
+
finally
|
|
39
|
+
FSuspenderAtualizacao := False;
|
|
40
|
+
end;
|
|
41
|
+
if LQuantidadeGerada > 0 then ... // [dcc32 Error] E2003 Undeclared identifier
|
|
42
|
+
end;
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
## Por que escapa da revisão
|
|
46
|
+
|
|
47
|
+
Lendo o código, a variável **parece** estar em escopo: a declaração continua ali, algumas linhas
|
|
48
|
+
acima, com o mesmo recuo — o novo `try` costuma ser inserido **sem reindentar** o corpo, justamente
|
|
49
|
+
para manter o diff pequeno. O executor e o revisor leem o diff, e o diff não mostra a declaração nem
|
|
50
|
+
o uso posterior, só as linhas `try`/`finally` acrescentadas. O erro só aparece no **build**, que o
|
|
51
|
+
agente não faz — um ciclo inteiro de build desperdiçado.
|
|
52
|
+
|
|
53
|
+
## Procedimento obrigatório
|
|
54
|
+
|
|
55
|
+
Ao inserir `try`, `begin` ou início de laço envolvendo código existente:
|
|
56
|
+
|
|
57
|
+
1. **Liste as inline declaradas dentro do trecho envolvido:**
|
|
58
|
+
```bash
|
|
59
|
+
awk 'NR>=<linha_try> && NR<=<linha_finally> && /^[[:space:]]*var L[A-Za-z]+/' <unit>.pas
|
|
60
|
+
```
|
|
61
|
+
2. **Para cada uma, procure uso DEPOIS do fim do bloco** (entre o `end` do bloco novo e o `end` da
|
|
62
|
+
rotina). Se houver, **mova a declaração para antes do bloco**, preservando o valor inicial —
|
|
63
|
+
desde que nada entre o ponto antigo e o novo leia a variável.
|
|
64
|
+
3. **Não migre para a seção `var`** da rotina se o projeto preserva as inline existentes. Basta subir a
|
|
65
|
+
declaração inline.
|
|
66
|
+
4. Registre na resposta ao revisor quais inline foram verificadas — "nenhuma" só vale acompanhado do
|
|
67
|
+
comando que produziu a lista vazia.
|
|
68
|
+
|
|
69
|
+
Vale igualmente para `for var LI := …`: o contador inline não existe depois do laço.
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.pas"
|
|
4
|
+
- "**/*.dfm"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Regra (camada de UI): decidir `SetFocus` por `CanFocus`, nunca por `TabStop`
|
|
10
|
+
|
|
11
|
+
Aplica-se a todo código que decide **para qual controle mover o foco** (`SetFocus`) a partir de uma
|
|
12
|
+
condição sobre outro controle, tipicamente em `OnExit`/`OnKeyPress` de telas de lançamento que testam se
|
|
13
|
+
um campo "está disponível" antes de focá-lo.
|
|
14
|
+
|
|
15
|
+
## `TabStop` não diz se o controle pode receber foco agora
|
|
16
|
+
|
|
17
|
+
`TabStop` só controla se a tecla **Tab** alcança o controle na navegação. Não indica se ele está apto a
|
|
18
|
+
receber foco neste momento. Um controle pode ter `TabStop = False` (valor de design, nunca ajustado em
|
|
19
|
+
runtime) e estar `Visible = True` e `Enabled = True`, perfeitamente focável por `SetFocus`.
|
|
20
|
+
|
|
21
|
+
Um `if <Campo>.TabStop then <Campo>.SetFocus else <Outro>.SetFocus` que dependa de `TabStop` sem que o
|
|
22
|
+
código jamais ajuste a propriedade **sempre cai no `else`** e manda o foco para o controle errado. Em
|
|
23
|
+
silêncio: não lança exceção, não aparece na compilação, só o usuário percebe ao navegar pela tela.
|
|
24
|
+
|
|
25
|
+
## Padrão obrigatório
|
|
26
|
+
|
|
27
|
+
Use `CanFocus` (de `TWinControl`): ele já considera `Visible`, `Enabled` e a hierarquia de exibição
|
|
28
|
+
(`Showing`):
|
|
29
|
+
|
|
30
|
+
```pascal
|
|
31
|
+
if EditCondicaoPagamento.CanFocus then
|
|
32
|
+
EditCondicaoPagamento.SetFocus
|
|
33
|
+
else
|
|
34
|
+
EditCarteira.SetFocus;
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
- Se a intenção for também permitir a navegação por Tab até o controle, ajuste `TabStop` à parte: é uma
|
|
38
|
+
decisão de navegação, independente da decisão de `SetFocus`.
|
|
39
|
+
- Um handler costuma repetir o mesmo bloco de decisão de foco para várias mensagens de validação. Corrija
|
|
40
|
+
**todas** as ocorrências de uma vez, e as dos handlers semelhantes de outras telas.
|