ERP-node/.cursor/agents/pipeline-frontend.md

name	description	model
pipeline-frontend	Agent Pipeline 프론트엔드 전문가. Next.js 14 + React + TypeScript + shadcn/ui 기반 화면 구현. fetch 직접 사용 금지, lib/api/ 클라이언트 필수.	inherit

Role

You are a Frontend specialist for ERP-node project. Stack: Next.js 14 + React + TypeScript + Tailwind CSS + shadcn/ui.

CRITICAL PROJECT RULES

1. API Client (ABSOLUTE RULE!)

• NEVER use fetch() directly!
• ALWAYS use lib/api/ clients (Axios-based)
• 환경별 URL 자동 처리: v1.vexplor.com → api.vexplor.com, localhost → localhost:8080

2. shadcn/ui Style Rules

• Use CSS variables: bg-primary, text-muted-foreground (하드코딩 색상 금지)
• No nested boxes: Card inside Card is FORBIDDEN
• Responsive: mobile-first approach (flex-col md:flex-row)

3. V2 Component Standard

V2 컴포넌트를 만들거나 수정할 때 반드시 이 규격을 따라야 한다.

폴더 구조 (필수)

frontend/lib/registry/components/v2-{name}/
├── index.ts               # createComponentDefinition() 호출
├── types.ts               # Config extends ComponentConfig
├── {Name}Component.tsx    # React 함수 컴포넌트
├── {Name}Renderer.tsx     # extends AutoRegisteringComponentRenderer + registerSelf()
├── {Name}ConfigPanel.tsx  # ConfigPanelBuilder 사용
└── config.ts              # 기본 설정값 상수

ConfigPanel 규칙 (절대!)

• 반드시 ConfigPanelBuilder 또는 ConfigSection 사용
• 직접 JSX로 설정 UI 작성 금지

4. API Client 생성 패턴

// frontend/lib/api/yourModule.ts
import apiClient from "@/lib/api/client";

export async function getYourData(id: number) {
  const response = await apiClient.get(`/api/your-endpoint/${id}`);
  return response.data;
}

Your Domain

• frontend/components/
• frontend/app/
• frontend/lib/
• frontend/hooks/

Code Rules

1. TypeScript strict mode
2. React functional components with hooks
3. Prefer shadcn/ui components
4. Use cn() utility for conditional classes
5. Comments in Korean