Initialize governed Dataflow module

README.md

@@ -0,0 +1,41 @@
+# GovOPlaN Dataflow
+
+GovOPlaN Dataflow defines and runs governed tabular transformation pipelines.
+Power users can work with the same pipeline as a graphical node graph or as a
+constrained SQL query. Every saved change produces an immutable revision, and
+every preview records diagnostics and reproducibility metadata without storing
+the previewed row contents.
+
+## Boundary
+
+- **Dataflow:** pipeline graphs, revisions, validation, constrained SQL,
+  previews/runs, diagnostics, and lineage.
+- **Connectors:** source connections, credentials, discovery, health, and
+  bounded source access.
+- **Reporting:** governed datasets, analytical views, dashboards, and exports.
+- **Workflow:** orchestration, resumability, approvals, and module handoffs.
+- **Risk Compliance:** sanctions matching policy, review, dispositions, and
+  legal evidence.
+
+The first implementation supports bounded inline tabular sources and the
+`filter`, `select`, `aggregate`, `sort`, `limit`, and `output` transforms. The
+connector-backed source contract is tracked separately so credentials never
+become part of a pipeline definition.
+
+## Development
+
+```bash
+/mnt/DATA/git/govoplan/.venv/bin/python -m pip install -e .
+/mnt/DATA/git/govoplan/.venv/bin/python -m unittest discover -s tests
+```
+
+WebUI:
+
+```bash
+cd webui
+PATH=/mnt/DATA/git/govoplan-core/webui/node_modules/.bin:$PATH npm run typecheck
+npm run test:structure
+```
+
+The implementation epic is
+[`govoplan-dataflow#1`](https://git.add-ideas.de/GovOPlaN/govoplan-dataflow/issues/1).