refactor: simplify CLAUDE.md + create BLOG_TEMPLATE.md
TaxBaik CI/CD / build-and-deploy (push) Failing after 40s
TaxBaik CI/CD / build-and-deploy (push) Failing after 40s
- Reduce CLAUDE.md blog section to essential guidelines only (10 lines) - Move detailed templates and checklists to new BLOG_TEMPLATE.md - Update core philosophy: education + natural professional referral - Not 'hire me' but 'understand concepts → know when to consult' BLOG_TEMPLATE.md includes: ✅ Complete 5-step blog post template ✅ Real persona examples (name, age, job, income) ✅ Before/After case structure ✅ Step-by-step calculation with tables ✅ Tone guidance (empowerment + professional value) ✅ Checklist for writers ✅ Do's & Don'ts ✅ Seasonal content ideas Philosophy: - Basic tax knowledge: anyone can do it - Complex cases: professionals add efficiency - Goal: grow customer understanding + increase professional service value
This commit is contained in:
@@ -0,0 +1,226 @@
|
||||
# 블로그 포스트 작성 템플릿
|
||||
|
||||
## 🎯 핵심 철학
|
||||
- **목표**: 고객들이 세무 개념을 이해 → 세무사의 가치를 더 잘 인식
|
||||
- **톤**: 교육적이고 격려적 (하지만 의존성은 자연스럽게 유도)
|
||||
- **메시지**: "기초는 이렇게, 복잡하면 전문가와 함께"
|
||||
|
||||
---
|
||||
|
||||
## 📝 템플릿 (복사해서 사용)
|
||||
|
||||
### 📌 Step 1: 도입부 (공감)
|
||||
```markdown
|
||||
# [제목]
|
||||
|
||||
"[구체적 상황]?"
|
||||
"많은 [직업]들이 이 상황을 겪습니다."
|
||||
|
||||
→ 독자가 자신의 상황을 발견하도록
|
||||
```
|
||||
|
||||
**예시**:
|
||||
```markdown
|
||||
# 동네 카페 월세 낼 때 세금이 안 나와요 - 정말 그럴까?
|
||||
|
||||
"사업을 시작했는데 세금을 낸 적이 없어요"
|
||||
"많은 소규모 사업자들이 이렇게 생각합니다."
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 👤 Step 2: 실제 사례 (구체적 페르소나)
|
||||
|
||||
**필수 정보**:
|
||||
- 이름, 나이, 직업, 사업 경력
|
||||
- 월/연간 매출 (현실적 수치)
|
||||
- 실제 겪은 문제/성공 사례
|
||||
|
||||
```markdown
|
||||
### 상황: [지역] [카테고리]를 운영하는 [이름]님 ([나이]세, 사업 [년]차)
|
||||
|
||||
**기본 정보**:
|
||||
- 위치: [구체적 위치]
|
||||
- 월 매출: [금액]
|
||||
- 월 경비: [주요 항목들]
|
||||
|
||||
### 원래는 이렇게 했어요 (실패 사례)
|
||||
→ [실제 실수 1]
|
||||
→ [실제 실수 2]
|
||||
→ **결과**: 세금을 [X만 원] 더 내게 됨 (또는 세무조사 대상)
|
||||
|
||||
### 바뀐 후 (성공 사례)
|
||||
→ [해결책 1]
|
||||
→ [해결책 2]
|
||||
→ **결과**: 세금을 [X만 원] 절약함 (또는 안정적인 운영)
|
||||
```
|
||||
|
||||
**예시**:
|
||||
```markdown
|
||||
### 상황: 강남 역삼동에서 카페를 운영하는 김민수님 (34세, 사업 3년차)
|
||||
|
||||
**기본 정보**:
|
||||
- 위치: 강남역 3번 출구 근처
|
||||
- 월 매출: 약 600만 원 (평일 200만, 주말 400만)
|
||||
- 월 경비: 월세 150만, 재료비 180만, 직원급여 100만 원
|
||||
|
||||
### 원래는 이렇게 했어요
|
||||
→ "세금은 큰 회사나 내는 거라고 생각했어요"
|
||||
→ 영수증도 대충 정리하고
|
||||
→ **결과**: 세무청에서 3년치를 추징받고 가산세까지...손해 70만 원
|
||||
|
||||
### 바뀐 후
|
||||
→ 매달 영수증을 정리해서
|
||||
→ 세무사와 년 1회 기장 상담
|
||||
→ **결과**: 세금도 명확하고, 추징도 없음. 심플하고 안전
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 📊 Step 3: 계산 & 설명
|
||||
|
||||
**구조**:
|
||||
1. **기본 정보 확인** (위에서 제시한 사례 요약)
|
||||
2. **단계별 계산** (Step 1, Step 2, ... 명확히)
|
||||
3. **표로 시각화**
|
||||
|
||||
```markdown
|
||||
## 계산 방법
|
||||
|
||||
### Step 1️⃣: 매출 정리
|
||||
월 600만 원 × 12개월 = 연 7,200만 원
|
||||
|
||||
### Step 2️⃣: 경비 계산
|
||||
| 항목 | 월 | 연간 |
|
||||
|------|-----|------|
|
||||
| 월세 | 150만 | 1,800만 |
|
||||
| 재료비 | 180만 | 2,160만 |
|
||||
| 직원급여 | 100만 | 1,200만 |
|
||||
| 기타 | 20만 | 240만 |
|
||||
| **합계** | **450만** | **5,400만** |
|
||||
|
||||
### Step 3️⃣: 순이익
|
||||
7,200만 - 5,400만 = **1,800만 원**
|
||||
|
||||
### Step 4️⃣: 세금
|
||||
1,800만 원 × 약 6% = **약 108만 원/년**
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 💡 Step 4: 실무 팁 (3~5개)
|
||||
|
||||
**구조**: ✅ 이렇게 하세요 / ❌ 이렇게 하면 안 돼요
|
||||
|
||||
```markdown
|
||||
## 이렇게 하면 세금이 명확해요
|
||||
|
||||
### ✅ 해야 할 것
|
||||
1. **영수증 정리** - 매달 봉투에 모아두기
|
||||
2. **기본 기록** - 엑셀에 간단히 기입
|
||||
3. **연 1회 점검** - 세무사와 기본 상담
|
||||
4. **투명성** - 세무청 신고는 정확하게
|
||||
|
||||
### ❌ 하면 안 되는 것
|
||||
1. **영수증 버리기** - 나중에 증거 없음
|
||||
2. **개인비와 섞기** - 기장 혼란
|
||||
3. **신고 늦추기** - 가산세 발생
|
||||
4. **과하게 깎기** - 세무조사 리스크
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 🎓 Step 5: 결론 (임파워먼트 + 세무사 자연스러운 유도)
|
||||
|
||||
**구조**:
|
||||
1. "기초 수준이면 이 정도면 충분"
|
||||
2. "하지만 이렇게 복잡해지면 전문가 도움이 효율적"
|
||||
3. "세무사와 함께 하는 게 장기적으로 낫다"
|
||||
|
||||
```markdown
|
||||
## 기초는 누구나 할 수 있어요
|
||||
|
||||
**이 정도면 자신이 충분히 가능합니다**:
|
||||
- 소규모 사업 (월 500만~1,000만 원)
|
||||
- 단순 경비 (재료, 임차료 등)
|
||||
- 월 1회 정도 기본 정리
|
||||
|
||||
→ 영수증 정리 + 기본 엑셀 기입면 충분
|
||||
|
||||
---
|
||||
|
||||
## 하지만 이렇게 복잡하면 전문가 도움이 효율적입니다
|
||||
|
||||
**세무사 상담을 권하는 경우**:
|
||||
- 📊 월 매출이 2,000만 원을 넘어갈 때
|
||||
- 💼 여러 사업을 동시에 운영할 때
|
||||
- 🏠 부동산 등 추가 수입이 있을 때
|
||||
- 📈 직원을 여러 명 두고 있을 때
|
||||
- 🌍 해외 거래나 수입이 있을 때
|
||||
|
||||
→ 이런 경우는 세무사와 함께 하면:
|
||||
- ✅ 세금을 더 효율적으로 절약 (프로 기법)
|
||||
- ✅ 세무조사 때 당당하게 대응
|
||||
- ✅ 복잡한 문제를 빠르게 해결
|
||||
- ✅ 시간을 절약 (당신은 사업에만 집중)
|
||||
|
||||
---
|
||||
|
||||
## 요약
|
||||
|
||||
**기본 개념을 아는 것만으로도**:
|
||||
- 실수를 줄이고
|
||||
- 세금을 절약하고
|
||||
- 세무사와의 상담이 훨씬 효율적
|
||||
|
||||
당신의 상황이 어느 정도인지 판단하고,
|
||||
필요할 때 전문가와 함께 하세요.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ 작성 체크리스트
|
||||
|
||||
### 내용
|
||||
- [ ] **실제 사례**: 동네 카페/편의점/학원 같은 주변 상황
|
||||
- [ ] **구체적 페르소나**: 이름, 나이, 직업, 사업 경력
|
||||
- [ ] **실제 금액**: 매출, 경비, 세금 (현실적 수치)
|
||||
- [ ] **Before/After**: 실패 사례 → 성공 사례
|
||||
- [ ] **절세 효과**: "X만 원 절약" 또는 "손해를 막음"
|
||||
- [ ] **계산**: Step별로 명확, 표 포함
|
||||
|
||||
### 톤
|
||||
- [ ] **교육적**: 개념을 이해하도록
|
||||
- [ ] **격려적**: 경고/협박 없음
|
||||
- [ ] **현실적**: 복잡할 수 있다는 인정
|
||||
- [ ] **세무사 자연스러운 유도**: "필요할 때 도움되는 선택"
|
||||
- [ ] **임파워먼트**: "기초는 누구나 할 수 있어요"
|
||||
|
||||
### 표현
|
||||
- [ ] **중학교 수준**: 어려운 용어는 () 설명
|
||||
- [ ] **이모지**: 🏠💰✅❌📊 등으로 시각화
|
||||
- [ ] **짧은 문장**: 한 문장에 한 개념
|
||||
- [ ] **표와 리스트**: 수치는 표로, 항목은 리스트로
|
||||
|
||||
---
|
||||
|
||||
## 피해야 할 표현
|
||||
|
||||
| ❌ 이렇게 | ✅ 이렇게 |
|
||||
|---------|---------|
|
||||
| "복잡하니까 맡기세요" | "기초는 누구나, 복잡하면 전문가" |
|
||||
| "전문가는 필수입니다" | "필요할 때 도움받으면 효율적" |
|
||||
| "혼자서도 잘해요" | "기초 수준은 자신이 가능해요" |
|
||||
| "세무사에 위임하세요" | "당신의 상황에 따라 판단하세요" |
|
||||
| "절대 실수하면 안 돼요" | "실수할 수 있으니 미리 대비하세요" |
|
||||
|
||||
---
|
||||
|
||||
## 시즌별 주제 예시
|
||||
|
||||
| 월 | 추천 주제 | 톤 |
|
||||
|----|---------|-----|
|
||||
| 1월 | 부가세 2기 신고 기한 | "이 정도면 자신이 가능" |
|
||||
| 5월 | 종소세 신고 방법 | "핵심 개념 + 전문가 도움 타이밍" |
|
||||
| 7월 | 부가세 1기 신고 | "기초 정리 방법" |
|
||||
| 11월 | 다음해 준비 | "계획하면 편해요" |
|
||||
@@ -745,134 +745,19 @@ ssh kjh2064@178.104.200.7 crontab -l | grep backup
|
||||
|
||||
---
|
||||
|
||||
## 5-1. 블로그 & FAQ 콘텐츠 작성 규칙 (2026-07-01 신규 지침)
|
||||
## 5-1. 블로그 & FAQ 콘텐츠 작성 규칙
|
||||
|
||||
### 📌 핵심 원칙 3가지
|
||||
**핵심**: 고객 임파워먼트 (당신도 할 수 있습니다!)
|
||||
- ✅ 주변에서 흔히 보는 실제 사례 (이름, 나이, 직업 구체화)
|
||||
- ✅ 절세 효과 수치화 ("세금을 X만 원 절약했습니다")
|
||||
- ✅ 중학교 2학년도 이해 가능한 수준
|
||||
- ✅ 단계별 설명 + 표로 시각화
|
||||
- ✅ 결론: "정확하게 하면 이런 이점이 있습니다" (임파워먼트)
|
||||
|
||||
**1. 실제 고객이 어려워하는 사례 중심**
|
||||
- 추상적 설명 X → 구체적 금액 & 상황 O
|
||||
- "세무 기장 팁" X → "사업자 기장 시 자주 하는 실수 5가지" O
|
||||
**피해야 할 톤**: "복잡하니까 맡기세요" (세무사 의존성 강화)
|
||||
**세무사 언급**: "더 복잡하면 전문가와 상담하세요" (선택지)
|
||||
|
||||
**2. 절세 팁과 실무 조언 (최소 3개)**
|
||||
- 해야 할 것 vs 하면 안 될 것 명확
|
||||
- 예: "영수증을 모으면 X만 원 절약"
|
||||
|
||||
**3. 중학교 2학년도 이해 가능한 수준**
|
||||
- 어려운 용어는 괄호로 쉽게 설명
|
||||
- 표, 그래프, 이모지로 시각화
|
||||
- 문장은 짧고 간결
|
||||
|
||||
### 📝 블로그 포스트 구조 (필수 5단계)
|
||||
|
||||
#### Step 1️⃣: 도입부 (공감 + 질문)
|
||||
```markdown
|
||||
"카페를 운영하는데 세금이 얼마나 될까요?"
|
||||
"많은 사업자들이 이 질문을 합니다."
|
||||
→ 독자가 자신의 상황을 발견하도록 유도
|
||||
```
|
||||
|
||||
#### Step 2️⃣: 실제 사례 (구체적 상황)
|
||||
```markdown
|
||||
### 상황: 카페를 운영하는 김 사장님
|
||||
**월 판매량**: 300개
|
||||
**상품 가격**: 평균 2만 원
|
||||
**월 매출**: 600만 원
|
||||
|
||||
### 문제가 생겼어요
|
||||
→ 영수증을 그냥 버렸어요
|
||||
→ 나중에 세무청이 소득 누락으로 판단해 세금을 더 거두었습니다.
|
||||
```
|
||||
|
||||
#### Step 3️⃣: 계산 & 설명 (단계별)
|
||||
```markdown
|
||||
### Step 1️⃣: 기본 정보 확인
|
||||
### Step 2️⃣: 차익 계산
|
||||
### Step 3️⃣: 공제 계산
|
||||
|
||||
| 항목 | 금액 |
|
||||
|------|------|
|
||||
| 매출 | 600만 원 |
|
||||
| 경비 | 351만 원 |
|
||||
| 순이익 | 249만 원 |
|
||||
```
|
||||
|
||||
#### Step 4️⃣: 실무 팁 (ㅇ vs X)
|
||||
```markdown
|
||||
### ✅ 올바른 방법
|
||||
- 📄 모든 영수증은 봉투에 정리해두기
|
||||
- 📊 매일 또는 매주 판매액을 정리하기
|
||||
|
||||
### ❌ 하면 안 되는 것
|
||||
- 영수증을 그냥 버리기
|
||||
- 개인 물건을 사업 경비로 깎기
|
||||
```
|
||||
|
||||
#### Step 5️⃣: 결론 & 강조 (핵심 3개)
|
||||
```markdown
|
||||
## 💡 꼭 기억하세요!
|
||||
|
||||
**1. 기장은 세금을 줄이는 가장 첫 번째 방법이다**
|
||||
**2. 영수침을 모아두면 정당한 경비를 더 계산할 수 있다**
|
||||
**3. 처음부터 정확하게 하면 나중에 편하다**
|
||||
```
|
||||
|
||||
### ✅ 필수 체크리스트
|
||||
|
||||
- [ ] **실제 고객 사례** (이름, 구체적 금액, 실제 상황)
|
||||
- [ ] **구체적 계산** (Step별로 명확, 표 포함)
|
||||
- [ ] **절세 효과 수치화** ("세금을 X만 원 절약했습니다")
|
||||
- [ ] **중학교 수준 언어** (어려운 용어는 괄호로 설명)
|
||||
- [ ] **법률 정확성** (세법/시행령 오류 없음)
|
||||
- [ ] **이모지 활용** (🏠, 💰, ✅, ❌ 등 시각화)
|
||||
- [ ] **해야 할 것 vs 하면 안 될 것** (명확한 구분)
|
||||
- [ ] **마지막 핵심 3개** (꼭 기억하세요! 섹션)
|
||||
|
||||
### 📋 피해야 할 표현
|
||||
|
||||
| ❌ 하지 말 것 | ✅ 대신 이렇게 |
|
||||
|-----------|-----------|
|
||||
| "세무 기장의 중요성" | "사업자 기장 시 자주 하는 실수 5가지" |
|
||||
| "일반적으로..." | "예: 카페를 운영하는 김 사장님..." |
|
||||
| "복잡한 계산..." | "Step 1,2,3으로 단계별 설명" |
|
||||
| "전문용어 설명 없음" | "세금계산서란 (회사가 품질 보증하는 영수증)" |
|
||||
| "결론 없음" | "💡 꼭 기억하세요! - 3개 핵심 요약" |
|
||||
|
||||
### 🎯 평가 기준 (점수 체계)
|
||||
|
||||
**⭐⭐⭐⭐⭐ (최고: 배포 권장)**
|
||||
- ✅ 실제 고객 상황 & 이름
|
||||
- ✅ 구체적 금액 & 계산 (표 포함)
|
||||
- ✅ 절세 효과 수치화 ("세금 130만 원 절약")
|
||||
- ✅ 중학교 수준의 언어
|
||||
- ✅ 법률 정확성 완벽
|
||||
|
||||
**⭐⭐⭐⭐ (좋음: 사소한 수정 후 배포)**
|
||||
- ✅ 고객 사례 있음
|
||||
- ✅ 계산 과정 명확
|
||||
- ⚠️ 일부 용어 설명 필요
|
||||
|
||||
**⭐⭐⭐ (보통: 개선 필요)**
|
||||
- ⚠️ 추상적 표현 많음
|
||||
- ⚠️ 계산 과정 부족
|
||||
- ⚠️ 절세 팁 부족
|
||||
|
||||
**⭐⭐ 이하 (부족: 재작성)**
|
||||
- ❌ 어려운 용어만 나열
|
||||
- ❌ 법률 오류
|
||||
- ❌ 실무 팁 전무
|
||||
|
||||
### 📌 시즌별 자동 배포 우선순위
|
||||
|
||||
**각 시즌에 관련 포스트가 자동으로 상단에 배치**:
|
||||
|
||||
| 월 | 시즌 | 추천 주제 | 예시 포스트 |
|
||||
|----|------|---------|-----------|
|
||||
| 1월 | 부가세 2기 신고 | 신고 기한 | "부가세 신고 - D-5일" |
|
||||
| 2월 | 연말정산 | 환급 받기 | "환급금 최대화하기" |
|
||||
| 3월 | 법인세 신고 | 법인세 | "법인세 신고 기한" |
|
||||
| 5월 | **종합소득세 (피크)** | **핵심 신고** | "종소세 완벽 가이드" |
|
||||
| 7월 | 부가세 1기 신고 | 신고 기한 | "부가세 신고 놓치지 말기" |
|
||||
| 11월 | 종부세 | 부동산세 | "종부세 계산하기" |
|
||||
**자세한 템플릿 및 체크리스트**: `BLOG_TEMPLATE.md` 참고
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user