@noeva/etl-core 1.0.0-next.4 → 1.0.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/CHANGELOG.md +183 -0
- package/LICENSE +19 -0
- package/README.md +3 -2
- package/deploy/Dockerfile +1 -1
- package/dist/chunk-BVUOUBLW.js +1 -0
- package/dist/chunk-CRR3Q2C7.js +2 -0
- package/dist/chunk-J3PBMWSP.js +2 -0
- package/dist/{chunk-KMUNED7K.js → chunk-LJ7DVP5F.js} +1 -1
- package/dist/{chunk-ZBKP2UOF.js → chunk-P6B2KLNJ.js} +2 -2
- package/dist/chunk-PKBSETMV.js +2 -0
- package/dist/chunk-QPJC4GWR.js +1 -0
- package/dist/chunk-RCRMQPFH.js +5 -0
- package/dist/chunk-RS5SGDUU.js +1 -0
- package/dist/chunk-RWPHH4E2.js +1 -0
- package/dist/chunk-SRFFKE5W.js +6 -0
- package/dist/chunk-WVODQB6Z.js +1 -0
- package/dist/chunk-XZMCC6VQ.js +1 -0
- package/dist/chunk-ZCYGHS7P.js +2 -0
- package/dist/cli.js +2 -2
- package/dist/connector-kit.d.ts +4 -2
- package/dist/connector-kit.js +1 -1
- package/dist/connectors/file.js +1 -1
- package/dist/connectors/http.js +1 -1
- package/dist/connectors/imap.js +1 -1
- package/dist/connectors/jira.js +2 -2
- package/dist/connectors/mail.js +1 -1
- package/dist/connectors/noeva.js +1 -1
- package/dist/connectors/oauth.js +1 -1
- package/dist/connectors/postgres.js +1 -1
- package/dist/connectors/sendgrid.js +1 -1
- package/dist/connectors/smtp.js +1 -1
- package/dist/connectors/sqlserver.js +1 -1
- package/dist/connectors/zoho.d.ts +304 -0
- package/dist/connectors/zoho.js +2 -0
- package/dist/etl.config.js +2 -2
- package/dist/guida/404.html +3 -3
- package/dist/guida/GUIDA_SVILUPPO.html +8 -8
- package/dist/guida/TECHNICAL_OVERVIEW.html +8 -8
- package/dist/guida/assets/{GUIDA_SVILUPPO.md.D13C7Zwu.js → GUIDA_SVILUPPO.md.CrN52ZDN.js} +1 -1
- package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.DQP0pWc8.js → TECHNICAL_OVERVIEW.md.DTIhkkg9.js} +1 -1
- package/dist/guida/assets/{app.CzIZwOrR.js → app.DlsuGVZn.js} +1 -1
- package/dist/guida/assets/chunks/@localSearchIndexroot.LnC621Vy.js +1 -0
- package/dist/guida/assets/chunks/{VPLocalSearchBox.Cv9o56BQ.js → VPLocalSearchBox.v4vBLemj.js} +2 -2
- package/dist/guida/assets/chunks/{theme.CsUxYN72.js → theme.D9XEK7o0.js} +2 -2
- package/dist/guida/assets/connectors_README.md.BqI2RLCu.js +1 -0
- package/dist/guida/assets/connectors_README.md.BqI2RLCu.lean.js +1 -0
- package/dist/guida/assets/connectors_oauth.md.BeotXAWb.js +7 -0
- package/dist/guida/assets/connectors_oauth.md.BeotXAWb.lean.js +1 -0
- package/dist/guida/assets/connectors_zoho.md.BfEzRNZk.js +17 -0
- package/dist/guida/assets/connectors_zoho.md.BfEzRNZk.lean.js +1 -0
- package/dist/guida/assets/{conventions_node-descriptor.md.D8Si7E2S.js → conventions_node-descriptor.md.MQaGlm8a.js} +1 -1
- package/dist/guida/assets/{guide_claude-code_index.md.CxVSru8e.js → guide_claude-code_index.md.DEnzf9b_.js} +1 -1
- package/dist/guida/assets/{nodes_source.md.V_vlNfOz.js → nodes_source.md.DP2i3GFv.js} +3 -3
- package/dist/guida/assets/{nodes_source.md.V_vlNfOz.lean.js → nodes_source.md.DP2i3GFv.lean.js} +1 -1
- package/dist/guida/assets/{runbooks_aggiornamento-pm2.md.f3LAxif4.js → runbooks_aggiornamento-pm2.md.DrFr4blI.js} +1 -1
- package/dist/guida/assets/{runbooks_deployment.md.CsIYRa_5.js → runbooks_deployment.md.CwG77qGO.js} +1 -1
- package/dist/guida/assets/{style.BNn_AkzN.css → style.DFlUbYCk.css} +1 -1
- package/dist/guida/connectors/README.html +6 -6
- package/dist/guida/connectors/file.html +6 -6
- package/dist/guida/connectors/http.html +6 -6
- package/dist/guida/connectors/imap.html +6 -6
- package/dist/guida/connectors/jira.html +6 -6
- package/dist/guida/connectors/noeva.html +6 -6
- package/dist/guida/connectors/oauth.html +8 -8
- package/dist/guida/connectors/postgres.html +6 -6
- package/dist/guida/connectors/process.html +6 -6
- package/dist/guida/connectors/sendgrid.html +6 -6
- package/dist/guida/connectors/smtp.html +6 -6
- package/dist/guida/connectors/sqlserver.html +6 -6
- package/dist/guida/connectors/zoho.html +43 -0
- package/dist/guida/conventions/node-columns.html +6 -6
- package/dist/guida/conventions/node-descriptor.html +8 -8
- package/dist/guida/conventions/run-report.html +6 -6
- package/dist/guida/conventions/run-trace.html +6 -6
- package/dist/guida/conventions/variabili-del-core.html +5 -5
- package/dist/guida/conventions/versioni-di-pipeline.html +6 -6
- package/dist/guida/guide/claude-code/index.html +7 -7
- package/dist/guida/guide/claude-code/prompt.html +7 -7
- package/dist/guida/guide/claude-code/strumenti.html +5 -5
- package/dist/guida/guide/grafo.html +6 -6
- package/dist/guida/guide/usare/app-desktop.html +5 -5
- package/dist/guida/guide/usare/esito-di-una-run.html +6 -6
- package/dist/guida/guide/usare/index.html +5 -5
- package/dist/guida/hashmap.json +1 -1
- package/dist/guida/index.html +6 -6
- package/dist/guida/nodes/README.html +6 -6
- package/dist/guida/nodes/action.html +6 -6
- package/dist/guida/nodes/ai.html +6 -6
- package/dist/guida/nodes/join.html +6 -6
- package/dist/guida/nodes/lookup.html +6 -6
- package/dist/guida/nodes/pipeline.html +6 -6
- package/dist/guida/nodes/route.html +6 -6
- package/dist/guida/nodes/sink.html +6 -6
- package/dist/guida/nodes/source.html +8 -8
- package/dist/guida/nodes/task.html +6 -6
- package/dist/guida/nodes/transform.html +6 -6
- package/dist/guida/nodes/try-catch.html +6 -6
- package/dist/guida/nodes/union.html +6 -6
- package/dist/guida/pagine.json +1 -0
- package/dist/guida/pipelines/README.html +6 -6
- package/dist/guida/pipelines/crm-leads-sync.html +6 -6
- package/dist/guida/pipelines/cross-workspace-csv-merge.html +6 -6
- package/dist/guida/pipelines/movimenti-per-conto.html +6 -6
- package/dist/guida/pipelines/orders-enriched-daily.html +6 -6
- package/dist/guida/pipelines/test-posta.html +6 -6
- package/dist/guida/runbooks/aggiornamento-pm2.html +7 -7
- package/dist/guida/runbooks/deploy-ecr.html +6 -6
- package/dist/guida/runbooks/deployment.html +8 -8
- package/dist/guida/runbooks/etl-worker.html +6 -6
- package/dist/guida/runbooks/graph-server.html +6 -6
- package/dist/guida/runbooks/mask-key.html +6 -6
- package/dist/guida/runbooks/oauth-google-posta.html +6 -6
- package/dist/guida/runbooks/rollback-di-pipeline.html +6 -6
- package/dist/guida/runbooks/scd2-rehash.html +6 -6
- package/dist/guida/runbooks/sql-task-truncate-swap.html +6 -6
- package/dist/guida/runbooks/stato-incrementale.html +6 -6
- package/dist/guida/sub-pipelines/README.html +6 -6
- package/dist/guida/sub-pipelines/riepilogo-ordini.html +6 -6
- package/dist/index.js +1 -1
- package/dist/pipelines.js +1 -1
- package/dist/testing.js +1 -1
- package/kit/boilerplate/.github/workflows/ci.yml +1 -1
- package/kit/boilerplate/.github/workflows/image.yml +1 -1
- package/kit/boilerplate/package.json +1 -1
- package/kit/skills/etl-graph/references/wiring.md +4 -3
- package/kit/skills/new-connector/SKILL.md +1 -1
- package/package.json +12 -6
- package/dist/chunk-BFW7HTF6.js +0 -2
- package/dist/chunk-BPRH262Y.js +0 -2
- package/dist/chunk-DPWGI266.js +0 -1
- package/dist/chunk-H75NY6Z4.js +0 -1
- package/dist/chunk-HMED2UDJ.js +0 -2
- package/dist/chunk-MOHJWOCB.js +0 -1
- package/dist/chunk-MXSKD3Z4.js +0 -2
- package/dist/chunk-PGJWGJEB.js +0 -5
- package/dist/chunk-R53642SH.js +0 -1
- package/dist/chunk-RU6CZIDB.js +0 -1
- package/dist/chunk-UN3BPCPA.js +0 -1
- package/dist/chunk-XFHTODDW.js +0 -6
- package/dist/guida/assets/chunks/@localSearchIndexroot.08YFQ5n8.js +0 -1
- package/dist/guida/assets/connectors_README.md.ChyXSf73.js +0 -1
- package/dist/guida/assets/connectors_README.md.ChyXSf73.lean.js +0 -1
- package/dist/guida/assets/connectors_oauth.md.DUHajB0u.js +0 -7
- package/dist/guida/assets/connectors_oauth.md.DUHajB0u.lean.js +0 -1
- /package/dist/guida/assets/{GUIDA_SVILUPPO.md.D13C7Zwu.lean.js → GUIDA_SVILUPPO.md.CrN52ZDN.lean.js} +0 -0
- /package/dist/guida/assets/{TECHNICAL_OVERVIEW.md.DQP0pWc8.lean.js → TECHNICAL_OVERVIEW.md.DTIhkkg9.lean.js} +0 -0
- /package/dist/guida/assets/{conventions_node-descriptor.md.D8Si7E2S.lean.js → conventions_node-descriptor.md.MQaGlm8a.lean.js} +0 -0
- /package/dist/guida/assets/{guide_claude-code_index.md.CxVSru8e.lean.js → guide_claude-code_index.md.DEnzf9b_.lean.js} +0 -0
- /package/dist/guida/assets/{runbooks_aggiornamento-pm2.md.f3LAxif4.lean.js → runbooks_aggiornamento-pm2.md.DrFr4blI.lean.js} +0 -0
- /package/dist/guida/assets/{runbooks_deployment.md.CsIYRa_5.lean.js → runbooks_deployment.md.CwG77qGO.lean.js} +0 -0
|
@@ -6,12 +6,12 @@
|
|
|
6
6
|
<title>Pipeline: orders-enriched-daily · Noeva ETL</title>
|
|
7
7
|
<meta name="description" content="Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.">
|
|
8
8
|
<meta name="generator" content="VitePress v1.6.4">
|
|
9
|
-
<link rel="preload stylesheet" href="/guida/core/assets/style.
|
|
9
|
+
<link rel="preload stylesheet" href="/guida/core/assets/style.DFlUbYCk.css" as="style">
|
|
10
10
|
<link rel="preload stylesheet" href="/guida/core/vp-icons.css" as="style">
|
|
11
11
|
|
|
12
|
-
<script type="module" src="/guida/core/assets/app.
|
|
12
|
+
<script type="module" src="/guida/core/assets/app.DlsuGVZn.js"></script>
|
|
13
13
|
<link rel="preload" href="/guida/core/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
|
|
14
|
-
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.
|
|
14
|
+
<link rel="modulepreload" href="/guida/core/assets/chunks/theme.D9XEK7o0.js">
|
|
15
15
|
<link rel="modulepreload" href="/guida/core/assets/chunks/framework.qdetmeNX.js">
|
|
16
16
|
<link rel="modulepreload" href="/guida/core/assets/pipelines_orders-enriched-daily.md.jESRtvBo.lean.js">
|
|
17
17
|
<link rel="icon" type="image/svg+xml" href="/guida/core/favicon.svg">
|
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
<script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
|
|
21
21
|
</head>
|
|
22
22
|
<body>
|
|
23
|
-
<div id="app"><div class="Layout etl-wide" data-v-f5dee57d><!--[--><!--]--><!--[--><span tabindex="-1" data-v-93360a68></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-93360a68>Skip to content</a><!--]--><!----><header class="VPNav" data-v-f5dee57d data-v-b9fcca01><div class="VPNavBar" data-v-b9fcca01 data-v-b140bbbf><div class="wrapper" data-v-b140bbbf><div class="container" data-v-b140bbbf><div class="title" data-v-b140bbbf><div class="VPNavBarTitle has-sidebar" data-v-b140bbbf data-v-fa0d91f3><a class="title" href="/guida/core/" data-v-fa0d91f3><!--[--><!--]--><!--[--><!--[--><!--[--><img class="VPImage dark logo" src="/guida/core/logo-light.png" alt="Noeva" data-v-05ca73a1><!--]--><!--[--><img class="VPImage light logo" src="/guida/core/logo-dark.png" alt="Noeva" data-v-05ca73a1><!--]--><!--]--><!--]--><!----><!--[--><!--[--><!--[--><!--[--><span class="etl-wordmark" aria-hidden="true">ETL</span><span class="etl-embedded-title">Documentazione</span><!--]--><!--]--><!--]--><!--]--></a></div></div><div class="content" data-v-b140bbbf><div class="content-body" data-v-b140bbbf><!--[--><!--]--><div class="VPNavBarSearch search" data-v-b140bbbf><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Cerca nella documentazione"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Cerca</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-b140bbbf data-v-bc0c15e0><span id="main-nav-aria-label" class="visually-hidden" data-v-bc0c15e0> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/usare/" tabindex="0" data-v-bc0c15e0 data-v-5860da0c><!--[--><span data-v-5860da0c>Usare</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/claude-code/" tabindex="0" data-v-bc0c15e0 data-v-5860da0c><!--[--><span data-v-5860da0c>Creare con Claude Code</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-bc0c15e0 data-v-6f404e8a><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-6f404e8a><span class="text" data-v-6f404e8a><!----><span data-v-6f404e8a>Riferimento</span><span class="vpi-chevron-down text-icon" data-v-6f404e8a></span></span></button><div class="menu" data-v-6f404e8a><div class="VPMenu" data-v-6f404e8a data-v-1bb74cb7><div class="items" data-v-1bb74cb7><!--[--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/guide/grafo" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Il grafo, nodo per nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/nodes/README" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Tipi di nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/connectors/README" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Connettori</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/pipelines/README" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Pipeline pronte</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/conventions/run-report" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Il report di run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/conventions/run-trace" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>La traccia di una run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/conventions/variabili-del-core" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Variabili d'ambiente del core</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-1bb74cb7 data-v-8b15bc2d><a class="VPLink link" href="/guida/core/runbooks/graph-server" data-v-8b15bc2d><!--[--><span data-v-8b15bc2d>Operatività</span><!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-b140bbbf data-v-978134ec><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-978134ec data-v-139a0758 data-v-6ae48061><span class="check" data-v-6ae48061><span class="icon" data-v-6ae48061><!--[--><span class="vpi-sun sun" data-v-139a0758></span><span class="vpi-moon moon" data-v-139a0758></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-b140bbbf data-v-0ddd3b74 data-v-6f404e8a><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-6f404e8a><span class="vpi-more-horizontal icon" data-v-6f404e8a></span></button><div class="menu" data-v-6f404e8a><div class="VPMenu" data-v-6f404e8a data-v-1bb74cb7><!----><!--[--><!--[--><!----><div class="group" data-v-0ddd3b74><div class="item appearance" data-v-0ddd3b74><p class="label" data-v-0ddd3b74>Tema</p><div class="appearance-action" data-v-0ddd3b74><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-0ddd3b74 data-v-139a0758 data-v-6ae48061><span class="check" data-v-6ae48061><span class="icon" data-v-6ae48061><!--[--><span class="vpi-sun sun" data-v-139a0758></span><span class="vpi-moon moon" data-v-139a0758></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-b140bbbf data-v-d8d7505f><span class="container" data-v-d8d7505f><span class="top" data-v-d8d7505f></span><span class="middle" data-v-d8d7505f></span><span class="bottom" data-v-d8d7505f></span></span></button></div></div></div></div><div class="divider" data-v-b140bbbf><div class="divider-line" data-v-b140bbbf></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-f5dee57d data-v-cff79b2d><div class="container" data-v-cff79b2d><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-cff79b2d><span class="vpi-align-left menu-icon" data-v-cff79b2d></span><span class="menu-text" data-v-cff79b2d>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-cff79b2d data-v-64e5faff><button data-v-64e5faff>Torna su</button><!----></div></div></div><aside class="VPSidebar" data-v-f5dee57d data-v-24ac7daa><div class="curtain" data-v-24ac7daa></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-24ac7daa><span class="visually-hidden" id="sidebar-aria-label" data-v-24ac7daa> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Usare Noeva ETL</h2><!----></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/usare/" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Come si usa</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/usare/app-desktop" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>L'app desktop</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/usare/esito-di-una-run" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Leggere l'esito di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/TECHNICAL_OVERVIEW" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Panoramica di prodotto</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Creare con Claude Code</h2><!----></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/claude-code/" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Dal bisogno al processo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/claude-code/prompt" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Comporre il prompt</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/claude-code/strumenti" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Skill e subagent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/GUIDA_SVILUPPO" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Guida allo sviluppo</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Concetti</h2><!----></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/guide/grafo" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Il grafo, nodo per nodo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/run-report" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Il report di run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/run-trace" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>La traccia di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/versioni-di-pipeline" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Versioni di pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/node-descriptor" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Descriptor dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/node-columns" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Colonne dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/conventions/variabili-del-core" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Variabili d'ambiente del core</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Tipi di nodo</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Cheatsheet</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/action" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>action</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/ai" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>ai</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/join" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>join</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/lookup" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>lookup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/pipeline" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/route" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>route</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/sink" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>sink</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/source" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>source</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/task" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>task</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/transform" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>transform</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/try-catch" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>try-catch</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/nodes/union" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>union</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Connettori</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Panoramica</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/file" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>File (storage × codec)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/http" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>HTTP (API REST per i nodi lookup e action)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/imap" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>IMAP (caselle di posta)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/jira" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/noeva" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Noeva (file dei workspace)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/oauth" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>OAuth2 per i connettori di posta</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/postgres" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>PostgreSQL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/process" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>processo esterno</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/sendgrid" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>SendGrid (mail via API REST)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/smtp" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>SMTP (notifiche email)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/connectors/sqlserver" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>SQL Server</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Pipeline pronte</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Le schede di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/test-posta" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>test-posta</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed has-active" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Esempi</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/sub-pipelines/README" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>Le schede di una sub-pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/crm-leads-sync" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>crm-leads-sync</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/cross-workspace-csv-merge" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>cross-workspace-csv-merge</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/movimenti-per-conto" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>movimenti-per-conto</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/pipelines/orders-enriched-daily" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>orders-enriched-daily</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/sub-pipelines/riepilogo-ordini" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>riepilogo-ordini</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-4be63f01><section class="VPSidebarItem level-0 collapsible collapsed" data-v-4be63f01 data-v-0fae8093><div class="item" role="button" tabindex="0" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><h2 class="text" data-v-0fae8093>Operatività</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0fae8093><span class="vpi-chevron-right caret-icon" data-v-0fae8093></span></div></div><div class="items" data-v-0fae8093><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/aggiornamento-pm2" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>aggiornare un deploy PM2 di un repo cliente</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/deploy-ecr" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>un cliente su ECR + ECS</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/deployment" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>distribuzione del runner ETL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/etl-worker" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>worker etl worker (polling su processes)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/graph-server" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>server grafi etl serve (HTTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/mask-key" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>chiavi di mask (creazione, rotazione, compromissione)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/oauth-google-posta" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>OAuth2 per una casella Google (IMAP + SMTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/rollback-di-pipeline" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>rollback di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/scd2-rehash" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>rehash di una dimensione storicizzata</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/sql-task-truncate-swap" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>task SQL, truncate e scambio di tabelle</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0fae8093><div class="item" data-v-0fae8093><div class="indicator" data-v-0fae8093></div><a class="VPLink link link" href="/guida/core/runbooks/stato-incrementale" data-v-0fae8093><!--[--><p class="text" data-v-0fae8093>stato di pipeline e watermark</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-f5dee57d data-v-b2578848><div class="VPDoc has-sidebar has-aside" data-v-b2578848 data-v-303c7d43><!--[--><!--]--><div class="container" data-v-303c7d43><div class="aside" data-v-303c7d43><div class="aside-curtain" data-v-303c7d43></div><div class="aside-container" data-v-303c7d43><div class="aside-content" data-v-303c7d43><div class="VPDocAside" data-v-303c7d43 data-v-50c80a94><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-50c80a94 data-v-ba0e722b><div class="content" data-v-ba0e722b><div class="outline-marker" data-v-ba0e722b></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-ba0e722b>In questa pagina</div><ul class="VPDocOutlineItem root" data-v-ba0e722b data-v-d9a98cc8><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-50c80a94></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-303c7d43><div class="content-container" data-v-303c7d43><!--[--><!--]--><main class="main" data-v-303c7d43><div style="position:relative;" class="vp-doc _guida_core_pipelines_orders-enriched-daily" data-v-303c7d43><div><h1 id="pipeline-orders-enriched-daily" tabindex="-1">Pipeline: orders-enriched-daily <a class="header-anchor" href="#pipeline-orders-enriched-daily" aria-label="Permalink to "Pipeline: orders-enriched-daily""></a></h1><ul><li><strong>Scopo:</strong> pipeline <strong>di riferimento</strong> per il DSL a grafo (<code>graph()</code>): arricchisce gli ordini con l'anagrafica clienti via join a chiave e distribuisce il risultato (fan-out) su due destinazioni indipendenti. Non movimenta dati reali — dataset dimostrativo in-memory — pensata come esempio eseguibile e banco di prova per le funzionalità DAG (join, fan-out, dead-letter per nodo, nodo try/catch, path di fallback su sink isolabile, corpo dei record falliti visibile nel report).</li></ul><blockquote><p><strong>Nota</strong>: il <code>guard</code> di questa pipeline attiva <code>includeRawInReport</code>, quindi il <strong>corpo</strong> degli ordini respinti finisce nel report ed è visibile nel pannello del guard in UI. È accettabile qui perché la demo gira su fixture sintetiche. Su una pipeline con dati reali significherebbe persisterli nel report: ci si pensa due volte prima di copiare quell'opzione altrove.</p></blockquote><ul><li><strong>Owner:</strong> — (esempio di piattaforma)</li><li><strong>Cadenza:</strong> on-demand (demo)</li><li><strong>Runbook:</strong> non applicabile (nessun sistema esterno).</li></ul><h2 id="flusso-dati" tabindex="-1">Flusso dati <a class="header-anchor" href="#flusso-dati" aria-label="Permalink to "Flusso dati""></a></h2><div class="level-nav" data-v-5318f34a data-v-c981a055><nav class="level-nav__crumbs" aria-label="Livelli del grafo" data-v-c981a055><!--[--><!--[--><!----><span class="level-nav__crumb is-current" aria-current="location" data-v-c981a055>orders-enriched-daily</span><!--]--><!--]--><!----></nav><!----><div class="level-nav__instances" data-v-c981a055><span class="level-nav__hint" data-v-c981a055>Istanze di sub-pipeline, chiuse: entra col doppio click o da qui.</span><!--[--><span class="level-nav__instance" data-v-c981a055><button type="button" class="etl-button" title="Entra in riepilogo-ordini" data-v-c981a055> Entra in <code data-v-c981a055>riepilogo-ordini</code></button><a href="/guida/core/sub-pipelines/riepilogo-ordini" class="level-nav__link" data-v-c981a055>scheda di riepilogo-ordini</a></span><!--]--></div><figure class="graph-demo etl-panel" tabindex="0" aria-label="Grafo della pipeline orders-enriched-daily: ← e → per andare avanti e indietro di un passo, spazio per play e pausa" data-v-c981a055 data-v-fc9b2f46><div class="graph-demo__toolbar" role="group" aria-label="Scene di Grafo della pipeline orders-enriched-daily" data-v-fc9b2f46><!--[--><button type="button" class="etl-button graph-demo__scene" aria-pressed="false" data-v-fc9b2f46>Fai passare un record</button><!--]--><span class="graph-demo__spacer" data-v-fc9b2f46></span><div class="graph-demo__controls" role="group" aria-label="Riproduzione" data-v-fc9b2f46><button type="button" class="etl-button graph-demo__control" aria-label="Passo precedente" title="Passo precedente (←)" disabled data-v-fc9b2f46><svg viewBox="0 0 16 16" aria-hidden="true" data-v-fc9b2f46><rect x="3" y="3" width="2" height="10" rx="1" data-v-fc9b2f46></rect><path d="M13 3v10L6 8z" data-v-fc9b2f46></path></svg></button><button type="button" class="etl-button graph-demo__control" aria-label="Riproduci da solo" title="Riproduci da solo (spazio)" data-v-fc9b2f46><svg viewBox="0 0 16 16" aria-hidden="true" data-v-fc9b2f46><path d="M4.5 2.8v10.4L13 8z" data-v-fc9b2f46></path></svg></button><button type="button" class="etl-button graph-demo__control" aria-label="Passo successivo" title="Passo successivo (→)" data-v-fc9b2f46><svg viewBox="0 0 16 16" aria-hidden="true" data-v-fc9b2f46><path d="M3 3v10l7-5z" data-v-fc9b2f46></path><rect x="11" y="3" width="2" height="10" rx="1" data-v-fc9b2f46></rect></svg></button><span class="graph-demo__counter" aria-live="off" data-v-fc9b2f46>0/7</span></div></div><div class="graph-demo__stage etl-dotgrid" data-v-fc9b2f46><svg class="graph-demo__canvas" style="min-width:1380px;" viewBox="0 0 1916 368" role="img" aria-label="Grafo della pipeline orders-enriched-daily" data-v-fc9b2f46><defs data-v-fc9b2f46><marker id="graph-demo-1-arrow" viewBox="0 0 8 8" refX="7" refY="4" markerWidth="7" markerHeight="7" orient="auto" data-v-fc9b2f46><path d="M0 0 L8 4 L0 8 z" class="graph-demo__arrow" data-v-fc9b2f46></path></marker></defs><!--[--><path data-edge="orders->validate-orders" d="M 206 139 C 229.6 139, 234.4 139, 258 139" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="customers->validate-customers" d="M 206 229 C 229.6 229, 234.4 229, 258 229" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="validate-customers->enrich:build" d="M 448 229 C 471.6 229, 476.4 229, 500 229" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="validate-orders->enrich:probe" d="M 448 139 C 495.2 139, 452.8 229, 500 229" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="enrich->guard" d="M 690 229 C 721.3 229, 710.7 184, 742 184" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="guard->riepilogo-ordini" d="M 932 184 C 963.3 184, 952.7 139, 984 139" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="riepilogo-ordini/fatti->enriched_orders" d="M 1174 152 C 1226.4 152, 1173.6 49, 1226 49" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="riepilogo-ordini/per-tier->tier_summary" d="M 1174 138 C 1197.6 138, 1202.4 139, 1226 139" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="guard->log-errors:catch" d="M 932 184 C 963.3 184, 952.7 229, 984 229" class="is-catch graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="log-errors->caught_errors" d="M 1174 229 C 1221.2 229, 1178.8 319, 1226 319" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="log-errors->recover-orders" d="M 1174 229 C 1197.6 229, 1202.4 229, 1226 229" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="recover-orders->restore-order" d="M 1416 229 C 1447.3 229, 1436.7 184, 1468 184" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="restore-order->orders-fallback" d="M 1658 184 C 1681.6 184, 1686.4 184, 1710 184" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="validate-orders->orders_dead_letter:dead-letter" d="M 448 139 C 471.6 139, 476.4 139, 500 139" class="is-dead-letter graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><!--]--><!--[--><!--]--><!--[--><g class="dag-node kind-source" data-v-fc9b2f46 data-v-340130bc><title data-v-340130bc>
|
|
23
|
+
<div id="app"><div class="Layout etl-wide" data-v-22f0e4eb><!--[--><!--]--><!--[--><span tabindex="-1" data-v-3426c47a></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-3426c47a>Skip to content</a><!--]--><!----><header class="VPNav" data-v-22f0e4eb data-v-c0562b42><div class="VPNavBar" data-v-c0562b42 data-v-09e46d68><div class="wrapper" data-v-09e46d68><div class="container" data-v-09e46d68><div class="title" data-v-09e46d68><div class="VPNavBarTitle has-sidebar" data-v-09e46d68 data-v-373bba86><a class="title" href="/guida/core/" data-v-373bba86><!--[--><!--]--><!--[--><!--[--><!--[--><img class="VPImage dark logo" src="/guida/core/logo-light.png" alt="Noeva" data-v-b8fe04e5><!--]--><!--[--><img class="VPImage light logo" src="/guida/core/logo-dark.png" alt="Noeva" data-v-b8fe04e5><!--]--><!--]--><!--]--><!----><!--[--><!--[--><!--[--><!--[--><span class="etl-wordmark" aria-hidden="true">ETL</span><span class="etl-embedded-title">Documentazione</span><!--]--><!--]--><!--]--><!--]--></a></div></div><div class="content" data-v-09e46d68><div class="content-body" data-v-09e46d68><!--[--><!--]--><div class="VPNavBarSearch search" data-v-09e46d68><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Cerca nella documentazione"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Cerca</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-09e46d68 data-v-39d75b74><span id="main-nav-aria-label" class="visually-hidden" data-v-39d75b74> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/usare/" tabindex="0" data-v-39d75b74 data-v-d4ae6030><!--[--><span data-v-d4ae6030>Usare</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/guida/core/guide/claude-code/" tabindex="0" data-v-39d75b74 data-v-d4ae6030><!--[--><span data-v-d4ae6030>Creare con Claude Code</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-39d75b74 data-v-5d303cc7><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-5d303cc7><span class="text" data-v-5d303cc7><!----><span data-v-5d303cc7>Riferimento</span><span class="vpi-chevron-down text-icon" data-v-5d303cc7></span></span></button><div class="menu" data-v-5d303cc7><div class="VPMenu" data-v-5d303cc7 data-v-e79ccfeb><div class="items" data-v-e79ccfeb><!--[--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/guide/grafo" data-v-b2643254><!--[--><span data-v-b2643254>Il grafo, nodo per nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/nodes/README" data-v-b2643254><!--[--><span data-v-b2643254>Tipi di nodo</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/connectors/README" data-v-b2643254><!--[--><span data-v-b2643254>Connettori</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/pipelines/README" data-v-b2643254><!--[--><span data-v-b2643254>Pipeline pronte</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/run-report" data-v-b2643254><!--[--><span data-v-b2643254>Il report di run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/run-trace" data-v-b2643254><!--[--><span data-v-b2643254>La traccia di una run</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/conventions/variabili-del-core" data-v-b2643254><!--[--><span data-v-b2643254>Variabili d'ambiente del core</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-e79ccfeb data-v-b2643254><a class="VPLink link" href="/guida/core/runbooks/graph-server" data-v-b2643254><!--[--><span data-v-b2643254>Operatività</span><!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-09e46d68 data-v-41033a42><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-41033a42 data-v-16571e93 data-v-3d2b146f><span class="check" data-v-3d2b146f><span class="icon" data-v-3d2b146f><!--[--><span class="vpi-sun sun" data-v-16571e93></span><span class="vpi-moon moon" data-v-16571e93></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-09e46d68 data-v-6ab99828 data-v-5d303cc7><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-5d303cc7><span class="vpi-more-horizontal icon" data-v-5d303cc7></span></button><div class="menu" data-v-5d303cc7><div class="VPMenu" data-v-5d303cc7 data-v-e79ccfeb><!----><!--[--><!--[--><!----><div class="group" data-v-6ab99828><div class="item appearance" data-v-6ab99828><p class="label" data-v-6ab99828>Tema</p><div class="appearance-action" data-v-6ab99828><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-6ab99828 data-v-16571e93 data-v-3d2b146f><span class="check" data-v-3d2b146f><span class="icon" data-v-3d2b146f><!--[--><span class="vpi-sun sun" data-v-16571e93></span><span class="vpi-moon moon" data-v-16571e93></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-09e46d68 data-v-91920283><span class="container" data-v-91920283><span class="top" data-v-91920283></span><span class="middle" data-v-91920283></span><span class="bottom" data-v-91920283></span></span></button></div></div></div></div><div class="divider" data-v-09e46d68><div class="divider-line" data-v-09e46d68></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-22f0e4eb data-v-caa5a72f><div class="container" data-v-caa5a72f><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-caa5a72f><span class="vpi-align-left menu-icon" data-v-caa5a72f></span><span class="menu-text" data-v-caa5a72f>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-caa5a72f data-v-731b3d50><button data-v-731b3d50>Torna su</button><!----></div></div></div><aside class="VPSidebar" data-v-22f0e4eb data-v-ac566ed2><div class="curtain" data-v-ac566ed2></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-ac566ed2><span class="visually-hidden" id="sidebar-aria-label" data-v-ac566ed2> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Usare Noeva ETL</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Come si usa</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/app-desktop" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>L'app desktop</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/usare/esito-di-una-run" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Leggere l'esito di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/TECHNICAL_OVERVIEW" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Panoramica di prodotto</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Creare con Claude Code</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Dal bisogno al processo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/prompt" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Comporre il prompt</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/claude-code/strumenti" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Skill e subagent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/GUIDA_SVILUPPO" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Guida allo sviluppo</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Concetti</h2><!----></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/guide/grafo" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Il grafo, nodo per nodo</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/run-report" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Il report di run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/run-trace" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>La traccia di una run</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/versioni-di-pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Versioni di pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/node-descriptor" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Descriptor dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/node-columns" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Colonne dei nodi</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/conventions/variabili-del-core" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Variabili d'ambiente del core</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Tipi di nodo</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Cheatsheet</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/action" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>action</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/ai" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>ai</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/join" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>join</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/lookup" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>lookup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/route" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>route</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/sink" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>sink</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/source" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>source</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/task" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>task</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/transform" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>transform</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/try-catch" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>try-catch</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/nodes/union" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>union</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Connettori</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Panoramica</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/file" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>File (storage × codec)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/http" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>HTTP (API REST per i nodi lookup e action)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/imap" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>IMAP (caselle di posta)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/jira" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/noeva" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Noeva (file dei workspace)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/oauth" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>OAuth2 per i connettori</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/postgres" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>PostgreSQL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/process" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>processo esterno</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/sendgrid" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SendGrid (mail via API REST)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/smtp" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SMTP (notifiche email)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/sqlserver" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>SQL Server</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/connectors/zoho" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Zoho CRM (record di un modulo, con i campi dichiarati)</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Pipeline pronte</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Le schede di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/test-posta" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>test-posta</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed has-active" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Esempi</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/sub-pipelines/README" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>Le schede di una sub-pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/crm-leads-sync" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>crm-leads-sync</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/cross-workspace-csv-merge" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>cross-workspace-csv-merge</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/movimenti-per-conto" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>movimenti-per-conto</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/pipelines/orders-enriched-daily" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>orders-enriched-daily</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/sub-pipelines/riepilogo-ordini" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>riepilogo-ordini</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-f8570edd><section class="VPSidebarItem level-0 collapsible collapsed" data-v-f8570edd data-v-8de60be2><div class="item" role="button" tabindex="0" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><h2 class="text" data-v-8de60be2>Operatività</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-8de60be2><span class="vpi-chevron-right caret-icon" data-v-8de60be2></span></div></div><div class="items" data-v-8de60be2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/aggiornamento-pm2" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>aggiornare un deploy PM2 di un repo cliente</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/deploy-ecr" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>un cliente su ECR + ECS</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/deployment" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>distribuzione del runner ETL</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/etl-worker" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>worker etl worker (polling su processes)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/graph-server" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>server grafi etl serve (HTTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/mask-key" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>chiavi di mask (creazione, rotazione, compromissione)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/oauth-google-posta" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>OAuth2 per una casella Google (IMAP + SMTP)</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/rollback-di-pipeline" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>rollback di una pipeline</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/scd2-rehash" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>rehash di una dimensione storicizzata</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/sql-task-truncate-swap" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>task SQL, truncate e scambio di tabelle</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-8de60be2><div class="item" data-v-8de60be2><div class="indicator" data-v-8de60be2></div><a class="VPLink link link" href="/guida/core/runbooks/stato-incrementale" data-v-8de60be2><!--[--><p class="text" data-v-8de60be2>stato di pipeline e watermark</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-22f0e4eb data-v-0c4b08a9><div class="VPDoc has-sidebar has-aside" data-v-0c4b08a9 data-v-4f20312f><!--[--><!--]--><div class="container" data-v-4f20312f><div class="aside" data-v-4f20312f><div class="aside-curtain" data-v-4f20312f></div><div class="aside-container" data-v-4f20312f><div class="aside-content" data-v-4f20312f><div class="VPDocAside" data-v-4f20312f data-v-2db35001><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-2db35001 data-v-2f8395af><div class="content" data-v-2f8395af><div class="outline-marker" data-v-2f8395af></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-2f8395af>In questa pagina</div><ul class="VPDocOutlineItem root" data-v-2f8395af data-v-9c3b479d><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-2db35001></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-4f20312f><div class="content-container" data-v-4f20312f><!--[--><!--]--><main class="main" data-v-4f20312f><div style="position:relative;" class="vp-doc _guida_core_pipelines_orders-enriched-daily" data-v-4f20312f><div><h1 id="pipeline-orders-enriched-daily" tabindex="-1">Pipeline: orders-enriched-daily <a class="header-anchor" href="#pipeline-orders-enriched-daily" aria-label="Permalink to "Pipeline: orders-enriched-daily""></a></h1><ul><li><strong>Scopo:</strong> pipeline <strong>di riferimento</strong> per il DSL a grafo (<code>graph()</code>): arricchisce gli ordini con l'anagrafica clienti via join a chiave e distribuisce il risultato (fan-out) su due destinazioni indipendenti. Non movimenta dati reali — dataset dimostrativo in-memory — pensata come esempio eseguibile e banco di prova per le funzionalità DAG (join, fan-out, dead-letter per nodo, nodo try/catch, path di fallback su sink isolabile, corpo dei record falliti visibile nel report).</li></ul><blockquote><p><strong>Nota</strong>: il <code>guard</code> di questa pipeline attiva <code>includeRawInReport</code>, quindi il <strong>corpo</strong> degli ordini respinti finisce nel report ed è visibile nel pannello del guard in UI. È accettabile qui perché la demo gira su fixture sintetiche. Su una pipeline con dati reali significherebbe persisterli nel report: ci si pensa due volte prima di copiare quell'opzione altrove.</p></blockquote><ul><li><strong>Owner:</strong> — (esempio di piattaforma)</li><li><strong>Cadenza:</strong> on-demand (demo)</li><li><strong>Runbook:</strong> non applicabile (nessun sistema esterno).</li></ul><h2 id="flusso-dati" tabindex="-1">Flusso dati <a class="header-anchor" href="#flusso-dati" aria-label="Permalink to "Flusso dati""></a></h2><div class="level-nav" data-v-5318f34a data-v-c981a055><nav class="level-nav__crumbs" aria-label="Livelli del grafo" data-v-c981a055><!--[--><!--[--><!----><span class="level-nav__crumb is-current" aria-current="location" data-v-c981a055>orders-enriched-daily</span><!--]--><!--]--><!----></nav><!----><div class="level-nav__instances" data-v-c981a055><span class="level-nav__hint" data-v-c981a055>Istanze di sub-pipeline, chiuse: entra col doppio click o da qui.</span><!--[--><span class="level-nav__instance" data-v-c981a055><button type="button" class="etl-button" title="Entra in riepilogo-ordini" data-v-c981a055> Entra in <code data-v-c981a055>riepilogo-ordini</code></button><a href="/guida/core/sub-pipelines/riepilogo-ordini" class="level-nav__link" data-v-c981a055>scheda di riepilogo-ordini</a></span><!--]--></div><figure class="graph-demo etl-panel" tabindex="0" aria-label="Grafo della pipeline orders-enriched-daily: ← e → per andare avanti e indietro di un passo, spazio per play e pausa" data-v-c981a055 data-v-fc9b2f46><div class="graph-demo__toolbar" role="group" aria-label="Scene di Grafo della pipeline orders-enriched-daily" data-v-fc9b2f46><!--[--><button type="button" class="etl-button graph-demo__scene" aria-pressed="false" data-v-fc9b2f46>Fai passare un record</button><!--]--><span class="graph-demo__spacer" data-v-fc9b2f46></span><div class="graph-demo__controls" role="group" aria-label="Riproduzione" data-v-fc9b2f46><button type="button" class="etl-button graph-demo__control" aria-label="Passo precedente" title="Passo precedente (←)" disabled data-v-fc9b2f46><svg viewBox="0 0 16 16" aria-hidden="true" data-v-fc9b2f46><rect x="3" y="3" width="2" height="10" rx="1" data-v-fc9b2f46></rect><path d="M13 3v10L6 8z" data-v-fc9b2f46></path></svg></button><button type="button" class="etl-button graph-demo__control" aria-label="Riproduci da solo" title="Riproduci da solo (spazio)" data-v-fc9b2f46><svg viewBox="0 0 16 16" aria-hidden="true" data-v-fc9b2f46><path d="M4.5 2.8v10.4L13 8z" data-v-fc9b2f46></path></svg></button><button type="button" class="etl-button graph-demo__control" aria-label="Passo successivo" title="Passo successivo (→)" data-v-fc9b2f46><svg viewBox="0 0 16 16" aria-hidden="true" data-v-fc9b2f46><path d="M3 3v10l7-5z" data-v-fc9b2f46></path><rect x="11" y="3" width="2" height="10" rx="1" data-v-fc9b2f46></rect></svg></button><span class="graph-demo__counter" aria-live="off" data-v-fc9b2f46>0/7</span></div></div><div class="graph-demo__stage etl-dotgrid" data-v-fc9b2f46><svg class="graph-demo__canvas" style="min-width:1380px;" viewBox="0 0 1916 368" role="img" aria-label="Grafo della pipeline orders-enriched-daily" data-v-fc9b2f46><defs data-v-fc9b2f46><marker id="graph-demo-1-arrow" viewBox="0 0 8 8" refX="7" refY="4" markerWidth="7" markerHeight="7" orient="auto" data-v-fc9b2f46><path d="M0 0 L8 4 L0 8 z" class="graph-demo__arrow" data-v-fc9b2f46></path></marker></defs><!--[--><path data-edge="orders->validate-orders" d="M 206 139 C 229.6 139, 234.4 139, 258 139" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="customers->validate-customers" d="M 206 229 C 229.6 229, 234.4 229, 258 229" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="validate-customers->enrich:build" d="M 448 229 C 471.6 229, 476.4 229, 500 229" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="validate-orders->enrich:probe" d="M 448 139 C 495.2 139, 452.8 229, 500 229" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="enrich->guard" d="M 690 229 C 721.3 229, 710.7 184, 742 184" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="guard->riepilogo-ordini" d="M 932 184 C 963.3 184, 952.7 139, 984 139" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="riepilogo-ordini/fatti->enriched_orders" d="M 1174 152 C 1226.4 152, 1173.6 49, 1226 49" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="riepilogo-ordini/per-tier->tier_summary" d="M 1174 138 C 1197.6 138, 1202.4 139, 1226 139" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="guard->log-errors:catch" d="M 932 184 C 963.3 184, 952.7 229, 984 229" class="is-catch graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="log-errors->caught_errors" d="M 1174 229 C 1221.2 229, 1178.8 319, 1226 319" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="log-errors->recover-orders" d="M 1174 229 C 1197.6 229, 1202.4 229, 1226 229" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="recover-orders->restore-order" d="M 1416 229 C 1447.3 229, 1436.7 184, 1468 184" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="restore-order->orders-fallback" d="M 1658 184 C 1681.6 184, 1686.4 184, 1710 184" class="is-data graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><path data-edge="validate-orders->orders_dead_letter:dead-letter" d="M 448 139 C 471.6 139, 476.4 139, 500 139" class="is-dead-letter graph-demo__edge" marker-end="url(#graph-demo-1-arrow)" data-v-fc9b2f46></path><!--]--><!--[--><!--]--><!--[--><g class="dag-node kind-source" data-v-fc9b2f46 data-v-340130bc><title data-v-340130bc>
|
|
24
24
|
orders — source
|
|
25
25
|
memory
|
|
26
26
|
</title><rect class="dag-node__halo" x="12" y="102" width="198" height="74" rx="12" data-v-340130bc></rect><!----><rect class="dag-node__card" x="16" y="106" width="190" height="66" rx="9" data-v-340130bc></rect><rect class="dag-node__accent" x="16" y="112" width="3" height="54" rx="1.5" data-v-340130bc></rect><text class="dag-node__label" x="28" y="125" data-v-340130bc>orders</text><text class="dag-node__kind" x="196" y="125" text-anchor="end" data-v-340130bc>source</text><!--[--><text class="dag-node__sub" x="28" y="141" data-v-340130bc>memory</text><!--]--><!--[--><!--]--></g><g class="dag-node kind-source" data-v-fc9b2f46 data-v-340130bc><title data-v-340130bc>
|
|
@@ -61,8 +61,8 @@ memory
|
|
|
61
61
|
</title><rect class="dag-node__halo" x="1706" y="147" width="198" height="74" rx="12" data-v-340130bc></rect><!----><rect class="dag-node__card" x="1710" y="151" width="190" height="66" rx="9" data-v-340130bc></rect><rect class="dag-node__accent" x="1710" y="157" width="3" height="54" rx="1.5" data-v-340130bc></rect><text class="dag-node__label" x="1722" y="170" data-v-340130bc>orders-fallback</text><text class="dag-node__kind" x="1890" y="170" text-anchor="end" data-v-340130bc>sink</text><!--[--><text class="dag-node__sub" x="1722" y="186" data-v-340130bc>memory</text><!--]--><!--[--><!--]--></g><g class="dag-node kind-dead-letter" data-v-fc9b2f46 data-v-340130bc><title data-v-340130bc>
|
|
62
62
|
orders_dead_letter — dead-letter
|
|
63
63
|
memory
|
|
64
|
-
</title><rect class="dag-node__halo" x="496" y="102" width="198" height="74" rx="12" data-v-340130bc></rect><!----><rect class="dag-node__card" x="500" y="106" width="190" height="66" rx="9" data-v-340130bc></rect><rect class="dag-node__accent" x="500" y="112" width="3" height="54" rx="1.5" data-v-340130bc></rect><text class="dag-node__label" x="512" y="125" data-v-340130bc>orders_dead_letter</text><text class="dag-node__kind" x="680" y="125" text-anchor="end" data-v-340130bc>dead-letter</text><!--[--><text class="dag-node__sub" x="512" y="141" data-v-340130bc>memory</text><!--]--><!--[--><!--]--></g><!--]--><!--[--><!--]--></svg><!--[--><!--]--><!----></div><!----><figcaption class="graph-demo__footer" data-v-fc9b2f46><span class="graph-demo__progress" aria-hidden="true" data-v-fc9b2f46><span style="width:0%;" data-v-fc9b2f46></span></span><span class="graph-demo__caption" aria-live="polite" data-v-fc9b2f46><!--[--> Scegli una scena e premi ▶ per guardarla scorrere, oppure → per andare avanti un passo alla volta. <!--]--></span></figcaption></figure><figure class="level-nav__purposes" data-v-c981a055><figcaption id="level-nav-purposes-v-0" class="level-nav__purposes-title" data-v-c981a055> Lo scopo dei nodi </figcaption><table aria-labelledby="level-nav-purposes-v-0" data-v-c981a055><thead data-v-c981a055><tr data-v-c981a055><th scope="col" data-v-c981a055>Nodo</th><th scope="col" data-v-c981a055>Tipo</th><th scope="col" data-v-c981a055>Scopo</th></tr></thead><tbody data-v-c981a055><!--[--><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>orders</code></td><td data-v-c981a055><code data-v-c981a055>source</code></td><td data-v-c981a055>Legge gli ordini di prova della dimostrazione, ognuno con il cliente che l'ha fatto, l'importo e la data.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>customers</code></td><td data-v-c981a055><code data-v-c981a055>source</code></td><td data-v-c981a055>Legge l'anagrafica di prova dei clienti, con il nome e la fascia di ciascuno, che servono a completare gli ordini.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>validate-orders</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Controlla che ogni ordine abbia cliente, importo e data validi. Un ordine fuori regola viene messo da parte fra gli scarti, e gli altri proseguono.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>validate-customers</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Controlla che ogni cliente abbia un nome e una fascia ammessa. Un cliente fuori regola ferma la run: gli ordini completati con un'anagrafica sbagliata sarebbero sbagliati anche loro.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>enrich</code></td><td data-v-c981a055><code data-v-c981a055>join</code></td><td data-v-c981a055>Completa ogni ordine con il nome e la fascia del suo cliente. Un ordine il cui cliente non è in anagrafica prosegue lo stesso, senza nome né fascia.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>guard</code></td><td data-v-c981a055><code data-v-c981a055>try-catch</code></td><td data-v-c981a055>Protegge, ordine per ordine, il riepilogo e il salvataggio: un ordine rifiutato più avanti, come quello con un importo non positivo, finisce fra gli errori e la run prosegue con gli altri.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>riepilogo-ordini</code></td><td data-v-c981a055><code data-v-c981a055>pipeline</code></td><td data-v-c981a055>Prepara i due risultati della giornata a partire dagli ordini completati: gli ordini controllati, pronti da salvare, e il riepilogo per fascia cliente.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>enriched_orders</code></td><td data-v-c981a055><code data-v-c981a055>sink</code></td><td data-v-c981a055>Salva gli ordini della giornata completati con i dati del cliente, uno per ordine: è il dettaglio su cui si appoggia ogni analisi.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>tier_summary</code></td><td data-v-c981a055><code data-v-c981a055>sink</code></td><td data-v-c981a055>Salva il riepilogo della giornata per fascia cliente, con quanti ordini e quale importo totale per ciascuna.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>log-errors</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Registra nel log ogni ordine finito fra gli errori, con il passo in cui l'errore è nato e il motivo, così si capisce che cosa è andato storto.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>caught_errors</code></td><td data-v-c981a055><code data-v-c981a055>sink</code></td><td data-v-c981a055>Conserva gli errori registrati, ognuno con l'ordine che l'ha causato, per poterli esaminare dopo la run.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>recover-orders</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Fra gli errori, tiene solo gli ordini che non si sono potuti salvare: sono gli unici da recuperare. Gli altri errori restano solo nel log.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>restore-order</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Riprende l'ordine com'era prima del salvataggio non riuscito, per poterlo salvare altrove.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>orders-fallback</code></td><td data-v-c981a055><code data-v-c981a055>sink</code></td><td data-v-c981a055>Salva in un archivio di riserva gli ordini che non si sono potuti salvare al loro posto, così nessun ordine va perso.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>orders_dead_letter</code></td><td data-v-c981a055><code data-v-c981a055>dead-letter</code></td><td data-v-c981a055>Raccoglie i record scartati dai nodi di questa pipeline, ognuno con il motivo dello scarto.</td></tr><!--]--></tbody></table></figure></div><blockquote><p>Il grafo qui sopra è disegnato dalla topologia reale della pipeline (<code>getSpec()</code>): nodi, archi, dead-letter e ramo catch sono quelli eseguiti. Premi ▶ per far passare un record, o → per avanzare un passo alla volta.</p></blockquote><p>Due sorgenti indipendenti confluiscono in un <strong>join a chiave</strong> (<code>enrich</code>), il cui output entra nell'istanza <code>riepilogo-ordini</code> della sub-pipeline omonima. Il suo confine d'ingresso valida l'ordine arricchito e fa <strong>fan-out</strong> sulle due uscite dell'istanza, due rami che non si influenzano a vicenda, salvo un errore fatale, che ferma la run: il fatto arricchito (<code>riepilogo-ordini</code> → <code>riepilogo-ordini/fatti</code> → <code>enriched_orders</code>) e un riepilogo aggregato per tier cliente (<code>riepilogo-ordini</code> → <code>riepilogo-ordini/tier-summary</code> → <code>riepilogo-ordini/per-tier</code> → <code>tier_summary</code>).</p><p>Il riepilogo è una <a href="./../sub-pipelines/riepilogo-ordini">sub-pipeline</a> istanziata col nodo <a href="./../nodes/pipeline"><code>pipeline</code></a>: alla costruzione si appiattisce nei suoi nodi, con gli id qualificati. Il grafo qui sopra mostra l'istanza come un nodo chiuso, in cui si entra col doppio click o da «Entra» (il link <code>?istanza=riepilogo-ordini</code> apre la scheda già dentro); il report mostra i nodi interni con l'id qualificato. La root cabla le due uscite con <code>fromPort: "fatti"</code> e <code>fromPort: "per-tier"</code>.</p><p>Codice: <code>src/pipelines/orders-enriched-daily/</code> · DSL a grafo: <code>src/core/graph-builder.ts</code>.</p><h2 id="sorgenti" tabindex="-1">Sorgenti <a class="header-anchor" href="#sorgenti" aria-label="Permalink to "Sorgenti""></a></h2><table tabindex="0"><thead><tr><th>Sistema</th><th>Schema/tabella</th><th>Chiave naturale</th><th>Modalità</th></tr></thead><tbody><tr><td>In-memory (demo)</td><td>ordini grezzi (<code>orders</code>)</td><td><code>order_id</code></td><td>full (dataset fisso in <code>run.ts</code>)</td></tr><tr><td>In-memory (demo)</td><td>anagrafica clienti (<code>customers</code>)</td><td><code>customer_id</code></td><td>full (dataset fisso in <code>run.ts</code>)</td></tr></tbody></table><h2 id="sink" tabindex="-1">Sink <a class="header-anchor" href="#sink" aria-label="Permalink to "Sink""></a></h2><table tabindex="0"><thead><tr><th>Sistema</th><th>Destinazione</th><th>Idempotenza</th></tr></thead><tbody><tr><td>In-memory (demo)</td><td><code>enriched_orders</code></td><td>n/a (demo — in un caso reale: upsert su <code>order_id</code>)</td></tr><tr><td>In-memory (demo)</td><td><code>tier_summary</code></td><td>n/a (demo — in un caso reale: upsert su <code>tier</code>)</td></tr><tr><td>In-memory (demo)</td><td><code>caught_errors</code></td><td>n/a (demo) — ramo <code>catch</code> del <code>guard</code> (<code>log-errors</code>): gli errori catturati, col loro <code>raw</code></td></tr><tr><td>In-memory (demo)</td><td><code>orders-fallback</code></td><td>n/a (demo) — ramo <code>catch</code>: gli ordini che <code>enriched_orders</code> ha rifiutato (<code>recover-orders</code> → <code>restore-order</code>)</td></tr><tr><td>In-memory (demo)</td><td><code>orders_dead_letter</code></td><td>n/a (demo) — dead-letter di <code>validate-orders</code>, opzionale</td></tr></tbody></table><h2 id="trasformazioni-e-regole-di-business" tabindex="-1">Trasformazioni e regole di business <a class="header-anchor" href="#trasformazioni-e-regole-di-business" aria-label="Permalink to "Trasformazioni e regole di business""></a></h2><p>Lo scopo di ogni nodo è nella tabella sotto il grafo, presa dal piano. Qui le regole che i nodi applicano.</p><ul><li><p><strong><code>validate-orders</code></strong> (contratto <code>raw-order-contract</code>) — valida l'ordine grezzo (<code>rawOrderSchema</code>): id non vuoti, <code>amount</code> numerico, <code>created_at</code> coercibile a data. Isolato su dead-letter <strong>per nodo</strong> (<code>ordersDeadLetter</code>, opzionale).</p></li><li><p><strong><code>validate-customers</code></strong> (contratto <code>raw-customer-contract</code>) — valida il cliente grezzo (<code>rawCustomerSchema</code>): id/nome non vuoti, <code>tier</code> in <code>gold|silver|bronze</code>.</p></li><li><p><strong><code>enrich</code></strong> — <code>hashJoin</code> a chiave (<code>build</code> = clienti in memoria, <code>probe</code> = ordini in streaming, <strong>pompato in concorrenza</strong> mentre la tabella di build si materializza), <code>how: "left"</code>: un ordine senza cliente noto sopravvive con <code>customer_name</code>/<code>tier</code> a <code>null</code>. Non solleva errori (il join si limita ad arricchire); entrambe le sorgenti validate vi confluiscono simmetricamente.</p></li><li><p><strong><code>guard</code></strong> — nodo <strong>try/catch</strong> subito <strong>dopo</strong> <code>enrich</code>: nel suo scope stanno l'istanza <code>riepilogo-ordini</code> e i sink a valle.</p></li><li><p><strong><code>riepilogo-ordini</code></strong> — istanza della sub-pipeline <a href="./../sub-pipelines/riepilogo-ordini"><code>riepilogo-ordini</code></a>, alimentata dal <code>guard</code>. Usa il parametro <code>tierMancante</code> al default, <code>"unknown"</code>, quindi si istanzia senza parametri; il piano lo mostra risolto in <code>instances[].params</code>. Appiattita, diventa quattro nodi:</p><ul><li><strong><code>riepilogo-ordini</code></strong>, il confine d'ingresso, che valida l'ordine arricchito (<code>enrichedOrderSchema</code>, <code>amount</code> <strong>positivo</strong>) e fa da gate/fan-out verso le due uscite. Era il nodo <code>fact-contract</code> della root, che l'istanza ha assorbito: il contratto del fatto non si ripete più a monte dell'istanza. <code>riepilogo-ordini:extracted</code> conta gli ordini entrati nell'istanza. Un ordine con <code>amount <= 0</code> passa il join ma viene qui respinto (<code>ValidationError</code>); essendo a valle del <code>guard</code>, l'errore è <strong>catturato dal <code>guard</code></strong> e instradato sul ramo <code>catch</code> (<code>log-errors</code> → <code>caught_errors</code>) invece di abortire. Il guard è <strong>per-record</strong>: <strong>tutti</strong> gli ordini con <code>amount <= 0</code> finiscono nel <code>catch</code> (col loro <code>raw</code>) e i validi continuano a essere caricati;</li><li><strong><code>riepilogo-ordini/fatti</code></strong>, il confine dell'uscita <code>fatti</code>, alimentato direttamente dall'ingresso, verso <code>enriched_orders</code>;</li><li><strong><code>riepilogo-ordini/tier-summary</code></strong>, <code>groupBy</code> <strong>stateful</strong> per tier cliente (<code>order_count</code>, <code>total_amount</code>, gli ordini senza cliente noto sotto il valore di <code>tierMancante</code>, <code>unknown</code>); come ogni aggregazione, è fail-fast (nessun dead-letter per-record: l'aggregazione bufferizza l'intero stream). Essendo stateful non viene mai isolato per-record, quindi un suo errore arriva al <code>catch</code> con <code>raw: undefined</code>; porta però <code>lastConsumed</code>, l'ultimo ordine consumato dal nodo — esatto se l'errore emerge durante il consumo dello stream, assente se emerge in fase di emissione. L'aggregazione di questa demo non ha punti in cui sollevare, quindi il caso è coperto dai test del core e non dalla demo;</li><li><strong><code>riepilogo-ordini/per-tier</code></strong>, il confine dell'uscita <code>per-tier</code>, che rivalida il riepilogo (<code>tierSummarySchema</code>) prima del sink. Era il nodo <code>tier-summary-contract</code>.</li></ul><p>Il <code>guard</code> sta a monte dell'istanza, quindi la copre per intero: un errore nato in uno di questi quattro nodi arriva al suo ramo <code>catch</code> col proprio id qualificato in <code>error.context.nodeId</code>.</p><p>Il caso dell'errore <strong>in emissione</strong> (e quello di un nodo a valle dell'aggregazione, dove <code>raw</code> è l'aggregato e non gli ordini) è coperto dalla lineage dei record: attivando <code>recordIds: true</code> sul grafo e <code>guardSnapshots: true</code> sul guard, il <code>catch</code> riceve <code>guardSnapshots</code> con gli <strong>ordini originali</strong> del gruppo colpevole. Questa pipeline <strong>non</strong> li attiva, per lo stesso motivo per cui il caso non è dimostrato qui: manca un punto di fallimento realistico nell'aggregazione, e gli snapshot terrebbero payload in memoria senza che serva a nulla.</p></li><li><p><strong><code>recover-orders</code> / <code>restore-order</code></strong> — <strong>path di fallback</strong> sul ramo <code>catch</code>. Il sink <code>enriched_orders</code> sta dentro lo scope del <code>guard</code>: se implementa <code>loadOne</code> è <strong>isolabile per-record</strong>, quindi un fallimento di scrittura non aborta la run ma finisce sul ramo <code>catch</code> <strong>portando con sé l'ordine</strong> (<code>DeadLetter.raw</code>). <code>recover-orders</code> filtra i soli errori provenienti da quel sink, <code>restore-order</code> ne estrae il payload e lo carica sul sink <code>orders-fallback</code>. Gli altri errori catturati (contratto, aggregazione, sink opachi) non hanno un ordine da recuperare e sono filtrati via.</p></li></ul><h2 id="contratti-schema-zod" tabindex="-1">Contratti (schema Zod) <a class="header-anchor" href="#contratti-schema-zod" aria-label="Permalink to "Contratti (schema Zod)""></a></h2><p>Definiti in <code>schema.ts</code>:</p><ul><li>Input: <code>rawOrderSchema</code>, <code>rawCustomerSchema</code>.</li><li>Intermedio/output: <code>enrichedOrderSchema</code> (fatto arricchito), <code>tierSummarySchema</code> (riepilogo per tier). Sono i contratti d'ingresso e d'uscita della sub-pipeline <code>riepilogo-ordini</code>: si definiscono in <code>src/sub-pipelines/riepilogo-ordini/schema.ts</code> e <code>schema.ts</code> li riesporta.</li></ul><p><strong>Colonne nel piano (<code>getSpec</code>)</strong>: da questi contratti l'introspezione Zod ricava le <code>columns</code> dei nodi mostrate nella UI del DAG. I nodi <code>validate()</code> (<code>validate-orders</code>, <code>validate-customers</code>) e i confini dell'istanza (<code>riepilogo-ordini</code>, <code>riepilogo-ordini/fatti</code>, <code>riepilogo-ordini/per-tier</code>) espongono le colonne del proprio schema; i sink (<code>enriched_orders</code>, <code>tier_summary</code>) le <strong>ereditano</strong> dal contratto a monte per propagazione. Il join <code>enrich</code> (predecessori discordi) e le source in-memory restano senza colonne. Il <code>groupBy</code> <code>riepilogo-ordini/tier-summary</code> dichiara <code>tierSummarySchema</code> come <code>outputSchema</code>, quindi mostra l'aggregato e non gli ordini che riceve. Il ramo <code>catch</code> non eredita (porta <code>DeadLetter</code>): <code>log-errors</code>, <code>caught_errors</code> e <code>recover-orders</code> restano senza colonne, finché <code>restore-order</code> riporta il record a un ordine e lo dichiara con <code>enrichedOrderSchema</code>. Vedi <code>columnsFromZodObject</code> e <code>toPlanSpec</code> in <code>src/core/</code>.</p><h2 id="parametri-ed-env" tabindex="-1">Parametri ed env <a class="header-anchor" href="#parametri-ed-env" aria-label="Permalink to "Parametri ed env""></a></h2><ul><li><code>ctx.params</code>: nessuno (dataset demo fisso in <code>run.ts</code>).</li><li>Variabili d'ambiente: nessuna — pipeline interamente in-memory, non richiede <code>.env.example</code>. <blockquote><p><strong>Nota storica.</strong> In passato questa pipeline aveva un'opzione <code>stepDelayMs</code> che inseriva un ritardo artificiale nel <code>writeReport</code> di ogni nodo, per rendere osservabile l'avanzamento in UI. Era una pezza a un buco nell'osservabilità: il runner notificava solo <code>onNodeComplete</code>, quindi la UI non aveva modo di sapere quali nodi stessero girando e senza ritardo la run finiva entro un singolo intervallo di polling. Con <code>onNodeStart</code> il segnale c'è davvero, e il ritardo — che stava <strong>nel percorso dati</strong> e bloccava anche il downstream — è stato rimosso.</p></blockquote></li></ul><h2 id="gestione-errori" tabindex="-1">Gestione errori <a class="header-anchor" href="#gestione-errori" aria-label="Permalink to "Gestione errori""></a></h2><ul><li><strong>Dead-letter per nodo</strong> (scelta di design del DSL a grafo): <code>validate-orders</code> ha il proprio sink di dead-letter (<code>ordersDeadLetter</code>, opzionale) che isola gli ordini grezzi non conformi <strong>record-by-record</strong>, continuando con i record buoni.</li><li><strong>Try/catch (per-record)</strong>: il nodo <code>guard</code> (dopo <code>enrich</code>) protegge l'istanza <code>riepilogo-ordini</code> e i nodi a valle. <strong>Ogni</strong> record che solleva un <code>EtlError</code> in un nodo protetto a valle del guard è deviato sul ramo <code>catch</code> (<code>errorLog</code>, opzionale; default: sink interno in memoria) come envelope <code>DeadLetter { raw, error }</code>, dopo essere stato loggato da <code>log-errors</code>, e lo stream <strong>continua</strong> (N record → N nel <code>catch</code>). La run <strong>non</strong> abortisce; lo stato diventa <code>partial</code>. Il comportamento "fermati al primo errore" è opt-in via <code>.tryCatch(..., { mode: "circuit-breaker" })</code>. Le transform <strong>stateful</strong> (es. <code>riepilogo-ordini/tier-summary</code>, un group-by) restano streaming, mai isolate.</li><li><strong>Errori a monte del guard</strong>: il guard cattura solo gli errori nati a valle di sé. Un cliente non conforme in <code>validate-customers</code> (senza dead-letter) o un errore del <code>join</code><code>enrich</code> fanno abortire la run, anche se l'errore attraversa l'istanza <code>riepilogo-ordini</code>.</li><li><strong><code>riepilogo-ordini/tier-summary</code></strong> resta fail-fast: essendo stateful, un errore qui aborta l'intera run (come ogni aggregazione).</li><li>Il <code>RunReport</code> (<code>GraphRunReport</code>) espone <code>status: "partial"</code> quando almeno un nodo ha scarti (<code>rejected</code>) o il try/catch ha catturato errori (<code>caught</code>), con <code>nodes[].rejected</code>/<code>rejectedReasons</code> e <code>nodes[].caught</code> per nodo — mai il payload del record (quello vive solo nel dead-letter/errorLog sink).</li><li><strong>Visibile nella DAG</strong>: <code>getSpec()</code> collega sia il dead-letter sia il ramo catch nella topologia statica, così la UI mostra i <strong>branch d'errore</strong> — da <code>validate-orders</code> verso <code>orders_dead_letter</code> (reject di schema, <code>stepType: "dead-letter"</code>) e dal nodo <code>guard</code> (<code>stepType: "try-catch"</code>) verso <code>log-errors</code> (<code>kind: "catch"</code>) — con edge tratteggiato destructive.</li></ul><h2 id="test" tabindex="-1">Test <a class="header-anchor" href="#test" aria-label="Permalink to "Test""></a></h2><ul><li>Unit pipeline: <code>pipeline.test.ts</code> — join <code>left</code>, fan-out su entrambi i sink, dead-letter per-record su <code>validate-orders</code>, cattura via <strong>try/catch</strong> dell'importo non positivo respinto dal confine d'ingresso <code>riepilogo-ordini</code>, instradato sul ramo catch, forma della topologia reale (<code>nodes</code>/<code>edges</code>, incl. <code>guard</code>, ramo catch e nodi dell'istanza <code>riepilogo-ordini</code>) nel report, riepilogo il cui totale trabocca rifiutato da <code>riepilogo-ordini/per-tier</code> e catturato dal <code>guard</code>.</li><li>Sub-pipeline: <code>sub-pipeline.test.ts</code> prova <code>riepilogo-ordini</code> da sola con <code>runSubPipeline</code>.</li><li>Esecuzione manuale: <code>pnpm run etl run orders-enriched-daily</code> stampa il <code>GraphRunReport</code> completo su stdout (vedi <a href="./../conventions/run-report"><code>docs/conventions/run-report.md</code></a>).</li></ul><h2 id="versioni" tabindex="-1">Versioni <a class="header-anchor" href="#versioni" aria-label="Permalink to "Versioni""></a></h2><p>La storia della pipeline, dalla versione più recente: la voce di changelog di ogni versione (<code>src/pipelines/orders-enriched-daily/changelog.ts</code>) e, sotto, cosa è cambiato nel piano rispetto alla precedente. Vedi <a href="./../conventions/versioni-di-pipeline">versioni di pipeline</a>.</p><div class="pipeline-versions" data-v-cdcb1722><!--[--><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v3</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-09 · ETL-193, ETL-195</span><!----></header><!----><!--[--><!--[--><!----><!--]--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Modifiche</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Nessun cambio di comportamento: il piano è identico alla v2. Gli import seguono l'infrastruttura (changelog, configurazione delle istanze, report di volume) uscita da `src/pipelines/` (ADR-0093 §1), e la pipeline si dichiara nel catalogo di `etl.config.ts` invece che in un registro (ADR-0093 §2)</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><p class="pipeline-versions__note" data-v-cdcb1722> Il piano non cambia rispetto alla v2. </p></div></article><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v2</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-05 · ETL-85, ETL-87, ETL-88</span><!----></header><!----><!--[--><!--[--><!----><!--]--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Modifiche</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Contratto del fatto e riepilogo per tier passano nella sub-pipeline `riepilogo-ordini`, istanziata da un nodo `pipeline` (ADR-0079): `fact-contract`, `tier-summary` e `tier-summary-contract` lasciano il posto ai nodi dell'istanza, e i due sink leggono dalle sue uscite `fatti` e `per-tier`</li><li data-v-cdcb1722>Un ordine con importo non positivo è rifiutato al confine d'ingresso dell'istanza invece che da `fact-contract`; il `guard` lo cattura e lo instrada sul ramo `catch` come prima</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><!--[--><p class="pipeline-versions__note" data-v-cdcb1722> Il piano rispetto alla v1: </p><dl data-v-cdcb1722><!----><!--[--><!--[--><dt data-v-cdcb1722>Nodi <!----></dt><dd data-v-cdcb1722><ul data-v-cdcb1722><!--[--><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini</code><span data-v-cdcb1722>transform</span></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini/tier-summary</code><span data-v-cdcb1722>transform</span></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini/per-tier</code><span data-v-cdcb1722>transform</span></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini/fatti</code><span data-v-cdcb1722>transform</span></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>fact-contract</code><span data-v-cdcb1722>transform</span></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>tier-summary</code><span data-v-cdcb1722>transform</span></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>tier-summary-contract</code><span data-v-cdcb1722>transform</span></li><!--]--></ul></dd><!--]--><!--[--><dt data-v-cdcb1722>Archi <!----></dt><dd data-v-cdcb1722><ul data-v-cdcb1722><!--[--><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>guard → riepilogo-ordini</code><span data-v-cdcb1722>porta out</span></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini/fatti → enriched_orders</code><!----></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini/per-tier → tier_summary</code><!----></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini → riepilogo-ordini/tier-summary</code><!----></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini/tier-summary → riepilogo-ordini/per-tier</code><!----></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini → riepilogo-ordini/fatti</code><!----></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>guard → fact-contract</code><span data-v-cdcb1722>porta out</span></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>fact-contract → enriched_orders</code><!----></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>fact-contract → tier-summary</code><!----></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>tier-summary → tier-summary-contract</code><!----></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>tier-summary-contract → tier_summary</code><!----></li><!--]--></ul></dd><!--]--><!--]--></dl><!--]--></div></article><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v1</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-05 · ETL-120</span><!----></header><!----><!--[--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Aggiunte</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Versione iniziale sotto versionamento (ADR-0086)</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><p class="pipeline-versions__note" data-v-cdcb1722> Prima versione: non c'è una versione precedente da confrontare. </p></div></article><!--]--></div></div></div></main><footer class="VPDocFooter" data-v-303c7d43 data-v-64d0b887><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-64d0b887><span class="visually-hidden" id="doc-footer-aria-label" data-v-64d0b887>Pager</span><div class="pager" data-v-64d0b887><a class="VPLink link pager-link prev" href="/guida/core/pipelines/movimenti-per-conto" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina precedente</span><span class="title" data-v-64d0b887>movimenti-per-conto</span><!--]--></a></div><div class="pager" data-v-64d0b887><a class="VPLink link pager-link next" href="/guida/core/sub-pipelines/riepilogo-ordini" data-v-64d0b887><!--[--><span class="desc" data-v-64d0b887>Pagina successiva</span><span class="title" data-v-64d0b887>riepilogo-ordini</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-f5dee57d data-v-e10de3dd><div class="container" data-v-e10de3dd><p class="message" data-v-e10de3dd>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-e10de3dd>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
|
|
65
|
-
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"
|
|
64
|
+
</title><rect class="dag-node__halo" x="496" y="102" width="198" height="74" rx="12" data-v-340130bc></rect><!----><rect class="dag-node__card" x="500" y="106" width="190" height="66" rx="9" data-v-340130bc></rect><rect class="dag-node__accent" x="500" y="112" width="3" height="54" rx="1.5" data-v-340130bc></rect><text class="dag-node__label" x="512" y="125" data-v-340130bc>orders_dead_letter</text><text class="dag-node__kind" x="680" y="125" text-anchor="end" data-v-340130bc>dead-letter</text><!--[--><text class="dag-node__sub" x="512" y="141" data-v-340130bc>memory</text><!--]--><!--[--><!--]--></g><!--]--><!--[--><!--]--></svg><!--[--><!--]--><!----></div><!----><figcaption class="graph-demo__footer" data-v-fc9b2f46><span class="graph-demo__progress" aria-hidden="true" data-v-fc9b2f46><span style="width:0%;" data-v-fc9b2f46></span></span><span class="graph-demo__caption" aria-live="polite" data-v-fc9b2f46><!--[--> Scegli una scena e premi ▶ per guardarla scorrere, oppure → per andare avanti un passo alla volta. <!--]--></span></figcaption></figure><figure class="level-nav__purposes" data-v-c981a055><figcaption id="level-nav-purposes-v-0" class="level-nav__purposes-title" data-v-c981a055> Lo scopo dei nodi </figcaption><table aria-labelledby="level-nav-purposes-v-0" data-v-c981a055><thead data-v-c981a055><tr data-v-c981a055><th scope="col" data-v-c981a055>Nodo</th><th scope="col" data-v-c981a055>Tipo</th><th scope="col" data-v-c981a055>Scopo</th></tr></thead><tbody data-v-c981a055><!--[--><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>orders</code></td><td data-v-c981a055><code data-v-c981a055>source</code></td><td data-v-c981a055>Legge gli ordini di prova della dimostrazione, ognuno con il cliente che l'ha fatto, l'importo e la data.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>customers</code></td><td data-v-c981a055><code data-v-c981a055>source</code></td><td data-v-c981a055>Legge l'anagrafica di prova dei clienti, con il nome e la fascia di ciascuno, che servono a completare gli ordini.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>validate-orders</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Controlla che ogni ordine abbia cliente, importo e data validi. Un ordine fuori regola viene messo da parte fra gli scarti, e gli altri proseguono.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>validate-customers</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Controlla che ogni cliente abbia un nome e una fascia ammessa. Un cliente fuori regola ferma la run: gli ordini completati con un'anagrafica sbagliata sarebbero sbagliati anche loro.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>enrich</code></td><td data-v-c981a055><code data-v-c981a055>join</code></td><td data-v-c981a055>Completa ogni ordine con il nome e la fascia del suo cliente. Un ordine il cui cliente non è in anagrafica prosegue lo stesso, senza nome né fascia.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>guard</code></td><td data-v-c981a055><code data-v-c981a055>try-catch</code></td><td data-v-c981a055>Protegge, ordine per ordine, il riepilogo e il salvataggio: un ordine rifiutato più avanti, come quello con un importo non positivo, finisce fra gli errori e la run prosegue con gli altri.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>riepilogo-ordini</code></td><td data-v-c981a055><code data-v-c981a055>pipeline</code></td><td data-v-c981a055>Prepara i due risultati della giornata a partire dagli ordini completati: gli ordini controllati, pronti da salvare, e il riepilogo per fascia cliente.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>enriched_orders</code></td><td data-v-c981a055><code data-v-c981a055>sink</code></td><td data-v-c981a055>Salva gli ordini della giornata completati con i dati del cliente, uno per ordine: è il dettaglio su cui si appoggia ogni analisi.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>tier_summary</code></td><td data-v-c981a055><code data-v-c981a055>sink</code></td><td data-v-c981a055>Salva il riepilogo della giornata per fascia cliente, con quanti ordini e quale importo totale per ciascuna.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>log-errors</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Registra nel log ogni ordine finito fra gli errori, con il passo in cui l'errore è nato e il motivo, così si capisce che cosa è andato storto.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>caught_errors</code></td><td data-v-c981a055><code data-v-c981a055>sink</code></td><td data-v-c981a055>Conserva gli errori registrati, ognuno con l'ordine che l'ha causato, per poterli esaminare dopo la run.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>recover-orders</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Fra gli errori, tiene solo gli ordini che non si sono potuti salvare: sono gli unici da recuperare. Gli altri errori restano solo nel log.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>restore-order</code></td><td data-v-c981a055><code data-v-c981a055>transform</code></td><td data-v-c981a055>Riprende l'ordine com'era prima del salvataggio non riuscito, per poterlo salvare altrove.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>orders-fallback</code></td><td data-v-c981a055><code data-v-c981a055>sink</code></td><td data-v-c981a055>Salva in un archivio di riserva gli ordini che non si sono potuti salvare al loro posto, così nessun ordine va perso.</td></tr><tr data-v-c981a055><td data-v-c981a055><code data-v-c981a055>orders_dead_letter</code></td><td data-v-c981a055><code data-v-c981a055>dead-letter</code></td><td data-v-c981a055>Raccoglie i record scartati dai nodi di questa pipeline, ognuno con il motivo dello scarto.</td></tr><!--]--></tbody></table></figure></div><blockquote><p>Il grafo qui sopra è disegnato dalla topologia reale della pipeline (<code>getSpec()</code>): nodi, archi, dead-letter e ramo catch sono quelli eseguiti. Premi ▶ per far passare un record, o → per avanzare un passo alla volta.</p></blockquote><p>Due sorgenti indipendenti confluiscono in un <strong>join a chiave</strong> (<code>enrich</code>), il cui output entra nell'istanza <code>riepilogo-ordini</code> della sub-pipeline omonima. Il suo confine d'ingresso valida l'ordine arricchito e fa <strong>fan-out</strong> sulle due uscite dell'istanza, due rami che non si influenzano a vicenda, salvo un errore fatale, che ferma la run: il fatto arricchito (<code>riepilogo-ordini</code> → <code>riepilogo-ordini/fatti</code> → <code>enriched_orders</code>) e un riepilogo aggregato per tier cliente (<code>riepilogo-ordini</code> → <code>riepilogo-ordini/tier-summary</code> → <code>riepilogo-ordini/per-tier</code> → <code>tier_summary</code>).</p><p>Il riepilogo è una <a href="./../sub-pipelines/riepilogo-ordini">sub-pipeline</a> istanziata col nodo <a href="./../nodes/pipeline"><code>pipeline</code></a>: alla costruzione si appiattisce nei suoi nodi, con gli id qualificati. Il grafo qui sopra mostra l'istanza come un nodo chiuso, in cui si entra col doppio click o da «Entra» (il link <code>?istanza=riepilogo-ordini</code> apre la scheda già dentro); il report mostra i nodi interni con l'id qualificato. La root cabla le due uscite con <code>fromPort: "fatti"</code> e <code>fromPort: "per-tier"</code>.</p><p>Codice: <code>src/pipelines/orders-enriched-daily/</code> · DSL a grafo: <code>src/core/graph-builder.ts</code>.</p><h2 id="sorgenti" tabindex="-1">Sorgenti <a class="header-anchor" href="#sorgenti" aria-label="Permalink to "Sorgenti""></a></h2><table tabindex="0"><thead><tr><th>Sistema</th><th>Schema/tabella</th><th>Chiave naturale</th><th>Modalità</th></tr></thead><tbody><tr><td>In-memory (demo)</td><td>ordini grezzi (<code>orders</code>)</td><td><code>order_id</code></td><td>full (dataset fisso in <code>run.ts</code>)</td></tr><tr><td>In-memory (demo)</td><td>anagrafica clienti (<code>customers</code>)</td><td><code>customer_id</code></td><td>full (dataset fisso in <code>run.ts</code>)</td></tr></tbody></table><h2 id="sink" tabindex="-1">Sink <a class="header-anchor" href="#sink" aria-label="Permalink to "Sink""></a></h2><table tabindex="0"><thead><tr><th>Sistema</th><th>Destinazione</th><th>Idempotenza</th></tr></thead><tbody><tr><td>In-memory (demo)</td><td><code>enriched_orders</code></td><td>n/a (demo — in un caso reale: upsert su <code>order_id</code>)</td></tr><tr><td>In-memory (demo)</td><td><code>tier_summary</code></td><td>n/a (demo — in un caso reale: upsert su <code>tier</code>)</td></tr><tr><td>In-memory (demo)</td><td><code>caught_errors</code></td><td>n/a (demo) — ramo <code>catch</code> del <code>guard</code> (<code>log-errors</code>): gli errori catturati, col loro <code>raw</code></td></tr><tr><td>In-memory (demo)</td><td><code>orders-fallback</code></td><td>n/a (demo) — ramo <code>catch</code>: gli ordini che <code>enriched_orders</code> ha rifiutato (<code>recover-orders</code> → <code>restore-order</code>)</td></tr><tr><td>In-memory (demo)</td><td><code>orders_dead_letter</code></td><td>n/a (demo) — dead-letter di <code>validate-orders</code>, opzionale</td></tr></tbody></table><h2 id="trasformazioni-e-regole-di-business" tabindex="-1">Trasformazioni e regole di business <a class="header-anchor" href="#trasformazioni-e-regole-di-business" aria-label="Permalink to "Trasformazioni e regole di business""></a></h2><p>Lo scopo di ogni nodo è nella tabella sotto il grafo, presa dal piano. Qui le regole che i nodi applicano.</p><ul><li><p><strong><code>validate-orders</code></strong> (contratto <code>raw-order-contract</code>) — valida l'ordine grezzo (<code>rawOrderSchema</code>): id non vuoti, <code>amount</code> numerico, <code>created_at</code> coercibile a data. Isolato su dead-letter <strong>per nodo</strong> (<code>ordersDeadLetter</code>, opzionale).</p></li><li><p><strong><code>validate-customers</code></strong> (contratto <code>raw-customer-contract</code>) — valida il cliente grezzo (<code>rawCustomerSchema</code>): id/nome non vuoti, <code>tier</code> in <code>gold|silver|bronze</code>.</p></li><li><p><strong><code>enrich</code></strong> — <code>hashJoin</code> a chiave (<code>build</code> = clienti in memoria, <code>probe</code> = ordini in streaming, <strong>pompato in concorrenza</strong> mentre la tabella di build si materializza), <code>how: "left"</code>: un ordine senza cliente noto sopravvive con <code>customer_name</code>/<code>tier</code> a <code>null</code>. Non solleva errori (il join si limita ad arricchire); entrambe le sorgenti validate vi confluiscono simmetricamente.</p></li><li><p><strong><code>guard</code></strong> — nodo <strong>try/catch</strong> subito <strong>dopo</strong> <code>enrich</code>: nel suo scope stanno l'istanza <code>riepilogo-ordini</code> e i sink a valle.</p></li><li><p><strong><code>riepilogo-ordini</code></strong> — istanza della sub-pipeline <a href="./../sub-pipelines/riepilogo-ordini"><code>riepilogo-ordini</code></a>, alimentata dal <code>guard</code>. Usa il parametro <code>tierMancante</code> al default, <code>"unknown"</code>, quindi si istanzia senza parametri; il piano lo mostra risolto in <code>instances[].params</code>. Appiattita, diventa quattro nodi:</p><ul><li><strong><code>riepilogo-ordini</code></strong>, il confine d'ingresso, che valida l'ordine arricchito (<code>enrichedOrderSchema</code>, <code>amount</code> <strong>positivo</strong>) e fa da gate/fan-out verso le due uscite. Era il nodo <code>fact-contract</code> della root, che l'istanza ha assorbito: il contratto del fatto non si ripete più a monte dell'istanza. <code>riepilogo-ordini:extracted</code> conta gli ordini entrati nell'istanza. Un ordine con <code>amount <= 0</code> passa il join ma viene qui respinto (<code>ValidationError</code>); essendo a valle del <code>guard</code>, l'errore è <strong>catturato dal <code>guard</code></strong> e instradato sul ramo <code>catch</code> (<code>log-errors</code> → <code>caught_errors</code>) invece di abortire. Il guard è <strong>per-record</strong>: <strong>tutti</strong> gli ordini con <code>amount <= 0</code> finiscono nel <code>catch</code> (col loro <code>raw</code>) e i validi continuano a essere caricati;</li><li><strong><code>riepilogo-ordini/fatti</code></strong>, il confine dell'uscita <code>fatti</code>, alimentato direttamente dall'ingresso, verso <code>enriched_orders</code>;</li><li><strong><code>riepilogo-ordini/tier-summary</code></strong>, <code>groupBy</code> <strong>stateful</strong> per tier cliente (<code>order_count</code>, <code>total_amount</code>, gli ordini senza cliente noto sotto il valore di <code>tierMancante</code>, <code>unknown</code>); come ogni aggregazione, è fail-fast (nessun dead-letter per-record: l'aggregazione bufferizza l'intero stream). Essendo stateful non viene mai isolato per-record, quindi un suo errore arriva al <code>catch</code> con <code>raw: undefined</code>; porta però <code>lastConsumed</code>, l'ultimo ordine consumato dal nodo — esatto se l'errore emerge durante il consumo dello stream, assente se emerge in fase di emissione. L'aggregazione di questa demo non ha punti in cui sollevare, quindi il caso è coperto dai test del core e non dalla demo;</li><li><strong><code>riepilogo-ordini/per-tier</code></strong>, il confine dell'uscita <code>per-tier</code>, che rivalida il riepilogo (<code>tierSummarySchema</code>) prima del sink. Era il nodo <code>tier-summary-contract</code>.</li></ul><p>Il <code>guard</code> sta a monte dell'istanza, quindi la copre per intero: un errore nato in uno di questi quattro nodi arriva al suo ramo <code>catch</code> col proprio id qualificato in <code>error.context.nodeId</code>.</p><p>Il caso dell'errore <strong>in emissione</strong> (e quello di un nodo a valle dell'aggregazione, dove <code>raw</code> è l'aggregato e non gli ordini) è coperto dalla lineage dei record: attivando <code>recordIds: true</code> sul grafo e <code>guardSnapshots: true</code> sul guard, il <code>catch</code> riceve <code>guardSnapshots</code> con gli <strong>ordini originali</strong> del gruppo colpevole. Questa pipeline <strong>non</strong> li attiva, per lo stesso motivo per cui il caso non è dimostrato qui: manca un punto di fallimento realistico nell'aggregazione, e gli snapshot terrebbero payload in memoria senza che serva a nulla.</p></li><li><p><strong><code>recover-orders</code> / <code>restore-order</code></strong> — <strong>path di fallback</strong> sul ramo <code>catch</code>. Il sink <code>enriched_orders</code> sta dentro lo scope del <code>guard</code>: se implementa <code>loadOne</code> è <strong>isolabile per-record</strong>, quindi un fallimento di scrittura non aborta la run ma finisce sul ramo <code>catch</code> <strong>portando con sé l'ordine</strong> (<code>DeadLetter.raw</code>). <code>recover-orders</code> filtra i soli errori provenienti da quel sink, <code>restore-order</code> ne estrae il payload e lo carica sul sink <code>orders-fallback</code>. Gli altri errori catturati (contratto, aggregazione, sink opachi) non hanno un ordine da recuperare e sono filtrati via.</p></li></ul><h2 id="contratti-schema-zod" tabindex="-1">Contratti (schema Zod) <a class="header-anchor" href="#contratti-schema-zod" aria-label="Permalink to "Contratti (schema Zod)""></a></h2><p>Definiti in <code>schema.ts</code>:</p><ul><li>Input: <code>rawOrderSchema</code>, <code>rawCustomerSchema</code>.</li><li>Intermedio/output: <code>enrichedOrderSchema</code> (fatto arricchito), <code>tierSummarySchema</code> (riepilogo per tier). Sono i contratti d'ingresso e d'uscita della sub-pipeline <code>riepilogo-ordini</code>: si definiscono in <code>src/sub-pipelines/riepilogo-ordini/schema.ts</code> e <code>schema.ts</code> li riesporta.</li></ul><p><strong>Colonne nel piano (<code>getSpec</code>)</strong>: da questi contratti l'introspezione Zod ricava le <code>columns</code> dei nodi mostrate nella UI del DAG. I nodi <code>validate()</code> (<code>validate-orders</code>, <code>validate-customers</code>) e i confini dell'istanza (<code>riepilogo-ordini</code>, <code>riepilogo-ordini/fatti</code>, <code>riepilogo-ordini/per-tier</code>) espongono le colonne del proprio schema; i sink (<code>enriched_orders</code>, <code>tier_summary</code>) le <strong>ereditano</strong> dal contratto a monte per propagazione. Il join <code>enrich</code> (predecessori discordi) e le source in-memory restano senza colonne. Il <code>groupBy</code> <code>riepilogo-ordini/tier-summary</code> dichiara <code>tierSummarySchema</code> come <code>outputSchema</code>, quindi mostra l'aggregato e non gli ordini che riceve. Il ramo <code>catch</code> non eredita (porta <code>DeadLetter</code>): <code>log-errors</code>, <code>caught_errors</code> e <code>recover-orders</code> restano senza colonne, finché <code>restore-order</code> riporta il record a un ordine e lo dichiara con <code>enrichedOrderSchema</code>. Vedi <code>columnsFromZodObject</code> e <code>toPlanSpec</code> in <code>src/core/</code>.</p><h2 id="parametri-ed-env" tabindex="-1">Parametri ed env <a class="header-anchor" href="#parametri-ed-env" aria-label="Permalink to "Parametri ed env""></a></h2><ul><li><code>ctx.params</code>: nessuno (dataset demo fisso in <code>run.ts</code>).</li><li>Variabili d'ambiente: nessuna — pipeline interamente in-memory, non richiede <code>.env.example</code>. <blockquote><p><strong>Nota storica.</strong> In passato questa pipeline aveva un'opzione <code>stepDelayMs</code> che inseriva un ritardo artificiale nel <code>writeReport</code> di ogni nodo, per rendere osservabile l'avanzamento in UI. Era una pezza a un buco nell'osservabilità: il runner notificava solo <code>onNodeComplete</code>, quindi la UI non aveva modo di sapere quali nodi stessero girando e senza ritardo la run finiva entro un singolo intervallo di polling. Con <code>onNodeStart</code> il segnale c'è davvero, e il ritardo — che stava <strong>nel percorso dati</strong> e bloccava anche il downstream — è stato rimosso.</p></blockquote></li></ul><h2 id="gestione-errori" tabindex="-1">Gestione errori <a class="header-anchor" href="#gestione-errori" aria-label="Permalink to "Gestione errori""></a></h2><ul><li><strong>Dead-letter per nodo</strong> (scelta di design del DSL a grafo): <code>validate-orders</code> ha il proprio sink di dead-letter (<code>ordersDeadLetter</code>, opzionale) che isola gli ordini grezzi non conformi <strong>record-by-record</strong>, continuando con i record buoni.</li><li><strong>Try/catch (per-record)</strong>: il nodo <code>guard</code> (dopo <code>enrich</code>) protegge l'istanza <code>riepilogo-ordini</code> e i nodi a valle. <strong>Ogni</strong> record che solleva un <code>EtlError</code> in un nodo protetto a valle del guard è deviato sul ramo <code>catch</code> (<code>errorLog</code>, opzionale; default: sink interno in memoria) come envelope <code>DeadLetter { raw, error }</code>, dopo essere stato loggato da <code>log-errors</code>, e lo stream <strong>continua</strong> (N record → N nel <code>catch</code>). La run <strong>non</strong> abortisce; lo stato diventa <code>partial</code>. Il comportamento "fermati al primo errore" è opt-in via <code>.tryCatch(..., { mode: "circuit-breaker" })</code>. Le transform <strong>stateful</strong> (es. <code>riepilogo-ordini/tier-summary</code>, un group-by) restano streaming, mai isolate.</li><li><strong>Errori a monte del guard</strong>: il guard cattura solo gli errori nati a valle di sé. Un cliente non conforme in <code>validate-customers</code> (senza dead-letter) o un errore del <code>join</code><code>enrich</code> fanno abortire la run, anche se l'errore attraversa l'istanza <code>riepilogo-ordini</code>.</li><li><strong><code>riepilogo-ordini/tier-summary</code></strong> resta fail-fast: essendo stateful, un errore qui aborta l'intera run (come ogni aggregazione).</li><li>Il <code>RunReport</code> (<code>GraphRunReport</code>) espone <code>status: "partial"</code> quando almeno un nodo ha scarti (<code>rejected</code>) o il try/catch ha catturato errori (<code>caught</code>), con <code>nodes[].rejected</code>/<code>rejectedReasons</code> e <code>nodes[].caught</code> per nodo — mai il payload del record (quello vive solo nel dead-letter/errorLog sink).</li><li><strong>Visibile nella DAG</strong>: <code>getSpec()</code> collega sia il dead-letter sia il ramo catch nella topologia statica, così la UI mostra i <strong>branch d'errore</strong> — da <code>validate-orders</code> verso <code>orders_dead_letter</code> (reject di schema, <code>stepType: "dead-letter"</code>) e dal nodo <code>guard</code> (<code>stepType: "try-catch"</code>) verso <code>log-errors</code> (<code>kind: "catch"</code>) — con edge tratteggiato destructive.</li></ul><h2 id="test" tabindex="-1">Test <a class="header-anchor" href="#test" aria-label="Permalink to "Test""></a></h2><ul><li>Unit pipeline: <code>pipeline.test.ts</code> — join <code>left</code>, fan-out su entrambi i sink, dead-letter per-record su <code>validate-orders</code>, cattura via <strong>try/catch</strong> dell'importo non positivo respinto dal confine d'ingresso <code>riepilogo-ordini</code>, instradato sul ramo catch, forma della topologia reale (<code>nodes</code>/<code>edges</code>, incl. <code>guard</code>, ramo catch e nodi dell'istanza <code>riepilogo-ordini</code>) nel report, riepilogo il cui totale trabocca rifiutato da <code>riepilogo-ordini/per-tier</code> e catturato dal <code>guard</code>.</li><li>Sub-pipeline: <code>sub-pipeline.test.ts</code> prova <code>riepilogo-ordini</code> da sola con <code>runSubPipeline</code>.</li><li>Esecuzione manuale: <code>pnpm run etl run orders-enriched-daily</code> stampa il <code>GraphRunReport</code> completo su stdout (vedi <a href="./../conventions/run-report"><code>docs/conventions/run-report.md</code></a>).</li></ul><h2 id="versioni" tabindex="-1">Versioni <a class="header-anchor" href="#versioni" aria-label="Permalink to "Versioni""></a></h2><p>La storia della pipeline, dalla versione più recente: la voce di changelog di ogni versione (<code>src/pipelines/orders-enriched-daily/changelog.ts</code>) e, sotto, cosa è cambiato nel piano rispetto alla precedente. Vedi <a href="./../conventions/versioni-di-pipeline">versioni di pipeline</a>.</p><div class="pipeline-versions" data-v-cdcb1722><!--[--><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v3</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-09 · ETL-193, ETL-195</span><!----></header><!----><!--[--><!--[--><!----><!--]--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Modifiche</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Nessun cambio di comportamento: il piano è identico alla v2. Gli import seguono l'infrastruttura (changelog, configurazione delle istanze, report di volume) uscita da `src/pipelines/` (ADR-0093 §1), e la pipeline si dichiara nel catalogo di `etl.config.ts` invece che in un registro (ADR-0093 §2)</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><p class="pipeline-versions__note" data-v-cdcb1722> Il piano non cambia rispetto alla v2. </p></div></article><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v2</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-05 · ETL-85, ETL-87, ETL-88</span><!----></header><!----><!--[--><!--[--><!----><!--]--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Modifiche</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Contratto del fatto e riepilogo per tier passano nella sub-pipeline `riepilogo-ordini`, istanziata da un nodo `pipeline` (ADR-0079): `fact-contract`, `tier-summary` e `tier-summary-contract` lasciano il posto ai nodi dell'istanza, e i due sink leggono dalle sue uscite `fatti` e `per-tier`</li><li data-v-cdcb1722>Un ordine con importo non positivo è rifiutato al confine d'ingresso dell'istanza invece che da `fact-contract`; il `guard` lo cattura e lo instrada sul ramo `catch` come prima</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><!--[--><p class="pipeline-versions__note" data-v-cdcb1722> Il piano rispetto alla v1: </p><dl data-v-cdcb1722><!----><!--[--><!--[--><dt data-v-cdcb1722>Nodi <!----></dt><dd data-v-cdcb1722><ul data-v-cdcb1722><!--[--><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini</code><span data-v-cdcb1722>transform</span></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini/tier-summary</code><span data-v-cdcb1722>transform</span></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini/per-tier</code><span data-v-cdcb1722>transform</span></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini/fatti</code><span data-v-cdcb1722>transform</span></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>fact-contract</code><span data-v-cdcb1722>transform</span></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>tier-summary</code><span data-v-cdcb1722>transform</span></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>tier-summary-contract</code><span data-v-cdcb1722>transform</span></li><!--]--></ul></dd><!--]--><!--[--><dt data-v-cdcb1722>Archi <!----></dt><dd data-v-cdcb1722><ul data-v-cdcb1722><!--[--><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>guard → riepilogo-ordini</code><span data-v-cdcb1722>porta out</span></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini/fatti → enriched_orders</code><!----></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini/per-tier → tier_summary</code><!----></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini → riepilogo-ordini/tier-summary</code><!----></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini/tier-summary → riepilogo-ordini/per-tier</code><!----></li><li class="is-added" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>+</span><code data-v-cdcb1722>riepilogo-ordini → riepilogo-ordini/fatti</code><!----></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>guard → fact-contract</code><span data-v-cdcb1722>porta out</span></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>fact-contract → enriched_orders</code><!----></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>fact-contract → tier-summary</code><!----></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>tier-summary → tier-summary-contract</code><!----></li><li class="is-removed" data-v-cdcb1722><span class="pipeline-versions__sign" data-v-cdcb1722>−</span><code data-v-cdcb1722>tier-summary-contract → tier_summary</code><!----></li><!--]--></ul></dd><!--]--><!--]--></dl><!--]--></div></article><article class="pipeline-versions__entry" data-v-cdcb1722><header class="pipeline-versions__header" data-v-cdcb1722><strong class="pipeline-versions__number" data-v-cdcb1722>v1</strong><span class="pipeline-versions__meta" data-v-cdcb1722>2026-10-05 · ETL-120</span><!----></header><!----><!--[--><!--[--><div class="pipeline-versions__list" data-v-cdcb1722><span class="pipeline-versions__list-title" data-v-cdcb1722>Aggiunte</span><ul data-v-cdcb1722><!--[--><li data-v-cdcb1722>Versione iniziale sotto versionamento (ADR-0086)</li><!--]--></ul></div><!--]--><!--[--><!----><!--]--><!--[--><!----><!--]--><!--]--><div class="pipeline-versions__diff" data-v-cdcb1722><p class="pipeline-versions__note" data-v-cdcb1722> Prima versione: non c'è una versione precedente da confrontare. </p></div></article><!--]--></div></div></div></main><footer class="VPDocFooter" data-v-4f20312f data-v-0be8676d><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-0be8676d><span class="visually-hidden" id="doc-footer-aria-label" data-v-0be8676d>Pager</span><div class="pager" data-v-0be8676d><a class="VPLink link pager-link prev" href="/guida/core/pipelines/movimenti-per-conto" data-v-0be8676d><!--[--><span class="desc" data-v-0be8676d>Pagina precedente</span><span class="title" data-v-0be8676d>movimenti-per-conto</span><!--]--></a></div><div class="pager" data-v-0be8676d><a class="VPLink link pager-link next" href="/guida/core/sub-pipelines/riepilogo-ordini" data-v-0be8676d><!--[--><span class="desc" data-v-0be8676d>Pagina successiva</span><span class="title" data-v-0be8676d>riepilogo-ordini</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-22f0e4eb data-v-331f077b><div class="container" data-v-331f077b><p class="message" data-v-331f077b>Noeva è un marchio registrato di 4D S.R.L.</p><p class="copyright" data-v-331f077b>© 2026 4D S.R.L. · Gruppo4D</p></div></footer><!--[--><span hidden></span><!--]--></div></div>
|
|
65
|
+
<script>window.__VP_HASH_MAP__=JSON.parse("{\"connectors_file.md\":\"B1NJe0VJ\",\"connectors_http.md\":\"B8utPijY\",\"connectors_imap.md\":\"CMMpZVXn\",\"connectors_jira.md\":\"0DJvrRXH\",\"connectors_noeva.md\":\"DkxCC8Ey\",\"connectors_oauth.md\":\"BeotXAWb\",\"connectors_postgres.md\":\"DPpHqXkc\",\"connectors_process.md\":\"lQLmWbGN\",\"connectors_readme.md\":\"BqI2RLCu\",\"connectors_sendgrid.md\":\"dJzIWepq\",\"connectors_smtp.md\":\"DXXvaNxD\",\"connectors_sqlserver.md\":\"D1sYNLEq\",\"connectors_zoho.md\":\"BfEzRNZk\",\"conventions_node-columns.md\":\"D9K1peUx\",\"conventions_node-descriptor.md\":\"MQaGlm8a\",\"conventions_run-report.md\":\"D_pG07VG\",\"conventions_run-trace.md\":\"nKS_RgLC\",\"conventions_variabili-del-core.md\":\"BU6BD6w_\",\"conventions_versioni-di-pipeline.md\":\"cy5nsizS\",\"guida_sviluppo.md\":\"CrN52ZDN\",\"guide_claude-code_index.md\":\"DEnzf9b_\",\"guide_claude-code_prompt.md\":\"C7uETA9W\",\"guide_claude-code_strumenti.md\":\"BWhQnAlY\",\"guide_grafo.md\":\"Dy8_YMeh\",\"guide_usare_app-desktop.md\":\"CcDu8cJL\",\"guide_usare_esito-di-una-run.md\":\"DkvAOPBE\",\"guide_usare_index.md\":\"BJqi3P7J\",\"index.md\":\"kMhsF-sv\",\"nodes_action.md\":\"DOsTbV-i\",\"nodes_ai.md\":\"CVtP9gEJ\",\"nodes_join.md\":\"DSYbIDG6\",\"nodes_lookup.md\":\"BI8tgBIq\",\"nodes_pipeline.md\":\"DIMlyprm\",\"nodes_readme.md\":\"CHGy_go6\",\"nodes_route.md\":\"Bt9qH6OA\",\"nodes_sink.md\":\"yAf_z4wO\",\"nodes_source.md\":\"DP2i3GFv\",\"nodes_task.md\":\"Dk6VB7as\",\"nodes_transform.md\":\"Bv5fg2Xx\",\"nodes_try-catch.md\":\"DCYydDPm\",\"nodes_union.md\":\"CznVzHTK\",\"pipelines_crm-leads-sync.md\":\"BlZUnxYn\",\"pipelines_cross-workspace-csv-merge.md\":\"CsRE6GNe\",\"pipelines_movimenti-per-conto.md\":\"DRGfO1_5\",\"pipelines_orders-enriched-daily.md\":\"jESRtvBo\",\"pipelines_readme.md\":\"Ee6LS-SU\",\"pipelines_test-posta.md\":\"Cxo_DGBs\",\"runbooks_aggiornamento-pm2.md\":\"DrFr4blI\",\"runbooks_deploy-ecr.md\":\"4jQypInn\",\"runbooks_deployment.md\":\"CwG77qGO\",\"runbooks_etl-worker.md\":\"Bu05cEgT\",\"runbooks_graph-server.md\":\"opGHnuzK\",\"runbooks_mask-key.md\":\"nZkhAjBf\",\"runbooks_oauth-google-posta.md\":\"Bs7QTkmU\",\"runbooks_rollback-di-pipeline.md\":\"6US0Wsdc\",\"runbooks_scd2-rehash.md\":\"DtmuXA67\",\"runbooks_sql-task-truncate-swap.md\":\"C8viT-fp\",\"runbooks_stato-incrementale.md\":\"hGZ8FlbZ\",\"sub-pipelines_readme.md\":\"CF8gmNPU\",\"sub-pipelines_riepilogo-ordini.md\":\"qCBZJ4nh\",\"technical_overview.md\":\"DTIhkkg9\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"it-IT\",\"dir\":\"ltr\",\"title\":\"Noeva ETL\",\"titleTemplate\":\":title · Noeva ETL\",\"description\":\"Documentazione di Noeva ETL: come usare la piattaforma e come creare pipeline con Claude Code.\",\"base\":\"/guida/core/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"light\":\"/logo-dark.png\",\"dark\":\"/logo-light.png\",\"alt\":\"Noeva\"},\"siteTitle\":false,\"footer\":{\"message\":\"Noeva è un marchio registrato di 4D S.R.L.\",\"copyright\":\"© 2026 4D S.R.L. · Gruppo4D\"},\"outline\":{\"level\":[2,3],\"label\":\"In questa pagina\"},\"docFooter\":{\"prev\":\"Pagina precedente\",\"next\":\"Pagina successiva\"},\"darkModeSwitchLabel\":\"Tema\",\"lightModeSwitchTitle\":\"Passa al tema chiaro\",\"darkModeSwitchTitle\":\"Passa al tema scuro\",\"sidebarMenuLabel\":\"Menu\",\"returnToTopLabel\":\"Torna su\",\"langMenuLabel\":\"Lingua\",\"notFound\":{\"title\":\"PAGINA NON TROVATA\",\"quote\":\"Il documento che cercavi non c'è più, o non è mai stato pubblicato qui.\",\"linkLabel\":\"Torna alla home\",\"linkText\":\"Torna alla home\"},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"Cerca\",\"buttonAriaLabel\":\"Cerca nella documentazione\"},\"modal\":{\"displayDetails\":\"Mostra i dettagli\",\"resetButtonTitle\":\"Azzera la ricerca\",\"backButtonTitle\":\"Chiudi la ricerca\",\"noResultsText\":\"Nessun risultato per\",\"footer\":{\"selectText\":\"per aprire\",\"selectKeyAriaLabel\":\"invio\",\"navigateText\":\"per spostarti\",\"navigateUpKeyAriaLabel\":\"freccia su\",\"navigateDownKeyAriaLabel\":\"freccia giù\",\"closeText\":\"per chiudere\",\"closeKeyAriaLabel\":\"esc\"}}}}},\"nav\":[{\"text\":\"Usare\",\"link\":\"/guide/usare/\",\"activeMatch\":\"^/guide/usare/\"},{\"text\":\"Creare con Claude Code\",\"link\":\"/guide/claude-code/\",\"activeMatch\":\"^/guide/claude-code/\"},{\"text\":\"Riferimento\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Tipi di nodo\",\"link\":\"/nodes/README\"},{\"text\":\"Connettori\",\"link\":\"/connectors/README\"},{\"text\":\"Pipeline pronte\",\"link\":\"/pipelines/README\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"},{\"text\":\"Operatività\",\"link\":\"/runbooks/graph-server\"}]}],\"sidebar\":[{\"text\":\"Usare Noeva ETL\",\"items\":[{\"text\":\"Come si usa\",\"link\":\"/guide/usare/\"},{\"text\":\"L'app desktop\",\"link\":\"/guide/usare/app-desktop\"},{\"text\":\"Leggere l'esito di una run\",\"link\":\"/guide/usare/esito-di-una-run\"},{\"text\":\"Panoramica di prodotto\",\"link\":\"/TECHNICAL_OVERVIEW\"}]},{\"text\":\"Creare con Claude Code\",\"items\":[{\"text\":\"Dal bisogno al processo\",\"link\":\"/guide/claude-code/\"},{\"text\":\"Comporre il prompt\",\"link\":\"/guide/claude-code/prompt\"},{\"text\":\"Skill e subagent\",\"link\":\"/guide/claude-code/strumenti\"},{\"text\":\"Guida allo sviluppo\",\"link\":\"/GUIDA_SVILUPPO\"}]},{\"text\":\"Concetti\",\"items\":[{\"text\":\"Il grafo, nodo per nodo\",\"link\":\"/guide/grafo\"},{\"text\":\"Il report di run\",\"link\":\"/conventions/run-report\"},{\"text\":\"La traccia di una run\",\"link\":\"/conventions/run-trace\"},{\"text\":\"Versioni di pipeline\",\"link\":\"/conventions/versioni-di-pipeline\"},{\"text\":\"Descriptor dei nodi\",\"link\":\"/conventions/node-descriptor\"},{\"text\":\"Colonne dei nodi\",\"link\":\"/conventions/node-columns\"},{\"text\":\"Variabili d'ambiente del core\",\"link\":\"/conventions/variabili-del-core\"}]},{\"text\":\"Tipi di nodo\",\"collapsed\":true,\"items\":[{\"text\":\"Cheatsheet\",\"link\":\"/nodes/README\"},{\"text\":\"action\",\"link\":\"/nodes/action\"},{\"text\":\"ai\",\"link\":\"/nodes/ai\"},{\"text\":\"join\",\"link\":\"/nodes/join\"},{\"text\":\"lookup\",\"link\":\"/nodes/lookup\"},{\"text\":\"pipeline\",\"link\":\"/nodes/pipeline\"},{\"text\":\"route\",\"link\":\"/nodes/route\"},{\"text\":\"sink\",\"link\":\"/nodes/sink\"},{\"text\":\"source\",\"link\":\"/nodes/source\"},{\"text\":\"task\",\"link\":\"/nodes/task\"},{\"text\":\"transform\",\"link\":\"/nodes/transform\"},{\"text\":\"try-catch\",\"link\":\"/nodes/try-catch\"},{\"text\":\"union\",\"link\":\"/nodes/union\"}]},{\"text\":\"Connettori\",\"collapsed\":true,\"items\":[{\"text\":\"Panoramica\",\"link\":\"/connectors/README\"},{\"text\":\"File (storage × codec)\",\"link\":\"/connectors/file\"},{\"text\":\"HTTP (API REST per i nodi lookup e action)\",\"link\":\"/connectors/http\"},{\"text\":\"IMAP (caselle di posta)\",\"link\":\"/connectors/imap\"},{\"text\":\"Jira Cloud (issue da una JQL o per chiave, liste di una issue, creazione, aggiornamento, transizioni, upsert, commenti, worklog e link)\",\"link\":\"/connectors/jira\"},{\"text\":\"Noeva (file dei workspace)\",\"link\":\"/connectors/noeva\"},{\"text\":\"OAuth2 per i connettori\",\"link\":\"/connectors/oauth\"},{\"text\":\"PostgreSQL\",\"link\":\"/connectors/postgres\"},{\"text\":\"processo esterno\",\"link\":\"/connectors/process\"},{\"text\":\"SendGrid (mail via API REST)\",\"link\":\"/connectors/sendgrid\"},{\"text\":\"SMTP (notifiche email)\",\"link\":\"/connectors/smtp\"},{\"text\":\"SQL Server\",\"link\":\"/connectors/sqlserver\"},{\"text\":\"Zoho CRM (record di un modulo, con i campi dichiarati)\",\"link\":\"/connectors/zoho\"}]},{\"text\":\"Pipeline pronte\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una pipeline\",\"link\":\"/pipelines/README\"},{\"text\":\"test-posta\",\"link\":\"/pipelines/test-posta\"}]},{\"text\":\"Esempi\",\"collapsed\":true,\"items\":[{\"text\":\"Le schede di una sub-pipeline\",\"link\":\"/sub-pipelines/README\"},{\"text\":\"crm-leads-sync\",\"link\":\"/pipelines/crm-leads-sync\"},{\"text\":\"cross-workspace-csv-merge\",\"link\":\"/pipelines/cross-workspace-csv-merge\"},{\"text\":\"movimenti-per-conto\",\"link\":\"/pipelines/movimenti-per-conto\"},{\"text\":\"orders-enriched-daily\",\"link\":\"/pipelines/orders-enriched-daily\"},{\"text\":\"riepilogo-ordini\",\"link\":\"/sub-pipelines/riepilogo-ordini\"}]},{\"text\":\"Operatività\",\"collapsed\":true,\"items\":[{\"text\":\"aggiornare un deploy PM2 di un repo cliente\",\"link\":\"/runbooks/aggiornamento-pm2\"},{\"text\":\"un cliente su ECR + ECS\",\"link\":\"/runbooks/deploy-ecr\"},{\"text\":\"distribuzione del runner ETL\",\"link\":\"/runbooks/deployment\"},{\"text\":\"worker etl worker (polling su processes)\",\"link\":\"/runbooks/etl-worker\"},{\"text\":\"server grafi etl serve (HTTP)\",\"link\":\"/runbooks/graph-server\"},{\"text\":\"chiavi di mask (creazione, rotazione, compromissione)\",\"link\":\"/runbooks/mask-key\"},{\"text\":\"OAuth2 per una casella Google (IMAP + SMTP)\",\"link\":\"/runbooks/oauth-google-posta\"},{\"text\":\"rollback di una pipeline\",\"link\":\"/runbooks/rollback-di-pipeline\"},{\"text\":\"rehash di una dimensione storicizzata\",\"link\":\"/runbooks/scd2-rehash\"},{\"text\":\"task SQL, truncate e scambio di tabelle\",\"link\":\"/runbooks/sql-task-truncate-swap\"},{\"text\":\"stato di pipeline e watermark\",\"link\":\"/runbooks/stato-incrementale\"}]}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
|
|
66
66
|
|
|
67
67
|
</body>
|
|
68
68
|
</html>
|