๋ธ”๋กœ๊ทธ๋กœ ๋Œ์•„๊ฐ€๊ธฐ

๐Ÿš€ ONit ๋ฌดํ•œ ์บ”๋ฒ„์Šค ํ˜‘์—… ํ”Œ๋žซํผ ๊ฐœ๋ฐœ๊ธฐ

React์™€ Socket.IO๋ฅผ ํ™œ์šฉํ•˜์—ฌ ๊ฐœ๋ฐœํ•œ ๋ฌดํ•œ ์บ”๋ฒ„์Šค ํ˜‘์—… ํ”Œ๋žซํผ ONit์˜ ๊ฐœ๋ฐœ ๊ณผ์ •๊ณผ ๊ธฐ์ˆ ์  ๋„์ „, ๊ทธ๋ฆฌ๊ณ  ์–ป์€ ์ธ์‚ฌ์ดํŠธ๋ฅผ ๊ณต์œ ํ•ฉ๋‹ˆ๋‹ค.

๐Ÿ“‹ ํ”„๋กœ์ ํŠธ ๊ฐœ์š”

ONit์€ ํŒ€์›๋“ค์ด ์‹ค์‹œ๊ฐ„์œผ๋กœ ์•„์ด๋””์–ด๋ฅผ ๊ณต์œ ํ•˜๊ณ  ํ˜‘์—…ํ•  ์ˆ˜ ์žˆ๋Š” ํ˜์‹ ์ ์ธ ์›น ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ž…๋‹ˆ๋‹ค. ๋ฌดํ•œ ํ™•์žฅ ๊ฐ€๋Šฅํ•œ ์บ”๋ฒ„์Šค์—์„œ ์ž์œ ๋กญ๊ฒŒ ํ…์ŠคํŠธ๋ฅผ ๋ฐฐ์น˜ํ•˜๊ณ , ์‹ค์‹œ๊ฐ„์œผ๋กœ ๋™๊ธฐํ™”ํ•˜๋ฉฐ, ์ง๊ด€์ ์ธ ์ธํ„ฐํŽ˜์ด์Šค๋กœ ํšจ์œจ์ ์ธ ํ˜‘์—…์„ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.

๐ŸŽฏ ํ•ต์‹ฌ ๊ธฐ๋Šฅ

  • ๋ฌดํ•œ ํ™•์žฅ ๊ฐ€๋Šฅํ•œ ์บ”๋ฒ„์Šค: ์ œํ•œ ์—†๋Š” ๊ณต๊ฐ„์—์„œ ์ž์œ ๋กญ๊ฒŒ ์ž‘์—…
  • ์‹ค์‹œ๊ฐ„ ํ˜‘์—…: Socket.IO๋ฅผ ํ†ตํ•œ ์ฆ‰์‹œ ๋™๊ธฐํ™”
  • ๋‹ค์ค‘ ๋ชจ๋“œ ์ง€์›: ํ…์ŠคํŠธ ์ƒ์„ฑ, ์ด๋™, ์‚ญ์ œ ๋ชจ๋“œ
  • ์›Œํฌ์ŠคํŽ˜์ด์Šค ๊ด€๋ฆฌ: ํ”„๋กœ์ ํŠธ๋ณ„ ๋…๋ฆฝ์ ์ธ ์ž‘์—… ๊ณต๊ฐ„
  • ์‹ค์‹œ๊ฐ„ ์ฑ„ํŒ…: ํŒ€์› ๊ฐ„ ์†Œํ†ต ์ฑ„๋„

๐Ÿ—๏ธ ๊ธฐ์ˆ  ์Šคํƒ ๋ฐ ์•„ํ‚คํ…์ฒ˜

Frontend ๊ธฐ์ˆ  ์Šคํƒ

{
  "dependencies": {
    "react": "^18.2.0",
    "react-dom": "^18.2.0", 
    "react-router-dom": "^7.9.3",
    "axios": "^1.12.2",
    "socket.io-client": "^4.8.1"
  },
  "devDependencies": {
    "vite": "^5.0.8",
    "tailwindcss": "^3.4.0",
    "eslint": "^8.55.0"
  }
}

Backend ์—ฐ๋™

  • REST API: Spring Boot ๊ธฐ๋ฐ˜ ๋ฐฑ์—”๋“œ ์„œ๋ฒ„
  • ์‹ค์‹œ๊ฐ„ ํ†ต์‹ : Socket.IO ์„œ๋ฒ„ (ํฌํŠธ 9092)
  • ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค: PostgreSQL
  • ์ธ์ฆ: JWT ํ† ํฐ ๊ธฐ๋ฐ˜

๐ŸŽจ ํ•ต์‹ฌ ์ปดํฌ๋„ŒํŠธ ๋ถ„์„

