@utopia-studio-design/design-system-cli 0.7.1 → 0.8.0

package/data/ui-parts/blocks/ux-pattern-examples/workflow-definitions.ts

@@ -0,0 +1,1291 @@
+import { L, type Copy } from "./workflow-copy";
+export type FieldDefinition = {
+  id: string;
+  label: Copy;
+  type?:
+    | "text"
+    | "email"
+    | "date"
+    | "time"
+    | "number"
+    | "url"
+    | "textarea"
+    | "select"
+    | "multi-select"
+    | "check"
+    | "file";
+  options?: Copy[];
+  required?: boolean;
+  minLength?: number;
+  min?: number;
+  max?: number;
+  accept?: string;
+};
+export type WorkflowDefinition = {
+  id: string;
+  exportName: string;
+  sources: string[];
+  category: string;
+  title: Copy;
+  description: Copy;
+  kind:
+    | "form"
+    | "table"
+    | "dashboard"
+    | "checklist"
+    | "rating"
+    | "media"
+    | "progress"
+    | "allocation"
+    | "settings"
+    | "articles"
+    | "welcome"
+    | "guard";
+  states: string[];
+  fields?: FieldDefinition[];
+  columns?: Copy[];
+  rows?: Copy[][];
+  tabs?: Copy[];
+  tabStatuses?: Copy[];
+  checks?: Copy[];
+  action?: Copy;
+  next?: string;
+  related?: string[];
+};
+const f = (
+  id: string,
+  label: Copy,
+  type: FieldDefinition["type"] = "text",
+  extra: Partial<FieldDefinition> = {}
+): FieldDefinition => ({ id, label, type, required: true, ...extra });
+const name = f("name", L("Full name", "이름", "الاسم الكامل"));
+const email = f("email", L("Email", "이메일", "البريد الإلكتروني"), "email");
+const organization = f("organization", L("Organization", "조직", "المؤسسة"));
+const region = f("region", L("Region", "지역", "المنطقة"), "select", {
+  options: [
+    L("Europe", "유럽", "أوروبا"),
+    L("Asia Pacific", "아시아 태평양", "آسيا والمحيط الهادئ"),
+    L("Americas", "미주", "الأمريكتان"),
+    L("Middle East", "중동", "الشرق الأوسط"),
+  ],
+});
+const timezone = f(
+  "timezone",
+  L("Time zone", "시간대", "المنطقة الزمنية"),
+  "select",
+  {
+    options: [
+      L("Asia/Seoul", "Asia/Seoul", "Asia/Seoul"),
+      L("Asia/Qatar", "Asia/Qatar", "Asia/Qatar"),
+      L("Europe/London", "Europe/London", "Europe/London"),
+    ],
+  }
+);
+const languages = f("languages", L("Languages", "언어", "اللغات"), "multi-select", {
+  options: [
+    L("English", "영어", "الإنجليزية"),
+    L("Korean", "한국어", "الكورية"),
+    L("Arabic", "아랍어", "العربية"),
+  ],
+});
+const specialty = f(
+  "specialty",
+  L("Specialty", "전문 분야", "التخصص"),
+  "select",
+  {
+    options: [
+      L("Product design", "제품 디자인", "تصميم المنتجات"),
+      L("Research", "리서치", "البحث"),
+      L("Engineering", "엔지니어링", "الهندسة"),
+    ],
+  }
+);
+const biography = f(
+  "bio",
+  L("Short biography", "짧은 소개", "نبذة قصيرة"),
+  "textarea",
+  { minLength: 30 }
+);
+const document = (id: string, label: Copy, required = true) =>
+  f(id, label, "file", { accept: ".pdf,.png,.jpg,.jpeg", required });
+const photo = f(
+  "photo",
+  L("Profile photo", "프로필 사진", "صورة الملف"),
+  "file",
+  { accept: "image/png,image/jpeg", required: false }
+);
+const date = f(
+  "date",
+  L("Scheduled date", "예정 날짜", "التاريخ المحدد"),
+  "date"
+);
+const time = f(
+  "time",
+  L("Scheduled time", "예정 시간", "الوقت المحدد"),
+  "time"
+);
+const title = f("title", L("Title", "제목", "العنوان"));
+const description = f(
+  "description",
+  L("Description", "설명", "الوصف"),
+  "textarea",
+  { minLength: 20 }
+);
+const person = L("Person", "담당자", "الشخص"),
+  status = L("Status", "상태", "الحالة"),
+  when = L("Date", "날짜", "التاريخ"),
+  subject = L("Subject", "항목", "الموضوع");
+const pending = L("Pending", "대기", "معلّق"),
+  active = L("Active", "활성", "نشط"),
+  completed = L("Completed", "완료", "مكتمل");
+const sampleDate = L("2026-09-14", "2026-09-14", "2026-09-14"),
+  alex = L("Alex Kim", "김아름", "أليكس كيم"),
+  noor = L("Noor Ali", "누르 알리", "نور علي");
+const design = L("Design review", "디자인 리뷰", "مراجعة التصميم"),
+  research = L("Research planning", "리서치 계획", "تخطيط البحث");
+const rows = [
+  [design, alex, sampleDate, pending],
+  [research, noor, L("2026-09-16", "2026-09-16", "2026-09-16"), active],
+  [
+    L("Prototype review", "프로토타입 리뷰", "مراجعة النموذج"),
+    alex,
+    L("2026-09-10", "2026-09-10", "2026-09-10"),
+    completed,
+  ],
+];
+const cols = [subject, person, when, status];
+const listDesc = L(
+  "Search and filter records, inspect details and recover from an empty result.",
+  "목록 검색·필터·상세 확인·빈 결과 복구 흐름을 살펴보세요.",
+  "ابحث وصفّ السجلات وافتح التفاصيل وتعافَ من النتائج الفارغة."
+);
+const formDesc = L(
+  "Complete the fields, inspect validation and review the local result.",
+  "입력·검증·결과 확인을 체험하는 폼 흐름입니다.",
+  "أكمل الحقول واختبر التحقق وراجع النتيجة المحلية."
+);
+const table = (
+  id: string,
+  exportName: string,
+  source: string,
+  title: Copy,
+  category = "operations",
+  extra: Partial<WorkflowDefinition> = {}
+): WorkflowDefinition => ({
+  id,
+  exportName,
+  sources: [source],
+  category,
+  title,
+  description: listDesc,
+  kind: "table",
+  states: ["default", "empty", "load-error"],
+  columns: cols,
+  rows,
+  ...extra,
+});
+const form = (
+  id: string,
+  exportName: string,
+  source: string,
+  title: Copy,
+  fields: FieldDefinition[],
+  extra: Partial<WorkflowDefinition> = {}
+): WorkflowDefinition => ({
+  id,
+  exportName,
+  sources: [source],
+  category: "onboarding",
+  title,
+  description: formDesc,
+  kind: "form",
+  states: ["default", "validation", "success"],
+  fields,
+  ...extra,
+});
+
+/** Source-linked compositions. Product names, permissions and fixture prices are not host policy. */
+export const workflowDefinitions: WorkflowDefinition[] = [
+  {
+    id: "account-protection-01",
+    exportName: "AccountProtectionExample",
+    sources: ["account-locked"],
+    category: "account",
+    title: L("Account protection", "계정 보호", "حماية الحساب"),
+    description: L(
+      "Attempt limits, suspicious devices and sensitive-action reauthentication.",
+      "시도 제한·의심 기기·중요 작업 재인증 흐름입니다.",
+      "حدود المحاولات والأجهزة المشبوهة وإعادة التحقق."
+    ),
+    kind: "guard",
+    states: ["attempts", "suspicious", "device-code", "confirm-action"],
+  },
+  {
+    id: "welcome-01",
+    exportName: "WelcomeExample",
+    sources: ["account-welcome"],
+    category: "account",
+    title: L(
+      "Welcome and next step",
+      "가입 완료와 다음 단계",
+      "الترحيب والخطوة التالية"
+    ),
+    description: L(
+      "Continue to profile setup or skip it without losing your destination.",
+      "프로필 설정을 계속하거나 나중에 진행하는 완료 화면입니다.",
+      "تابع إعداد الملف أو أجّله مع الحفاظ على وجهتك."
+    ),
+    kind: "welcome",
+    states: ["default", "redirect"],
+    next: "profile-setup-01",
+  },
+  {
+    id: "setup-progress-01",
+    exportName: "SetupProgressExample",
+    sources: ["account-onboarding"],
+    category: "onboarding",
+    title: L("Setup progress", "설정 진행 상황", "تقدم الإعداد"),
+    description: L(
+      "Ordered steps, locked prerequisites and review-pending recovery.",
+      "단계 순서·선행 조건·검토 대기를 보여주는 진행 패턴입니다.",
+      "خطوات مرتبة ومتطلبات سابقة وحالة انتظار المراجعة."
+    ),
+    kind: "progress",
+    states: ["default", "midway", "review", "complete"],
+    checks: [
+      L("Profile", "프로필", "الملف"),
+      L("Credentials", "자격 정보", "المؤهلات"),
+      L("Agreements", "약정", "الاتفاقيات"),
+      L("Orientation", "사용 안내", "الإرشادات"),
+    ],
+    related: [
+      "profile-setup-01",
+      "credentials-01",
+      "agreements-01",
+      "orientation-01",
+    ],
+  },
+  form(
+    "profile-setup-01",
+    "ProfileSetupExample",
+    "account-onboarding-profile",
+    L("Profile setup", "프로필 설정", "إعداد الملف"),
+    [name, email, photo, languages, region, timezone],
+    { states: ["default", "expert", "organization", "validation", "success"] }
+  ),
+  form(
+    "credentials-01",
+    "CredentialsExample",
+    "account-onboarding-credentials",
+    L("Credentials and documents", "자격 정보와 증빙", "المؤهلات والمستندات"),
+    [
+      f(
+        "registration",
+        L("Registration number", "등록 번호", "رقم التسجيل"),
+        "text",
+        { minLength: 4 }
+      ),
+      organization,
+      region,
+      specialty,
+      f("program", L("Training programme", "교육 프로그램", "برنامج التدريب")),
+      f("supervisor", L("Supervisor", "책임자", "المشرف")),
+      f(
+        "experience",
+        L("Experience level", "경험 수준", "مستوى الخبرة"),
+        "select",
+        {
+          options: [
+            L("Beginner", "입문", "مبتدئ"),
+            L("Intermediate", "중급", "متوسط"),
+            L("Advanced", "고급", "متقدم"),
+          ],
+        }
+      ),
+    ],
+    { states: ["default", "expert", "organization", "validation", "success"] }
+  ),
+  form(
+    "agreements-01",
+    "AgreementsExample",
+    "account-onboarding-legal",
+    L("Agreement collection", "약정 수집", "جمع الاتفاقيات"),
+    [
+      document(
+        "agreement",
+        L("Signed agreement", "서명된 약정", "الاتفاقية الموقعة")
+      ),
+    ],
+    { states: ["default", "expert", "organization", "validation", "success"] }
+  ),
+  {
+    id: "orientation-01",
+    exportName: "OrientationExample",
+    sources: ["account-onboarding-orientation"],
+    category: "onboarding",
+    title: L(
+      "Orientation and acknowledgements",
+      "사용 안내와 확인",
+      "التوجيه والإقرار"
+    ),
+    description: L(
+      "Read or preview guidance and explicitly acknowledge each topic.",
+      "안내를 읽고 각 항목을 명시적으로 확인합니다.",
+      "راجع الإرشادات وأقرّ بكل موضوع بوضوح."
+    ),
+    kind: "checklist",
+    states: ["default", "expert", "complete"],
+    checks: [
+      L("Getting started", "시작 방법", "البدء"),
+      L("Information handling", "정보 취급", "التعامل مع المعلومات"),
+      L("Preparation expectations", "준비 사항", "متطلبات التحضير"),
+      L("Structured feedback", "체계적인 피드백", "الملاحظات المنظمة"),
+    ],
+  },
+  form(
+    "plan-selection-01",
+    "PlanSelectionExample",
+    "account-onboarding-orientation",
+    L("Plan comparison", "플랜 비교", "مقارنة الخطط"),
+    [
+      f("tier", L("Plan", "플랜", "الخطة"), "select", {
+        options: [
+          L("Starter", "스타터", "بداية"),
+          L("Growth", "그로스", "نمو"),
+          L("Scale", "스케일", "توسع"),
+          L("Enterprise", "엔터프라이즈", "مؤسسات"),
+        ],
+      }),
+    ],
+    { category: "billing" }
+  ),
+  form(
+    "profile-editing-01",
+    "ProfileEditingExample",
+    "portal-trainee-profile",
+    L("Profile editing", "프로필 편집", "تعديل الملف"),
+    [
+      name,
+      email,
+      photo,
+      biography,
+      languages,
+      timezone,
+      specialty,
+      f("timing", L("Preferred availability", "선호 시간", "التوفر المفضل")),
+      f("site", L("Site name", "근무지 이름", "اسم الموقع")),
+      f("address", L("Site address", "근무지 주소", "عنوان الموقع")),
+    ],
+    {
+      category: "settings",
+      sources: [
+        "portal-trainee-profile",
+        "portal-mentor-profile",
+        "portal-sponsor-profile",
+      ],
+      states: ["default", "expert", "organization", "success"],
+    }
+  ),
+  {
+    id: "account-settings-01",
+    exportName: "AccountSettingsExample",
+    sources: [
+      "portal-trainee-settings",
+      "portal-mentor-settings",
+      "portal-sponsor-settings",
+      "admin-settings",
+    ],
+    category: "settings",
+    title: L("Account settings", "계정 설정", "إعدادات الحساب"),
+    description: L(
+      "Account, notifications, security, appearance, devices and closure.",
+      "계정·알림·보안·표시·기기·탈퇴 설정 예시입니다.",
+      "الحساب والإشعارات والأمان والمظهر والأجهزة والإغلاق."
+    ),
+    kind: "settings",
+    states: [
+      "account",
+      "notifications",
+      "security",
+      "appearance",
+      "devices",
+      "closure",
+    ],
+  },
+  form(
+    "booking-request-01",
+    "BookingRequestExample",
+    "portal-trainee-request",
+    L("Booking request", "예약 요청", "طلب حجز"),
+    [
+      f("mode", L("Matching method", "매칭 방법", "طريقة المطابقة"), "select", {
+        options: [
+          L(
+            "Find an available expert",
+            "가능한 전문가 찾기",
+            "العثور على خبير متاح"
+          ),
+          L("Choose a specific expert", "특정 전문가 선택", "اختيار خبير محدد"),
+        ],
+      }),
+      specialty,
+      date,
+      time,
+      f("complexity", L("Complexity", "난이도", "التعقيد"), "select", {
+        options: [L("Standard", "일반", "قياسي"), L("Complex", "복잡", "معقد")],
+      }),
+      f("goals", L("Learning goals", "학습 목표", "أهداف التعلم"), "textarea", {
+        minLength: 20,
+      }),
+      document(
+        "context",
+        L("Supporting files", "참고 파일", "ملفات داعمة"),
+        false
+      ),
+    ],
+    {
+      category: "scheduling",
+      states: ["default", "specific", "no-credits", "validation", "success"],
+    }
+  ),
+  table(
+    "session-list-01",
+    "SessionListExample",
+    "portal-trainee-sessions",
+    L("Session list", "세션 목록", "قائمة الجلسات"),
+    "scheduling",
+    {
+      sources: ["portal-trainee-sessions", "portal-sponsor-sessions"],
+      columns: [title.label, person, when, status],
+      rows: [
+        [L("Design review", "디자인 리뷰", "مراجعة التصميم"), L("Alex Kim", "Alex Kim", "أليكس كيم"), L("2026-09-14", "2026-09-14", "2026-09-14"), L("Scheduled", "예정", "مجدولة")],
+        [L("Research planning", "리서치 계획", "تخطيط البحث"), L("Noor Ali", "Noor Ali", "نور علي"), L("2026-09-16", "2026-09-16", "2026-09-16"), L("Pending", "대기", "معلّقة")],
+        [L("Prototype feedback", "프로토타입 피드백", "ملاحظات النموذج"), L("Alex Kim", "Alex Kim", "أليكس كيم"), L("2026-09-10", "2026-09-10", "2026-09-10"), L("Completed", "완료", "مكتملة")],
+      ],
+      tabStatuses: [L("Scheduled", "예정", "مجدولة"), L("Pending", "대기", "معلّقة"), L("Completed", "완료", "مكتملة")],
+      tabs: [
+        L("Upcoming", "예정", "القادمة"),
+        L("Pending", "대기", "المعلّقة"),
+        L("Past", "지난 세션", "السابقة"),
+      ],
+      related: ["session-detail-01"],
+    }
+  ),
+  table(
+    "session-detail-01",
+    "SessionDetailExample",
+    "portal-trainee-sessions-detail",
+    L("Session preparation", "세션 준비", "التحضير للجلسة"),
+    "scheduling",
+    {
+      states: ["default", "documents", "conversation"],
+      tabs: [
+        L("Alignment", "목표 정리", "المواءمة"),
+        L("Documents", "문서", "المستندات"),
+        L("Conversation", "대화", "المحادثة"),
+      ],
+      related: ["connectivity-check-01", "live-session-01"],
+    }
+  ),
+  table(
+    "request-decision-01",
+    "RequestDecisionExample",
+    "portal-mentor-requests-detail",
+    L("Request decision", "요청 수락과 거절", "قرار الطلب"),
+    "scheduling",
+    {
+      states: ["default", "accepted", "declined"],
+      action: L("Accept request", "요청 수락", "قبول الطلب"),
+    }
+  ),
+  {
+    id: "connectivity-check-01",
+    exportName: "ConnectivityCheckExample",
+    sources: ["portal-trainee-sessions-detail-precheck"],
+    category: "scheduling",
+    title: L("Connectivity pre-check", "연결 사전 점검", "فحص الاتصال"),
+    description: L(
+      "Per-item pass/fail, failure recovery and completion gating. No real device check is performed.",
+      "항목별 통과·실패·복구 흐름입니다. 실제 기기 검사는 수행하지 않습니다.",
+      "نجاح وفشل واسترداد لكل بند. لا يتم فحص جهاز فعلي."
+    ),
+    kind: "checklist",
+    states: ["default", "failed", "complete"],
+    checks: [
+      L(
+        "Device and camera position",
+        "기기와 카메라 위치",
+        "الجهاز وموضع الكاميرا"
+      ),
+      L("Video quality", "영상 품질", "جودة الفيديو"),
+      L("Audio quality", "음성 품질", "جودة الصوت"),
+      L("Bandwidth", "네트워크 속도", "عرض النطاق"),
+      L("Fallback protocol", "연결 장애 대응", "إجراءات انقطاع الاتصال"),
+    ],
+  },
+  {
+    id: "session-feedback-01",
+    exportName: "SessionFeedbackExample",
+    sources: ["portal-trainee-sessions-detail-feedback"],
+    category: "scheduling",
+    title: L("Session feedback", "세션 피드백", "تقييم الجلسة"),
+    description: L(
+      "Rate four dimensions with an optional comment and live average.",
+      "네 가지 항목 평가·의견·실시간 평균을 보여줍니다.",
+      "قيّم أربعة أبعاد مع تعليق اختياري ومتوسط مباشر."
+    ),
+    kind: "rating",
+    states: ["default", "complete"],
+    checks: [
+      L("Expertise", "전문성", "الخبرة"),
+      L("Communication", "소통", "التواصل"),
+      L("Guidance", "안내 품질", "جودة الإرشاد"),
+      L("Professionalism", "전문가 태도", "المهنية"),
+    ],
+  },
+  {
+    id: "structured-assessment-01",
+    exportName: "StructuredAssessmentExample",
+    sources: ["portal-mentor-sessions-detail-assess"],
+    category: "scheduling",
+    title: L("Structured assessment", "구조화된 평가", "تقييم منظم"),
+    description: L(
+      "Five scores, supervision level, detailed feedback, recommendations and draft.",
+      "5개 점수·지도 수준·상세 피드백·권고·임시 저장 흐름입니다.",
+      "خمس درجات ومستوى إشراف وملاحظات وتوصيات ومسودة."
+    ),
+    kind: "rating",
+    states: ["default", "complete"],
+    checks: [
+      L("Technical skill", "기술 역량", "المهارة التقنية"),
+      L("Strategy", "전략", "الاستراتيجية"),
+      L("Knowledge", "지식", "المعرفة"),
+      L("Communication", "소통", "التواصل"),
+      L("Professionalism", "전문가 태도", "المهنية"),
+    ],
+  },
+  table(
+    "verification-queue-01",
+    "VerificationQueueExample",
+    "admin-onboarding",
+    L("Verification queue", "인증 검토 대기열", "قائمة التحقق"),
+    "operations",
+    {
+      columns: [
+        person,
+        L("Role", "역할", "الدور"),
+        L("Waiting hours", "대기 시간", "ساعات الانتظار"),
+        status,
+      ],
+      rows: [
+        [alex, L("Member", "구성원", "عضو"), L("25", "25", "25"), pending],
+        [noor, L("Expert", "전문가", "خبير"), L("52", "52", "52"), active],
+      ],
+      related: ["verification-checklist-01"],
+    }
+  ),
+  {
+    id: "verification-checklist-01",
+    exportName: "VerificationChecklistExample",
+    sources: ["admin-onboarding-detail"],
+    category: "operations",
+    title: L(
+      "Verification checklist",
+      "인증 검토 체크리스트",
+      "قائمة فحص التحقق"
+    ),
+    description: L(
+      "Review evidence and notes; final activation waits for prerequisite checks.",
+      "증빙·메모를 검토하며 선행 확인 후 마지막 활성화가 가능합니다.",
+      "راجع الأدلة والملاحظات قبل خطوة التفعيل النهائية."
+    ),
+    kind: "checklist",
+    states: ["default", "failed", "complete"],
+    checks: [
+      L("Identity", "신원", "الهوية"),
+      L("Registration", "등록", "التسجيل"),
+      L("Affiliation", "소속", "الانتماء"),
+      L("Agreements", "약정", "الاتفاقيات"),
+      L("Hardware readiness", "기기 준비", "جاهزية الأجهزة"),
+      L("Final activation", "최종 활성화", "التفعيل النهائي"),
+    ],
+  },
+  table(
+    "closure-queue-01",
+    "ClosureQueueExample",
+    "admin-closures",
+    L("Completion queue", "완료 처리 대기열", "قائمة الإكمال"),
+    "operations",
+    {
+      action: L(
+        "Close ready session",
+        "준비된 세션 완료",
+        "إغلاق الجلسة الجاهزة"
+      ),
+      columns: [
+        subject,
+        L("Duration", "소요 시간", "المدة"),
+        L("Blocking item", "미완료 항목", "البند المانع"),
+        status,
+      ],
+      rows: [
+        [
+          design,
+          L("2h", "2시간", "ساعتان"),
+          L("Feedback", "피드백", "التقييم"),
+          pending,
+        ],
+        [
+          research,
+          L("1h", "1시간", "ساعة"),
+          L("None", "없음", "لا شيء"),
+          completed,
+        ],
+      ],
+    }
+  ),
+  table(
+    "matching-escalations-01",
+    "MatchingEscalationsExample",
+    "admin-escalations",
+    L("Manual matching", "수동 매칭", "المطابقة اليدوية"),
+    "operations",
+    { action: L("Assign expert", "전문가 배정", "تعيين خبير") }
+  ),
+  table(
+    "device-monitoring-01",
+    "DeviceMonitoringExample",
+    "admin-devices",
+    L("Device monitoring", "기기 모니터링", "مراقبة الأجهزة"),
+    "operations",
+    {
+      columns: [
+        L("Device", "기기", "الجهاز"),
+        L("Site", "위치", "الموقع"),
+        L("Provider", "제공사", "المزود"),
+        status,
+      ],
+      rows: [
+        [
+          L("CAM-001", "CAM-001", "CAM-001"),
+          L("Studio A", "스튜디오 A", "استوديو A"),
+          L("Provider A", "제공사 A", "المزود A"),
+          L("Online", "온라인", "متصل"),
+        ],
+        [
+          L("CAM-002", "CAM-002", "CAM-002"),
+          L("Studio B", "스튜디오 B", "استوديو B"),
+          L("Provider B", "제공사 B", "المزود B"),
+          L("Offline", "오프라인", "غير متصل"),
+        ],
+      ],
+      related: ["provider-connections-01"],
+    }
+  ),
+  table(
+    "provider-connections-01",
+    "ProviderConnectionsExample",
+    "admin-providers",
+    L("Provider connections", "제공사 연결", "اتصالات المزودين"),
+    "operations",
+    {
+      columns: [
+        L("Provider", "제공사", "المزود"),
+        L("API endpoint", "API 주소", "نقطة API"),
+        L("Auth method", "인증 방식", "طريقة المصادقة"),
+        status,
+      ],
+      rows: [
+        [
+          L("Provider A", "제공사 A", "المزود A"),
+          L("api.example.test", "api.example.test", "api.example.test"),
+          L("OAuth", "OAuth", "OAuth"),
+          active,
+        ],
+      ],
+      action: L(
+        "Test example connection",
+        "예시 연결 테스트",
+        "اختبار الاتصال التجريبي"
+      ),
+    }
+  ),
+  table(
+    "incident-tracking-01",
+    "IncidentTrackingExample",
+    "admin-incidents",
+    L("Incident tracking", "이슈 추적", "تتبع الحوادث"),
+    "operations",
+    {
+      columns: [subject, L("Severity", "심각도", "الشدة"), person, status],
+      rows: [
+        [
+          L("Connection interrupted", "연결 끊김", "انقطاع الاتصال"),
+          L("High", "높음", "عالية"),
+          alex,
+          pending,
+        ],
+        [
+          L("File unavailable", "파일 접근 불가", "الملف غير متاح"),
+          L("Medium", "보통", "متوسطة"),
+          noor,
+          completed,
+        ],
+      ],
+      action: L("Mark resolved", "해결로 표시", "وضع علامة محلول"),
+    }
+  ),
+  table(
+    "audit-log-01",
+    "AuditLogExample",
+    "admin-audit",
+    L("Audit trail", "변경 이력", "سجل التدقيق"),
+    "operations",
+    {
+      columns: [
+        L("Action", "작업", "الإجراء"),
+        person,
+        when,
+        L("Detail", "상세", "التفاصيل"),
+      ],
+      rows: [
+        [
+          L("Profile verified", "프로필 확인", "تم التحقق من الملف"),
+          alex,
+          sampleDate,
+          L("Evidence reviewed", "증빙 검토", "تمت مراجعة الأدلة"),
+        ],
+        [
+          L("Status changed", "상태 변경", "تغيير الحالة"),
+          noor,
+          sampleDate,
+          completed,
+        ],
+      ],
+    }
+  ),
+  table(
+    "subscriptions-01",
+    "SubscriptionsExample",
+    "admin-subscriptions",
+    L("Subscriptions", "구독 목록", "الاشتراكات"),
+    "billing",
+    {
+      columns: [
+        organization.label,
+        L("Plan", "플랜", "الخطة"),
+        L("Credits", "크레딧", "الرصيد"),
+        status,
+      ],
+      rows: [
+        [
+          L("North Studio", "노스 스튜디오", "استوديو نورث"),
+          L("Growth", "그로스", "نمو"),
+          L("80 / 100", "80 / 100", "80 / 100"),
+          active,
+        ],
+      ],
+      related: ["subscription-create-01", "subscription-detail-01"],
+    }
+  ),
+  form(
+    "subscription-create-01",
+    "SubscriptionCreateExample",
+    "admin-subscriptions-new",
+    L("Create subscription", "구독 생성", "إنشاء اشتراك"),
+    [
+      organization,
+      name,
+      email,
+      f("tier", L("Plan", "플랜", "الخطة"), "select", {
+        options: [
+          L("Starter", "스타터", "بداية"),
+          L("Growth", "그로스", "نمو"),
+          L("Scale", "스케일", "توسع"),
+        ],
+      }),
+      f("credits", L("Credits", "크레딧", "الرصيد"), "number", { min: 1 }),
+      f("fee", L("Access fee", "이용료", "رسوم الوصول"), "number", { min: 0 }),
+      date,
+    ],
+    { category: "billing", related: ["credit-allocation-01"] }
+  ),
+  {
+    id: "credit-allocation-01",
+    exportName: "CreditAllocationExample",
+    sources: ["admin-subscriptions-detail-allocate"],
+    category: "billing",
+    title: L("Credit allocation", "크레딧 배분", "توزيع الرصيد"),
+    description: L(
+      "Allocate a shared pool across people with an overspend guard and running totals.",
+      "공유 잔액을 배분하며 초과 배분 방지·합계를 확인합니다.",
+      "وزّع الرصيد المشترك مع منع التجاوز وإجماليات مباشرة."
+    ),
+    kind: "allocation",
+    states: ["default", "over-budget", "complete"],
+  },
+  table(
+    "payment-cycle-01",
+    "PaymentCycleExample",
+    "admin-payments",
+    L("Payment cycle", "지급 처리", "دورة الدفع"),
+    "billing",
+    {
+      columns: [
+        person,
+        L("Sessions", "세션", "الجلسات"),
+        L("Amount", "금액", "المبلغ"),
+        status,
+      ],
+      rows: [
+        [
+          alex,
+          L("3", "3", "3"),
+          L("900", "900", "900"),
+          L("Queued", "대기", "في الانتظار"),
+        ],
+        [
+          noor,
+          L("2", "2", "2"),
+          L("600", "600", "600"),
+          L("Invoiced", "청구됨", "مفوتر"),
+        ],
+      ],
+      action: L("Advance payment status", "지급 단계 진행", "تقدم حالة الدفع"),
+    }
+  ),
+  table(
+    "credit-transactions-01",
+    "CreditTransactionsExample",
+    "admin-transactions",
+    L("Credit transactions", "크레딧 거래 이력", "معاملات الرصيد"),
+    "billing",
+    {
+      columns: [
+        when,
+        L("Type", "유형", "النوع"),
+        person,
+        L("Credit change", "크레딧 증감", "تغير الرصيد"),
+      ],
+      rows: [
+        [
+          sampleDate,
+          L("Allocated", "배분", "توزيع"),
+          alex,
+          L("+5", "+5", "+5"),
+        ],
+        [
+          sampleDate,
+          L("Consumed", "사용", "استهلاك"),
+          noor,
+          L("-1", "-1", "-1"),
+        ],
+      ],
+    }
+  ),
+  table(
+    "invoices-01",
+    "InvoicesExample",
+    "portal-sponsor-billing",
+    L("Invoices and receipts", "청구서와 영수증", "الفواتير والإيصالات"),
+    "billing",
+    {
+      columns: [
+        L("Invoice", "청구서", "الفاتورة"),
+        when,
+        L("Amount", "금액", "المبلغ"),
+        status,
+      ],
+      rows: [
+        [
+          L("INV-001", "INV-001", "INV-001"),
+          sampleDate,
+          L("1200", "1200", "1200"),
+          L("Paid", "결제 완료", "مدفوع"),
+        ],
+      ],
+    }
+  ),
+  table(
+    "team-allocations-01",
+    "TeamAllocationsExample",
+    "portal-sponsor-trainees",
+    L("Team allocations", "팀 배분 현황", "توزيعات الفريق"),
+    "directory",
+    {
+      columns: [
+        person,
+        L("Allocated", "배분", "المخصص"),
+        L("Consumed", "사용", "المستهلك"),
+        L("Remaining", "잔액", "المتبقي"),
+      ],
+      rows: [
+        [alex, L("10", "10", "10"), L("3", "3", "3"), L("7", "7", "7")],
+        [noor, L("8", "8", "8"), L("5", "5", "5"), L("3", "3", "3")],
+      ],
+      related: ["credit-allocation-01"],
+    }
+  ),
+  ...(
+    [
+      [
+        "personal-overview-01",
+        "PersonalOverviewExample",
+        "portal-trainee",
+        L("Personal overview", "개인 현황", "نظرة شخصية"),
+      ],
+      [
+        "expert-overview-01",
+        "ExpertOverviewExample",
+        "portal-mentor",
+        L(
+          "Requests and schedule overview",
+          "요청과 일정 현황",
+          "نظرة الطلبات والجدول"
+        ),
+      ],
+      [
+        "subscription-detail-01",
+        "SubscriptionDetailExample",
+        "admin-subscriptions-detail",
+        L("Subscription overview", "구독 현황", "نظرة الاشتراك"),
+      ],
+      [
+        "credit-balance-01",
+        "CreditBalanceExample",
+        "portal-trainee-credits",
+        L("Credit balance and history", "크레딧 잔액과 내역", "الرصيد والسجل"),
+      ],
+      [
+        "skill-progression-01",
+        "SkillProgressionExample",
+        "portal-trainee-competency",
+        L("Progress and milestones", "성장과 마일스톤", "التقدم والمراحل"),
+      ],
+      [
+        "analytics-01",
+        "AnalyticsExample",
+        "admin-analytics",
+        L(
+          "Analytics and risk signals",
+          "분석과 위험 신호",
+          "التحليلات وإشارات المخاطر"
+        ),
+      ],
+    ] as const
+  ).map(
+    ([id, exportName, source, title]): WorkflowDefinition => ({
+      id,
+      exportName,
+      sources:
+        source === "admin-subscriptions-detail"
+          ? [source, "portal-sponsor"]
+          : [source],
+      category: "dashboard",
+      title,
+      description: L(
+          "Summary measures, trends and linked records for the current task.",
+          "현재 작업의 요약·추세·연결된 내역을 보여줍니다.",
+          "مقاييس موجزة واتجاهات وسجلات مرتبطة بالمهمة الحالية."
+      ),
+      kind: "dashboard",
+      states: ['personal-overview-01','subscription-detail-01','credit-balance-01'].includes(id) ? ["default", "empty", "low-balance"] : ['default','empty'],
+      columns: cols,
+      rows,
+      related:
+        id === "expert-overview-01"
+          ? ["request-decision-01", "session-list-01"]
+          : id === "skill-progression-01"
+          ? ["structured-assessment-01"]
+          : ["credit-allocation-01", "session-list-01"],
+    })
+  ),
+  table(
+    "broadcast-management-01",
+    "BroadcastManagementExample",
+    "admin-broadcasts",
+    L("Broadcast management", "방송 관리", "إدارة البث"),
+    "media",
+    {
+      columns: [title.label, person, when, status],
+      rows: [
+        [design, alex, sampleDate, L("Draft", "초안", "مسودة")],
+        [research, noor, sampleDate, L("Live", "방송 중", "مباشر")],
+      ],
+      action: L("Advance broadcast state", "방송 상태 진행", "تقدم حالة البث"),
+      related: ["broadcast-schedule-01", "broadcast-viewer-01"],
+    }
+  ),
+  form(
+    "broadcast-schedule-01",
+    "BroadcastScheduleExample",
+    "admin-broadcasts-new",
+    L("Schedule a broadcast", "방송 일정 만들기", "جدولة بث"),
+    [
+      title,
+      description,
+      f("host", L("Host", "진행자", "المضيف"), "select", {
+        options: [alex, noor],
+      }),
+      date,
+      time,
+      f(
+        "duration",
+        L("Duration (minutes)", "소요 시간(분)", "المدة بالدقائق"),
+        "number",
+        { min: 1, max: 480 }
+      ),
+      f("access", L("Audience", "공개 대상", "الجمهور"), "select", {
+        options: [
+          L("Everyone", "전체", "الجميع"),
+          L("Selected group", "선택한 그룹", "مجموعة محددة"),
+          L("Invited only", "초대된 사람", "المدعوون فقط"),
+        ],
+      }),
+    ],
+    { category: "media" }
+  ),
+  table(
+    "media-library-01",
+    "MediaLibraryExample",
+    "portal-tv",
+    L("Media library", "미디어 라이브러리", "مكتبة الوسائط"),
+    "media",
+    {
+      tabs: [
+        L("Live", "방송 중", "مباشر"),
+        L("Upcoming", "예정", "القادمة"),
+        L("Past", "지난 방송", "السابقة"),
+      ],
+      related: ["broadcast-viewer-01"],
+    }
+  ),
+  {
+    id: "broadcast-viewer-01",
+    exportName: "BroadcastViewerExample",
+    sources: ["portal-tv-detail"],
+    category: "media",
+    title: L("Broadcast viewer", "방송 시청", "مشاهدة البث"),
+    description: L(
+      "Receive-only viewing with scheduled reminders and ended states.",
+      "예약 알림·종료 상태를 포함한 시청 전용 흐름입니다.",
+      "مشاهدة فقط مع تذكيرات الجدولة وحالة الانتهاء."
+    ),
+    kind: "media",
+    states: ["scheduled", "live", "ended"],
+  },
+  {
+    id: "live-session-01",
+    exportName: "LiveSessionExample",
+    sources: ["portal-sessions-detail-live"],
+    category: "media",
+    title: L("Live collaboration", "실시간 협업", "التعاون المباشر"),
+    description: L(
+      "Participants, microphone state, incident notes and connection recovery.",
+      "참가자·마이크 상태·이슈 메모·연결 복구를 체험합니다.",
+      "مشاركون وحالة الميكروفون وملاحظات الحوادث واسترداد الاتصال."
+    ),
+    kind: "media",
+    states: ["live", "connection-lost", "ended"],
+  },
+  {
+    id: "article-library-01",
+    exportName: "ArticleLibraryExample",
+    sources: ["marketing-blog"],
+    category: "content",
+    title: L("Article library", "아티클 목록", "مكتبة المقالات"),
+    description: L(
+      "Category filtering, featured content, reading and newsletter signup.",
+      "카테고리 필터·추천 글·본문·뉴스레터 구독 흐름입니다.",
+      "تصفية الفئات والمحتوى المميز والقراءة والاشتراك."
+    ),
+    kind: "articles",
+    states: ["default", "empty"],
+    tabs: [
+      L("All", "전체", "الكل"),
+      L("Education", "교육", "التعليم"),
+      L("Technology", "기술", "التقنية"),
+    ],
+  },
+  {
+    id: "product-introduction-01",
+    exportName: "ProductIntroductionExample",
+    sources: ["marketing"],
+    category: "content",
+    title: L(
+      "Product introduction and FAQ",
+      "제품 소개와 FAQ",
+      "مقدمة المنتج والأسئلة"
+    ),
+    description: L(
+      "Role-based features, proof points, FAQ disclosure and a next action.",
+      "역할별 기능·근거·FAQ 펼치기·다음 행동으로 구성됩니다.",
+      "ميزات حسب الدور ودلائل وأسئلة قابلة للتوسيع وخطوة تالية."
+    ),
+    kind: "articles",
+    states: ["default"],
+    tabs: [
+      L("For members", "구성원용", "للأعضاء"),
+      L("For experts", "전문가용", "للخبراء"),
+      L("For teams", "팀용", "للفرق"),
+    ],
+    related: ["contact-form-01"],
+  },
+  form(
+    "contact-form-01",
+    "ContactFormExample",
+    "marketing-contact",
+    L("Contact and enquiry", "문의하기", "التواصل والاستفسار"),
+    [
+      name,
+      email,
+      f("subject", L("Subject", "문의 주제", "الموضوع"), "text", {
+        required: false,
+      }),
+      f("message", L("Message", "문의 내용", "الرسالة"), "textarea"),
+    ],
+    { category: "content" }
+  ),
+  {
+    id: "loading-recovery-01",
+    exportName: "LoadingRecoveryExample",
+    sources: [
+      "error",
+      "not-found",
+      "loading",
+      "portal-loading",
+      "admin-loading",
+    ],
+    category: "system",
+    title: L("Loading and recovery", "로딩과 오류 복구", "التحميل والاسترداد"),
+    description: L(
+      "Loading, empty, missing-page and retryable error states.",
+      "로딩·빈 상태·없는 페이지·재시도 가능한 오류를 보여줍니다.",
+      "حالات تحميل وفراغ وصفحة مفقودة وخطأ قابل لإعادة المحاولة."
+    ),
+    kind: "guard",
+    states: ["loading", "empty", "not-found", "load-error"],
+  },
+];
+
+export function fieldsFor(
+  definition: WorkflowDefinition,
+  state: string
+): FieldDefinition[] {
+  const fields = definition.fields ?? [];
+  if (["profile-setup-01", "profile-editing-01"].includes(definition.id)) {
+    if (state === "organization")
+      return [
+        organization,
+        name,
+        email,
+        f("website", L("Website", "웹사이트", "الموقع"), "url", {
+          required: false,
+        }),
+        region,
+        languages,
+        timezone,
+      ];
+    if (state === "expert")
+      return [
+        name,
+        email,
+        { ...photo, required: true },
+        biography,
+        languages,
+        region,
+        timezone,
+        specialty,
+        f("availability", L("Availability", "가능 시간", "التوفر"), 'multi-select', {options: [L('Monday morning','월요일 오전','صباح الاثنين'), L('Tuesday afternoon','화요일 오후','بعد ظهر الثلاثاء'), L('Wednesday morning','수요일 오전','صباح الأربعاء')]}),
+        f("rate", L("Hourly rate", "시간당 요금", "السعر بالساعة"), "number", {
+          min: 0,
+        }),
+      ];
+  }
+  if (definition.id === "credentials-01") {
+    if (state === "organization")
+      return [
+        f("industry", L("Industry", "산업", "القطاع")),
+        description,
+        f("count", L("Participants", "참여 인원", "عدد المشاركين"), "number", {
+          min: 1,
+        }),
+        specialty,
+        region,
+      ];
+    if (state === "expert")
+      return [
+        f("title", L("Professional title", "직함", "المسمى المهني")),
+        organization,
+        fields[0],
+        region,
+        specialty,
+        f(
+          "volume",
+          L("Annual volume", "연간 활동 수", "الحجم السنوي"),
+          "number",
+          { min: 0 }
+        ),
+        f("insurance", L("Insurance provider", "보험 제공사", "شركة التأمين")),
+        f("policy", L("Policy number", "증권 번호", "رقم الوثيقة")),
+        f(
+          "expiry",
+          L("Policy expiry", "보험 만료일", "انتهاء الوثيقة"),
+          "date"
+        ),
+        document(
+          "affiliation",
+          L("Affiliation letter", "소속 증명서", "خطاب الانتماء")
+        ),
+        document(
+          "cv",
+          L("CV (optional)", "이력서(선택)", "السيرة الذاتية (اختياري)"),
+          false
+        ),
+      ];
+  }
+  if (definition.id === "agreements-01") {
+    if (state === "expert")
+      return [
+        document(
+          "agreement",
+          L(
+            "Signed service agreement",
+            "서명된 서비스 약정",
+            "اتفاقية الخدمة الموقعة"
+          )
+        ),
+        document(
+          "nda",
+          L(
+            "Signed confidentiality agreement",
+            "서명된 비밀유지 약정",
+            "اتفاقية السرية الموقعة"
+          )
+        ),
+      ];
+    if (state === "organization")
+      return [
+        f("terms", L("Accept terms", "이용 약관 동의", "قبول الشروط"), "check"),
+        f(
+          "privacy",
+          L(
+            "Accept privacy policy",
+            "개인정보 정책 동의",
+            "قبول سياسة الخصوصية"
+          ),
+          "check"
+        ),
+        f(
+          "dpa",
+          L(
+            "Accept data processing agreement",
+            "데이터 처리 약정 동의",
+            "قبول اتفاقية معالجة البيانات"
+          ),
+          "check"
+        ),
+      ];
+  }
+  return fields;
+}