프리뷰 UX: 모바일 뷰 E2E 추가

Reviewed-on: #3

.gitea/workflows/ci.yml

@@ -0,0 +1,108 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - feature/**
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: |
+          npm ci
+
+      - name: Generate Prisma Client
+        run: |
+          npx prisma generate
+
+      - name: Run unit tests
+        run: |
+          npm test
+
+      - name: Install Playwright browsers
+        run: |
+          npx playwright install --with-deps
+
+      - name: Run Playwright E2E tests
+        run: |
+          npx playwright test
+
+  pr_and_merge:
+    needs: test
+    # feature/* 브랜치에 push 되었을 때만 실행한다.
+    if: ${{ startsWith(github.ref, 'refs/heads/feature/') }}
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Create or update PR and try auto-merge
+        env:
+          CI_BASE_URL: ${{ secrets.CI_BASE_URL }}
+          CI_TOKEN: ${{ secrets.CI_TOKEN }}
+          CI_OWNER: ${{ secrets.CI_OWNER }}
+          CI_REPO: ${{ secrets.CI_REPO }}
+          BRANCH_REF: ${{ github.ref }}
+          BRANCH_NAME: ${{ github.ref_name }}
+        run: |
+          set -e
+
+          if [ -z "$CI_BASE_URL" ] || [ -z "$CI_TOKEN" ] || [ -z "$CI_OWNER" ] || [ -z "$CI_REPO" ]; then
+            echo "CI_* 시크릿이 설정되지 않아 PR/자동 머지를 건너뜁니다." >&2
+            exit 0
+          fi
+
+          echo "현재 브랜치: $BRANCH_NAME ($BRANCH_REF)"
+
+          # 1) PR 생성 시도 (이미 존재하면 4xx를 허용)
+          create_pr_payload=$(jq -n \
+            --arg title "CI: $BRANCH_NAME" \
+            --arg head "$BRANCH_NAME" \
+            --arg base "main" \
+            '{title: $title, head: $head, base: $base}')
+
+          echo "PR 생성 시도..."
+          curl -sS -X POST \
+            -H "Content-Type: application/json" \
+            -H "Authorization: token $CI_TOKEN" \
+            "$CI_BASE_URL/api/v1/repos/$CI_OWNER/$CI_REPO/pulls" \
+            -d "$create_pr_payload" || true
+
+          # 2) 열린 PR 목록에서 해당 브랜치의 PR 번호를 찾는다.
+          echo "열린 PR 목록 조회..."
+          pr_list=$(curl -sS \
+            -H "Authorization: token $CI_TOKEN" \
+            "$CI_BASE_URL/api/v1/repos/$CI_OWNER/$CI_REPO/pulls?state=open")
+
+          pr_number=$(echo "$pr_list" | jq ".[] | select(.head.ref == \"$BRANCH_NAME\") | .number" | head -n 1)
+
+          if [ -z "$pr_number" ]; then
+            echo "브랜치 $BRANCH_NAME 에 대한 열린 PR을 찾지 못했습니다. 종료합니다."
+            exit 0
+          fi
+
+          echo "브랜치 $BRANCH_NAME 에 대한 PR #$pr_number 발견"
+
+          # 3) main 대상으로 자동 머지 시도
+          merge_payload=$(jq -n '{Do: "merge"}')
+
+          echo "PR #$pr_number 자동 머지 시도..."
+          curl -sS -X POST \
+            -H "Content-Type: application/json" \
+            -H "Authorization: token $CI_TOKEN" \
+            "$CI_BASE_URL/api/v1/repos/$CI_OWNER/$CI_REPO/pulls/$pr_number/merge" \
+            -d "$merge_payload" || true

src/app/editor/page.tsx

@@ -1,7 +1,8 @@
 "use client";
 
 import type { CSSProperties, ReactNode } from "react";
-import { useState } from "react";
+import { useEffect, useState } from "react";
+import Link from "next/link";
 import {
   DndContext,
   PointerSensor,
@@ -36,11 +37,18 @@ export default function EditorPage() {
   const addHeroTemplateSection = useEditorStore((state) => state.addHeroTemplateSection);
   const addFeaturesTemplateSection = useEditorStore((state) => state.addFeaturesTemplateSection);
   const addCtaTemplateSection = useEditorStore((state) => state.addCtaTemplateSection);
+  const addFaqTemplateSection = useEditorStore((state) => state.addFaqTemplateSection);
+  const addPricingTemplateSection = useEditorStore((state) => state.addPricingTemplateSection);
+  const addTestimonialsTemplateSection = useEditorStore((state) => state.addTestimonialsTemplateSection);
   const updateBlock = useEditorStore((state) => state.updateBlock);
   const selectBlock = useEditorStore((state) => state.selectBlock);
   const replaceBlocks = useEditorStore((state) => state.replaceBlocks);
   const reorderBlocks = useEditorStore((state) => state.reorderBlocks);
   const moveBlock = useEditorStore((state) => state.moveBlock);
+  const undo = useEditorStore((state) => state.undo);
+  const redo = useEditorStore((state) => state.redo);
+  const removeBlock = useEditorStore((state) => state.removeBlock);
+  const duplicateBlock = useEditorStore((state) => state.duplicateBlock);
 
   const [editingBlockId, setEditingBlockId] = useState<string | null>(null);
   const [editingText, setEditingText] = useState("");
@@ -197,6 +205,87 @@ export default function EditorPage() {
 
   const rootBlocks = blocks.filter((block) => !block.sectionId);
 
+  // 에디터 전역에서 Undo/Redo 단축키(Cmd/Ctrl+Z, Cmd/Ctrl+Shift+Z),
+  // Delete/Backspace 기반 삭제, Cmd/Ctrl+D 기반 복제,
+  // ArrowUp/ArrowDown을 이용한 선택 블록 이동을 처리한다.
+  useEffect(() => {
+    const handleKeyDown = (event: KeyboardEvent) => {
+      // 방향키로 선택된 블록을 위/아래로 이동 (순서 변경이 아니라 선택만 이동)
+      if (event.key === "ArrowDown" || event.key === "ArrowUp") {
+        const { blocks: currentBlocks, selectedBlockId: currentSelectedId, selectBlock: storeSelectBlock } =
+          (useEditorStore as any).getState();
+
+        if (!currentBlocks.length) return;
+
+        const currentIndex = currentSelectedId
+          ? currentBlocks.findIndex((b: Block) => b.id === currentSelectedId)
+          : -1;
+
+        let nextIndex = currentIndex;
+
+        if (event.key === "ArrowDown") {
+          nextIndex = currentIndex < currentBlocks.length - 1 ? currentIndex + 1 : currentIndex;
+        } else if (event.key === "ArrowUp") {
+          nextIndex = currentIndex > 0 ? currentIndex - 1 : currentIndex;
+        }
+
+        if (nextIndex !== -1 && nextIndex !== currentIndex) {
+          event.preventDefault();
+          const nextId = currentBlocks[nextIndex]?.id;
+          if (nextId) {
+            storeSelectBlock(nextId);
+          }
+        }
+
+        return;
+      }
+
+      const isMac = navigator.platform.toLowerCase().includes("mac");
+      const metaKey = isMac ? event.metaKey : event.ctrlKey;
+
+      // Delete / Backspace 로 선택된 블록 삭제
+      if (event.key === "Delete" || event.key === "Backspace") {
+        const { selectedBlockId: currentSelectedId } = (useEditorStore as any).getState();
+        if (currentSelectedId) {
+          event.preventDefault();
+          removeBlock(currentSelectedId);
+        }
+        return;
+      }
+
+      // Cmd/Ctrl 없는 경우에는 여기서 종료한다.
+      if (!metaKey) return;
+
+      // Cmd/Ctrl + D → 현재 선택된 블록 복제
+      if (event.key.toLowerCase() === "d") {
+        const { selectedBlockId: currentSelectedId } = (useEditorStore as any).getState();
+        if (currentSelectedId) {
+          event.preventDefault();
+          duplicateBlock(currentSelectedId);
+        }
+        return;
+      }
+
+      // Cmd/Ctrl + Shift + Z → Redo
+      if (event.key.toLowerCase() === "z" && event.shiftKey) {
+        event.preventDefault();
+        redo();
+        return;
+      }
+
+      // Cmd/Ctrl + Z → Undo
+      if (event.key.toLowerCase() === "z") {
+        event.preventDefault();
+        undo();
+      }
+    };
+
+    window.addEventListener("keydown", handleKeyDown);
+    return () => {
+      window.removeEventListener("keydown", handleKeyDown);
+    };
+  }, [undo, redo]);
+
   const renderBlocks = (targetBlocks: Block[]) =>
     targetBlocks.map((block) => {
       const isSelected = block.id === selectedBlockId;
@@ -222,8 +311,16 @@ export default function EditorPage() {
   return (
     <main className="min-h-screen flex flex-col bg-slate-950 text-slate-50">
       <header className="border-b border-slate-800 px-6 py-4 flex items-center justify-between">
-        <h1 className="text-xl font-semibold">Page Editor</h1>
-        <p className="text-xs text-slate-400">빌더 MVP용 에디터 페이지 골격</p>
+        <div className="flex items-baseline gap-3">
+          <h1 className="text-xl font-semibold">Page Editor</h1>
+          <p className="text-xs text-slate-400">빌더 MVP용 에디터 페이지 골격</p>
+        </div>
+        <Link
+          href="/preview"
+          className="inline-flex items-center rounded border border-slate-700 bg-slate-900 px-3 py-1 text-xs text-slate-100 hover:bg-slate-800"
+        >
+          프리뷰 열기
+        </Link>
       </header>
       <section className="flex flex-1 overflow-hidden">
         <aside className="w-60 border-r border-slate-800 p-4 text-sm space-y-3">
@@ -279,6 +376,27 @@ export default function EditorPage() {
             >
               CTA 템플릿 추가
             </button>
+            <button
+              type="button"
+              className="w-full rounded border border-slate-700 bg-slate-900 px-3 py-2 text-left text-xs hover:bg-slate-800"
+              onClick={addFaqTemplateSection}
+            >
+              FAQ 템플릿 추가
+            </button>
+            <button
+              type="button"
+              className="w-full rounded border border-slate-700 bg-slate-900 px-3 py-2 text-left text-xs hover:bg-slate-800"
+              onClick={addPricingTemplateSection}
+            >
+              Pricing 템플릿 추가
+            </button>
+            <button
+              type="button"
+              className="w-full rounded border border-slate-700 bg-slate-900 px-3 py-2 text-left text-xs hover:bg-slate-800"
+              onClick={addTestimonialsTemplateSection}
+            >
+              Testimonials 템플릿 추가
+            </button>
           </div>
           <p className="text-xs text-slate-500">
             Text / Image / Button / Section 블록을 이 영역에서 추가할 수 있습니다.
@@ -311,6 +429,22 @@ export default function EditorPage() {
           <h2 className="font-medium mb-2">속성 패널</h2>
           {selectedBlockId ? (
             <div className="space-y-3">
+              <div className="flex gap-2 text-[11px]">
+                <button
+                  type="button"
+                  className="flex-1 rounded border border-slate-700 bg-slate-900 px-2 py-1 text-slate-100 hover:bg-red-900/60 hover:border-red-700"
+                  onClick={() => removeBlock(selectedBlockId)}
+                >
+                  블록 삭제
+                </button>
+                <button
+                  type="button"
+                  className="flex-1 rounded border border-slate-700 bg-slate-900 px-2 py-1 text-slate-100 hover:bg-slate-800"
+                  onClick={() => duplicateBlock(selectedBlockId)}
+                >
+                  블록 복제
+                </button>
+              </div>
               {(() => {
                 const selectedBlock = blocks.find((b) => b.id === selectedBlockId);
                 if (!selectedBlock) return null;

src/app/preview/page.tsx

@@ -0,0 +1,19 @@
+"use client";
+
+import { useEditorStore } from "@/features/editor/state/editorStore";
+import { PublicPageRenderer } from "@/features/editor/components/PublicPageRenderer";
+
+export default function PreviewPage() {
+  const blocks = useEditorStore((state) => state.blocks);
+
+  return (
+    <main className="min-h-screen flex flex-col bg-slate-950 text-slate-50">
+      <header className="border-b border-slate-800 px-6 py-4 flex items-center justify-between">
+        <h1 className="text-xl font-semibold">Page Preview</h1>
+        <p className="text-xs text-slate-400">빌더로 만든 페이지를 미리 보는 화면</p>
+      </header>
+      {/* 에디터 크롬 없이 순수 페이지 형태로 블록들을 렌더링 */}
+      <PublicPageRenderer blocks={blocks} />
+    </main>
+  );
+}