1. ๋ฌดํ•œ ์บ”๋ฒ„์Šค ์‹œ์Šคํ…œ

๋ฌดํ•œ ์บ”๋ฒ„์Šค์˜ ํ•ต์‹ฌ์€ ๋™์  ์บ”๋ฒ„์Šค ์˜์—ญ ๊ด€๋ฆฌ์ž…๋‹ˆ๋‹ค. ์‚ฌ์šฉ์ž๊ฐ€ ๊ธฐ์กด ์บ”๋ฒ„์Šค ์˜์—ญ ๋ฐ–์œผ๋กœ ํ…์ŠคํŠธ๋ฅผ ๋“œ๋ž˜๊ทธํ•˜๋ฉด ์ž๋™์œผ๋กœ ์ƒˆ๋กœ์šด ์บ”๋ฒ„์Šค ์˜์—ญ์ด ์ƒ์„ฑ๋ฉ๋‹ˆ๋‹ค.

const handleTextUpdate = (id, updates) => {
  textFields.updateText(id, updates);
  
  // ์บ”๋ฒ„์Šค ๋ฐ–์œผ๋กœ ์ด๋™ํ•˜๋Š”์ง€ ์ฒดํฌํ•˜๊ณ  ํ™•์žฅ
  if (updates.x !== undefined && updates.y !== undefined) {
    const currentAreas = canvas.canvasAreas;
    const isOutsideCanvas = !currentAreas.some(area => 
      updates.x >= area.x && updates.x <= area.x + area.width &&
      updates.y >= area.y && updates.y <= area.y + area.height
    );
    
    if (isOutsideCanvas) {
      canvas.addCanvasArea(updates.x, updates.y);
    }
  }
};

์ฃผ์š” ํŠน์ง•:

  • ์ž๋™ ์บ”๋ฒ„์Šค ํ™•์žฅ: ์‚ฌ์šฉ์ž๊ฐ€ ๊ธฐ์กด ์˜์—ญ ๋ฐ–์œผ๋กœ ๋‚˜๊ฐ€๋ฉด ์ž๋™์œผ๋กœ ์ƒˆ ์˜์—ญ ์ƒ์„ฑ
  • ๊ทธ๋ฆฌ๋“œ ๊ธฐ๋ฐ˜ ๋ ˆ์ด์•„์›ƒ: 3840x2160px ๋‹จ์œ„๋กœ ์˜์—ญ์„ ๋‚˜๋ˆ„์–ด ๊ด€๋ฆฌ
  • ์„ฑ๋Šฅ ์ตœ์ ํ™”: ํ•„์š”ํ•œ ์˜์—ญ๋งŒ ๋ Œ๋”๋งํ•˜์—ฌ ๋ฉ”๋ชจ๋ฆฌ ํšจ์œจ์„ฑ ํ™•๋ณด

2. ์‹ค์‹œ๊ฐ„ ์ฑ„ํŒ… ์‹œ์Šคํ…œ

Socket.IO๋ฅผ ํ™œ์šฉํ•œ ์‹ค์‹œ๊ฐ„ ์ฑ„ํŒ… ๊ธฐ๋Šฅ์„ ๊ตฌํ˜„ํ–ˆ์Šต๋‹ˆ๋‹ค.

// Socket.IO ์—ฐ๊ฒฐ ๋ฐ ์ด๋ฒคํŠธ ๋ฆฌ์Šค๋„ˆ ์„ค์ •
useEffect(() => {
  socketService.connect();
  setIsConnected(socketService.getConnectionStatus());

  socketService.on('new_message', (data) => {
    const message = {
      id: Date.now(),
      text: data,
      sender: "other",
      time: new Date().toLocaleTimeString('ko-KR', { hour: '2-digit', minute: '2-digit' }),
      timestamp: Date.now()
    };
    setLocalMessages(prev => [...prev, message]);
  });
}, []);

๊ตฌํ˜„๋œ ๊ธฐ๋Šฅ:

  • ์‹ค์‹œ๊ฐ„ ๋ฉ”์‹œ์ง€ ๋™๊ธฐํ™”: ๋ชจ๋“  ์ฐธ์—ฌ์ž์—๊ฒŒ ์ฆ‰์‹œ ๋ฉ”์‹œ์ง€ ์ „๋‹ฌ
  • ์—ฐ๊ฒฐ ์ƒํƒœ ํ‘œ์‹œ: Socket.IO ์—ฐ๊ฒฐ ์ƒํƒœ๋ฅผ ์‹œ๊ฐ์ ์œผ๋กœ ํ‘œ์‹œ
  • ์ž๋™ ์Šคํฌ๋กค: ์ƒˆ ๋ฉ”์‹œ์ง€๊ฐ€ ์˜ฌ ๋•Œ๋งˆ๋‹ค ์ž๋™์œผ๋กœ ํ•˜๋‹จ์œผ๋กœ ์Šคํฌ๋กค
  • ์œ„์น˜ ๊ณต์œ : ํ…์ŠคํŠธ ํ•„๋“œ์˜ ์œ„์น˜๋ฅผ ์ฑ„ํŒ…์œผ๋กœ ๊ณต์œ  ๊ฐ€๋Šฅ

