# govoplan-connectors

<!-- govoplan-repository-type:start -->
**Repository type:** connector (connector-hub).
<!-- govoplan-repository-type:end -->

`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)
- [Public-sector integration catalogue](docs/PUBLIC_SECTOR_INTEGRATION_CATALOGUE.md)
- [Connector source lifecycle](docs/CONNECTOR_SOURCE_LIFECYCLE.md)
- [OpenProject connector concept](docs/OPENPROJECT_CONNECTOR.md)
- [OpenDesk integration map](docs/OPENDESK_INTEGRATION_MAP.md)