@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
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.pas"
|
|
4
|
+
- "**/*.dfm"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
- "**/*.sql"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra (camada de dados/cálculo): divisão segura e conversão numérica de campos
|
|
11
|
+
|
|
12
|
+
Aplica-se a todo cálculo que (a) divide valores e atribui o resultado a um campo `Currency`/BCD de
|
|
13
|
+
`TFDQuery`/`TFDMemTable`, ou (b) lê campos numéricos de dataset. Complementa
|
|
14
|
+
`fieldbyname-value-variant-cru-em-aritmetica.md`.
|
|
15
|
+
|
|
16
|
+
## 1. Nunca dividir sem proteger o divisor
|
|
17
|
+
|
|
18
|
+
Antes de qualquer divisão cujo resultado vá para um campo numérico (`AsCurrency`, `AsFloat`, `AsBCD`),
|
|
19
|
+
garanta que o divisor não é zero nem Null:
|
|
20
|
+
|
|
21
|
+
- divisor **zero** produz `NaN`/infinito, e ao atribuir em campo BCD/Currency o Delphi lança
|
|
22
|
+
`NAN is not a valid BCD value`;
|
|
23
|
+
- agregado (`TAggregateField`) ou campo **sem registros** devolve **Null**, e a divisão lança
|
|
24
|
+
`Could not convert variant of type (Null) into type (Currency)`.
|
|
25
|
+
|
|
26
|
+
```pascal
|
|
27
|
+
if LDivisor <> 0 then
|
|
28
|
+
LResultado := LDividendo / LDivisor
|
|
29
|
+
else
|
|
30
|
+
LResultado := 0; // ou o fallback semanticamente correto
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
- Ao usar `TAggregateField.Value` (ou qualquer `.Value` Variant), trate o Null **antes** de calcular: leia
|
|
34
|
+
em variável local tratando Null como 0 (ex.: `VarIsNull`).
|
|
35
|
+
- Os dois erros só aparecem em runtime, nunca na compilação. Surgem nas bordas (grid vazia, primeiro item,
|
|
36
|
+
quantidade 0) e com muitos itens, onde a chance de um divisor zerado cresce.
|
|
37
|
+
|
|
38
|
+
## 2. Não truncar valores fracionários com `.AsInteger`
|
|
39
|
+
|
|
40
|
+
Quantidade, peso, volume, custo e percentual são fracionários (`TFloatField`, `TCurrencyField`,
|
|
41
|
+
`TBCDField`). Leia com `.AsFloat` ou `.AsCurrency`, nunca `.AsInteger`: ele trunca (12,365 kg vira 12),
|
|
42
|
+
pode zerar divisores e distorce cálculos como custo médio.
|
|
43
|
+
|
|
44
|
+
- Confira o tipo do campo e o do parâmetro ou destino, e use o acessor compatível e consistente com os
|
|
45
|
+
demais acessos ao mesmo campo na unit.
|
|
46
|
+
|
|
47
|
+
```pascal
|
|
48
|
+
// ERRADO: trunca o peso e pode zerar o divisor
|
|
49
|
+
LQtd := Query.FieldByName('quantidade').AsInteger;
|
|
50
|
+
|
|
51
|
+
// CERTO
|
|
52
|
+
LQtd := Query.FieldByName('quantidade').AsFloat;
|
|
53
|
+
```
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.pas"
|
|
4
|
+
- "**/*.dfm"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
- "**/*.sql"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra (camada de dados): `FieldByName(...).Value` em aritmética estoura com NULL
|
|
11
|
+
|
|
12
|
+
Use acessor tipado. Aplica-se a todo código que lê campo de dataset (`TFDQuery`, `TFDMemTable`,
|
|
13
|
+
`TClientDataSet` legado) e usa o valor em conta: soma, subtração, multiplicação, divisão ou comparação com
|
|
14
|
+
número. Complementa `divisao-e-conversao-numerica.md`.
|
|
15
|
+
|
|
16
|
+
## `.Value` devolve Variant cru, e Variant `Null` em conta lança exceção
|
|
17
|
+
|
|
18
|
+
`System.Variants.NullStrictConvert` é `True` por padrão. Com isso, um Variant `Null` numa operação
|
|
19
|
+
aritmética não vira `Null` nem `0`: lança `EVariantTypeCastError` com a mensagem
|
|
20
|
+
|
|
21
|
+
```
|
|
22
|
+
Could not convert variant of type (Null) into type (Double)
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Os acessores tipados não têm o problema: `.AsFloat`, `.AsCurrency`, `.AsInteger` e `.AsString` já
|
|
26
|
+
convertem campo NULL para `0` / `''`.
|
|
27
|
+
|
|
28
|
+
```pascal
|
|
29
|
+
// ERRADO: qualquer um dos três campos NULL derruba a rotina inteira
|
|
30
|
+
if (FieldByName('TOTAL').Value + FieldByName('DESCONTO').Value + FieldByName('ACRESCIMO').Value) > 0 then
|
|
31
|
+
|
|
32
|
+
// CERTO: lido uma vez, em variável local tipada
|
|
33
|
+
LTotal := FieldByName('TOTAL').AsFloat;
|
|
34
|
+
LDesconto := FieldByName('DESCONTO').AsFloat;
|
|
35
|
+
LAcrescimo := FieldByName('ACRESCIMO').AsFloat;
|
|
36
|
+
if (LTotal + LDesconto + LAcrescimo) > 0 then
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Escolha do acessor: quantidade, peso, volume e percentual → `.AsFloat`; valor monetário → `.AsCurrency`;
|
|
40
|
+
nunca `.AsInteger` em campo fracionário (trunca; ver `divisao-e-conversao-numerica.md`).
|
|
41
|
+
|
|
42
|
+
`.Value` continua legítimo em variável de componente (variável de relatório, `TParam.Value`) e quando o
|
|
43
|
+
Variant é o próprio tipo desejado. O critério é: **este valor vai entrar numa conta?**
|
|
44
|
+
|
|
45
|
+
## O sintoma engana: parece problema de dado
|
|
46
|
+
|
|
47
|
+
O erro só aparece quando **um** registro NULL entra no resultado. Como relatórios filtram por período, o
|
|
48
|
+
efeito é "um mês funciona, o outro não" ou "a partir de tal dia quebra". Isso empurra a investigação para
|
|
49
|
+
o banco, à caça do "registro com problema", em vez de para o código.
|
|
50
|
+
|
|
51
|
+
Pior: numa expressão como `total - desconto - imposto - frete`, **qualquer** operando NULL quebra a conta.
|
|
52
|
+
Corrigir o campo suspeito não resolve se o NULL está em outro operando, e a hipótese certa é descartada
|
|
53
|
+
por parecer refutada.
|
|
54
|
+
|
|
55
|
+
> Ao investigar `Could not convert variant of type (Null) into type (<tipo>)`, a **primeira** hipótese é
|
|
56
|
+
> esta. Rode `grep -n "FieldByName(.*)\.Value" <Unit>.pas` na unit da tela antes de procurar o registro
|
|
57
|
+
> culpado no banco.
|
|
58
|
+
|
|
59
|
+
## Corrigir no Pascal basta; `COALESCE` no SQL é escolha
|
|
60
|
+
|
|
61
|
+
Com acessores tipados, o NULL já vira 0 em todos os pontos de leitura. `COALESCE(..., 0)` no SELECT é
|
|
62
|
+
defesa extra opcional, com custo próprio: envolver em `coalesce(...)` uma coluna sem alias faz o
|
|
63
|
+
PostgreSQL renomeá-la para `coalesce`, o que quebra todo `FieldByName('<NOME>')`. Cada coluna tocada
|
|
64
|
+
precisa ganhar `AS <nome_original>`.
|
|
65
|
+
|
|
66
|
+
Antes de propor o `COALESCE`, veja se ainda resta consumidor sem proteção (somatórios, cópia para
|
|
67
|
+
`TFDMemTable`, campos calculados do relatório). Se todos já usam acessor tipado, o `COALESCE` é cosmético.
|
|
68
|
+
|
|
69
|
+
## Antes de fechar
|
|
70
|
+
|
|
71
|
+
- `grep -n "FieldByName(.*)\.Value"` na unit inteira: **zero** ocorrências em expressão aritmética.
|
|
72
|
+
- Teste o caso que reproduzia o erro **e** um que já funcionava. O segundo é o teste de regressão que
|
|
73
|
+
importa, porque a leitura mudou de Variant para tipo fixo.
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.pas"
|
|
4
|
+
- "**/*.dfm"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
- "**/*.sql"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra (camada de dados): filtro condicional em SQL montado em código
|
|
11
|
+
|
|
12
|
+
`SQL.Add` e `ParamByName` são um par indivisível, e queries gêmeas recebem o filtro juntas.
|
|
13
|
+
|
|
14
|
+
Aplica-se a toda `TFDQuery` cujo SQL é montado em código com filtros condicionais, o padrão comum das
|
|
15
|
+
telas de relatório e consulta: cada filtro preenchido na tela vira um `if <preenchido> then SQL.Add(...)`.
|
|
16
|
+
Complementa `sql-qualificacao-colunas.md`.
|
|
17
|
+
|
|
18
|
+
## O par é indivisível e mora em dois blocos distantes
|
|
19
|
+
|
|
20
|
+
A montagem separa o SQL dos parâmetros em dois blocos, muitas vezes a dezenas de linhas um do outro:
|
|
21
|
+
|
|
22
|
+
```pascal
|
|
23
|
+
if EditCodCliente.Text <> '000000' then
|
|
24
|
+
SQL.Add(' AND pedidos.cod_cliente = :cod_cliente ');
|
|
25
|
+
// ... 20+ linhas de GROUP BY / ORDER BY ...
|
|
26
|
+
if EditCodCliente.Text <> '000000' then
|
|
27
|
+
ParamByName('cod_cliente').AsInteger := StrToInt(EditCodCliente.Text);
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
Um filtro novo exige **duas** edições, em dois lugares. Nada no compilador liga uma à outra, e o
|
|
31
|
+
esquecimento quebra nos dois sentidos:
|
|
32
|
+
|
|
33
|
+
- `SQL.Add` **sem** `ParamByName`: o FireDAC chega ao `Prepare`/`Execute` com um parâmetro sem tipo nem
|
|
34
|
+
valor:
|
|
35
|
+
`[FireDAC][Phys][PG]-335. Parameter [X] data type is unknown. Hint: specify TFDParam.DataType or assign TFDParam value before Prepare/Execute call`
|
|
36
|
+
- `ParamByName` **sem** `SQL.Add`: `Parameter 'X' not found` quando a condição do parâmetro é verdadeira e
|
|
37
|
+
a do SQL não.
|
|
38
|
+
|
|
39
|
+
**As duas guardas têm de ser idênticas**: mesma expressão, mesmo literal de "vazio" (`'0000'`,
|
|
40
|
+
`'000000'`). Guardas divergentes funcionam no caminho testado e estouram na borda.
|
|
41
|
+
|
|
42
|
+
## Checklist antes de fechar
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
grep -n ":<nome_do_parametro>" <Unit>.pas
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Deve retornar **exatamente 2 ocorrências por query**: a do `SQL.Add` e a do `ParamByName`. Uma só é o
|
|
49
|
+
defeito desta regra. Numa unit com query de detalhe e de totais, espere 4.
|
|
50
|
+
|
|
51
|
+
## Queries gêmeas do mesmo relatório recebem o filtro juntas
|
|
52
|
+
|
|
53
|
+
Um relatório costuma ter mais de uma query: a do detalhe e a de totais (ou de sub-relatório), cada uma
|
|
54
|
+
com sua cópia dos mesmos filtros. Pôr o filtro só no detalhe produz um defeito pior que um erro, porque
|
|
55
|
+
não há erro:
|
|
56
|
+
|
|
57
|
+
- o detalhe mostra só o recorte filtrado;
|
|
58
|
+
- o rodapé de totais soma o universo inteiro do período;
|
|
59
|
+
- o usuário lê aquele total como sendo o do filtro que escolheu.
|
|
60
|
+
|
|
61
|
+
Ao acrescentar um filtro, `grep -n "SQL.Add" <Unit>.pas` e confirme quantas queries a unit monta. O
|
|
62
|
+
filtro entra em **todas** as que alimentam o mesmo relatório. Se alguma ficar de fora de propósito,
|
|
63
|
+
registre o motivo no documento do trabalho: divergência sem registro entre queries gêmeas é bug latente.
|
|
64
|
+
|
|
65
|
+
## Ao investigar `[FireDAC][Phys][PG]-335 ... data type is unknown`
|
|
66
|
+
|
|
67
|
+
A primeira hipótese é esta: procure o `ParamByName` daquele parâmetro. Se não houver nenhum, o problema
|
|
68
|
+
não é do driver, do tipo da coluna nem de `TFDParam.DataType` (que a mensagem sugere e levaria a
|
|
69
|
+
"consertar" o sintoma). É a atribuição que nunca foi escrita.
|
|
70
|
+
|
|
71
|
+
O sintoma aparece só em runtime e só quando o filtro é preenchido. O caminho "todos" nunca declara o
|
|
72
|
+
parâmetro e sempre funciona, o que esconde o defeito de qualquer teste que não use o filtro específico.
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.pas"
|
|
4
|
+
- "**/*.dfm"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
- "**/*.sql"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra (camada de dados): FireDAC
|
|
11
|
+
|
|
12
|
+
Aplica-se a DataModules e a todo código que abre conexão, monta query ou grava dados com FireDAC.
|
|
13
|
+
|
|
14
|
+
## `TFDQuery` com `CachedUpdates` substitui o `TClientDataSet`
|
|
15
|
+
|
|
16
|
+
Com `CachedUpdates` ativo, o `TFDQuery` guarda as alterações em memória e as grava com
|
|
17
|
+
`ApplyUpdates`/`CommitUpdates`. Ele faz o papel do antigo par `TDataSetProvider` + `TClientDataSet`.
|
|
18
|
+
|
|
19
|
+
- **Não** introduza `TDataSetProvider`/`TClientDataSet` em código novo. Código legado que ainda os usa
|
|
20
|
+
não é modelo a copiar.
|
|
21
|
+
- **Use a conexão central do projeto** (o DataModule que guarda a `TFDConnection` principal). Não crie
|
|
22
|
+
`TFDConnection` avulsa: ela foge da configuração de sessão feita no `AfterConnect` (ver
|
|
23
|
+
`datestyle-sessao-firedac-postgres.md`) e do controle de transação.
|
|
24
|
+
- **Exceção: thread de fundo.** A `TFDConnection` não é thread-safe, então thread de fundo usa uma
|
|
25
|
+
conexão própria, criada e liberada dentro da thread (ver `threads-e-timers.md`). Essa conexão replica a
|
|
26
|
+
inicialização de sessão que o `AfterConnect` da conexão central faz (ex.: o `DateStyle` de
|
|
27
|
+
`datestyle-sessao-firedac-postgres.md`), seja ligando o mesmo handler, seja chamando a mesma rotina.
|
|
28
|
+
- **Sempre parâmetros `:Param`** no SQL. Nunca concatene valores na string: abre injeção de SQL, impede
|
|
29
|
+
o reaproveitamento do plano e torna data e número dependentes do locale.
|
|
30
|
+
- Siga a língua e o padrão de nomes do schema existente nos nomes de campos e aliases.
|
|
31
|
+
|
|
32
|
+
```pascal
|
|
33
|
+
// ERRADO
|
|
34
|
+
Query.SQL.Text := 'SELECT * FROM pedidos WHERE cod_cliente = ' + IntToStr(LCodigo);
|
|
35
|
+
|
|
36
|
+
// CERTO
|
|
37
|
+
Query.SQL.Text := 'SELECT * FROM pedidos WHERE cod_cliente = :cod_cliente';
|
|
38
|
+
Query.ParamByName('cod_cliente').AsInteger := LCodigo;
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## DataModule é unit de alto fan-in
|
|
42
|
+
|
|
43
|
+
DataModules costumam ser usados por dezenas de telas. Antes de mudar a `interface` de um DM (assinatura
|
|
44
|
+
de método, nome de componente publicado, campo persistente), mapeie **todos** os chamadores com `grep`
|
|
45
|
+
no projeto inteiro. Renomear um componente quebra também os `.dfm` e o código que o referencia por nome.
|
|
46
|
+
|
|
47
|
+
## Acoplamento invertido existente
|
|
48
|
+
|
|
49
|
+
Em código legado, DataModules às vezes abrem diálogos de confirmação ou seleção no meio de uma gravação.
|
|
50
|
+
É um desenho ruim, mas o fluxo depende dele: preserve-o e não o "conserte" sem que isso tenha sido
|
|
51
|
+
pedido.
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.pas"
|
|
4
|
+
- "**/*.dfm"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
- "**/*.sql"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra (camada de dados): macro nova no SQL de um `.dfm` exige entrada em `MacroData`
|
|
11
|
+
|
|
12
|
+
Aplica-se a toda inclusão de macro FireDAC (`!nome`) no `SQL.Strings` de um `TFDQuery` que mora em
|
|
13
|
+
`.dfm`. O scan automático do SQL **não** basta. Complementa `filtro-condicional-sql-par-add-parambyname.md`
|
|
14
|
+
e `sql-qualificacao-colunas.md`.
|
|
15
|
+
|
|
16
|
+
## O `MacroData` do `.dfm` substitui as macros criadas pelo scan
|
|
17
|
+
|
|
18
|
+
O FireDAC cria macros ao varrer o `SQL.Text`. Mas, quando o `.dfm` traz um bloco `MacroData` explícito,
|
|
19
|
+
esse bloco é lido **depois** do `SQL.Strings` no stream do DFM e **redefine a coleção**. Macro que não
|
|
20
|
+
estiver declarada ali não existe em runtime, e o `MacroByName` do `BeforeOpen` estoura:
|
|
21
|
+
|
|
22
|
+
```
|
|
23
|
+
[FireDAC][Stan]-706. Macro [filtro_extra] is not found
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Formato da entrada (copie de uma macro vizinha do mesmo bloco):
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
item
|
|
30
|
+
Value = Null
|
|
31
|
+
Name = 'FILTRO_EXTRA'
|
|
32
|
+
end
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
- Nome em **maiúsculas**, como as demais (a busca ignora caixa, mas o arquivo tem padrão).
|
|
36
|
+
- `Value = Null`: o valor real é atribuído em runtime, no `BeforeOpen`.
|
|
37
|
+
|
|
38
|
+
## As macros irmãs que funcionam não provam a autocriação
|
|
39
|
+
|
|
40
|
+
É a armadilha central. Ao investigar, é natural olhar as macros que já existem, ver que "funcionam" e
|
|
41
|
+
concluir que o FireDAC as cria sozinho a partir do `!nome`. A observação está invertida: elas funcionam
|
|
42
|
+
**porque estão declaradas** no `MacroData` de cada query que as usa.
|
|
43
|
+
|
|
44
|
+
Antes de concluir que a autocriação basta, verifique se existe o bloco:
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
grep -n "MacroData" <Unit>.dfm
|
|
48
|
+
grep -in "Name = '<MACRO_IRMA>'" <Unit>.dfm
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Se as irmãs aparecem nesse `grep`, a sua também precisa aparecer.
|
|
52
|
+
|
|
53
|
+
## Um `BeforeOpen` costuma servir mais de uma query
|
|
54
|
+
|
|
55
|
+
É comum duas queries compartilharem o mesmo handler `BeforeOpen`. Um caso frequente em relatórios: uma
|
|
56
|
+
query de runtime e uma de design-time, que alimenta o designer de layout do gerador de relatórios com o
|
|
57
|
+
mesmo SELECT. O `MacroByName` roda para todas as queries do handler, então:
|
|
58
|
+
|
|
59
|
+
1. a query sem a macro estoura ao abrir;
|
|
60
|
+
2. mesmo sem erro, a coluna nova que só existe numa das queries não aparece no designer, e o layout não
|
|
61
|
+
consegue usá-la.
|
|
62
|
+
|
|
63
|
+
Levante o mapeamento antes de editar:
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
grep -n "BeforeOpen = " <Unit>.dfm # quais queries usam cada handler
|
|
67
|
+
grep -n "object .*: TFDQuery" <Unit>.dfm # limites de cada bloco
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Toda query servida por um handler que atribui a macro precisa da macro no SQL **e** da entrada no
|
|
71
|
+
`MacroData`.
|
|
72
|
+
|
|
73
|
+
## Checklist antes de fechar
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
grep -c "!<nome_da_macro>" <Unit>.dfm # usos no SQL
|
|
77
|
+
grep -c "Name = '<NOME_DA_MACRO>'" <Unit>.dfm # declarações
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
As duas contagens têm de ser iguais e bater com o número de queries servidas pelo handler. Contagens
|
|
81
|
+
diferentes são exatamente o defeito desta regra.
|
|
82
|
+
|
|
83
|
+
Ao inserir várias entradas no mesmo arquivo, trabalhe do bloco de maior número de linha para o menor,
|
|
84
|
+
para que as inserções não desloquem as posições ainda não editadas. Preserve o EOL do `.dfm` (ver
|
|
85
|
+
`encoding-eol.md`).
|
|
86
|
+
|
|
87
|
+
## Ao investigar `-706. Macro [x] is not found`
|
|
88
|
+
|
|
89
|
+
Ordem de hipóteses:
|
|
90
|
+
|
|
91
|
+
1. a macro não está declarada no `MacroData` daquela query (comece aqui);
|
|
92
|
+
2. outra query servida pelo mesmo `BeforeOpen` não tem a macro no SQL;
|
|
93
|
+
3. o SQL é reescrito em runtime (`SQL.Text := ...`) antes do `Open`, refazendo o scan.
|
|
94
|
+
|
|
95
|
+
Compare com um DataModule que já faça a mesma coisa e funcione. A divergência entre o que funciona e o
|
|
96
|
+
que quebra é o diagnóstico.
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.pas"
|
|
4
|
+
- "**/*.dfm"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
- "**/*.sql"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra (camada de dados): qualificação de colunas em SQL
|
|
11
|
+
|
|
12
|
+
Aplica-se a todo SQL de `TFDQuery` (relatórios, telas, consultas). Complementa `firedac.md`.
|
|
13
|
+
|
|
14
|
+
**Toda coluna qualificada (`tabela.coluna` ou `alias.coluna`) tem de apontar para a tabela ou alias que
|
|
15
|
+
de fato contém a coluna**, de forma consistente em todas as cláusulas da query (`SELECT`, `JOIN`, `WHERE`,
|
|
16
|
+
`GROUP BY`, `ORDER BY`, `HAVING`).
|
|
17
|
+
|
|
18
|
+
- Antes de pôr ou mudar uma coluna no `ORDER BY`/`GROUP BY`/`WHERE`, confirme em que tabela ela existe:
|
|
19
|
+
veja como o `SELECT` e os `JOIN` da própria query já a qualificam e **repita o mesmo prefixo**. O
|
|
20
|
+
PostgreSQL falha em runtime com `column <tabela>.<coluna> does not exist`, não na compilação; o erro só
|
|
21
|
+
aparece ao executar.
|
|
22
|
+
- Em queries com tabela mestre e tabela de detalhe por filial, atenção às colunas que existem numa e não
|
|
23
|
+
na outra. Exemplo: `cod_localizacao` pertence a `produtos_filial`, não a `produtos`.
|
|
24
|
+
- Ao copiar um bloco de ordenação ou quebra de outro ramo (`if ItemIndex = N`), revise cada prefixo. O
|
|
25
|
+
prefixo do bloco copiado não necessariamente serve para a coluna nova.
|
|
26
|
+
|
|
27
|
+
```sql
|
|
28
|
+
-- ERRADO: SELECT e JOIN usam produtos_filial, o ORDER BY usa produtos
|
|
29
|
+
SELECT produtos.descricao, produtos_filial.cod_localizacao
|
|
30
|
+
FROM produtos
|
|
31
|
+
JOIN produtos_filial ON produtos_filial.cod_produto = produtos.codigo
|
|
32
|
+
ORDER BY produtos.cod_localizacao
|
|
33
|
+
|
|
34
|
+
-- CERTO
|
|
35
|
+
ORDER BY produtos_filial.cod_localizacao
|
|
36
|
+
```
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.pas"
|
|
4
|
+
- "**/*.dfm"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
- "**/*.sql"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra (camada de dados): `TMemIniFile.GetStrings` não limpa o destino
|
|
11
|
+
|
|
12
|
+
Sempre `Clear` antes. Aplica-se a todo código que edita em memória um conteúdo de INI carregado num
|
|
13
|
+
`TStrings` e o grava de volta. Um caso comum é o override de parâmetros de componentes que guardam a
|
|
14
|
+
configuração como INI num `TStrings` (ex.: `Configuracoes.WebServices.Params` dos componentes ACBr).
|
|
15
|
+
|
|
16
|
+
## O método só faz `Add`
|
|
17
|
+
|
|
18
|
+
Trecho de `System.IniFiles.pas` na RTL:
|
|
19
|
+
|
|
20
|
+
```pascal
|
|
21
|
+
procedure TMemIniFile.GetStrings(const List: TStrings);
|
|
22
|
+
begin
|
|
23
|
+
List.BeginUpdate;
|
|
24
|
+
try
|
|
25
|
+
for I := 0 to FSections.Count - 1 do
|
|
26
|
+
begin
|
|
27
|
+
List.Add('[' + FSections.Names[I] + ']'); // só Add, nunca List.Clear
|
|
28
|
+
Strings := FSections.Sections[I];
|
|
29
|
+
for J := 0 to Strings.Count - 1 do
|
|
30
|
+
List.Add(Strings.Pairs[J]);
|
|
31
|
+
List.Add('');
|
|
32
|
+
end;
|
|
33
|
+
finally
|
|
34
|
+
List.EndUpdate;
|
|
35
|
+
end;
|
|
36
|
+
end;
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
O nome sugere "obter" (substituir), mas o comportamento é **acrescentar**. Se o destino for o mesmo
|
|
40
|
+
`TStrings` que alimentou o `SetStrings`, o resultado é o conteúdo antigo seguido de uma segunda cópia
|
|
41
|
+
inteira, agora com as alterações.
|
|
42
|
+
|
|
43
|
+
## Por que é silencioso e caro de achar
|
|
44
|
+
|
|
45
|
+
Com o INI duplicado, o próximo `SetStrings` cria **duas seções com o mesmo nome** (não mescla nem
|
|
46
|
+
substitui), e `ReadString` resolve pela **primeira**, que é a versão antiga. O `WriteString` "funcionou",
|
|
47
|
+
o INI em memória contém o valor novo, e mesmo assim quem lê recebe o valor velho.
|
|
48
|
+
|
|
49
|
+
Nada aparece em compilação, exceção ou log. O sintoma é a alteração simplesmente não ter efeito, o que
|
|
50
|
+
leva a investigar as hipóteses erradas (dado de origem, condição do `if`, ordem de chamada) antes de
|
|
51
|
+
suspeitar da RTL.
|
|
52
|
+
|
|
53
|
+
## Padrão obrigatório
|
|
54
|
+
|
|
55
|
+
```pascal
|
|
56
|
+
LIni := TMemIniFile.Create('');
|
|
57
|
+
try
|
|
58
|
+
LIni.SetStrings(<Destino>);
|
|
59
|
+
LIni.WriteString(<Secao>, <Chave>, <Valor>);
|
|
60
|
+
<Destino>.Clear; // GetStrings só faz Add; sem Clear o INI fica duplicado
|
|
61
|
+
LIni.GetStrings(<Destino>);
|
|
62
|
+
finally
|
|
63
|
+
LIni.Free;
|
|
64
|
+
end;
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
- O `SetStrings` já copiou tudo para dentro do `TMemIniFile`, então limpar o destino antes do
|
|
68
|
+
`GetStrings` é seguro: a fonte dos dados passa a ser o `LIni`, não a lista.
|
|
69
|
+
- **Comente a linha do `Clear`** com o motivo. Sem o comentário ela parece supérflua, e alguém a remove
|
|
70
|
+
numa "limpeza" futura, ressuscitando o bug.
|
|
71
|
+
- `TStrings.Assign` não tem esse problema (faz `Clear` + `AddStrings`); é a alternativa quando se quer só
|
|
72
|
+
substituir o conteúdo por uma lista pronta.
|
|
73
|
+
|
|
74
|
+
## Override de parâmetros em componentes ACBr
|
|
75
|
+
|
|
76
|
+
Nos componentes ACBr, `LerParamsIni` só recarrega o INI do resource quando `Params.Count = 0`. Por isso
|
|
77
|
+
um override gravado em `Configuracoes.WebServices.Params` sobrevive às leituras internas do componente, e
|
|
78
|
+
essa é a forma suportada de forçar provedor ou versão em runtime sem tocar no `.ini` em disco.
|
|
79
|
+
|
|
80
|
+
Depois do override, **dispare a resolução de novo** atribuindo outra vez a propriedade que a desencadeia
|
|
81
|
+
(no ACBrNFSeX, `CodigoMunicipio`): é ela que recalcula provedor, versão e layout. Trocar o provider "na mão"
|
|
82
|
+
deixa valores derivados (como o layout) com o estado anterior.
|
|
83
|
+
|
|
84
|
+
## Antes de fechar
|
|
85
|
+
|
|
86
|
+
- Confirme o efeito **em runtime**, não por leitura do código: o valor lido depois do override tem de ser
|
|
87
|
+
o novo.
|
|
88
|
+
- Se o comportamento não mudar, a primeira hipótese é esta regra (seção duplicada no `TStrings`), não erro
|
|
89
|
+
no dado nem na condição.
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.pas"
|
|
4
|
+
- "**/*.dpr"
|
|
5
|
+
- "**/*.dpk"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
- "**/*.dfm"
|
|
8
|
+
- "**/*.dproj"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Encoding e EOL dos fontes Delphi
|
|
12
|
+
|
|
13
|
+
Encoding e fim de linha (EOL) nunca mudam como efeito colateral de uma edição. Converter por engano corrompe os
|
|
14
|
+
acentos do arquivo inteiro (inclusive mensagens exibidas ao usuário) e reescreve o arquivo todo no diff,
|
|
15
|
+
escondendo a alteração real.
|
|
16
|
+
|
|
17
|
+
## Formato por extensão
|
|
18
|
+
|
|
19
|
+
| Extensão | Encoding | EOL | Conduta |
|
|
20
|
+
|---|---|---|---|
|
|
21
|
+
| `.pas`, `.dpr`, `.dpk`, `.inc` | UTF-8 com BOM (`EF BB BF`) | CRLF | converter para UTF-8 com BOM antes de editar, se não estiver |
|
|
22
|
+
| `.dfm` texto | o que o arquivo já tem (em geral ASCII, acentos escapados) | o que o arquivo já tem | preservar encoding e EOL; nunca converter |
|
|
23
|
+
| `.dfm` binário (começa com `FF 0A 00` ou `TPF0`) | binário | — | não se edita como texto; abrir na IDE |
|
|
24
|
+
| `.dproj` | UTF-8 (XML) | o que o arquivo já tem | editar só as linhas necessárias |
|
|
25
|
+
| terceiros (ACBr, `modules/`) | o do fornecedor (ACBr em ISO-8859-1) | o do fornecedor | não converter nem reformatar |
|
|
26
|
+
|
|
27
|
+
Unit `.pas` sem BOM aparece com acentos quebrados na IDE. Unit criada por ferramenta sai em UTF-8 **sem** BOM:
|
|
28
|
+
falta só o BOM, e o `converter` só o acrescenta.
|
|
29
|
+
|
|
30
|
+
## Antes de editar: detectar
|
|
31
|
+
|
|
32
|
+
```
|
|
33
|
+
npx @fontdata/ai-harness delphi encoding detectar <arquivo>
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Mostra `utf8-bom`, `utf8-sem-bom`, `cp1252` ou `dfm-binario`, e o EOL (`crlf`, `lf`, `misto`).
|
|
37
|
+
|
|
38
|
+
- `utf8-bom` → edite direto.
|
|
39
|
+
- `utf8-sem-bom` ou `cp1252` em `.pas`/`.dpr`/`.dpk`/`.inc` → converta **antes** da primeira edição:
|
|
40
|
+
|
|
41
|
+
```
|
|
42
|
+
npx @fontdata/ai-harness delphi encoding converter <arquivo>
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
O `converter` lê o que não é UTF-8 como CP1252, grava UTF-8 com BOM e mantém o EOL de cada linha. Em UTF-8 sem
|
|
46
|
+
BOM só acrescenta o BOM; em UTF-8 com BOM não altera nenhum byte. Ele recusa `.dfm`.
|
|
47
|
+
|
|
48
|
+
Por quê converter antes: as ferramentas de edição regravam em UTF-8. Editar um `.pas` em CP1252 direto troca cada
|
|
49
|
+
acento por U+FFFD (`'Obrigat�rio'`), e isso não tem volta.
|
|
50
|
+
|
|
51
|
+
Se o arquivo já tem edição não commitada e pode ter sido corrompido, restaure antes de converter
|
|
52
|
+
(`git restore --source=HEAD -- <arquivo>`), mas só se não houver trabalho do usuário a preservar; havendo, pare e
|
|
53
|
+
avise.
|
|
54
|
+
|
|
55
|
+
A conversão é sob demanda, só no arquivo que a tarefa vai editar. Migrar o projeto inteiro é tarefa explícita, a
|
|
56
|
+
pedido do usuário.
|
|
57
|
+
|
|
58
|
+
## `.dfm`: editar sim, converter nunca
|
|
59
|
+
|
|
60
|
+
Editar `.dfm` é permitido quando a tarefa pede (componente novo, propriedade, `TabOrder`), esteja ele em LF ou
|
|
61
|
+
CRLF. `.dfm` em CRLF em geral foi salvo pela IDE, e isso não impede a edição.
|
|
62
|
+
|
|
63
|
+
- Preserve o EOL existente: CRLF continua CRLF, LF continua LF.
|
|
64
|
+
- Altere só as linhas necessárias com `Edit`. Nunca regrave o `.dfm` inteiro por script: além do EOL, isso pode
|
|
65
|
+
capturar alteração concorrente no mesmo arquivo.
|
|
66
|
+
- Acento no `.dfm` texto fica escapado fora das aspas: `'Data da Emiss'#227'o'`. Gravar o acento cru em UTF-8
|
|
67
|
+
quebra o form na IDE.
|
|
68
|
+
- Meça o EOL **antes** da primeira edição e compare com esse número, não com o `HEAD`:
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
grep -c $'\r' <arquivo.dfm> # 0 = LF; maior que 0 = CRLF
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### Diff enorme no `.dfm`: descubra quem mudou antes de "corrigir"
|
|
75
|
+
|
|
76
|
+
O usuário pode ter salvo o `.dfm` pela IDE entre duas tarefas (a IDE grava em CRLF). Comparado com o `HEAD`, o
|
|
77
|
+
diff mostra o arquivo inteiro alterado sem que o agente tenha convertido nada. Sinais de gravação pela IDE:
|
|
78
|
+
|
|
79
|
+
- mudaram propriedades que só a IDE recalcula: `ExplicitWidth`, `ExplicitHeight`, `ExplicitLeft`, `ExplicitTop`,
|
|
80
|
+
`PixelsPerInch`, `TextHeight`;
|
|
81
|
+
- mudaram valores que nenhum agente tocou (larguras de coluna, posições);
|
|
82
|
+
- a contagem de CR já era maior que 0 antes da primeira edição.
|
|
83
|
+
|
|
84
|
+
Com sinal de IDE, o CRLF é o EOL existente e o conteúdo é trabalho do usuário: não remova CR (`tr -d '\r'`,
|
|
85
|
+
`sed`, `dos2unix`), não reverta para o `HEAD`, continue editando só as linhas do escopo e relate ao usuário o que
|
|
86
|
+
a IDE mudou. Só trate como conversão sua quando a contagem de CR antes da sua edição for diferente da contagem
|
|
87
|
+
depois, e desfaça só o que você introduziu.
|
|
88
|
+
|
|
89
|
+
## Depois de editar: checar
|
|
90
|
+
|
|
91
|
+
```
|
|
92
|
+
npx @fontdata/ai-harness delphi encoding checar <arquivo>
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
Aponta, por linha, U+FFFD, dupla codificação, BOM ausente (em `.pas`/`.dpr`/`.dpk`/`.inc`) e EOL misto; sai com
|
|
96
|
+
código 1 se achar algo. Com `--todos`, confere todos os fontes Delphi versionados.
|
|
97
|
+
|
|
98
|
+
A dupla codificação (UTF-8 lido como CP1252 e gravado de novo em UTF-8: `ã` vira `ã`) não gera U+FFFD, então
|
|
99
|
+
só um grep a pega:
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
grep -nE 'Ã[¡¢£¤§¨©ª³´µº¼]|â€' <arquivo> # deve dar nada
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
A classe cobre os acentos comuns em português (`á` á, `ã` ã, `ç` ç, `é` é, `ê` ê, `Ã` í, `ó` ó, `õ` õ,
|
|
106
|
+
`ú` ú, `â` â); o `checar` acima usa a faixa inteira.
|
|
107
|
+
|
|
108
|
+
Confira também `git diff --stat -- <arquivo>`: só as linhas tocadas devem aparecer. Em `.pas`/`.dpr`/`.dpk`/`.inc`,
|
|
109
|
+
dezenas de linhas de acento alteradas indicam encoding ou EOL convertido; desfaça e refaça a edição preservando os
|
|
110
|
+
bytes originais. Em `.dfm`, aplique antes a seção "Diff enorme no `.dfm`": o diff pode ser gravação da IDE, e
|
|
111
|
+
desfazer apagaria trabalho do usuário.
|
|
112
|
+
|
|
113
|
+
## Rede de segurança: hook `delphi-encoding`
|
|
114
|
+
|
|
115
|
+
O hook `delphi-encoding` do perfil bloqueia `Edit`/`MultiEdit` em `.pas`, `.dpr`, `.dpk` e `.inc` que não está em
|
|
116
|
+
UTF-8 válido e mostra o comando `converter`. Depois da edição, avisa BOM ausente, U+FFFD novo, dupla codificação
|
|
117
|
+
nova e EOL misto novo; no `.dfm`, avisa só U+FFFD novo e EOL diferente do anterior. O hook é a rede; esta rule é
|
|
118
|
+
a conduta.
|
|
119
|
+
|
|
120
|
+
Pastas de terceiros ficam fora do hook e do `--todos` pela lista `delphi.ignorar` do `.ai-harness/config.json`
|
|
121
|
+
(padrão: `**/modules/**` e `**/ACBr*/**`). Se o hook bloquear uma unit de terceiro, acrescente a pasta dela à
|
|
122
|
+
lista em vez de converter o arquivo:
|
|
123
|
+
|
|
124
|
+
```json
|
|
125
|
+
{
|
|
126
|
+
"delphi": {
|
|
127
|
+
"ignorar": ["**/modules/**", "**/ACBr*/**", "**/Terceiros/**"]
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
```
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
---
|
|
2
|
+
descricao: Campo de dataset não se lê depois de um laço First/while not Eof — capture o valor dentro do laço, no registro selecionado
|
|
3
|
+
paths:
|
|
4
|
+
- "**/*.pas"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.dpk"
|
|
7
|
+
- "**/*.inc"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra incondicional: depois de `while not Eof`, o cursor está na última linha — não na que você quer
|
|
11
|
+
|
|
12
|
+
Aplica-se a toda rotina que percorre um dataset (`TFDQuery`, `TFDMemTable`, `TClientDataSet`) com
|
|
13
|
+
`First; while not Eof do ... Next;`, típico para achar os registros marcados numa grade, e **depois** usa dados
|
|
14
|
+
"do registro escolhido".
|
|
15
|
+
|
|
16
|
+
## O defeito: o `FieldByName` depois do laço não falha, só lê outro registro
|
|
17
|
+
|
|
18
|
+
No FireDAC, o `Next` sobre o último registro liga `Eof`, mas o cursor **continua no último registro**. O
|
|
19
|
+
`FieldByName` depois do laço devolve os valores da **última linha do dataset**, sem erro nenhum:
|
|
20
|
+
|
|
21
|
+
```pascal
|
|
22
|
+
// ERRADO: o laço só marcou; nome e chave saem da ÚLTIMA linha da grade
|
|
23
|
+
QueryDocumentos.First;
|
|
24
|
+
while not QueryDocumentos.Eof do
|
|
25
|
+
begin
|
|
26
|
+
if QueryDocumentos.FieldByName('selecionado').AsBoolean then
|
|
27
|
+
LTelefone := QueryDocumentos.FieldByName('telefone').AsString;
|
|
28
|
+
QueryDocumentos.Next;
|
|
29
|
+
end;
|
|
30
|
+
LTexto.Add('Cliente: ' + QueryDocumentos.FieldByName('nome').AsString);
|
|
31
|
+
LArquivo := 'PDF\' + QueryDocumentos.FieldByName('chave').AsString + '.pdf';
|
|
32
|
+
|
|
33
|
+
// CERTO: tudo o que se usa depois é capturado no registro selecionado, dentro do laço
|
|
34
|
+
if QueryDocumentos.FieldByName('selecionado').AsBoolean then
|
|
35
|
+
begin
|
|
36
|
+
LTelefone := QueryDocumentos.FieldByName('telefone').AsString;
|
|
37
|
+
LNome := QueryDocumentos.FieldByName('nome').AsString;
|
|
38
|
+
LChave := QueryDocumentos.FieldByName('chave').AsString;
|
|
39
|
+
end;
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## Por que escapa do teste
|
|
43
|
+
|
|
44
|
+
- Se o registro testado é o **último da grade**, o valor sai certo por acaso. É exatamente o que acontece ao testar
|
|
45
|
+
com o registro mais recente, que costuma ser a última linha.
|
|
46
|
+
- Um campo capturado dentro do laço e outro lido depois dele parecem simétricos no diff.
|
|
47
|
+
- Reposicionar com `First` depois do laço não resolve: volta para o **primeiro** registro, não para o selecionado,
|
|
48
|
+
e o laço pode ter desmarcado a seleção.
|
|
49
|
+
- Quando o valor lido errado é vazio (uma chave ausente na última linha), o defeito aparece longe dali, como um
|
|
50
|
+
arquivo sem nome ou um registro não encontrado.
|
|
51
|
+
|
|
52
|
+
## Antes de fechar a alteração
|
|
53
|
+
|
|
54
|
+
- Para cada `while not Eof` tocado, procure `FieldByName` do **mesmo dataset** entre o fim do laço e o fim da rotina.
|
|
55
|
+
Cada um precisa de um `Locate` pela chave de negócio ou de uma variável capturada dentro do laço.
|
|
56
|
+
- Teste com o registro selecionado **no meio da grade**, nunca só na última linha.
|