본문으로 건너뛰기

StagePipeline

다단계 파이프라인 — Stage enum + sequential gate + 진행률 (모든 다단계 처리)

상태​

항목값
Layercore
TierL1
Statusreleased
Version1.0.0
가격Free (free)
**카�
�고리**Infrastructure

개요​

개요​

StagePipeline 은 multi-saas-kit 의 Layer 1 Core Plugin � 니다. 다단계 처리 워크플로의 진행 추적 — Stage enum + sequential gate + percent — 을 도메인 무관 Pure 로 제공합니다.

분리선 (ADR-039)​

ADR-039 사례 5 — 기존 ContentGeneration (academy.how Stage 1~3 추출) � � 일반화. 'content' 한정 → 모든 다단계 워크플로 (결제/회원가� /콘� �츠 생성/배포 파이프라인) 활용 가능.

변경: namespace App\Plugins\ContentGeneration → App\Plugins\StagePipeline, slug content-generation → stage-pipeline.

핵심 컴포넌트​

Stage (enum) — 기본값​

  • EXTRACT — 1단계 (� 력 추출)
  • ANALYZE — 2단계 (분석)
  • RENDER — 3단계 (출력 렌더)

도메인별 stage � � 은 SaaS 측 어댑터가 자유롭게 매핑.

StageProgressTracker (Pure)​

  • nextAvailable($completed) — 시퀀� � 게이트 (이전 stage 완료 후만 다음 stage 진� )
  • progress($completed) — completed_count / total / percent / current / next
  • 재귀 prerequisite 검증 — gap 검출 (1번 건너뛰고 3번 못 가게)

활용 시나리오​

  • academy.how: 콘� �츠 생성 파이프라인 (extract → analyze → render)
  • commerce: 주문 처리 (cart → payment → fulfillment → delivery)
  • 회원가� : 단계별 onboarding (signup → verify → profile → preferences)
  • AI 챗봇: 메시지 처리 (intent → tool-use → response)
  • 배포: CI/CD (build → test → stage → deploy)

사용 예시​

use App\Plugins\StagePipeline\Enums\Stage;
use App\Plugins\StagePipeline\Services\StageProgressTracker;

$tracker = new StageProgressTracker;
$result = $tracker->progress([
    Stage::EXTRACT->value => true,
    Stage::ANALYZE->value => true,
    Stage::RENDER->value => false,
]);
// → ['completed_count' => 2, 'total' => 3, 'percent' => 67, 'current' => Stage::RENDER, 'next' => null]

출처​

academy.how Stage 1~3 (extract/analyze/render) 파이프라인 추출 → 일반화.

의존성​

  • core: >=1.1.0

라이선스​

MIT

데모​

🛒 Plugin Store에서 보기: store.codebase.how/plugins/stage-pipeline