본문으로 건너뛰기

QuestionGeneration

문제 생성 — RenderStatus enum + template scope resolver + rendering meta validator

상태​

항목값
Layercomposite
TierL1
Statusdeprecated
Version0.9.0
가격Free (free)
**카�
�고리**Learning

개요​

⛔ Deprecated (ADR-039 사례 10)​

ADR-039: Plugin Scope 원칙 적용 — 단일 도메인 전용 plugin 부적격 판정.

부적격 근거​

시험 문제 도메인 — RenderingMetaValidator 의 question_type/interaction_type/visual_type/layout_need/render_modes/render_template_key 메타 + TemplateScopeResolver 의 profile→lesson→course→grade→grade_band→subject→common 5계층은 exam.how 한국 시험 문제 양식 한정.

현재 상태 (중요)​

⚠️ 'SaaS 이전' 작� 불필요. 본 plugin 의 원본 코드는 추출 작� 중에 exam.how 코드에 그대로 남아있습니다.

  • 원본 위치: workspace/exam.how/web/app/Services/QuestionGenerationService.php (외 Model/Resolver)
  • plugin 추출본: platform/web/laravel/plugins/QuestionGeneration/ (Phase 1+2 추출만 완료, Phase 4 어댑터 미진행)
  • exam.how 의 동작: 추출 작� 이후에도 자기 코드를 그대로 사용 중 (변경 없음)

Deprecated 의 의미​

  • ❌ 본 plugin 추출본을 더 이상 발전시키지 않음 (Phase 3 / Phase 4 진행 안 함)
  • ❌ plugin store 카탈로그 � �출 안 함 (운영자 검색 결과에서 숨김)
  • � exam.how 의 원본 코드는 그대로 사용 — 변경 불필요
  • � plugin 폴더는 reference 로 보존 (다른 SaaS 가 유사 기능 작성 시 참고용)

다른 SaaS 가 유사 기능을 만든다면​

본 plugin 폴더의 Pure 코드를 참고해서 자기 SaaS 의 app/Sites/{Name}/ 안에 자체 구현. plugin 으로 활용하지 않음.

이력​

  • 2026-04-30: QuestionGeneration plugin RC 0.9.0 추출 (exam.how 출처)
  • 2026-05-02: ADR-039 적용 — deprecated. exam.how 원본 코드는 그대로 사용 (이전 작� 불필요).

(이전) 개요​

개요​

QuestionGeneration 은 multi-saas-kit 의 Layer 2 Composite Plugin � 니다. exam.how 의 Template Gallery + question-generation-footer 정� 을 표준화한 plugin.

핵심 컴포넌트​

RenderStatus (enum)​

exam.how 의 문제 렌더 상태:

  • READY — 렌더러 존재, 학생 공개 가능
  • TEMPLATE_MISSING — � �플릿 개발 필요 (품질 실패 아님!)
  • NEEDS_MAPPING — � �플릿 존재하지만 매핑 미정

TemplateScopeResolver (Pure)​

좁은 → 넓은 범위 매칭 fallback:

profile → lesson → course → grade → grade_band → subject → common

context 매칭 (profile=10, lesson=20, ...) 없으면 다음 scope 로 자동 진행.

RenderingMetaValidator (Pure)​

exam.how 의 question-generation-footer 가 요구하는 rendering 객체 검증:

  • 필수 필드: question_type, interaction_type, visual_type, render_modes, render_status
  • canPublishToStudents(): render_status=ready 만 학생 공개 가능

출처​

exam.how 의 QuestionGenerationService + Template Gallery + question-generation-footer PromptTemplate 정� 추출.

의존성​

  • CurriculumStructure — chapter context 로 문제 생성

라이선스​

MIT

의존성​

데모​

🛒 Plugin Store에서 보기: store.codebase.how/plugins/question-generation