src/features/editor/components/PublicPageRenderer.tsx

@@ -0,0 +1,106 @@
+"use client";
+
+import type { Block, TextBlockProps, ButtonBlockProps, ImageBlockProps, SectionBlockProps } from "@/features/editor/state/editorStore";
+
+// 에디터 크롬 없이 실제 랜딩 페이지처럼 블록들을 렌더링하는 컴포넌트
+interface PublicPageRendererProps {
+  blocks: Block[];
+}
+
+export function PublicPageRenderer({ blocks }: PublicPageRendererProps) {
+  const sectionBlocks = blocks.filter((b) => b.type === "section");
+  const rootBlocks = blocks.filter((b) => !b.sectionId && b.type !== "section");
+
+  const renderBlock = (block: Block) => {
+    if (block.type === "text") {
+      const props = block.props as TextBlockProps;
+
+      const alignClass =
+        props.align === "center" ? "text-center" : props.align === "right" ? "text-right" : "text-left";
+      const sizeClass = props.size === "sm" ? "text-sm" : props.size === "lg" ? "text-2xl" : "text-base";
+
+      return (
+        <p key={block.id} className={`${alignClass} ${sizeClass} text-slate-50 leading-relaxed`}>
+          {props.text}
+        </p>
+      );
+    }
+
+    if (block.type === "button") {
+      const props = block.props as ButtonBlockProps;
+
+      return (
+        <a
+          key={block.id}
+          href={props.href}
+          className="inline-flex items-center justify-center rounded-md bg-sky-600 px-4 py-2 text-sm font-medium text-white hover:bg-sky-500 transition-colors"
+        >
+          {props.label}
+        </a>
+      );
+    }
+
+    if (block.type === "image") {
+      const props = block.props as ImageBlockProps;
+
+      return (
+        <div key={block.id} className="w-full flex justify-center">
+          {/* eslint-disable-next-line @next/next/no-img-element */}
+          <img src={props.src || ""} alt={props.alt} className="max-w-full h-auto object-contain" />
+        </div>
+      );
+    }
+
+    return null;
+  };
+
+  const renderSection = (section: Block) => {
+    const props = section.props as SectionBlockProps;
+
+    const bgClass =
+      props.background === "muted" ? "bg-slate-900" : props.background === "primary" ? "bg-sky-900" : "bg-slate-950";
+
+    const pyClass = props.paddingY === "sm" ? "py-8" : props.paddingY === "lg" ? "py-20" : "py-12";
+
+    const columns = props.columns && props.columns.length > 0 ? props.columns : [{ id: `${section.id}_col`, span: 12 }];
+
+    return (
+      <section key={section.id} className={`${bgClass} ${pyClass}`}>
+        <div className="mx-auto max-w-5xl px-4">
+          <div className="flex gap-8">
+            {columns.map((col) => {
+              const basis = `${(col.span / 12) * 100}%`;
+              const columnBlocks = blocks.filter((b) => b.sectionId === section.id && b.columnId === col.id);
+
+              return (
+                <div key={col.id} className="flex flex-col gap-4" style={{ flexBasis: basis }}>
+                  {columnBlocks.map((b) => (
+                    <div key={b.id}>{renderBlock(b)}</div>
+                  ))}
+                </div>
+              );
+            })}
+          </div>
+        </div>
+      </section>
+    );
+  };
+
+  return (
+    <div className="flex-1 flex flex-col bg-slate-950 text-slate-50">
+      {/* 루트 텍스트/버튼/이미지 블록들이 있다면 페이지 상단에 노출 */}
+      {rootBlocks.length > 0 && (
+        <section className="bg-slate-950 py-12">
+          <div className="mx-auto max-w-3xl px-4 flex flex-col gap-4">
+            {rootBlocks.map((b) => (
+              <div key={b.id}>{renderBlock(b)}</div>
+            ))}
+          </div>
+        </section>
+      )}
+
+      {/* 섹션 블록들 */}
+      {sectionBlocks.map((section) => renderSection(section))}
+    </div>
+  );
+}

