docs: add failure prevention checklist to blog template
TaxBaik CI/CD / build-and-deploy (push) Failing after 1m1s
TaxBaik CI/CD / build-and-deploy (push) Failing after 1m1s
과거 실수들을 명시하여 같은 오류 반복 방지 ## 실수 방지 체크리스트 추가 1. 카테고리 할당 실수 (category_id NULL) 2. 내용 길이 부족 (1,500자 미만) 3. 테이블 사용 금지 (리스트만) 4. 계산 예시 누락 (절세액 미수치) 5. 카테고리 주제 불일치 6. 정확한 세법 인용 누락 ## 각 실수별 - 과거 오류 상황 - 문제점 분석 - 예방책 (SQL/마크다운 예시) - 최종 체크리스트 SQL 확인 쿼리도 포함하여 DB 적용 후 자동 검증 가능하게 구성. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -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;
|
||||
-- 결과 없음이 정상!
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user