3. ๊ณ ๊ธ‰ ํ…์ŠคํŠธ ํ•„๋“œ ์‹œ์Šคํ…œ

ํ…์ŠคํŠธ ํ•„๋“œ๋Š” ๋‹จ์ˆœํ•œ ์ž…๋ ฅ ์š”์†Œ๊ฐ€ ์•„๋‹Œ ํ’๋ถ€ํ•œ ์ƒํ˜ธ์ž‘์šฉ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

const handleMouseDown = (e) => {
  if (mode === 'delete') {
    // ์‚ญ์ œ ๋ชจ๋“œ: ๊ธธ๊ฒŒ ํด๋ฆญ ์‹œ์ž‘
    setIsLongPressing(true);
    setPressProgress(0);
    
    const progressInterval = setInterval(() => {
      setPressProgress(prev => {
        const newProgress = prev + 100 / 15; // 1.5์ดˆ ๋™์•ˆ 100%๊นŒ์ง€
        if (newProgress >= 100) {
          clearInterval(progressInterval);
          return 100;
        }
        return newProgress;
      });
    }, 100);
    
    const timer = setTimeout(() => {
      onDelete(id);
      setIsLongPressing(false);
      setPressProgress(0);
      clearInterval(progressInterval);
    }, 1500);
    setLongPressTimer(timer);
  }
};

์ฃผ์š” ๊ธฐ๋Šฅ:

  • ๋‹ค์ค‘ ์„ ํƒ: Shift + ๋“œ๋ž˜๊ทธ๋กœ ์—ฌ๋Ÿฌ ํ…์ŠคํŠธ ํ•„๋“œ ๋™์‹œ ์„ ํƒ
  • ๊ทธ๋ฃน ๋“œ๋ž˜๊ทธ: ์„ ํƒ๋œ ํ…์ŠคํŠธ๋“ค์„ ํ•จ๊ป˜ ์ด๋™
  • ์•ˆ์ „ํ•œ ์‚ญ์ œ: 1.5์ดˆ ๊ธธ๊ฒŒ ํด๋ฆญ์œผ๋กœ ์‹ค์ˆ˜ ๋ฐฉ์ง€
  • ์‹ค์‹œ๊ฐ„ ํŽธ์ง‘: ๋”๋ธ”ํด๋ฆญ์œผ๋กœ ์ฆ‰์‹œ ํŽธ์ง‘ ๋ชจ๋“œ ์ง„์ž…

4. ์บ”๋ฒ„์Šค ์ƒํƒœ ๊ด€๋ฆฌ

์บ”๋ฒ„์Šค์˜ ๋ชจ๋“  ์ƒํƒœ๋ฅผ ๊ด€๋ฆฌํ•˜๋Š” ์ปค์Šคํ…€ ํ›…์ž…๋‹ˆ๋‹ค.

export const useCanvas = () => {
  const [canvasTransform, setCanvasTransform] = useState({ x: 0, y: 0, scale: 1 });
  const [canvasAreas, setCanvasAreas] = useState([]);
  const [isDragging, setIsDragging] = useState(false);
  const [selectionArea, setSelectionArea] = useState(null);

  // ์˜์—ญ ์„ ํƒ ์‹œ์ž‘
  const startAreaSelection = (e) => {
    if (!e.shiftKey) return;
    
    if (!isDragging && !isAreaSelecting) {
      e.preventDefault();
      e.stopPropagation();
      
      const rect = canvasRef.current.getBoundingClientRect();
      const startX = (e.clientX - rect.left - canvasTransform.x) / canvasTransform.scale;
      const startY = (e.clientY - rect.top - canvasTransform.y) / canvasTransform.scale;
      
      setIsAreaSelecting(true);
      setHasStartedAreaSelection(true);
      setSelectionArea({
        startX, startY,
        endX: startX, endY: startY
      });
    }
  };
};

ํ•ต์‹ฌ ๊ธฐ๋Šฅ:

  • ์คŒ/ํŒฌ ์ œ์Šค์ฒ˜: ๋งˆ์šฐ์Šค ํœ ๋กœ ์คŒ, ๋“œ๋ž˜๊ทธ๋กœ ์ด๋™
  • ์˜์—ญ ์„ ํƒ: Shift + ๋“œ๋ž˜๊ทธ๋กœ ๋‹ค์ค‘ ์„ ํƒ
  • ๋™์  ์˜์—ญ ๊ด€๋ฆฌ: ํ•„์š”์— ๋”ฐ๋ผ ์บ”๋ฒ„์Šค ์˜์—ญ ์ถ”๊ฐ€/์‚ญ์ œ
  • ์„ฑ๋Šฅ ์ตœ์ ํ™”: ์ด๋ฒคํŠธ ๋ฆฌ์Šค๋„ˆ ์ตœ์ ํ™” ๋ฐ ๋ฉ”๋ชจ๋ฆฌ ๋ˆ„์ˆ˜ ๋ฐฉ์ง€