src/features/editor/state/editorStore.ts

@@ -51,6 +51,8 @@ export interface Block {
 export interface EditorState {
   blocks: Block[];
   selectedBlockId: string | null;
+  history: Block[][];
+  future: Block[][];
   addTextBlock: () => void;
   addButtonBlock: () => void;
   addImageBlock: () => void;
@@ -58,11 +60,18 @@ export interface EditorState {
   addHeroTemplateSection: () => void;
   addFeaturesTemplateSection: () => void;
   addCtaTemplateSection: () => void;
+  addFaqTemplateSection: () => void;
+  addPricingTemplateSection: () => void;
+  addTestimonialsTemplateSection: () => void;
   updateBlock: (id: string, partial: Partial<TextBlockProps & ButtonBlockProps>) => void;
   selectBlock: (id: string | null) => void;
   replaceBlocks: (blocks: Block[]) => void;
   reorderBlocks: (activeId: string, overId: string) => void;
   moveBlock: (id: string, sectionId: string | null, columnId: string | null) => void;
+  undo: () => void;
+  redo: () => void;
+  removeBlock: (id: string) => void;
+  duplicateBlock: (id: string) => void;
 }
 
 // 간단한 ID 생성기 (추후 uuid 라이브러리로 교체 가능)
@@ -74,6 +83,8 @@ const createId = () => `blk_${Date.now()}_${idCounter++}`;
 const createEditorState = (set: any, get: any): EditorState => ({
     blocks: [],
     selectedBlockId: null,
+    history: [],
+    future: [],
 
     // 텍스트 블록 추가: 기본 텍스트와 함께 생성 후 선택 상태로 만든다
     addTextBlock: () => {
@@ -112,6 +123,8 @@ const createEditorState = (set: any, get: any): EditorState => ({
       set((state: EditorState) => ({
         blocks: [...state.blocks, newBlock],
         selectedBlockId: id,
+        history: [...state.history, blocks],
+        future: [],
       }));
     },
 
@@ -313,6 +326,233 @@ const createEditorState = (set: any, get: any): EditorState => ({
       });
     },
 
+    // FAQ 템플릿 섹션 추가: 질문/답변 쌍이 수직으로 나열된 섹션을 생성한다
+    addFaqTemplateSection: () => {
+      const sectionId = createId();
+
+      const sectionBlock: Block = {
+        id: sectionId,
+        type: "section",
+        props: {
+          background: "default",
+          paddingY: "md",
+          columns: [
+            {
+              id: `${sectionId}_col_1`,
+              span: 12,
+            },
+          ],
+        },
+        sectionId: null,
+        columnId: null,
+      };
+
+      const firstColumnId = `${sectionId}_col_1`;
+
+      const faqPairs = [
+        {
+          question: "자주 묻는 질문 1",
+          answer: "첫 번째 질문에 대한 답변을 여기에 입력하세요.",
+        },
+        {
+          question: "자주 묻는 질문 2",
+          answer: "두 번째 질문에 대한 답변을 여기에 입력하세요.",
+        },
+        {
+          question: "자주 묻는 질문 3",
+          answer: "세 번째 질문에 대한 답변을 여기에 입력하세요.",
+        },
+      ];
+
+      const faqBlocks: Block[] = faqPairs.flatMap((pair) => {
+        const qId = createId();
+        const aId = createId();
+
+        const questionBlock: Block = {
+          id: qId,
+          type: "text",
+          props: {
+            text: pair.question,
+            align: "left",
+            size: "lg",
+          },
+          sectionId,
+          columnId: firstColumnId,
+        };
+
+        const answerBlock: Block = {
+          id: aId,
+          type: "text",
+          props: {
+            text: pair.answer,
+            align: "left",
+            size: "sm",
+          },
+          sectionId,
+          columnId: firstColumnId,
+        };
+
+        return [questionBlock, answerBlock];
+      });
+
+      const lastBlockId = faqBlocks[faqBlocks.length - 1].id;
+
+      set((state: EditorState) => {
+        const newBlocks = [...state.blocks, sectionBlock, ...faqBlocks];
+
+        return {
+          blocks: newBlocks,
+          selectedBlockId: lastBlockId,
+        };
+      });
+    },
+
+    // Pricing 템플릿 섹션 추가: 3컬럼 요금제 카드(플랜 이름/가격/설명)를 생성한다
+    addPricingTemplateSection: () => {
+      const sectionId = createId();
+
+      const columns = [
+        { id: `${sectionId}_col_1`, span: 4 },
+        { id: `${sectionId}_col_2`, span: 4 },
+        { id: `${sectionId}_col_3`, span: 4 },
+      ];
+
+      const sectionBlock: Block = {
+        id: sectionId,
+        type: "section",
+        props: {
+          background: "muted",
+          paddingY: "lg",
+          columns,
+        },
+        sectionId: null,
+        columnId: null,
+      };
+
+      const planDefinitions = [
+        { name: "Basic", price: "₩9,900/월" },
+        { name: "Pro", price: "₩29,900/월" },
+        { name: "Enterprise", price: "문의" },
+      ];
+
+      const pricingBlocks: Block[] = columns.flatMap((col, index) => {
+        const plan = planDefinitions[index] ?? planDefinitions[0];
+
+        const nameId = createId();
+        const priceId = createId();
+
+        const nameBlock: Block = {
+          id: nameId,
+          type: "text",
+          props: {
+            text: plan.name,
+            align: "center",
+            size: "lg",
+          },
+          sectionId,
+          columnId: col.id,
+        };
+
+        const priceBlock: Block = {
+          id: priceId,
+          type: "text",
+          props: {
+            text: plan.price,
+            align: "center",
+            size: "base",
+          },
+          sectionId,
+          columnId: col.id,
+        };
+
+        return [nameBlock, priceBlock];
+      });
+
+      const lastBlockId = pricingBlocks[pricingBlocks.length - 1].id;
+
+      set((state: EditorState) => {
+        const newBlocks = [...state.blocks, sectionBlock, ...pricingBlocks];
+
+        return {
+          blocks: newBlocks,
+          selectedBlockId: lastBlockId,
+        };
+      });
+    },
+
+    // Testimonials 템플릿 섹션 추가: 3컬럼 후기 카드(본문/작성자)를 생성한다
+    addTestimonialsTemplateSection: () => {
+      const sectionId = createId();
+
+      const columns = [
+        { id: `${sectionId}_col_1`, span: 4 },
+        { id: `${sectionId}_col_2`, span: 4 },
+        { id: `${sectionId}_col_3`, span: 4 },
+      ];
+
+      const sectionBlock: Block = {
+        id: sectionId,
+        type: "section",
+        props: {
+          background: "default",
+          paddingY: "lg",
+          columns,
+        },
+        sectionId: null,
+        columnId: null,
+      };
+
+      const testimonialDefinitions = [
+        { body: "이 서비스 덕분에 랜딩 페이지 제작 시간이 크게 줄었습니다.", author: "홍길동" },
+        { body: "디자인을 잘 못해도 깔끔한 페이지를 만들 수 있어요.", author: "김영희" },
+        { body: "팀 전체가 만족하는 빌더입니다.", author: "이철수" },
+      ];
+
+      const testimonialBlocks: Block[] = columns.flatMap((col, index) => {
+        const t = testimonialDefinitions[index] ?? testimonialDefinitions[0];
+
+        const bodyId = createId();
+        const authorId = createId();
+
+        const bodyBlock: Block = {
+          id: bodyId,
+          type: "text",
+          props: {
+            text: t.body,
+            align: "left",
+            size: "base",
+          },
+          sectionId,
+          columnId: col.id,
+        };
+
+        const authorBlock: Block = {
+          id: authorId,
+          type: "text",
+          props: {
+            text: `- ${t.author}`,
+            align: "left",
+            size: "sm",
+          },
+          sectionId,
+          columnId: col.id,
+        };
+
+        return [bodyBlock, authorBlock];
+      });
+
+      const lastBlockId = testimonialBlocks[testimonialBlocks.length - 1].id;
+
+      set((state: EditorState) => {
+        const newBlocks = [...state.blocks, sectionBlock, ...testimonialBlocks];
+
+        return {
+          blocks: newBlocks,
+          selectedBlockId: lastBlockId,
+        };
+      });
+    },
+
     // 이미지 블록 추가: 기본 플레이스홀더와 함께 생성 후 선택 상태로 만든다
     addImageBlock: () => {
       const id = createId();
@@ -478,6 +718,91 @@ const createEditorState = (set: any, get: any): EditorState => ({
         ),
       }));
     },
+    removeBlock: (id) => {
+      set((state: EditorState) => {
+        const current = state.blocks;
+        const index = current.findIndex((b) => b.id === id);
+        if (index === -1) {
+          return state;
+        }
+
+        const nextBlocks = current.filter((b) => b.id !== id);
+
+        // 선택 상태는 삭제된 블록의 이전 블록 또는 다음 블록으로 이동한다.
+        let nextSelected: string | null = null;
+        if (nextBlocks.length > 0) {
+          const prevIndex = index - 1;
+          if (prevIndex >= 0) {
+            nextSelected = nextBlocks[prevIndex].id;
+          } else {
+            // 첫 블록이 삭제된 경우, 새 첫 블록을 선택한다.
+            nextSelected = nextBlocks[0].id;
+          }
+        }
+
+        return {
+          ...state,
+          blocks: nextBlocks,
+          selectedBlockId: nextSelected,
+        };
+      });
+    },
+    duplicateBlock: (id) => {
+      set((state: EditorState) => {
+        const current = state.blocks;
+        const index = current.findIndex((b) => b.id === id);
+        if (index === -1) {
+          return state;
+        }
+
+        const original = current[index];
+        const newId = createId();
+
+        const cloned: Block = {
+          ...original,
+          id: newId,
+          // props 는 얕은 복사로 충분 (현재 props 는 모두 평면 구조)
+          props: { ...(original.props as any) },
+        };
+
+        const nextBlocks = [...current];
+        nextBlocks.splice(index + 1, 0, cloned);
+
+        return {
+          ...state,
+          blocks: nextBlocks,
+          selectedBlockId: newId,
+        };
+      });
+    },
+    undo: () => {
+      const { history, blocks } = get();
+      if (history.length === 0) return;
+
+      const previous = history[history.length - 1];
+      const nextHistory = history.slice(0, -1);
+
+      set((state: EditorState) => ({
+        blocks: previous,
+        selectedBlockId: previous.length > 0 ? previous[previous.length - 1].id : null,
+        history: nextHistory,
+        future: [...state.future, blocks],
+      }));
+    },
+    redo: () => {
+      const { future, blocks } = get();
+      if (future.length === 0) return;
+
+      const next = future[future.length - 1];
+      const nextFuture = future.slice(0, -1);
+
+      set((state: EditorState) => ({
+        blocks: next,
+        selectedBlockId: next.length > 0 ? next[next.length - 1].id : null,
+        history: [...state.history, blocks],
+        future: nextFuture,
+      }));
+    },
   });
 
 // React 컴포넌트에서 사용하는 전역 훅 스토어

tests/e2e/editor.spec.ts

@@ -325,7 +325,7 @@ test("Features 템플릿 버튼을 클릭하면 3개의 Feature 항목(제목/
   await expect(canvas.getByText("Feature 3 제목")).toBeVisible();
 });
 
