diff --git a/BLOG_TEMPLATE.md b/BLOG_TEMPLATE.md index e6c10d1..6e2c764 100644 --- a/BLOG_TEMPLATE.md +++ b/BLOG_TEMPLATE.md @@ -583,3 +583,195 @@ | 5월 | 종소세 신고 방법 | "핵심 개념 + 전문가 도움 타이밍" | | 7월 | 부가세 1기 신고 | "기초 정리 방법" | | 11월 | 다음해 준비 | "계획하면 편해요" | + +--- + +## ⚠️ 실수 방지 체크리스트 (과거 오류 기록) + +**이전에 반복된 실수들을 기록하여, 같은 실수를 하지 않도록 합니다.** + +### 1️⃣ 카테고리 할당 실수 ❌ + +**과거 오류**: 포스트를 만들 때 category_id를 NULL로 두었음 + +**문제점**: +- DB NOT NULL 제약 위반 +- 블로그 페이지에 노출 안 됨 +- 고객이 카테고리로 검색 불가 + +**예방책**: +- ✅ **SQL INSERT 시 반드시 category_id 명시** +- ✅ **포스트 작성 전에 카테고리 결정** +- ✅ **DB 적용 후 category_id NOT NULL 확인** +- ✅ **각 카테고리별 최소 3개 이상 포스트 유지** + +**SQL 예시** (권장): +```sql +INSERT INTO blog_posts (title, slug, content, category_id, is_published, ...) +VALUES ('제목', 'slug', $$본문$$, 1, true, ...); +-- category_id 절대 생략 금지! +``` + +--- + +### 2️⃣ 내용 길이 부족 ❌ + +**과거 오류**: 에이전트가 지침(1,500~2,500자)을 무시하고 간단한 버전(500자)으로 생성 + +**문제점**: +- 고객 설득력 부족 +- 계산 예시 없음 +- 3단계 구조 불완전 +- 세법 인용 부족 + +**예방책**: +- ✅ **각 포스트 최소 1,500자 이상 (추천 2,000~2,500자)** +- ✅ **포스트 작성 후 글자 수 확인: `LENGTH(content) >= 1500`** +- ✅ **항상 실제 사례 포함** (이름, 나이, 직업, 구체적 상황) +- ✅ **항상 계산 과정 포함** (절세액 수치화) +- ✅ **3단계 구조 필수** (1️⃣ 기초 → 2️⃣ 현실 → 3️⃣ 해결책) + +**확인 쿼리**: +```sql +SELECT id, title, LENGTH(content) as length FROM blog_posts +WHERE LENGTH(content) < 1500; -- 부족한 포스트 검출 +``` + +--- + +### 3️⃣ 테이블 사용 금지 ❌ + +**과거 오류**: 마크다운 테이블(`| |---|---|`) 사용 + +**문제점**: +- 지침 위반 (리스트만 사용) +- 모바일에서 가독성 저하 +- 유지보수 어려움 + +**예방책**: +- ✅ **테이블 금지, 리스트만 사용** (- 또는 숫자 목록) +- ✅ **작성 후 `| |` 패턴 검색으로 테이블 확인** +- ✅ **수치/계산은 리스트 형식**: + +**❌ 금지 (테이블)**: +```markdown +| 항목 | 월 | 연간 | +|------|-----|------| +| 월세 | 150만 | 1,800만 | +``` + +**✅ 권장 (리스트)**: +```markdown +월 경비 구성: +- 월세: 150만 원 (연 1,800만 원) +- 재료비: 180만 원 (연 2,160만 원) +- 직원급여: 100만 원 (연 1,200만 원) +``` + +--- + +### 4️⃣ 계산 예시 누락 ❌ + +**과거 오류**: 포스트에 개념만 있고 실제 계산 예시 부족 + +**문제점**: +- 고객이 "내 상황에 얼마나 해당하나" 판단 어려움 +- 추상적 설명으로 설득력 감소 +- 세무사 필요성 전달 미흡 + +**예방책**: +- ✅ **모든 포스트에 구체적 계산 예시 필수** +- ✅ **절세액을 수치로 제시** ("약 50만 원 절약") +- ✅ **단계별 계산 과정 포함** (Step 1️⃣, 2️⃣, 3️⃣, 4️⃣) +- ✅ **실제 사례로 숫자 구체화**: + +**예시**: +```markdown +### Step 1️⃣: 매출 정리 +월 600만 원 × 12개월 = 연 7,200만 원 + +### Step 2️⃣: 경비 계산 +- 월세: 150만 원 → 연 1,800만 원 +- 재료비: 180만 원 → 연 2,160만 원 +합계: 5,400만 원 + +### Step 3️⃣: 순이익 +7,200만 - 5,400만 = 1,800만 원 + +### Step 4️⃣: 세금 +1,800만 원 × 약 6% = **약 108만 원/년** +``` + +--- + +### 5️⃣ 카테고리 주제 불일치 ❌ + +**과거 오류**: 포스트 주제와 카테고리가 맞지 않음 + +**문제점**: +- 고객이 원하는 정보 검색 불가 +- 카테고리 신뢰도 저하 +- UX 혼란 + +**예방책**: +- ✅ **포스트 작성 전 카테고리 명확히 결정** +- ✅ **포스트 주제와 카테고리 일관성 검증**: + +| 포스트 | 카테고리 | 확인 | +|--------|---------|------| +| 프리랜서 경비 | 종합소득세 (3) | ✅ 맞음 | +| 월세 신고 | 부동산 세금 (2) | ✅ 맞음 | +| 자녀 증여세 | 가족자산·증여 (5) | ✅ 맞음 | +| 사업자 기장 | 사업자 세무 (1) | ✅ 맞음 | +| 부가세 신고 | 부가가치세 (4) | ✅ 맞음 | + +--- + +### 6️⃣ 정확한 세법 인용 누락 ❌ + +**과거 오류**: 일부 포스트에서 법조 명시 부족 + +**문제점**: +- 정확성 원칙 위반 +- 법적 책임 불명확 +- 고객 신뢰도 저하 + +**예방책**: +- ✅ **모든 주요 내용에 세법 조항 인용 필수** +- ✅ **형식**: "소득세법 제XX조에 따르면" +- ✅ **연도 기준 명시**: "2025년 기준" +- ✅ **포스트 끝에 "법적 근거" 섹션 필수**: + +```markdown +**법적 근거**: +- 소득세법 제29조 (수입금액의 계산) +- 국세기본법 제47조 (가산세) +- 소득세법 제160조 (증빙 보관) +``` + +--- + +## ✅ 포스트 최종 체크리스트 + +모든 포스트를 DB에 등록하기 전에 다음을 확인하세요: + +- [ ] **카테고리 할당**: `category_id NOT NULL` (필수) +- [ ] **내용 길이**: `LENGTH(content) >= 1500` (최소 1,500자) +- [ ] **테이블 확인**: `| |` 패턴 없음 (리스트만) +- [ ] **계산 예시**: Step 1️⃣~4️⃣ 포함 (절세액 수치) +- [ ] **세법 인용**: 모든 주요 내용에 법조 명시 +- [ ] **카테고리 일치**: 포스트 주제 ↔ 카테고리 일관성 +- [ ] **3단계 구조**: 1️⃣ 기초 → 2️⃣ 현실 → 3️⃣ 해결책 +- [ ] **광고 규칙**: 금지 표현(보장, 최저가, 무료) 없음 +- [ ] **사례 포함**: 실제 상황 + 이름/나이/직업 구체화 +- [ ] **정확성**: 추측/예상/의견 표현 없음 + +**체크 쿼리**: +```sql +-- DB 적용 후 확인 +SELECT id, title, LENGTH(content), category_id +FROM blog_posts +WHERE LENGTH(content) < 1500 OR category_id IS NULL +ORDER BY id; +-- 결과 없음이 정상! +```