djangoldp_tamis_onboarding

Public registration form, operator review dashboard, and Keycloak provisioning hooks for the TAMIS dataspace.

What's in here

• RegisterParticipant model - mirrors the MediaEnterpriseCredential VC claim shape (organisation, legal address, sectoral roles, general + billing contacts) plus a state-machine lifecycle (pending → processing → approved | rejected).
• ParticipantAttachment model - one row per supporting document (K-bis, VAT cert, PROCIREP/ISAN proofs, etc.); files land in a private storage tree scoped per participant.
• Public multi-step registration form (/registration/) + success page.
• Operator dashboard (/registration/admin/) - Django-side approve / deny flow.
• Keycloak provisioning stub (keycloak_service.py) + background provisioning task (tasks.py) triggered on processing.
• Branded HTML + plain-text emails (templates/onboarding/email/): password magic link, admin notification on a new application, admin notification when connector details are ready for technical approval, approval, rejection, change requests, and the (off by default) Keycloak credentials mail. All extend email/_base.html, which mirrors the registration views' lockup, fonts and colours.
• ./manage.py generate_sample_documents - plausible random supporting documents for demos and testing.

Requirements

• Python ≥ 3.10, Django 5.2, DjangoLDP 5.0
• Pillow (logo re-encoding and sample-doc rendering)
• python-magic + system libmagic1 (content-based MIME sniffing on uploads)
• setuptools<80 in the host environment - DjangoLDP still imports pkg_resources, which setuptools 80+ deprecates at import time (setuptools' own warning message says "<81" but the deprecation shipped in 80.x). Pin it in your image with pip install 'setuptools<80' before installing this package.

Install

pip install djangoldp-tamis-onboarding

Add to your DjangoLDP settings.yml:

dependencies:
  - djangoldp-tamis-onboarding

ldppackages:
  - djangoldp_tamis_onboarding

Then wire the URLs under your onboarding prefix (default onboarding/):

path("onboarding/", include("djangoldp_tamis_onboarding.urls")),

Configuration

Settings read by the package (all optional except TAMIS_ADMIN_MAILS):

Runnable stack

The governance-services/ docker-compose stack in the TAMIS workspace bundles this package with Keycloak + Postgres + nginx for local and staging onboarding.

Sample documents

Generate plausible K-bis, VAT certificates, PROCIREP/ISAN membership proofs for manual testing:

./manage.py generate_sample_documents --output ./sample-docs --count 3 --format both

License

MIT.