워크플로우 표준화와 팀 가이드라인

📖 이론10분

🛠️ 실습15분

🎯 미션5분

"규칙이 없으면 자유도 없다. 혼돈만 있을 뿐이다."

— 아리스토텔레스 (Aristotle, 고대 그리스 철학자)

🎯 오늘의 학습 목표

워크플로우 네이밍 컨벤션을 수립하고 팀 전체에 적용할 수 있다.
Sticky Note를 활용해 워크플로우 문서화를 표준화할 수 있다.
팀 n8n 가이드라인 문서를 작성할 수 있다.

왜 표준화가 필요한가?

팀원이 늘어날수록 '이 워크플로우가 뭐하는 건지 모르겠어요'라는 말이 늘어납니다. 표준화된 네이밍과 문서화는 온보딩 시간을 줄이고, 운영 사고를 예방합니다.

📊 워크플로우 네이밍 컨벤션

구분	나쁜 예	좋은 예
워크플로우 이름	테스트1, 새 워크플로우	sales_send_quote_v1
노드 이름	HTTP Request, Set	고객정보_가져오기, 이메일주소_추출
웹훅 경로	/webhook/abc123	/webhook/new-customer-form

네이밍 형식

형식: [부서]_[동작]_[대상]_[빈도]_v[버전] 예시: - mkt_send_newsletter_v1 (마케팅팀 뉴스레터 발송) - sales_sync_crm_daily_v2 (영업팀 CRM 일별 동기화) - hr_notify_vacation_v1 (HR팀 연차 알림)

Sticky Note 표준 템플릿

markdown

## 워크플로우명
**목적**: 매주 월요일 영업 실적을 구글 시트에서 읽어 팀장 이메일로 요약 보고서 발송
**트리거**: 매주 월요일 오전 9시

**데이터 흐름**:
1. Google Sheets → 지난주 영업 데이터 조회
2. Code 노드 → 요약 통계 계산
3. Gmail → 팀장에게 이메일 발송

**주의사항**:
- Google Sheets 크리덴셜 만료 확인 필요 (분기 1회)

**최종 수정**: 2025-03-15 / 홍길동

팀 n8n 가이드라인 문서 템플릿

markdown

# [회사명] n8n 팀 가이드라인

## 1. 기본 규칙
- 새 워크플로우는 반드시 Dev 프로젝트에서 먼저 테스트
- Production 워크플로우 수정 전 팀장 승인 필수
- 크리덴셜은 개인적으로 생성하지 말고 팀 크리덴셜 사용

## 2. 네이밍 규칙
형식: [팀약자]_[동작]_[대상]_v[버전]

## 3. 노드 이름 규칙
- 기본 이름(HTTP Request, Set 등) 그대로 쓰지 말 것
- 기능을 설명하는 이름 사용: '고객데이터_가져오기', '이메일주소_추출'

## 4. Sticky Note 필수 작성 항목
- 워크플로우 목적
- 주의 사항
- 최종 수정일 + 수정자

## 5. 오류 처리
- 모든 외부 API 호출에 Error 핸들러 추가
- 중요한 워크플로우에는 반드시 Slack 오류 알림 연결

🛠️ DAY 18 실습

Step 1기존 워크플로우 이름 정비

n8n 대시보드에서 모든 워크플로우 이름 확인
네이밍 규칙에 맞지 않는 것들을 목록으로 정리
[부서]_[동작]_[대상]_v[버전] 형식으로 이름 변경

Step 2Sticky Note 추가

운영 중인 주요 워크플로우 3개 선택
각 워크플로우 첫 부분에 Sticky Note 노드 추가
표준 템플릿에 맞게 목적, 트리거, 데이터 흐름, 주의사항 작성

Step 3팀 가이드라인 문서 작성

Notion 또는 Google Docs에 팀 가이드라인 페이지 생성
네이밍 규칙, 노드 이름 규칙, 오류 처리 규칙 작성
팀원들과 공유 및 피드백 수집

🚀 DAY 18 미션

팀 n8n 가이드라인 문서를 Notion 또는 Google Docs에 작성하고, 기존 워크플로우 3개의 이름을 네이밍 컨벤션에 맞게 수정한 뒤 Sticky Note를 추가하세요.

☑️ 미션 체크리스트

워크플로우 네이밍 컨벤션 수립 및 기존 워크플로우 이름 정비
주요 워크플로우 3개에 Sticky Note 추가
팀 가이드라인 문서 초안 작성 완료
팀원 1명 이상에게 가이드라인 공유

💡 힌트: Sticky Note는 n8n 편집기에서 노드 패널의 'Sticky Note'를 검색하면 찾을 수 있어요.

🎯 성공 기준: 팀 가이드라인 문서가 완성되고, 3개 워크플로우에 Sticky Note가 추가된 상태

← 이전

워크플로우 버전 관리와 소스 컨트롤

PART 3 미니 프로젝트: 10인 팀 n8n 운영 환경 설계

← 목차로 돌아가기