๐Ÿ”ง ๋ฐฑ์—”๋“œ ์—ฐ๋™ ์•„ํ‚คํ…์ฒ˜

API ํด๋ผ์ด์–ธํŠธ ์„ค๊ณ„

const apiClient = axios.create({
  baseURL: API_CONFIG.BASE_URL,
  timeout: API_CONFIG.TIMEOUT,
  headers: {
    'Content-Type': 'application/json',
  },
});

// ์š”์ฒญ ์ธํ„ฐ์…‰ํ„ฐ
apiClient.interceptors.request.use(
  (config) => {
    const token = localStorage.getItem('authToken');
    if (token) {
      config.headers.Authorization = `Bearer ${token}`;
    }
    return config;
  },
  (error) => Promise.reject(error)
);

// ์‘๋‹ต ์ธํ„ฐ์…‰ํ„ฐ
apiClient.interceptors.response.use(
  (response) => response,
  (error) => {
    if (error.response?.status === 401) {
      localStorage.removeItem('authToken');
      window.location.href = '/login';
    }
    return Promise.reject(error);
  }
);

Socket.IO ์„œ๋น„์Šค

์‹ค์‹œ๊ฐ„ ํ†ต์‹ ์„ ์œ„ํ•œ ํฌ๊ด„์ ์ธ ์„œ๋น„์Šค ํด๋ž˜์Šค๋ฅผ ๊ตฌํ˜„ํ–ˆ์Šต๋‹ˆ๋‹ค.

export class SocketService {
  constructor() {
    this.socket = null;
    this.isConnected = false;
    this.listeners = new Map();
  }

  connect(sessionId = null) {
    if (this.socket && this.isConnected) {
      console.log('์ด๋ฏธ ์—ฐ๊ฒฐ๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค.');
      return;
    }

    try {
      this.socket = io(API_CONFIG.SOCKET_URL, {
        transports: ['websocket', 'polling'],
        timeout: 5000,
        forceNew: true,
      });

      this.socket.on('connect', () => {
        console.log('Socket.IO ์„œ๋ฒ„์— ์—ฐ๊ฒฐ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.');
        this.isConnected = true;
        
        if (sessionId) {
          this.joinSession(sessionId);
        }
      });
    } catch (error) {
      console.error('Socket.IO ์—ฐ๊ฒฐ ์‹คํŒจ:', error);
    }
  }
}

๊ตฌํ˜„๋œ ์ด๋ฒคํŠธ:

  • chat_message: ์‹ค์‹œ๊ฐ„ ์ฑ„ํŒ… ๋ฉ”์‹œ์ง€
  • join_session/leave_session: ์„ธ์…˜ ์ฐธ์—ฌ/๋‚˜๊ฐ€๊ธฐ
  • idea_update: ์•„์ด๋””์–ด ์—…๋ฐ์ดํŠธ ๋™๊ธฐํ™”
  • voice_join/voice_leave: ์Œ์„ฑ ์ฑ„ํŒ… ์ฐธ์—ฌ

๐ŸŽจ ์‚ฌ์šฉ์ž ๊ฒฝํ—˜ (UX) ์„ค๊ณ„

1. ์ง๊ด€์ ์ธ ๋ชจ๋“œ ์‹œ์Šคํ…œ

const FloatingToolbar = ({ mode, onModeChange, onReset, onArrange }) => {
  return (
    <div className="fixed bottom-6 z-50 bg-white/95 backdrop-blur-md rounded-2xl shadow-2xl border border-gray-200 p-2 flex gap-1">
      <button
        onClick={() => onModeChange('text')}
        className={`w-12 h-12 rounded-xl flex items-center justify-center text-lg font-bold transition-all duration-200 ${
          mode === 'text'
            ? 'bg-blue-500 text-white shadow-lg scale-105'
            : 'bg-gray-100 text-gray-600 hover:bg-gray-200 hover:scale-105'
        }`}
        title="ํ…์ŠคํŠธ ๋ชจ๋“œ"
      >
        T
      </button>
      {/* ์ด๋™, ์‚ญ์ œ ๋ชจ๋“œ ๋ฒ„ํŠผ๋“ค... */}
    </div>
  );
};

