CurriculumStructure

Curriculum chapter tree — traversal / path / audit checklist + verdict aggregation (Pure) (Layer 1 Core).

Status

Key	Value
Layer	core
Tier	L1
Status	wip
Version	0.9.0
Price	Free (free)
Category	Learning

Overview

Overview

CurriculumStructure is a Layer 1 Core Plugin of multi-saas-kit. It provides standard traversal, path builder, structure audit checklist, and audit verdict aggregation for Chapter hierarchy (대단원 → 중단원 → lesson) — all model-free Pure services.

Core Components

ChapterNode (DTO)

Subset of Eloquent Chapter Model with 6 fields (id, parent_id, name, depth, sort_order, slug).

ChapterTreeTraversal (Pure)

Extracted from exam.how's ChapterStructureAuditService::getAncestors / getChildren / getSiblings. DB-free — accepts ChapterNode array.

Method	Result
ancestors($all, $id)	Parent chain (root first)
children($all, $id)	Direct children (sort_order asc)
siblings($all, $id)	Siblings excluding self
descendants($all, $id)	All descendants (recursive depth-first)

ChapterPathBuilder (Pure)

Builds "대단원 > 중단원 > 레슨" path. Configurable separator.

AuditChecklist (Pure constant)

6 standard categories:

Key	Korean Label
scope_alignment	학�
�/학기 범위 적합성
hierarchy_balance	단원-레슨 계층 균형
coverage_gap	구성 누락/과다 여부
naming_clarity	단원/레슨 �
�
�
확성
sequence_prerequisite	학습 순서/선수학습
redundancy_overlap	중복/겹침 위험

AuditVerdictAggregator (Pure)

Aggregates multiple provider verdicts into one — priority: fail > warn > pass. Configurable priority.

Configuration

return [
    'enabled' => env('PLG_CURRICULUM_STRUCTURE_ENABLED', true),
    'tree' => ['max_depth' => 2, 'path_separator' => ' > '],
    'audit_checklist' => [/* 6 keys */],
    'verdict_priority' => ['fail' => 0, 'warn' => 1, 'pass' => 2],
];

Usage

$nodes = Chapter::all()->map(fn ($c) => ChapterNode::fromArray($c->toArray()))->all();

$ancestors = (new ChapterTreeTraversal)->ancestors($nodes, $chapter->id);
$path = ChapterPathBuilder::fromConfig(config('curriculum-structure'))->build($nodes, $chapter->id);
$verdict = AuditVerdictAggregator::fromConfig(config('curriculum-structure'))
    ->aggregateByChecklist($providerResults);

Origin

Extracted from exam.how's Chapter Model + ChapterStructureAuditService (562 LOC). Only model-free Pure parts kept; LLM/external API calls remain in project.

Plugin Relationships

• Used by QuestionGeneration (Layer 3) for chapter context
• Used by ContentReview for audit verdict workflow

Roadmap (Phase 3+)

• Standard Chapter / Subject / Course Model + Migration (opt-in)
• Filament Resource (chapter tree editor)
• LLM provider integration
• Depth validation + sort_order auto-correction

License

MIT

Demos

• Platform 관리자 패널에서 메타 확인 🔒 Login required
• 사용 예시 (PHP)

---

🛒 View on Plugin Store: store.codebase.how/plugins/curriculum-structure