Implement governed tabular source snapshots

README.md

@@ -4,14 +4,32 @@
 **Repository type:** connector (connector-hub).
 <!-- govoplan-repository-type:end -->
 
-`govoplan-connectors` will own integration catalogues and generic external
-system connection patterns for GovOPlaN.
+`govoplan-connectors` owns integration catalogues and generic external system
+connection patterns for GovOPlaN.
 
 The module should make external systems discoverable, testable, and usable
 without taking ownership of their business semantics. Domain-specific modules
 remain responsible for case, file, workflow, payment, mail, identity, document,
 or reporting behavior.
 
+## Executable First Slice
+
+The first executable connector capability provides tenant-isolated tabular
+sources for Dataflow. Operators can import bounded JSON or CSV snapshots,
+inspect inferred schemas, and expose immutable source references and content
+fingerprints through `connectors.tabular_sources@0.1.0`.
+
+Database, API, file, and warehouse providers can implement the same core
+capability later. Dataflow stores opaque references and expected fingerprints;
+it never stores connector credentials.
+
+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
+```
+
 See:
 
 - [Connector concept](docs/CONCEPT.md)