๋ชจ๋“œ๋ณ„ ๊ธฐ๋Šฅ:

  • ํ…์ŠคํŠธ ๋ชจ๋“œ (T): ํด๋ฆญ์œผ๋กœ ํ…์ŠคํŠธ ํ•„๋“œ ์ƒ์„ฑ
  • ์ด๋™ ๋ชจ๋“œ: ๋“œ๋ž˜๊ทธ๋กœ ํ…์ŠคํŠธ ์ด๋™, Shift+๋“œ๋ž˜๊ทธ๋กœ ๋‹ค์ค‘ ์„ ํƒ
  • ์‚ญ์ œ ๋ชจ๋“œ: 1.5์ดˆ ๊ธธ๊ฒŒ ํด๋ฆญ์œผ๋กœ ์•ˆ์ „ํ•œ ์‚ญ์ œ

2. ํ‚ค๋ณด๋“œ ๋‹จ์ถ•ํ‚ค ์ง€์›

export const useKeyboard = (onModeChange, isTextEditing) => {
  useEffect(() => {
    const handleKeyDown = (e) => {
      if (isTextEditing) return;
      
      const key = e.key.toLowerCase();
      
      if (key === 'a') {
        e.preventDefault();
        onModeChange('text');
      } else if (key === 's') {
        e.preventDefault();
        onModeChange('move');
      } else if (key === 'd') {
        e.preventDefault();
        onModeChange('delete');
      }
    };

    document.addEventListener('keydown', handleKeyDown);
    return () => {
      document.removeEventListener('keydown', handleKeyDown);
    };
  }, [onModeChange, isTextEditing]);
};

3. ๋ฐ˜์‘ํ˜• ๋””์ž์ธ

Tailwind CSS๋ฅผ ํ™œ์šฉํ•œ ์™„์ „ ๋ฐ˜์‘ํ˜• ๋””์ž์ธ:

/* ๊ธฐ๋ณธ ์Šคํƒ€์ผ ๋ฆฌ์…‹ */
* {
  box-sizing: border-box;
}

body {
  margin: 0;
  padding: 0;
  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',
    'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue',
    sans-serif;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  overflow: hidden;
}

/* ์บ”๋ฒ„์Šค ์Šคํฌ๋กค๋ฐ” ์ˆจ๊ธฐ๊ธฐ */
canvas::-webkit-scrollbar {
  display: none;
}

/* ํ…์ŠคํŠธ ํ•„๋“œ ์ปค์Šคํ…€ ์Šคํƒ€์ผ */
.draggable-text {
  user-select: none;
  -webkit-user-select: none;
  -moz-user-select: none;
  -ms-user-select: none;
}

๐Ÿš€ ์„ฑ๋Šฅ ์ตœ์ ํ™” ์ „๋žต

1. ๋ฉ”๋ชจ๋ฆฌ ๊ด€๋ฆฌ

useEffect(() => {
  if (isDragging) {
    document.addEventListener('mousemove', handleMouseMove);
    document.addEventListener('mouseup', handleMouseUp);
    return () => {
      document.removeEventListener('mousemove', handleMouseMove);
      document.removeEventListener('mouseup', handleMouseUp);
    };
  }
}, [isDragging, handleMouseMove, handleMouseUp]);

2. ์ด๋ฒคํŠธ ์ตœ์ ํ™”

const handleMouseMove = useCallback((e) => {
  if (!isDragging) return;
  
  const newX = (e.clientX - dragStart.x - canvasTransform.x) / canvasTransform.scale;
  const newY = (e.clientY - dragStart.y - canvasTransform.y) / canvasTransform.scale;
  
  if (isMultiSelecting && isSelected && onUpdateGroupDrag) {
    onUpdateGroupDrag(id, newX, newY);
  } else {
    onUpdate(id, { x: newX, y: newY, text: currentText });
  }
}, [isDragging, dragStart, id, currentText, onUpdate, canvasTransform, isMultiSelecting, isSelected, onUpdateGroupDrag]);

3. ๋ Œ๋”๋ง ์ตœ์ ํ™”

  • ๊ฐ€์ƒํ™”: ํ•„์š”ํ•œ ์˜์—ญ๋งŒ ๋ Œ๋”๋ง
  • ๋ฉ”๋ชจ์ด์ œ์ด์…˜: React.memo์™€ useCallback ํ™œ์šฉ
  • ์ง€์—ฐ ๋กœ๋”ฉ: ์ปดํฌ๋„ŒํŠธ๋ณ„ ์ฝ”๋“œ ์Šคํ”Œ๋ฆฌํŒ…

๐Ÿ”’ ๋ณด์•ˆ ๋ฐ ์—๋Ÿฌ ์ฒ˜๋ฆฌ

1. ์ธ์ฆ ์‹œ์Šคํ…œ