-test("CTA 템플릿 버튼을 클릭하면 CTA 텍스트와 버튼이 생성되어야 한다", async ({ page }) => {
+test("CTA 템플릿 버튼을 클릭하면 CTA 텍스트와 버튼이 포함된 섹션이 캔버스에 생성되어야 한다", async ({ page }) => {
   await page.goto("/editor");
 
   const canvas = page.getByTestId("editor-canvas");
@@ -336,3 +336,150 @@ test("CTA 템플릿 버튼을 클릭하면 CTA 텍스트와 버튼이 생성되
   const ctaButton = canvas.getByRole("button", { name: "CTA 버튼" });
   await expect(ctaButton).toBeVisible();
 });
+
+test("FAQ 템플릿 버튼을 클릭하면 질문/답변 텍스트가 세 쌍 이상 생성되어야 한다", async ({ page }) => {
+  await page.goto("/editor");
+
+  const canvas = page.getByTestId("editor-canvas");
+
+  await page.getByRole("button", { name: "FAQ 템플릿 추가" }).click();
+
+  // 기본 FAQ 질문/답변 텍스트들이 렌더되어야 한다.
+  await expect(canvas.getByText("자주 묻는 질문 1")).toBeVisible();
+  await expect(canvas.getByText("첫 번째 질문에 대한 답변을 여기에 입력하세요.")).toBeVisible();
+  await expect(canvas.getByText("자주 묻는 질문 2")).toBeVisible();
+  await expect(canvas.getByText("자주 묻는 질문 3")).toBeVisible();
+});
+
+test("Pricing 템플릿 버튼을 클릭하면 3개의 요금제 카드가 생성되어야 한다", async ({ page }) => {
+  await page.goto("/editor");
+
+  const canvas = page.getByTestId("editor-canvas");
+
+  await page.getByRole("button", { name: "Pricing 템플릿 추가" }).click();
+
+  await expect(canvas.getByText("Basic")).toBeVisible();
+  await expect(canvas.getByText("₩9,900/월")).toBeVisible();
+  await expect(canvas.getByText("Pro")).toBeVisible();
+  await expect(canvas.getByText("₩29,900/월")).toBeVisible();
+  await expect(canvas.getByText("Enterprise")).toBeVisible();
+  await expect(canvas.getByText("문의")).toBeVisible();
+});
+
+test("Testimonials 템플릿 버튼을 클릭하면 3개의 후기 카드가 생성되어야 한다", async ({ page }) => {
+  await page.goto("/editor");
+
+  const canvas = page.getByTestId("editor-canvas");
+
+  await page.getByRole("button", { name: "Testimonials 템플릿 추가" }).click();
+
+  await expect(canvas.getByText("이 서비스 덕분에 랜딩 페이지 제작 시간이 크게 줄었습니다.")).toBeVisible();
+  await expect(canvas.getByText("디자인을 잘 못해도 깔끔한 페이지를 만들 수 있어요.")).toBeVisible();
+  await expect(canvas.getByText("팀 전체가 만족하는 빌더입니다.")).toBeVisible();
+});
+
+test("Cmd/Ctrl+Z로 블록 추가를 Undo 하고 Cmd/Ctrl+Shift+Z로 Redo 할 수 있어야 한다", async ({ page }) => {
+  await page.goto("/editor");
+
+  const canvas = page.getByTestId("editor-canvas");
+
+  // 텍스트 블록을 하나 추가한다.
+  await page.getByRole("button", { name: "텍스트 블록 추가" }).click();
+  await expect(canvas.getByTestId("editor-block")).toHaveCount(1);
+
+  // Cmd/Ctrl + Z 로 Undo 한다.
+  await page.keyboard.press("Meta+Z");
+
+  // Undo 후에는 블록이 0개가 되어야 한다.
+  await expect(canvas.getByTestId("editor-block")).toHaveCount(0);
+
+  // Cmd/Ctrl + Shift + Z 로 Redo 한다.
+  await page.keyboard.press("Meta+Shift+Z");
+
+  // Redo 후 다시 블록이 1개가 되어야 한다.
+  await expect(canvas.getByTestId("editor-block")).toHaveCount(1);
+});
+
+test("ArrowUp/ArrowDown 키로 선택된 블록을 위/아래로 이동하며 순차적으로 선택할 수 있어야 한다", async ({ page }) => {
+  await page.goto("/editor");
+
+  const canvas = page.getByTestId("editor-canvas");
+
+  // 텍스트 블록을 세 개 추가한다.
+  await page.getByRole("button", { name: "텍스트 블록 추가" }).click();
+  await page.getByRole("button", { name: "텍스트 블록 추가" }).click();
+  await page.getByRole("button", { name: "텍스트 블록 추가" }).click();
+
+  const blocks = canvas.getByTestId("editor-block");
+  await expect(blocks).toHaveCount(3);
+
+  // 첫 번째 블록을 클릭해 선택한다.
+  await blocks.nth(0).click();
+  await expect(blocks.nth(0)).toHaveAttribute("data-selected", "true");
+
+  // ArrowDown 으로 두 번째 블록으로 이동.
+  await page.keyboard.press("ArrowDown");
+  await expect(blocks.nth(1)).toHaveAttribute("data-selected", "true");
+
+  // 다시 ArrowDown 으로 세 번째 블록으로 이동.
+  await page.keyboard.press("ArrowDown");
+  await expect(blocks.nth(2)).toHaveAttribute("data-selected", "true");
+
+  // ArrowDown 을 한 번 더 눌러도 마지막에서 더 내려가지 않는다.
+  await page.keyboard.press("ArrowDown");
+  await expect(blocks.nth(2)).toHaveAttribute("data-selected", "true");
+
+  // ArrowUp 으로 두 번째 블록으로 올라간다.
+  await page.keyboard.press("ArrowUp");
+  await expect(blocks.nth(1)).toHaveAttribute("data-selected", "true");
+});
+
+test("속성 패널의 블록 삭제 버튼으로 선택된 블록을 삭제할 수 있어야 한다", async ({ page }) => {
+  await page.goto("/editor");
+
+  const canvas = page.getByTestId("editor-canvas");
+
+  // 텍스트 블록 두 개를 추가한다.
+  await page.getByRole("button", { name: "텍스트 블록 추가" }).click();
+  await page.getByRole("button", { name: "텍스트 블록 추가" }).click();
+
+  const blocks = canvas.getByTestId("editor-block");
+  await expect(blocks).toHaveCount(2);
+
+  // 두 번째 블록을 선택한 다음, 속성 패널에서 "블록 삭제" 버튼을 클릭한다.
+  await blocks.nth(1).click();
+  await page.getByRole("button", { name: "블록 삭제" }).click();
+
+  // 하나의 블록만 남아야 하며, 첫 번째 블록이 남아 있어야 한다.
+  const remainingBlocks = canvas.getByTestId("editor-block");
+  await expect(remainingBlocks).toHaveCount(1);
+  await expect(remainingBlocks.nth(0)).toHaveAttribute("data-selected", "true");
+});
+
+test("Cmd/Ctrl+D 단축키로 선택된 블록을 복제할 수 있어야 한다", async ({ page }) => {
+  await page.goto("/editor");
+
+  const canvas = page.getByTestId("editor-canvas");
+
+  // 텍스트 블록을 하나 추가한다.
+  await page.getByRole("button", { name: "텍스트 블록 추가" }).click();
+
+  let blocks = canvas.getByTestId("editor-block");
+  await expect(blocks).toHaveCount(1);
+
+  // 블록의 텍스트를 식별 가능한 값으로 바꾼다.
+  await blocks.nth(0).click();
+  const sidebarEditor = page.getByRole("textbox", { name: "선택한 텍스트 블록 내용" });
+  await sidebarEditor.fill("복제 대상 블록");
+
+  // Cmd/Ctrl + D 로 복제한다.
+  await page.keyboard.press("Meta+D");
+
+  // 블록이 두 개가 되어야 한다.
+  blocks = canvas.getByTestId("editor-block");
+  await expect(blocks).toHaveCount(2);
+
+  // 두 블록 모두 동일한 텍스트를 가지고 있어야 한다.
+  await expect(blocks.nth(0)).toContainText("복제 대상 블록");
+  await expect(blocks.nth(1)).toContainText("복제 대상 블록");
+});

tests/e2e/preview.spec.ts

@@ -0,0 +1,109 @@
+import { test, expect } from "@playwright/test";
+
+// 프리뷰/뷰 모드 TDD: 먼저 실패하는 E2E부터 작성한다.
+
+test("/preview 페이지는 에디터 크롬 없이 컨텐츠만 보여야 한다", async ({ page }) => {
+  // 프리뷰 페이지로 이동한다.
+  await page.goto("/preview");
+
+  // 프리뷰 전용 헤더가 있어야 한다.
+  await expect(page.getByRole("heading", { name: "Page Preview" })).toBeVisible();
+
+  // 에디터 좌측 패널용 버튼들은 나타나지 않아야 한다.
+  await expect(page.getByRole("button", { name: "텍스트 블록 추가" })).toHaveCount(0);
+  await expect(page.getByRole("button", { name: "Hero 템플릿 추가" })).toHaveCount(0);
+});
+
+test("에디터에서 Hero 템플릿을 추가하면 프리뷰에서 동일한 Hero 콘텐츠가 보여야 한다", async ({ page }) => {
+  // 에디터에서 Hero 템플릿을 추가한다.
+  await page.goto("/editor");
+
+  await page.getByRole("button", { name: "Hero 템플릿 추가" }).click();
+
+  // 헤드라인과 CTA 버튼이 에디터에서 생성되었는지 한 번 확인한다.
+  const editorCanvas = page.getByTestId("editor-canvas");
+  await expect(editorCanvas.getByText("Hero 제목을 여기에 입력하세요")).toBeVisible();
+  await expect(editorCanvas.getByRole("button", { name: "지금 시작하기" })).toBeVisible();
+
+  // 헤더의 프리뷰 열기 링크를 통해 /preview 로 이동한다 (클라이언트 내 내비게이션 유지).
+  await page.getByRole("link", { name: "프리뷰 열기" }).click();
+
+  // 프리뷰 헤더가 보여야 한다.
+  await expect(page.getByRole("heading", { name: "Page Preview" })).toBeVisible();
+
+  // 프리뷰에서도 Hero 헤드라인과 CTA 버튼이 그대로 보여야 한다.
+  await expect(page.getByText("Hero 제목을 여기에 입력하세요")).toBeVisible();
+  // 프리뷰에서는 CTA를 실제 링크(<a>)로 렌더링하므로 텍스트 기준으로만 검증한다.
+  await expect(page.getByText("지금 시작하기")).toBeVisible();
+
+  // 프리뷰 화면에는 에디터용 "텍스트 블록 추가" 버튼이 없어야 한다.
+  await expect(page.getByRole("button", { name: "텍스트 블록 추가" })).toHaveCount(0);
+});
+
+test("에디터에서 Features 템플릿을 추가하면 프리뷰에서 3개의 Feature 섹션이 보여야 한다", async ({ page }) => {
+  await page.goto("/editor");
+
+  await page.getByRole("button", { name: "Features 템플릿 추가" }).click();
+
+  const editorCanvas = page.getByTestId("editor-canvas");
+  await expect(editorCanvas.getByText("Feature 1 제목")).toBeVisible();
+  await expect(editorCanvas.getByText("Feature 2 제목")).toBeVisible();
+  await expect(editorCanvas.getByText("Feature 3 제목")).toBeVisible();
+
+  await page.getByRole("link", { name: "프리뷰 열기" }).click();
+
+  await expect(page.getByRole("heading", { name: "Page Preview" })).toBeVisible();
+
+  await expect(page.getByText("Feature 1 제목")).toBeVisible();
+  await expect(page.getByText("Feature 2 제목")).toBeVisible();
+  await expect(page.getByText("Feature 3 제목")).toBeVisible();
+});
+
+test("에디터에서 CTA 템플릿을 추가하면 프리뷰에서 CTA 텍스트와 버튼이 보여야 한다", async ({ page }) => {
+  await page.goto("/editor");
+
+  await page.getByRole("button", { name: "CTA 템플릿 추가" }).click();
+
+  const editorCanvas = page.getByTestId("editor-canvas");
+  await expect(editorCanvas.getByText("지금 바로 행동을 유도하는 CTA 텍스트를 입력하세요.")).toBeVisible();
+  await expect(editorCanvas.getByRole("button", { name: "CTA 버튼" })).toBeVisible();
+
+  await page.getByRole("link", { name: "프리뷰 열기" }).click();
+
+  await expect(page.getByRole("heading", { name: "Page Preview" })).toBeVisible();
+
+  await expect(page.getByText("지금 바로 행동을 유도하는 CTA 텍스트를 입력하세요.")).toBeVisible();
+  await expect(page.getByText("CTA 버튼")).toBeVisible();
+});
+
+test("모바일 뷰에서도 프리뷰 페이지가 깨지지 않고 주요 템플릿 컨텐츠를 보여줘야 한다", async ({ page }) => {
+  // 에디터에서 여러 템플릿을 추가한다.
+  await page.goto("/editor");
+
+  await page.getByRole("button", { name: "Hero 템플릿 추가" }).click();
+  await page.getByRole("button", { name: "Features 템플릿 추가" }).click();
+  await page.getByRole("button", { name: "Pricing 템플릿 추가" }).click();
+  await page.getByRole("button", { name: "Testimonials 템플릿 추가" }).click();
+
+  // 모바일 뷰포트로 전환한다.
+  await page.setViewportSize({ width: 390, height: 844 });
+
+  // 프리뷰로 이동한다.
+  await page.getByRole("link", { name: "프리뷰 열기" }).click();
+
+  // 프리뷰 헤더와 주요 템플릿 텍스트들이 모두 보여야 한다.
+  await expect(page.getByRole("heading", { name: "Page Preview" })).toBeVisible();
+
+  // Hero 헤드라인
+  await expect(page.getByText("Hero 제목을 여기에 입력하세요")).toBeVisible();
+
+  // Features 제목 일부
+  await expect(page.getByText("Feature 1 제목")).toBeVisible();
+
+  // Pricing 플랜 이름/가격 일부
+  await expect(page.getByText("Basic")).toBeVisible();
+  await expect(page.getByText("₩9,900/월")).toBeVisible();
+
+  // Testimonials 본문 일부
+  await expect(page.getByText("이 서비스 덕분에 랜딩 페이지 제작 시간이 크게 줄었습니다.")).toBeVisible();
+});

tests/unit/editorStore.spec.ts

@@ -282,4 +282,189 @@ describe("editorStore", () => {
 
     expect(selectedBlockId).toBe(blocks[blocks.length - 1].id);
   });
+
+  it("FAQ 템플릿 섹션을 추가하면 질문/답변 쌍이 포함된 섹션이 생성되어야 한다", () => {
+    const store = createEditorStore();
+
+    store.getState().addFaqTemplateSection();
+
+    const { blocks, selectedBlockId } = store.getState();
+
+    const sectionBlocks = blocks.filter((b) => b.type === "section");
+    expect(sectionBlocks).toHaveLength(1);
+
+    const section = sectionBlocks[0] as any;
+    const columns = (section.props as any).columns;
+    expect(Array.isArray(columns)).toBe(true);
+    expect(columns.length).toBeGreaterThanOrEqual(1);
+
+    const firstColumnId = columns[0].id;
+
+    const textBlocks = blocks.filter((b) => b.type === "text") as any[];
+
+    // 최소 3개의 FAQ 항목(질문+답변 쌍)을 가정한다.
+    expect(textBlocks.length).toBeGreaterThanOrEqual(6);
+
+    textBlocks.forEach((tb) => {
+      expect(tb.sectionId).toBe(section.id);
+      expect(tb.columnId).toBe(firstColumnId);
+    });
+
+    expect(selectedBlockId).toBe(blocks[blocks.length - 1].id);
+  });
+
+  it("Pricing 템플릿 섹션을 추가하면 요금제 카드(플랜 이름/가격/설명)가 3개 생성되어야 한다", () => {
+    const store = createEditorStore();
+
+    store.getState().addPricingTemplateSection();
+
+    const { blocks, selectedBlockId } = store.getState();
+
+    const sectionBlocks = blocks.filter((b) => b.type === "section");
+    expect(sectionBlocks).toHaveLength(1);
+
+    const section = sectionBlocks[0] as any;
+    const columns = (section.props as any).columns;
+    expect(Array.isArray(columns)).toBe(true);
+    expect(columns.length).toBe(3);
+
+    const textBlocks = blocks.filter((b) => b.type === "text") as any[];
+
+    // 3개의 요금제에 대해 각 컬럼에 최소 2개 텍스트(플랜 이름 + 가격/설명)를 가정한다.
+    expect(textBlocks.length).toBeGreaterThanOrEqual(6);
+
+    textBlocks.forEach((tb) => {
+      expect(tb.sectionId).toBe(section.id);
+      expect(columns.some((col: any) => col.id === tb.columnId)).toBe(true);
+    });
+
+    expect(selectedBlockId).toBe(blocks[blocks.length - 1].id);
+  });
+
+  it("Testimonials 템플릿 섹션을 추가하면 후기(본문/작성자)가 3개 생성되어야 한다", () => {
+    const store = createEditorStore();
+
+    store.getState().addTestimonialsTemplateSection();
+
+    const { blocks, selectedBlockId } = store.getState();
+
+    const sectionBlocks = blocks.filter((b) => b.type === "section");
+    expect(sectionBlocks).toHaveLength(1);
+
+    const section = sectionBlocks[0] as any;
+    const columns = (section.props as any).columns;
+    expect(Array.isArray(columns)).toBe(true);
+    expect(columns.length).toBe(3);
+
+    const textBlocks = blocks.filter((b) => b.type === "text") as any[];
+
+    // 3개의 후기 카드에 대해 각 컬럼에 최소 2개 텍스트(본문 + 작성자)를 가정한다.
+    expect(textBlocks.length).toBeGreaterThanOrEqual(6);
+
+    textBlocks.forEach((tb) => {
+      expect(tb.sectionId).toBe(section.id);
+      expect(columns.some((col: any) => col.id === tb.columnId)).toBe(true);
+    });
+
+    expect(selectedBlockId).toBe(blocks[blocks.length - 1].id);
+  });
+
+  it("undo 호출 시 마지막 변경 이전의 블록 상태로 되돌려야 한다", () => {
+    const store = createEditorStore();
+
+    // 텍스트 블록을 두 개 추가한다.
+    store.getState().addTextBlock();
+    store.getState().addTextBlock();
+
+    let { blocks, selectedBlockId } = store.getState();
+    expect(blocks).toHaveLength(2);
+
+    const firstId = blocks[0].id;
+
+    store.getState().undo();
+
+    ({ blocks, selectedBlockId } = store.getState());
+
+    // 마지막 추가 이전 상태로 되돌아가야 하므로 블록은 1개만 남아야 한다.
+    expect(blocks).toHaveLength(1);
+    expect(blocks[0].id).toBe(firstId);
+    expect(selectedBlockId).toBe(firstId);
+  });
+
+  it("redo 호출 시 undo로 되돌린 변경을 다시 적용해야 한다", () => {
+    const store = createEditorStore();
+
+    store.getState().addTextBlock();
+    store.getState().addTextBlock();
+
+    let { blocks } = store.getState();
+    expect(blocks).toHaveLength(2);
+
+    store.getState().undo();
+
+    ({ blocks } = store.getState());
+    expect(blocks).toHaveLength(1);
+
+    store.getState().redo();
+
+    ({ blocks } = store.getState());
+    expect(blocks).toHaveLength(2);
+  });
+
+  it("removeBlock 호출 시 해당 블록이 삭제되고 선택 상태가 적절히 변경되어야 한다", () => {
+    const store = createEditorStore();
+
+    // 텍스트 블록 두 개를 추가한다.
+    store.getState().addTextBlock();
+    store.getState().addTextBlock();
+
+    let { blocks, selectedBlockId } = store.getState();
+    expect(blocks).toHaveLength(2);
+
+    const firstId = blocks[0].id;
+    const secondId = blocks[1].id;
+
+    // 두 번째 블록을 선택한 상태에서 삭제한다.
+    store.getState().selectBlock(secondId);
+    store.getState().removeBlock(secondId);
+
+    ({ blocks, selectedBlockId } = store.getState());
+
+    // 두 번째 블록만 삭제되고 첫 번째 블록은 남아 있어야 한다.
+    expect(blocks).toHaveLength(1);
+    expect(blocks[0].id).toBe(firstId);
+    expect(selectedBlockId).toBe(firstId);
+  });
+
+  it("duplicateBlock 호출 시 같은 내용의 블록이 같은 위치 정보로 복제되어야 한다", () => {
+    const store = createEditorStore();
+
+    // 섹션 + 텍스트 블록을 하나 만든다.
+    store.getState().addSectionBlock();
+    const { blocks: afterSection } = store.getState();
+    const sectionBlock = afterSection[0] as any;
+
+    store.getState().selectBlock(sectionBlock.id);
+    store.getState().addTextBlock();
+
+    let { blocks } = store.getState();
+    const original = blocks.find((b) => b.type === "text") as any;
+
+    expect(original).toBeTruthy();
+
+    // duplicateBlock 으로 복제한다.
+    store.getState().duplicateBlock(original.id);
+
+    ({ blocks } = store.getState());
+    const textBlocks = blocks.filter((b) => b.type === "text") as any[];
+
+    // 텍스트 블록이 두 개가 되어야 한다.
+    expect(textBlocks).toHaveLength(2);
+
+    const [t1, t2] = textBlocks;
+    expect(t1.id).not.toBe(t2.id);
+    expect(t1.props).toEqual(t2.props);
+    expect(t2.sectionId).toBe(t1.sectionId);
+    expect(t2.columnId).toBe(t1.columnId);
+  });
 });