feat: initialize governed datasources module

This commit is contained in:
2026-07-28 12:43:02 +02:00
commit 1cb6228442
37 changed files with 5910 additions and 0 deletions

25
README.md Normal file
View File

@@ -0,0 +1,25 @@
# govoplan-datasources
<!-- govoplan-repository-type:start -->
**Repository type:** module (platform).
<!-- govoplan-repository-type:end -->
`govoplan-datasources` is GovOPlaN's provider-neutral data access layer. It owns
the tenant catalogue, lifecycle, staging, immutable materializations, frozen
states, schema and fingerprint metadata, provenance, and bounded reads.
The module deliberately separates two layers:
- **Datasources** describe governed data that modules can consume consistently.
- **Connectors** acquire data from external systems and expose provider origins.
Dataflow, Workflow, Reporting, Risk Compliance, and other consumers depend on
Datasource contracts rather than connector implementations.
The first executable slice supports tabular static uploads, connector-backed
live and cached sources, staging and promotion, refresh, immutable snapshots,
explicit frozen states, previews, and retirement. The contracts already model
database, HTTP/REST, directory, file, feed, document, binary, directory, and
stream sources so providers can be added without changing consumers.
See [docs/CONCEPT.md](docs/CONCEPT.md) for ownership and lifecycle details.