// ์š”์ฒญ ์ธํ„ฐ์…‰ํ„ฐ์—์„œ ์ž๋™ ํ† ํฐ ์ถ”๊ฐ€
apiClient.interceptors.request.use(
  (config) => {
    const token = localStorage.getItem('authToken');
    if (token) {
      config.headers.Authorization = `Bearer ${token}`;
    }
    return config;
  }
);

// ์‘๋‹ต ์ธํ„ฐ์…‰ํ„ฐ์—์„œ 401 ์—๋Ÿฌ ์ฒ˜๋ฆฌ
apiClient.interceptors.response.use(
  (response) => response,
  (error) => {
    if (error.response?.status === 401) {
      localStorage.removeItem('authToken');
      window.location.href = '/login';
    }
    return Promise.reject(error);
  }
);

2. ์—๋Ÿฌ ๊ฒฝ๊ณ„ (Error Boundary)

const handleCreateWorkspace = async (e) => {
  e.preventDefault();
  if (!newWorkspaceName.trim()) return;

  setIsCreating(true);
  try {
    const workspace = await WorkspaceService.createWorkspace(newWorkspaceName);
    setWorkspaces(prev => [...prev, workspace]);
    setNewWorkspaceName('');
    setShowCreateForm(false);
    
    if (onWorkspaceCreated) {
      onWorkspaceCreated(workspace);
    }
  } catch (error) {
    console.error('์›Œํฌ์ŠคํŽ˜์ด์Šค ์ƒ์„ฑ ์‹คํŒจ:', error);
    alert('์›Œํฌ์ŠคํŽ˜์ด์Šค ์ƒ์„ฑ์— ์‹คํŒจํ–ˆ์Šต๋‹ˆ๋‹ค: ' + error.message);
  } finally {
    setIsCreating(false);
  }
};

๐Ÿ“ฑ ๋ชจ๋ฐ”์ผ ์ง€์›

1. ํ„ฐ์น˜ ์ œ์Šค์ฒ˜ ์ง€์›

// ๋ธŒ๋ผ์šฐ์ € ์คŒ ์™„์ „ ์ฐจ๋‹จ (์บ”๋ฒ„์Šค ์คŒ๋งŒ ํ—ˆ์šฉ)
useEffect(() => {
  const preventZoom = (e) => {
    if (e.ctrlKey || e.metaKey) {
      e.preventDefault();
      e.stopPropagation();
      return false;
    }
  };

  document.addEventListener('wheel', preventZoom, { passive: false });
  document.addEventListener('keydown', preventKeyboardZoom, { passive: false });
  document.addEventListener('gesturestart', preventZoom, { passive: false });
  document.addEventListener('gesturechange', preventZoom, { passive: false });
  document.addEventListener('gestureend', preventZoom, { passive: false });
}, []);

2. ๋ฐ˜์‘ํ˜• ๋ ˆ์ด์•„์›ƒ

/* ๋ชจ๋ฐ”์ผ ์ตœ์ ํ™” */
@media (max-width: 768px) {
  .floating-toolbar {
    bottom: 1rem;
    left: 50%;
    transform: translateX(-50%);
  }
  
  .chat-panel {
    width: 90vw;
    height: 60vh;
  }
}

๐Ÿ“Š ์„ฑ๋Šฅ ๋ฉ”ํŠธ๋ฆญ

1. ๋ฒˆ๋“ค ํฌ๊ธฐ ์ตœ์ ํ™”

  • ์ดˆ๊ธฐ ๋ฒˆ๋“ค: ~200KB (gzipped)
  • ์ฝ”๋“œ ์Šคํ”Œ๋ฆฌํŒ…: ๋ผ์šฐํŠธ๋ณ„ ๋ถ„ํ• 
  • Tree Shaking: ์‚ฌ์šฉํ•˜์ง€ ์•Š๋Š” ์ฝ”๋“œ ์ œ๊ฑฐ

2. ๋Ÿฐํƒ€์ž„ ์„ฑ๋Šฅ

  • FPS: 60fps ์œ ์ง€
  • ๋ฉ”๋ชจ๋ฆฌ ์‚ฌ์šฉ๋Ÿ‰: < 100MB
  • ๋ Œ๋”๋ง ์‹œ๊ฐ„: < 16ms

๐Ÿ”ฎ ํ–ฅํ›„ ๊ณ„ํš

1. ์ถ”๊ฐ€ ๊ธฐ๋Šฅ

  • AI ๊ธฐ๋ฐ˜ ์•„์ด๋””์–ด ํด๋Ÿฌ์Šคํ„ฐ๋ง: OpenAI API ์—ฐ๋™
  • ์Œ์„ฑ ์ฑ„ํŒ…: WebRTC ๊ธฐ๋ฐ˜ ์‹ค์‹œ๊ฐ„ ์Œ์„ฑ ํ†ต์‹ 
  • ๋ฒ„์ „ ๊ด€๋ฆฌ: ์ž‘์—… ํžˆ์Šคํ† ๋ฆฌ ์ถ”์ 
  • ํ…œํ”Œ๋ฆฟ ์‹œ์Šคํ…œ: ๋ฏธ๋ฆฌ ์ •์˜๋œ ๋ ˆ์ด์•„์›ƒ ์ œ๊ณต

