# GovOPlaN Dataflow Codex Guide

## Scope

This repository owns canonical pipeline definitions, immutable revisions,
validation, constrained SQL compilation, preview and run diagnostics, and
lineage references.

Keep external connection profiles and credentials in `govoplan-connectors`,
analytical presentation in `govoplan-reporting`, process orchestration in
`govoplan-workflow`, and sanctions review semantics in
`govoplan-risk-compliance`.

## Working Rules

- Never pass user-entered SQL directly to a database.
- Keep previews bounded by rows, bytes, nodes, and execution time.
- Do not persist preview row contents unless a future explicit retention policy
  requires it.
- Optional module integrations use manifest interfaces and capabilities, not
  direct imports.
- Gitea issues are the canonical backlog and implementation state.