Instructor Frontend Builder Runtime and API

The Instructor Frontend Builder turns selected structures into instructor-manageable frontend trees with separate dashboard, manager, and editor routes. The current runtime owner is src/Modules/InstructorFrontendBuilder/InstructorFrontendBuilderSystem.php.

Module Gate and Entry Points

• Module flag: brm_enable_instructor_frontend_builder
• Bootstrap path: src/Bootstrap/BootstrapCoordinator.php → InstructorFrontendBuilderSystem::boot()
• Admin page: admin.php?page=brm_instructor_builder
• Access owner: src/Modules/InstructorFrontendBuilder/InstructorAccessService.php
• Read owner: src/Modules/InstructorFrontendBuilder/InstructorReadService.php

Query Vars and Routing

The runtime registers these query vars for scope-aware frontend routes:

• brm_scope
• brm_mode
• brm_structure
• brm_level
• brm_parent
• brm_item

InstructorPageGate validates the request context and routes the user into the assigned dashboard, manager, or editor page layouts.

Key Options

• brm_instructor_builder_roles
• brm_instructor_builder_structures
• brm_instructor_builder_allow_publish
• brm_instructor_builder_dashboard_page_id
• brm_instructor_builder_manager_page_id
• brm_instructor_builder_editor_page_id

Ownership Split

• InstructorFrontendBuilderSystem owns runtime boot and query-var registration.
• InstructorAccessService owns enabled-structure selection, allowed roles, page assignment reads, and write/publish capability checks.
• InstructorReadService owns validated scope-tree reads for frontend rendering.
• InstructorFrontendBatchRuntime owns batch-backed refresh behavior for larger trees.

Transport Adapters

• Admin settings page: InstructorFrontendBuilderPage
• Bricks Forms action pack: InstructorBuilderFormIntegration
• Scope assignment meta box: InstructorScopeAssignmentMetaBox

Edit Guidance

• Start in InstructorFrontendBuilderSystem for bootstrap and route questions.
• Start in InstructorAccessService for permissions and configuration logic.
• Start in InstructorReadService when the frontend needs a different scope-tree read model.