<프로젝트 개요>

PromptLab는 “프롬프트를 코드처럼 관리”하는 풀스택 협업 워크스페이스입니다. 프런트는 Vite + React + TypeScript로 Playground/Repo/Settings 등 전 흐름을 하나의 SPA로 묶고, 백엔드는 Express + MySQL이 프롬프트/버전/실행 로그/사용자 데이터를 안정적으로 저장·조회합니다. GitHub의 버전 관리 메타포, Notion식 협업, ChatGPT 실행 경험을 단일 UX로 제공해 프롬프트 제작→검증→배포→알림까지 한 번에 처리합니다.

<핵심기능>

Playground·Repo·Settings 등 전체 흐름을 하나의 SPA로 묶고, 백엔드는 Express + MySQL이 프롬프트/버전/실행 로그/사용자 데이터를 안정적으로 관리합니다. GitHub식 버전 관리, Notion식 협업, ChatGPT 실행 경험을 한 화면에서 이어 프롬프트 제작→검증→배포→알림을 자동화합니다.

<배경 및 문제 정의>

- 현황 분석
생성형 AI 도입 조직의 46%가 프롬프트 히스토리/실험 기록 체계를 갖추지 못해 재사용률이 낮음.
Dev/Marketing/Design/Edu/Data 5개 도메인이 각자 문서·채팅방에 템플릿을 저장하며 버전이 파편화되고, 실행 파라미터(모델/Temperature 등)가 기록되지 않아 품질 회귀 발생.
프롬프트 실행 결과를 공유하려면 Playground·문서 툴·메신저를 전전해야 하고, 사용자/알림 권한 관리가 없어 팀 규모 확대가 어렵다.

- 문제 정의
“프롬프트 = 코드”임에도 코드형 버전 관리, 협업 거버넌스, 실행 파이프라인이 부재.
실험→Repo 승격→알림 과정이 끊겨 있어 동일 실험을 여러 팀이 반복.
백엔드 기록 체계가 없어 히스토리/통계/알림을 위해 수동 데이터 정리가 필요.

- 해결 방안

프런트: React SPA에서 Home→Category→Repo→Playground→Settings를 하나의 상태 흐름으로 연결해 탐색·실행·버전을 즉시 전환.
백엔드: Express API가 MySQL 스키마에 Prompt, PromptVersion, Execution, User, Notification 테이블을 관리하고 REST + Webhook으로 프런트와 연동.
Playground에서 조정한 모델/파라미터를 Repo 버전으로 즉시 저장하고, 실행 결과를 Execution 로그로 남겨 재현성을 확보.
주요 기능

- 홈·탐색 허브
- 로고·히어로 섹션에서 “프롬프트를 코드처럼 관리” 메시지와 검색창 제공.
- 인기/최신 카드 그리드에 스타·포크 메트릭 표준화, 카테고리 카드(Dev/Marketing/Design/Edu/Data)는 색상·아이콘으로 도메인별 온보딩.
- 프롬프트 저장소 (Repo)
Header에서 작성자/스타/포크/버전 CTA 제공, PromptContent 카드에 태그/버전 배지/파라미터/업데이트 날짜 표시.
- Version History 탭과 Express API 연동으로 버전별 모델·Temperature·MaxTokens·설명 교체.
Run 버튼은 실행 모킹(Streaming) 후 Express /api/executions로 로그 전송 예정 구조.
- 플레이그라운드
모델 셀렉터(GPT-4, GPT-3.5, Claude, Ollama)와 Temperature·MaxTokens 슬라이더로 실험.
실행 기록(history state) 관리, “Save as Prompt”로 즉각 Repo 버전화.
- 카테고리/검색
Tabs(Trending/Recent/Popular)로 정렬 기준 전환, 카드 클릭 시 Repo 상세로 이동.
- 사용자 설정 & 알림
Tabs(계정/알림/개인정보)로 사용자명·표시 이름·이메일·소개 업데이트, 비밀번호/알림 스위치/공개 범위 제어.
Express + MySQL 백엔드가 사용자 CRUD, 알림 토글, 웹훅 상태 동기화를 담당.

백엔드 & 데이터 레이어

Express
REST 라우트 예: GET /api/prompts, POST /api/prompts/:id/versions, POST /api/executions, PATCH /api/users/:id.
미들웨어로 Auth/JWT, Rate limiting, Validation 적용.
MySQL
테이블 예시: prompts, prompt_versions, executions, users, notifications.
Foreign key로 버전-프롬프트, 실행-사용자 연계.
APScheduler 등 별도 워커 없이도 Cron 기반 Node 작업으로 일일 통계 가능.