feat: add competency criteria models for CBE authoring layer

.annotation_safe_list.yml

@@ -77,6 +77,12 @@ openedx_content.Unit:
   ".. no_pii:": "This model has no PII"
 openedx_content.UnitVersion:
   ".. no_pii:": "This model has no PII"
+openedx_learning.HistoricalCompetencyCriteriaGroup:
+  ".. no_pii:": "This model has no PII"
+openedx_learning.HistoricalCompetencyCriterion:
+  ".. no_pii:": "This model has no PII"
+openedx_learning.HistoricalCompetencyRuleProfile:
+  ".. no_pii:": "This model has no PII"
 social_django.Association:
   ".. no_pii:": "This model has no PII"
 social_django.Code:

.importlinter

@@ -7,6 +7,7 @@
 root_packages =
     openedx_learning
     openedx_content
+    openedx_catalog
     openedx_tagging
     openedx_django_lib
     openedx_core
@@ -26,6 +27,11 @@ layers =
     # Content: authoring-side models and APIs.
     openedx_content
 
+    # Catalog: CatalogCourse/CourseRun. CompetencyCriteriaGroup and CompetencyRuleProfile
+    # (openedx_learning) scope to a CourseRun, so this must sit below openedx_learning; it doesn't
+    # depend on tagging or content, so it can sit above openedx_tagging.
+    openedx_catalog
+
     # Tagging is very simple & fundamental. Should probably not depend on any other Django apps.
     openedx_tagging
 

mypy.ini

@@ -12,5 +12,8 @@ files =
 [mypy-organizations.*]
 follow_untyped_imports = True
 
+[mypy-simple_history.*]
+follow_untyped_imports = True
+
 [mypy.plugins.django-stubs]
 django_settings_module = "projects.dev"

requirements/base.in

@@ -17,3 +17,5 @@ rules<4.0                 # Django extension for rules-based authorization check
 tomlkit                   # Parses and writes TOML configuration files
 
 edx-organizations         # Implemented the "Organization" model that CatalogCourse/CourseRun are keyed to
+
+django-simple-history     # History tracking for CBE criteria definitions, per ADR-0003

requirements/base.txt

@@ -58,7 +58,9 @@ django-crum==0.7.9
 django-model-utils==5.0.0
     # via edx-organizations
 django-simple-history==3.13.0
-    # via edx-organizations
+    # via
+    #   -r requirements/base.in
+    #   edx-organizations
 django-waffle==5.0.0
     # via
     #   edx-django-utils

src/openedx_learning/applets/cbe/models/__init__.py

@@ -0,0 +1,23 @@
+"""
+Models for Competency-Based Education (CBE).
+"""
+
+from .competency_taxonomy import CompetencyTaxonomy
+from .criteria import (
+    CompetencyCriteriaGroup,
+    CompetencyCriterion,
+    CompetencyRuleProfile,
+    LogicOperator,
+    RuleType,
+    validate_rule_payload,
+)
+
+__all__ = [
+    "CompetencyTaxonomy",
+    "CompetencyCriteriaGroup",
+    "CompetencyCriterion",
+    "CompetencyRuleProfile",
+    "LogicOperator",
+    "RuleType",
+    "validate_rule_payload",
+]

src/openedx_learning/applets/cbe/models.py → src/openedx_learning/applets/cbe/models/competency_taxonomy.py

@@ -1,6 +1,9 @@
 """
-Models for Competency-Based Education (CBE).
+The CompetencyTaxonomy model.
 """
+from django.db import models
+from django.utils.translation import gettext_lazy as _
+
 from openedx_tagging.models import Taxonomy
 
 __all__ = [
@@ -35,6 +38,19 @@ class CompetencyTaxonomy(Taxonomy):
     .. no_pii:
     """
 
+    taxonomy_overrides_org = models.BooleanField(
+        default=False,
+        help_text=_(
+            "Resolves a tie when assigning a CompetencyRuleProfile to a CompetencyCriterion (ADR-0002 "
+            "Decision 4): if both an organization-scoped profile and a taxonomy-scoped profile from this "
+            "taxonomy apply to the same criterion, False (the default) assigns the organization-scoped "
+            "profile, and True assigns this taxonomy's own profile instead, so it cannot be locally "
+            "weakened by an organization. Nothing reads this field yet: organization-scoped "
+            "CompetencyRuleProfile rows do not exist in this phase, so the tie it resolves cannot arise "
+            "until they do."
+        ),
+    )
+
     class Meta:
         verbose_name = "Competency Taxonomy"
         verbose_name_plural = "Competency Taxonomies"