2. ๊ธฐ์ˆ ์  ๊ฐœ์„ 

  • PWA ์ง€์›: ์˜คํ”„๋ผ์ธ ์ž‘์—… ๊ฐ€๋Šฅ
  • WebAssembly: ์„ฑ๋Šฅ ํ–ฅ์ƒ
  • WebGL: 3D ์บ”๋ฒ„์Šค ์ง€์›
  • ๋งˆ์ดํฌ๋กœ์„œ๋น„์Šค: ํ™•์žฅ์„ฑ ๊ฐœ์„ 

๐Ÿ’ก ๊ฐœ๋ฐœ ๊ณผ์ •์—์„œ์˜ ์ธ์‚ฌ์ดํŠธ

1. ๊ธฐ์ˆ ์  ๋„์ „

๋ฌดํ•œ ์บ”๋ฒ„์Šค ๊ตฌํ˜„์˜ ์–ด๋ ค์›€:

  • ๋ฉ”๋ชจ๋ฆฌ ๊ด€๋ฆฌ: ๋ฌดํ•œํ•œ ๊ณต๊ฐ„์„ ํšจ์œจ์ ์œผ๋กœ ๊ด€๋ฆฌ
  • ์„ฑ๋Šฅ ์ตœ์ ํ™”: ๋Œ€๋Ÿ‰์˜ DOM ์š”์†Œ ๋ Œ๋”๋ง ์ตœ์ ํ™”
  • ์‚ฌ์šฉ์ž ๊ฒฝํ—˜: ์ง๊ด€์ ์ธ ์คŒ/ํŒฌ ์ œ์Šค์ฒ˜ ๊ตฌํ˜„

ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•:

  • ๊ทธ๋ฆฌ๋“œ ๊ธฐ๋ฐ˜ ์˜์—ญ ๊ด€๋ฆฌ๋กœ ๋ฉ”๋ชจ๋ฆฌ ํšจ์œจ์„ฑ ํ™•๋ณด
  • ๊ฐ€์ƒํ™” ๊ธฐ์ˆ ๋กœ ํ•„์š”ํ•œ ์˜์—ญ๋งŒ ๋ Œ๋”๋ง
  • ๋„ค์ดํ‹ฐ๋ธŒ ์•ฑ ์ˆ˜์ค€์˜ ๋ถ€๋“œ๋Ÿฌ์šด ์• ๋‹ˆ๋ฉ”์ด์…˜ ๊ตฌํ˜„

2. ์‹ค์‹œ๊ฐ„ ํ˜‘์—…์˜ ๋ณต์žก์„ฑ

๋™์‹œ์„ฑ ๋ฌธ์ œ:

  • ์—ฌ๋Ÿฌ ์‚ฌ์šฉ์ž๊ฐ€ ๋™์‹œ์— ๊ฐ™์€ ์˜์—ญ์„ ์ˆ˜์ •ํ•  ๋•Œ์˜ ์ถฉ๋Œ
  • ๋„คํŠธ์›Œํฌ ์ง€์—ฐ์œผ๋กœ ์ธํ•œ ์ƒํƒœ ๋ถˆ์ผ์น˜
  • ์—ฐ๊ฒฐ ๋Š๊น€ ์‹œ ๋ฐ์ดํ„ฐ ๋ณต๊ตฌ

ํ•ด๊ฒฐ ์ „๋žต:

  • Operational Transform (OT) ์•Œ๊ณ ๋ฆฌ์ฆ˜ ์ ์šฉ
  • ๋‚™๊ด€์  ์—…๋ฐ์ดํŠธ์™€ ์ถฉ๋Œ ํ•ด๊ฒฐ ๋ฉ”์ปค๋‹ˆ์ฆ˜
  • ์ž๋™ ์žฌ์—ฐ๊ฒฐ ๋ฐ ์ƒํƒœ ๋™๊ธฐํ™”

3. ์‚ฌ์šฉ์ž ๊ฒฝํ—˜ ์„ค๊ณ„

์ง๊ด€์„ฑ vs ๊ธฐ๋Šฅ์„ฑ:

  • ๋ณต์žกํ•œ ๊ธฐ๋Šฅ์„ ๋‹จ์ˆœํ•œ ์ธํ„ฐํŽ˜์ด์Šค๋กœ ์ œ๊ณต
  • ํ‚ค๋ณด๋“œ ๋‹จ์ถ•ํ‚ค์™€ ๋งˆ์šฐ์Šค ์ œ์Šค์ฒ˜์˜ ๊ท ํ˜•
  • ๋ชจ๋ฐ”์ผ๊ณผ ๋ฐ์Šคํฌํ†ฑ์˜ ์ผ๊ด€๋œ ๊ฒฝํ—˜

