Open edX 课程证书白名单Allowlist机制解析从需求约束到源码实现【免费下载链接】openedx-platformThe Open edX LMS Studio, powering education sites around the world!项目地址: https://gitcode.com/GitHub_Trending/ed/openedx-platform导读Open edX 平台中课程证书的颁发通常与成绩、选课模式等硬性条件绑定但在实际运营中课程团队经常需要为个别差一点的学员破例发证。本文以 Open edX 的架构决策记录ADRAllowlist Course Certificate Requirements 为骨架系统梳理证书 allowlist白名单的准入条件、数据模型、生成链路与操作入口并结合 LMS 源码generation_handler.py、models.py、signals.py逐条验证每条需求的底层实现帮助你完整掌握破格发证能力的配置与排障方法。一、背景什么是证书 Allowlist在 Open edX 中学员在某个课程 runcourse run内满足一定条件后即可获得课程证书证书记录存储在GeneratedCertificate模型中见 models.py。但存在一类特殊情况学员没有达到正常获证条件而课程方仍然希望为其颁发证书。此时课程工作人员可以把该学员加入该课程 run 的证书 allowlist从而为其破格生成一张证书。allowlist 的存储模型是CertificateAllowlist。它此前被称为证书 whitelist白名单旧实现存储在CertificateWhitelist模型中。从迁移历史可以完整还原这段演进0026_certificateallowlist.py创建CertificateAllowlist表0029_allowlist_created_20210623_1417.py分页将CertificateWhitelist中的数据复制到CertificateAllowlist保留allowlist、notes、created字段0030_delete_certificatewhitelist.py删除旧的CertificateWhitelist表。也就是说allowlist 与 whitelist 只是同一能力在不同时期的命名迁移后统一收敛到CertificateAllowlist。注意一个易混淆点加入 allowlist 并不等于一定拿到证书。原 ADR 明确指出即使学员在某个课程 run 的 allowlist 上也不一定获得downloadable可下载状态的证书。下文将逐条展开真正影响结果的必要条件。二、生成可下载 Allowlist 证书的全部必要条件原文档核心需求根据 ADR在证书生成的时间点以下条件必须同时成立学员才能获得一张downloadable状态的 allowlist 课程证书学员必须在该课程 run 中有选课记录enrollment选课模式mode必须是可获证模式eligible for a certificate例如 verified、honor、professional、masters 等选课记录不要求处于 active 状态即已退课inactive enrollment的学员仍可凭 allowlist 获证。学员没有处于无效状态的证书invalidation即不存在生效中的CertificateInvalidation记录见 models.py。HTMLWeb证书必须在全局启用且该课程 run 也启用平台级开关与课程级开关缺一不可。学员必须在该课程 run 的 allowlist 上即CertificateAllowlist中存在allowlistTrue的有效记录。若ENABLE_CERTIFICATES_IDV_REQUIREMENTWaffle Flag 开启学员必须通过身份验证ID verification且验证未过期该 Flag 默认关闭开启后未通过 IDV 的学员即使在校验链的其他环节全部通过也无法获得 downloadable 证书。以上五点是 ADR 给出的需求清单下面分别从配置层面与源码层面验证每条需求的实际落地。三、需求背后的配置项与开关3.1 HTML 证书两级开关HTML 证书全局启用 课程 run 启用这一需求在源码中对应 utils.py 的has_html_certificates_enableddef has_html_certificates_enabled(course_overview): Returns True if HTML certificates are enabled in a course run. if not settings.CERTIFICATES_HTML_VIEW: return False return course_overview.cert_html_view_enabledsettings.CERTIFICATES_HTML_VIEW平台级开关位于 LMS 的 settings 中默认在 lms/envs/common.py 一带配置各环境可覆盖例如测试环境 lms/envs/test.py 中CERT_QUEUE certificates配套生效course_overview.cert_html_view_enabled课程 run 级开关由课程设置Studio 中的证书页面控制。只有当两者同时为真时Web 证书渲染链路才会生效证书 URL 通过certificates:render_cert_by_uuid路由生成见 utils.py。3.2 IDV身份验证开关ENABLE_CERTIFICATES_IDV_REQUIREMENT定义在 lms/envs/common.py默认值为False# .. toggle_name: settings.ENABLE_CERTIFICATES_IDV_REQUIREMENT ENABLE_CERTIFICATES_IDV_REQUIREMENT False该开关开启后证书生成逻辑会调用IDVerificationService.user_is_verified(user)判断学员是否有已批准且未过期的 IDV若未通过生成会被阻断详见下文源码分析。注意 mock 环境 lms/envs/mock.yml 中该开关被置为true用于测试。四、源码级验证允许列表证书的完整生成链路allowlist 证书并不是简单查一下名单就发证而是走了一条与普通证书共享大部分检查、但跳过成绩/CCX/内测者等限制的独立路径。核心实现在 generation_handler.py。4.1 入口分流generate_certificate_taskdef generate_certificate_task(user, course_key, generation_modeNone, delay_secondsCERTIFICATE_DELAY_SECONDS): if is_on_certificate_allowlist(user, course_key): return generate_allowlist_certificate_task(user, course_key, generation_modegeneration_mode, delay_secondsdelay_seconds) return _generate_regular_certificate_task(user, course_key, generation_modegeneration_mode, delay_secondsdelay_seconds)见 generation_handler.pyis_on_certificate_allowlist的判定是def is_on_certificate_allowlist(user, course_key): return CertificateAllowlist.objects.filter(useruser, course_idcourse_key, allowlistTrue).exists()见 generation_handler.py即只有allowlistTrue的记录才算有效 allowlist 成员——这也是CertificateAllowlist模型存在布尔字段allowlist默认 0见 models.py的原因通过update_or_create可以把已有学员移出白名单置allowlistFalse而不必删除记录。4.2 allowlist 专属检查_can_generate_allowlist_certificatedef _can_generate_allowlist_certificate(user, course_key, enrollment_mode): if not is_on_certificate_allowlist(user, course_key): return False if not _can_generate_certificate_common(user, course_key, enrollment_mode): return False return True见 generation_handler.py关键差异与普通证书相比allowlist 路径不再检查_is_passing_grade、_is_ccx_course、is_beta_tester这三项在普通证书的_can_generate_regular_certificate中均存在见 002-cert-requirements.rst。这正是破格的体现CCX 课程、beta tester、未及格学员只要在 allowlist 上就有机会获证。4.3 与普通证书共用的检查_can_generate_certificate_common见 generation_handler.py该函数依次执行CertificateInvalidation.has_certificate_invalidation(user, course_key)—— 存在生效的 invalidation 记录则拒绝对应需求 2enrollment_mode is None—— 无选课记录则拒绝对应需求 1modes_api.is_eligible_for_certificate(enrollment_mode)—— 选课模式不可获证则拒绝对应需求 1 的子条件普通 audit 模式会被拦截IDV 检查_id_verification_enforced_and_missing(user)当settings.ENABLE_CERTIFICATES_IDV_REQUIREMENT为真且学员未通过 IDV 时若选课模式不属于CourseMode.NON_VERIFIED_MODES即 honor / no-id-professional 等非强制 IDV 模式则拒绝对应需求 5_can_generate_certificate_for_status—— 已存在 downloadable 证书且当前模式不再eligible 时拒绝保证终态证书不被反复改写get_course_overview_or_none(course_key)必须存在has_html_certificates_enabled(course_overview)—— 两级 HTML 证书开关必须同时开启对应需求 3。4.4 无法 downloadable 时的降级行为当 allowlist 证书无法以downloadable状态生成时系统会尝试为其设置一个说明性状态见_set_allowlist_cert_statusgeneration_handler.py若存在 invalidation把已有证书标记为unavailable若 IDV 强制开启但学员未验证同时通过成绩或 allowlist 豁免生成或标记为unverified状态。这些状态与 004-cert-status.rst 中定义的CertificateStatuses一一对应downloadable、notpassing、unverified、unavailable、audit_passing、audit_notpassing等见 data.py。五、数据模型与迁移5.1 CertificateAllowlist 模型字段字段类型说明userForeignKey(User, CASCADE)被允许获证的学员course_idCourseKeyField所属课程 runallowlistBooleanField(default0)是否处于生效的 allowlist 状态False表示历史记录但已停用notesTextField(nullTrue)操作备注如破格原因created/modifiedAutoCreatedField / AutoLastModifiedField时间戳继承TimeStampedModelhistoryHistoricalRecords历史审计仅在 certificates app 已安装时挂载模型层面通过unique_together [[course_id, user]]models.py保证同一课程 run 下每个学员只有一条 allowlist 记录配合 0021_remove_certificate_allowlist_duplicate_records.py 与 0022_add_unique_constraints_to_certificatewhitelist_model.py 完成了历史重复数据的清理。5.2 查询接口CertificateAllowlist.get_certificate_allowlist(course_id, studentNone)models.py返回该课程 run 的 allowlist 明细包括学员 id、用户名、邮箱、创建日期、备注以及与GeneratedCertificate.eligible_certificates关联后计算出的certificate_generated是否已生成 downloadable 证书及日期。这个接口被 instructor dashboard 的证书例外列表直接消费。六、如何实际操作 allowlist6.1 业务 APIcertificates/api.py 提供了完整的增删查接口create_or_update_certificate_allowlist_entry(user, course_key, notes, enabledTrue)api.pyupdate_or_create实现添加/更新enabledFalse即移出remove_allowlist_entry(user, course_key)api.py先从 allowlist 移除前自动 invalidate 已存在的证书certificate.invalidate(sourceallowlist_removal)再删除记录——避免名单已移除但证书仍可下载的漏网is_on_allowlist(user, course_key)/get_allowlist_entry(user, course_key)/get_allowlisted_users(course_key)查询能力can_be_added_to_allowlist(user, course_key)api.py预检查能否加入——要求已选课、未被 invalidation、且当前不在 allowlist 上。6.2 Instructor 工具与 CSV 批量导入LMS 的 instructor dashboardinstructor/views/api.py封装了面向课程工作人员的操作add_certificate_exception/remove_certificate_exceptioninstructor/views/api.py按用户名或邮箱添加/移除单条 allowlist 记录CSV 批量导入通过generate_certificate_exceptions接口上传 CSV逐行校验并汇总结果返回user_already_allowlisted已在名单、success成功加入等分类清单generate_certificates_for_allowlisted_students为名单内学员批量触发证书生成任务studentsall_allowlisted或studentsallowlisted_not_generated即全部名单成员或尚未生成者两种范围。6.3 信号驱动的自动生成除了人工在 dashboard 上触发Open edX 还会在 allowlist 记录被保存后自动尝试生成证书。见 signals.pyreceiver(post_save, senderCertificateAllowlist, dispatch_uidappend_certificate_allowlist) def _listen_for_certificate_allowlist_append(sender, instance, **kwargs): if not auto_certificate_generation_enabled(): return if is_on_certificate_allowlist(instance.user, instance.course_id): return generate_allowlist_certificate_task(instance.user, instance.course_id)前置条件是auto_certificate_generation_enabled()自动发证全局开关开启保存后只要该记录处于生效状态allowlistTrue即异步入队生成任务。同样在 signals.pyCOURSE_GRADE_NOW_FAILED信号的处理会对 allowlist 学员直接豁免学员成绩转差fail时若其在 allowlist 上已颁发的证书不会被标记为notpassing——这是 allowlist 学员成绩波动不影响证书的又一体现。七、allowlist 在证书生成整体架构中的位置仓库中的 certificate_generation.dslStructurizr DSL渲染图见 certificate_generation.png将Certificate AllowList作为 Certificates app 内的独立组件建模整体调用链可归纳为Allowlist 记录保存(post_save 信号) └─ Certificates Signal Handlers └─ generate_allowlist_certificate_task (Generation Handler) └─ Celery: generate_certificate_task └─ Database: UPSERT GeneratedCertificate 记录 ├─ 事件总线: CERTIFICATE_CREATED └─ Programs: COURSE_CERT_CHANGED / COURSE_CERT_AWARDED对应 DSL 中allowlist - signal_handlers、signal_handlers - generation_handler、generation_handler - celery - database的连线关系。八、测试验证允许列表证书的行为边界仓库中的测试集中体现了上述规则的预期行为可作为排障与二次开发的参考test_generation_handler.py 的AllowlistTeststest_is_on_allowlist/test_is_on_allowlist_false验证is_on_certificate_allowlist的判定test_can_generate_not_allowlisted不在名单上时allowlist 路径拒绝生成test_can_generate_invalidated存在生效 invalidation 时拒绝生成且状态设置结果为unavailabletest_can_generate_web_cert_disabled/test_can_generate_no_overviewHTML 证书开关关闭或 CourseOverview 缺失时拒绝test_generate_allowlist_honor_cert结合DISABLE_HONOR_CERTIFICATES开关验证 honor 模式 allowlist 证书可生成/不可生成的两种情形test_can_generate_not_verified_not_passing_allowlist在 IDV 强制开启ENABLE_CERTIFICATES_IDV_REQUIREMENTTrue时未验证且未及格的 allowlist 学员的行为。测试工厂CertificateAllowlistFactoryfactories.py默认allowlistTrue、notesTest Notes与生产默认值一致。九、总结allowlist 的破格边界一句话概括本 ADR 与源码的对应关系allowlist 免除的是成绩/身份类硬门槛但绝不豁免选课、失效标记、证书功能开关这类平台级护栏。需求免除源码落点已选课且模式可获证否必须满足_can_generate_certificate_common第 2、3 步无 invalidation 记录否必须满足CertificateInvalidation.has_certificate_invalidationHTML 证书两级启用否必须满足has_html_certificates_enabledCERTIFICATES_HTML_VIEWcert_html_view_enabled在 allowlist 上是allowlist 的本职is_on_certificate_allowlist及格成绩 / 非 CCX / 非 beta tester是允许豁免allowlist 路径不检查_is_passing_grade、_is_ccx_course、is_beta_testerIDV 验证Flag 开启时视模式而定NON_VERIFIED_MODES豁免_id_verification_enforced_and_missing实操建议为学员添加 allowlist 前可先用can_be_added_to_allowlist做预检添加后证书并不会立即出现——要么依赖post_save信号自动入队要么在 instructor dashboard 手动对名单成员触发批量生成若始终拿不到 downloadable 证书请按本文第三节的两级 HTML 开关、第四节的三类公共检查逐项排查并留意ENABLE_CERTIFICATES_IDV_REQUIREMENT是否开启。相关实现细节可继续阅读 generation_handler.py、models.py 与 signals.py以及配套 ADR 002-cert-requirements.rst普通证书需求对照。【免费下载链接】openedx-platformThe Open edX LMS Studio, powering education sites around the world!项目地址: https://gitcode.com/GitHub_Trending/ed/openedx-platform创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Open edX 课程证书白名单Allowlist机制解析从需求约束到源码实现【免费下载链接】openedx-platformThe Open edX LMS Studio, powering education sites around the world!项目地址: https://gitcode.com/GitHub_Trending/ed/openedx-platform导读Open edX 平台中课程证书的颁发通常与成绩、选课模式等硬性条件绑定但在实际运营中课程团队经常需要为个别差一点的学员破例发证。本文以 Open edX 的架构决策记录ADRAllowlist Course Certificate Requirements 为骨架系统梳理证书 allowlist白名单的准入条件、数据模型、生成链路与操作入口并结合 LMS 源码generation_handler.py、models.py、signals.py逐条验证每条需求的底层实现帮助你完整掌握破格发证能力的配置与排障方法。一、背景什么是证书 Allowlist在 Open edX 中学员在某个课程 runcourse run内满足一定条件后即可获得课程证书证书记录存储在GeneratedCertificate模型中见 models.py。但存在一类特殊情况学员没有达到正常获证条件而课程方仍然希望为其颁发证书。此时课程工作人员可以把该学员加入该课程 run 的证书 allowlist从而为其破格生成一张证书。allowlist 的存储模型是CertificateAllowlist。它此前被称为证书 whitelist白名单旧实现存储在CertificateWhitelist模型中。从迁移历史可以完整还原这段演进0026_certificateallowlist.py创建CertificateAllowlist表0029_allowlist_created_20210623_1417.py分页将CertificateWhitelist中的数据复制到CertificateAllowlist保留allowlist、notes、created字段0030_delete_certificatewhitelist.py删除旧的CertificateWhitelist表。也就是说allowlist 与 whitelist 只是同一能力在不同时期的命名迁移后统一收敛到CertificateAllowlist。注意一个易混淆点加入 allowlist 并不等于一定拿到证书。原 ADR 明确指出即使学员在某个课程 run 的 allowlist 上也不一定获得downloadable可下载状态的证书。下文将逐条展开真正影响结果的必要条件。二、生成可下载 Allowlist 证书的全部必要条件原文档核心需求根据 ADR在证书生成的时间点以下条件必须同时成立学员才能获得一张downloadable状态的 allowlist 课程证书学员必须在该课程 run 中有选课记录enrollment选课模式mode必须是可获证模式eligible for a certificate例如 verified、honor、professional、masters 等选课记录不要求处于 active 状态即已退课inactive enrollment的学员仍可凭 allowlist 获证。学员没有处于无效状态的证书invalidation即不存在生效中的CertificateInvalidation记录见 models.py。HTMLWeb证书必须在全局启用且该课程 run 也启用平台级开关与课程级开关缺一不可。学员必须在该课程 run 的 allowlist 上即CertificateAllowlist中存在allowlistTrue的有效记录。若ENABLE_CERTIFICATES_IDV_REQUIREMENTWaffle Flag 开启学员必须通过身份验证ID verification且验证未过期该 Flag 默认关闭开启后未通过 IDV 的学员即使在校验链的其他环节全部通过也无法获得 downloadable 证书。以上五点是 ADR 给出的需求清单下面分别从配置层面与源码层面验证每条需求的实际落地。三、需求背后的配置项与开关3.1 HTML 证书两级开关HTML 证书全局启用 课程 run 启用这一需求在源码中对应 utils.py 的has_html_certificates_enableddef has_html_certificates_enabled(course_overview): Returns True if HTML certificates are enabled in a course run. if not settings.CERTIFICATES_HTML_VIEW: return False return course_overview.cert_html_view_enabledsettings.CERTIFICATES_HTML_VIEW平台级开关位于 LMS 的 settings 中默认在 lms/envs/common.py 一带配置各环境可覆盖例如测试环境 lms/envs/test.py 中CERT_QUEUE certificates配套生效course_overview.cert_html_view_enabled课程 run 级开关由课程设置Studio 中的证书页面控制。只有当两者同时为真时Web 证书渲染链路才会生效证书 URL 通过certificates:render_cert_by_uuid路由生成见 utils.py。3.2 IDV身份验证开关ENABLE_CERTIFICATES_IDV_REQUIREMENT定义在 lms/envs/common.py默认值为False# .. toggle_name: settings.ENABLE_CERTIFICATES_IDV_REQUIREMENT ENABLE_CERTIFICATES_IDV_REQUIREMENT False该开关开启后证书生成逻辑会调用IDVerificationService.user_is_verified(user)判断学员是否有已批准且未过期的 IDV若未通过生成会被阻断详见下文源码分析。注意 mock 环境 lms/envs/mock.yml 中该开关被置为true用于测试。四、源码级验证允许列表证书的完整生成链路allowlist 证书并不是简单查一下名单就发证而是走了一条与普通证书共享大部分检查、但跳过成绩/CCX/内测者等限制的独立路径。核心实现在 generation_handler.py。4.1 入口分流generate_certificate_taskdef generate_certificate_task(user, course_key, generation_modeNone, delay_secondsCERTIFICATE_DELAY_SECONDS): if is_on_certificate_allowlist(user, course_key): return generate_allowlist_certificate_task(user, course_key, generation_modegeneration_mode, delay_secondsdelay_seconds) return _generate_regular_certificate_task(user, course_key, generation_modegeneration_mode, delay_secondsdelay_seconds)见 generation_handler.pyis_on_certificate_allowlist的判定是def is_on_certificate_allowlist(user, course_key): return CertificateAllowlist.objects.filter(useruser, course_idcourse_key, allowlistTrue).exists()见 generation_handler.py即只有allowlistTrue的记录才算有效 allowlist 成员——这也是CertificateAllowlist模型存在布尔字段allowlist默认 0见 models.py的原因通过update_or_create可以把已有学员移出白名单置allowlistFalse而不必删除记录。4.2 allowlist 专属检查_can_generate_allowlist_certificatedef _can_generate_allowlist_certificate(user, course_key, enrollment_mode): if not is_on_certificate_allowlist(user, course_key): return False if not _can_generate_certificate_common(user, course_key, enrollment_mode): return False return True见 generation_handler.py关键差异与普通证书相比allowlist 路径不再检查_is_passing_grade、_is_ccx_course、is_beta_tester这三项在普通证书的_can_generate_regular_certificate中均存在见 002-cert-requirements.rst。这正是破格的体现CCX 课程、beta tester、未及格学员只要在 allowlist 上就有机会获证。4.3 与普通证书共用的检查_can_generate_certificate_common见 generation_handler.py该函数依次执行CertificateInvalidation.has_certificate_invalidation(user, course_key)—— 存在生效的 invalidation 记录则拒绝对应需求 2enrollment_mode is None—— 无选课记录则拒绝对应需求 1modes_api.is_eligible_for_certificate(enrollment_mode)—— 选课模式不可获证则拒绝对应需求 1 的子条件普通 audit 模式会被拦截IDV 检查_id_verification_enforced_and_missing(user)当settings.ENABLE_CERTIFICATES_IDV_REQUIREMENT为真且学员未通过 IDV 时若选课模式不属于CourseMode.NON_VERIFIED_MODES即 honor / no-id-professional 等非强制 IDV 模式则拒绝对应需求 5_can_generate_certificate_for_status—— 已存在 downloadable 证书且当前模式不再eligible 时拒绝保证终态证书不被反复改写get_course_overview_or_none(course_key)必须存在has_html_certificates_enabled(course_overview)—— 两级 HTML 证书开关必须同时开启对应需求 3。4.4 无法 downloadable 时的降级行为当 allowlist 证书无法以downloadable状态生成时系统会尝试为其设置一个说明性状态见_set_allowlist_cert_statusgeneration_handler.py若存在 invalidation把已有证书标记为unavailable若 IDV 强制开启但学员未验证同时通过成绩或 allowlist 豁免生成或标记为unverified状态。这些状态与 004-cert-status.rst 中定义的CertificateStatuses一一对应downloadable、notpassing、unverified、unavailable、audit_passing、audit_notpassing等见 data.py。五、数据模型与迁移5.1 CertificateAllowlist 模型字段字段类型说明userForeignKey(User, CASCADE)被允许获证的学员course_idCourseKeyField所属课程 runallowlistBooleanField(default0)是否处于生效的 allowlist 状态False表示历史记录但已停用notesTextField(nullTrue)操作备注如破格原因created/modifiedAutoCreatedField / AutoLastModifiedField时间戳继承TimeStampedModelhistoryHistoricalRecords历史审计仅在 certificates app 已安装时挂载模型层面通过unique_together [[course_id, user]]models.py保证同一课程 run 下每个学员只有一条 allowlist 记录配合 0021_remove_certificate_allowlist_duplicate_records.py 与 0022_add_unique_constraints_to_certificatewhitelist_model.py 完成了历史重复数据的清理。5.2 查询接口CertificateAllowlist.get_certificate_allowlist(course_id, studentNone)models.py返回该课程 run 的 allowlist 明细包括学员 id、用户名、邮箱、创建日期、备注以及与GeneratedCertificate.eligible_certificates关联后计算出的certificate_generated是否已生成 downloadable 证书及日期。这个接口被 instructor dashboard 的证书例外列表直接消费。六、如何实际操作 allowlist6.1 业务 APIcertificates/api.py 提供了完整的增删查接口create_or_update_certificate_allowlist_entry(user, course_key, notes, enabledTrue)api.pyupdate_or_create实现添加/更新enabledFalse即移出remove_allowlist_entry(user, course_key)api.py先从 allowlist 移除前自动 invalidate 已存在的证书certificate.invalidate(sourceallowlist_removal)再删除记录——避免名单已移除但证书仍可下载的漏网is_on_allowlist(user, course_key)/get_allowlist_entry(user, course_key)/get_allowlisted_users(course_key)查询能力can_be_added_to_allowlist(user, course_key)api.py预检查能否加入——要求已选课、未被 invalidation、且当前不在 allowlist 上。6.2 Instructor 工具与 CSV 批量导入LMS 的 instructor dashboardinstructor/views/api.py封装了面向课程工作人员的操作add_certificate_exception/remove_certificate_exceptioninstructor/views/api.py按用户名或邮箱添加/移除单条 allowlist 记录CSV 批量导入通过generate_certificate_exceptions接口上传 CSV逐行校验并汇总结果返回user_already_allowlisted已在名单、success成功加入等分类清单generate_certificates_for_allowlisted_students为名单内学员批量触发证书生成任务studentsall_allowlisted或studentsallowlisted_not_generated即全部名单成员或尚未生成者两种范围。6.3 信号驱动的自动生成除了人工在 dashboard 上触发Open edX 还会在 allowlist 记录被保存后自动尝试生成证书。见 signals.pyreceiver(post_save, senderCertificateAllowlist, dispatch_uidappend_certificate_allowlist) def _listen_for_certificate_allowlist_append(sender, instance, **kwargs): if not auto_certificate_generation_enabled(): return if is_on_certificate_allowlist(instance.user, instance.course_id): return generate_allowlist_certificate_task(instance.user, instance.course_id)前置条件是auto_certificate_generation_enabled()自动发证全局开关开启保存后只要该记录处于生效状态allowlistTrue即异步入队生成任务。同样在 signals.pyCOURSE_GRADE_NOW_FAILED信号的处理会对 allowlist 学员直接豁免学员成绩转差fail时若其在 allowlist 上已颁发的证书不会被标记为notpassing——这是 allowlist 学员成绩波动不影响证书的又一体现。七、allowlist 在证书生成整体架构中的位置仓库中的 certificate_generation.dslStructurizr DSL渲染图见 certificate_generation.png将Certificate AllowList作为 Certificates app 内的独立组件建模整体调用链可归纳为Allowlist 记录保存(post_save 信号) └─ Certificates Signal Handlers └─ generate_allowlist_certificate_task (Generation Handler) └─ Celery: generate_certificate_task └─ Database: UPSERT GeneratedCertificate 记录 ├─ 事件总线: CERTIFICATE_CREATED └─ Programs: COURSE_CERT_CHANGED / COURSE_CERT_AWARDED对应 DSL 中allowlist - signal_handlers、signal_handlers - generation_handler、generation_handler - celery - database的连线关系。八、测试验证允许列表证书的行为边界仓库中的测试集中体现了上述规则的预期行为可作为排障与二次开发的参考test_generation_handler.py 的AllowlistTeststest_is_on_allowlist/test_is_on_allowlist_false验证is_on_certificate_allowlist的判定test_can_generate_not_allowlisted不在名单上时allowlist 路径拒绝生成test_can_generate_invalidated存在生效 invalidation 时拒绝生成且状态设置结果为unavailabletest_can_generate_web_cert_disabled/test_can_generate_no_overviewHTML 证书开关关闭或 CourseOverview 缺失时拒绝test_generate_allowlist_honor_cert结合DISABLE_HONOR_CERTIFICATES开关验证 honor 模式 allowlist 证书可生成/不可生成的两种情形test_can_generate_not_verified_not_passing_allowlist在 IDV 强制开启ENABLE_CERTIFICATES_IDV_REQUIREMENTTrue时未验证且未及格的 allowlist 学员的行为。测试工厂CertificateAllowlistFactoryfactories.py默认allowlistTrue、notesTest Notes与生产默认值一致。九、总结allowlist 的破格边界一句话概括本 ADR 与源码的对应关系allowlist 免除的是成绩/身份类硬门槛但绝不豁免选课、失效标记、证书功能开关这类平台级护栏。需求免除源码落点已选课且模式可获证否必须满足_can_generate_certificate_common第 2、3 步无 invalidation 记录否必须满足CertificateInvalidation.has_certificate_invalidationHTML 证书两级启用否必须满足has_html_certificates_enabledCERTIFICATES_HTML_VIEWcert_html_view_enabled在 allowlist 上是allowlist 的本职is_on_certificate_allowlist及格成绩 / 非 CCX / 非 beta tester是允许豁免allowlist 路径不检查_is_passing_grade、_is_ccx_course、is_beta_testerIDV 验证Flag 开启时视模式而定NON_VERIFIED_MODES豁免_id_verification_enforced_and_missing实操建议为学员添加 allowlist 前可先用can_be_added_to_allowlist做预检添加后证书并不会立即出现——要么依赖post_save信号自动入队要么在 instructor dashboard 手动对名单成员触发批量生成若始终拿不到 downloadable 证书请按本文第三节的两级 HTML 开关、第四节的三类公共检查逐项排查并留意ENABLE_CERTIFICATES_IDV_REQUIREMENT是否开启。相关实现细节可继续阅读 generation_handler.py、models.py 与 signals.py以及配套 ADR 002-cert-requirements.rst普通证书需求对照。【免费下载链接】openedx-platformThe Open edX LMS Studio, powering education sites around the world!项目地址: https://gitcode.com/GitHub_Trending/ed/openedx-platform创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
