OpenG2P G2P Bridge

Consolidated monorepo for the OpenG2P G2P Bridge. It brings together what were previously seven separate repositories into one, keeping each component's folder structure intact.

Layout

Folder	Origin repo	Contents
core/	openg2p-g2p-bridge	Core services: models, partner-api, bene-portal-api, celery-beat-producers, celery-workers
example-bank/	openg2p-g2p-bridge-example-bank	Reference "example bank": api, celery-beat-producers, celery-workers, models
docker/	openg2p-g2p-bridge-docker	Dockerfiles for the API and Celery service images
deployment/	openg2p-g2p-bridge-deployment + openg2p-g2p-bridge-example-bank-deployment	Single consolidated Helm chart charts/openg2p-bridge (G2P Bridge + bundled example-bank, toggle via exampleBank.enabled)
test/	openg2p-g2p-bridge-test	Functional / Postman tests

The redundant openg2p-g2p-bridge- prefix has been stripped from folder and file names within the repo. Python package names (e.g. openg2p_g2p_bridge_models), Docker image names, and Helm Chart.yaml names are intentionally left unchanged.

Connectors live in a separate repo

The pluggable connectors (bank, mapper, notification, geo, agency, warehouse) were moved out of this repo into g2p-bridge-connectors. This core repo is the standard, versioned platform — it is consumed as a library (installed by git ref) and is not meant to be forked or modified by adopters. The Celery image pulls the reference connectors from g2p-bridge-connectors at build time (G2P_BRIDGE_CONNECTORS_REF); adopters add their own connector by extending the published image and selecting it via config — without forking core. See the connectors repo and the design docs for the full split rationale and the "write your own connector" guide.

CI workflows

All GitHub Actions live in .github/workflows (the only location GitHub runs them from). Each is scoped with paths: filters so it only runs when its own component changes:

• pre-commit.yml — runs each sub-project's own pre-commit config.
• core-test.yml, example-bank-test.yml — test + coverage.
• docker-build-apis.yml, docker-build-celery.yml, docker-build-example-bank.yml, docker-build-sanity.yml — build/push images. The image tag matches the g2p-bridge repository ref (branch name or git tag).
• helm-publish.yml — package and publish every Helm chart under deployment/charts/ (G2P Bridge + example bank).

Notes

• The Python packages are not published to PyPI — every image builds them from local in-repo source. Each module's __version__ (in its __init__.py) is 0.0.0.dev0 on develop.
• Docker images build from local source. The only external OpenG2P libraries (openg2p-fastapi-common, and openg2p-spar-models for celery) are overridable inputs on the docker build workflows (defaults shown in the GitHub Actions UI).
• Helm Chart.yaml versions / values image tags are still to be reconciled (pending chart consolidation).
• Detailed documentation will be added separately.