iil-learnfw

Django Learning Platform Framework — Courses, Quizzes, Certificates, Gamification, SCORM.

Part of the IIL Platform ecosystem.

Architecture Decision

• ADR-139: Package design, models, services, API
• ADR-140: Learn-Hub (central deployment using this package)
• ADR-137: Multi-Tenancy (TenantManager, RLS)

Installation

# Minimal
pip install iil-learnfw

# All extras
pip install "iil-learnfw[all]"

# Specific extras
pip install "iil-learnfw[api,tenancy,certificates]"

Quick Start

# settings.py
INSTALLED_APPS = [
    "iil_learnfw",   # Python module name (pip package: iil-learnfw)
    ...
]

IIL_LEARNFW = {
    "TENANT_AWARE": True,        # Enable multi-tenancy (requires `tenancy` extra)
    "AUTHORING_ENABLED": True,   # Allow course creation via admin/API
    "ENROLLMENT_MODE": "self_enroll",  # Options: self_enroll | invite_only | open
}

# urls.py
from django.urls import include, path

urlpatterns = [
    path("schulungen/", include("iil_learnfw.urls")),
]

Extras

Modules

Deployment

Run migrations after installation:

python manage.py migrate

For multi-tenant setups, configure TENANT_AWARE: True in IIL_LEARNFW and ensure each request carries a tenant_id (see ADR-137).

Production checklist:

• Set DEBUG=False and configure ALLOWED_HOSTS
• Configure media storage (PDF certificates, PPTX uploads)
• Set CACHES to Redis for session/progress caching

License

MIT