๐ŸŽฏ ๊ฒฐ๋ก 

ONit ๋ฌดํ•œ ์บ”๋ฒ„์Šค ํ˜‘์—… ํ”Œ๋žซํผ ํ”„๋กœ์ ํŠธ๋ฅผ ํ†ตํ•ด ํ˜„๋Œ€์ ์ธ ์›น ๊ฐœ๋ฐœ์˜ ๋ชจ๋“  ์ธก๋ฉด์„ ๊ฒฝํ—˜ํ•  ์ˆ˜ ์žˆ์—ˆ์Šต๋‹ˆ๋‹ค.

ํ•ต์‹ฌ ์„ฑ๊ณผ:

  • โœ… ์‹ค์‹œ๊ฐ„ ํ˜‘์—…: Socket.IO๋ฅผ ํ™œ์šฉํ•œ ์ฆ‰์‹œ ๋™๊ธฐํ™”
  • โœ… ๋ฌดํ•œ ํ™•์žฅ: ์ œํ•œ ์—†๋Š” ์ž‘์—… ๊ณต๊ฐ„ ์ œ๊ณต
  • โœ… ์ง๊ด€์  UX: ํ•™์Šต ๊ณก์„ ์ด ๋‚ฎ์€ ์‚ฌ์šฉ์ž ์ธํ„ฐํŽ˜์ด์Šค
  • โœ… ํ™•์žฅ ๊ฐ€๋Šฅํ•œ ์•„ํ‚คํ…์ฒ˜: ๋ชจ๋“ˆํ™”๋œ ์„œ๋น„์Šค ๊ตฌ์กฐ
  • โœ… ์„ฑ๋Šฅ ์ตœ์ ํ™”: ๋Œ€์šฉ๋Ÿ‰ ๋ฐ์ดํ„ฐ ์ฒ˜๋ฆฌ ์ตœ์ ํ™”

๊ธฐ์ˆ ์  ์„ฑ์žฅ:

  • React Hooks์™€ ์ƒํƒœ ๊ด€๋ฆฌ์˜ ๊นŠ์€ ์ดํ•ด
  • Socket.IO๋ฅผ ํ™œ์šฉํ•œ ์‹ค์‹œ๊ฐ„ ํ†ต์‹  ๊ตฌํ˜„
  • ๋ณต์žกํ•œ ์‚ฌ์šฉ์ž ์ธํ„ฐ๋ž™์…˜ ์„ค๊ณ„ ๊ฒฝํ—˜
  • ์„ฑ๋Šฅ ์ตœ์ ํ™”์™€ ๋ฉ”๋ชจ๋ฆฌ ๊ด€๋ฆฌ ๊ธฐ์ˆ  ์Šต๋“

์ด ํ”„๋กœ์ ํŠธ๋Š” ๋‹จ์ˆœํ•œ ์›น ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๋„˜์–ด์„œ ์‚ฌ์šฉ์ž ์ค‘์‹ฌ์˜ ํ˜์‹ ์ ์ธ ํ˜‘์—… ๋„๊ตฌ๋กœ ๋ฐœ์ „์‹œํ‚ฌ ์ˆ˜ ์žˆ๋Š” ๊ธฐ๋ฐ˜์„ ๋งˆ๋ จํ–ˆ์Šต๋‹ˆ๋‹ค. ์•ž์œผ๋กœ AI ๊ธฐ์ˆ ๊ณผ ๊ฒฐํ•ฉํ•˜์—ฌ ๋”์šฑ ์ง€๋Šฅ์ ์ธ ํ˜‘์—… ํ™˜๊ฒฝ์„ ์ œ๊ณตํ•  ์ˆ˜ ์žˆ์„ ๊ฒƒ์œผ๋กœ ๊ธฐ๋Œ€ํ•ฉ๋‹ˆ๋‹ค.


์ด ํ”„๋กœ์ ํŠธ๋Š” React, Socket.IO, ๊ทธ๋ฆฌ๊ณ  ํ˜„๋Œ€์ ์ธ ์›น ๊ฐœ๋ฐœ ๊ธฐ์ˆ ์„ ํ™œ์šฉํ•˜์—ฌ ๊ตฌํ˜„๋œ ๋ฌดํ•œ ์บ”๋ฒ„์Šค ํ˜‘์—… ํ”Œ๋žซํผ์ž…๋‹ˆ๋‹ค. ์ „์ฒด ์†Œ์Šค์ฝ”๋“œ๋Š” GitHub์—์„œ ํ™•์ธํ•˜์‹ค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.