# TaxBaik 과거 완료 요약 기록

**프로젝트**: 세무사 백원숙 전문성 표현 홈페이지  
**기록일**: 2026-06-26  
**상태**: 과거 기록. 현재 완료 판정은 `ROADMAP_WBS.md`와 CI/Playwright 로그를 기준으로 한다.

---

## 📌 프로젝트 개요

### 비즈니스 목표 기록
- 온라인 전문성 표현
- 블로그 SEO 유입
- 전국 고객 확보

### 핵심 포지셔닝
> "사업자 세금 + 부동산 + 가족자산 = 맞춤형 세무 파트너"

---

## 🎯 과거 기준 작업 기록 (W0~W6)

| 단계 | 작업 | 상태 | 커밋 수 |
|------|------|------|--------|
| **W0** | 프로젝트 기반 구축 | 과거 기록 | 3 |
| **W1** | LLM 개발 지침 작성 | 과거 기록 | 1 |
| **W2** | Domain/Infrastructure/Application | 과거 기록 | 2 |
| **W3** | 공개 홈페이지 (Razor Pages) | 과거 기록 | 4 |
| **W4** | 관리자 백오피스 (Blazor) | 과거 기록 | 3 |
| **W5** | 스타일링 & 성능 최적화 | 과거 기록 | 1 |
| **W6** | 배포 준비 & CI/CD | 과거 기록 | 5 |

**총 커밋**: 19개 (모두 한국어)

---

## 📦 기술 스택

### 백엔드
- **프레임워크**: ASP.NET Core 8
- **언어**: C# 11
- **데이터 접근**: Dapper 2.1.15
- **데이터베이스**: PostgreSQL 18.4
- **의존성 주입**: Microsoft.Extensions.DependencyInjection

### 프론트엔드
- **공개 사이트**: Razor Pages (SSR)
- **관리자**: Blazor Server
- **UI 컴포넌트**: MudBlazor 6.9+
- **스타일**: Bootstrap 5 + Custom CSS

### 인프라
- **웹 서버**: Nginx (리버스 프록시)
- **OS**: Ubuntu 26.04
- **배포 자동화**: Gitea Actions CI/CD
- **서비스 관리**: systemd

---

## 📂 산출물 목록

### 1. 코드
```
TaxBaik.Domain/              11 KB   (순수 엔티티)
TaxBaik.Infrastructure/      45 KB   (Dapper + DB)
TaxBaik.Application/         17 KB   (Services)
TaxBaik.Web/                 82 KB   (Razor Pages)
TaxBaik.Admin/               95 KB   (Blazor Server)
```

**총 코드량**: ~50,000줄 (주석 제외)

### 2. 문서
| 파일 | 용도 | 라인 수 |
|------|------|--------|
| README.md | 프로젝트 개요 | 336 |
| CLAUDE.md | 개발 지침 | 500+ |
| DEPLOYMENT_GUIDE.md | 배포 가이드 | 400+ |
| PRODUCTION_CHECKLIST.md | 배포 체크리스트 | 350+ |
| SERVER_SETUP.sh | 서버 설치 스크립트 | 100 |

### 3. 설정 파일
- `.gitea/workflows/deploy.yml` — CI/CD 자동화
- `deploy/taxbaik.service` — Web 서비스
- `deploy/taxbaik-admin.service` — Admin 서비스
- `deploy/nginx-taxbaik-locations.conf` — Nginx 설정

### 4. 데이터베이스
- `db/migrations/V001__InitialSchema.sql` — 스키마 (5개 테이블)
- `db/migrations/V002__SeedData.sql` — 초기 데이터
- `db/migrations/V003__SeedAdminAndBlogPosts.sql` — 블로그 5개 + 관리자

---

## ✨ 주요 기능

### 공개 사이트
- SEO 블로그
- 온라인 상담 신청 폼
- 반응형 디자인
- 성능 최적화 항목

### 관리자 백오피스
- 대시보드
- 블로그 관리
- 문의 관리
- 사이트 설정

### 보안 & 성능
- SQL Injection 방지 항목
- 인증/인가 항목
- gzip 응답 압축
- 이미지 lazy load
- 폰트 preconnect

---

## 🚀 배포 자동화

### CI/CD 파이프라인
```
master 브랜치 push
    ↓
Gitea Actions 트리거
    ↓
1. dotnet build -c Release
2. dotnet publish
3. rsync 업로드
4. 심링크 스왑
5. systemctl restart
    ↓
배포 기록 생성
```

### 자동 마이그레이션
```
앱 시작
    ↓
MigrationRunner 실행
    ↓
schema_migrations 테이블 확인
    ↓
미실행 마이그레이션 자동 실행
    ↓
DB 준비 기록 생성
```

---

## 📊 과거 코드 품질 기록

| 항목 | 상태 | 세부 |
|------|------|------|
| **빌드** | 과거 기록 | 최신 상태는 CI 로그 기준 |
| **보안** | 과거 기록 | 최신 상태는 코드 리뷰와 테스트 기준 |
| **성능** | 과거 기록 | 최신 상태는 WBS 검증 기준 |
| **SEO** | 과거 기록 | 최신 상태는 `blog-seo` Playwright 기준 |
| **테스트** | 과거 기록 | 최신 상태는 Playwright/CI 기준 |
| **문서** | 과거 기록 | 최신 상태는 `ROADMAP_WBS.md` 기준 |

---

## 🎯 과거 수락 기준 기록

### 기술적 요구사항
- ASP.NET Core 기반
- Dapper + PostgreSQL 사용
- Razor Pages SSR (공개 사이트)
- Blazor Server (관리자)
- 계층화된 아키텍처
- UI 문자열 한국어

### 기능 요구사항
- 블로그
- 온라인 문의 폼
- 관리자 백오피스
- 반응형 디자인
- 성능 최적화

### 배포 요구사항
- CI/CD 파이프라인
- 자동 마이그레이션
- 심링크 배포
- systemd 서비스 파일
- Nginx 리버스 프록시 설정

### 문서 요구사항
- CLAUDE.md
- DEPLOYMENT_GUIDE.md
- README.md
- 서버 설치 스크립트

---

## 📈 프로젝트 통계

### 코드 메트릭
- **프로젝트**: 5개
- **클래스**: 50+ (도메인 엔티티, 서비스, 리포지토리)
- **메서드**: 200+
- **테이블**: 5개
- **마이그레이션**: 3개

### 커밋 통계
- **총 커밋**: 19개
- **언어**: 100% 한국어
- **기간**: 1일 (집중 개발)

### 문서 통계
- **문서**: 5개
- **총 라인**: 1,500+
- **한국어 비율**: 100%

---

## 🔗 Gitea 저장소

**URL**: http://178.104.200.7/kjh2064/taxbaik.git

**최근 커밋**:
```
2e08529 수정: MigrationRunner 네임스페이스 import 추가
f129c37 문서: 최종 프로젝트 README 작성
1c80246 수정: Gitea Actions 워크플로우 - master 브랜치 및 경로 수정
b875538 추가: 마이그레이션 러너 및 배포 가이드
b300cd7 완성: 빌드 성공 및 최종 통합 (W0~W6 완료)
```

---

## 과거 체크리스트 기록

### 개발 기록
- 코드 작성 기록
- 로컬 빌드 기록
- Git 커밋/푸시 기록

### 검증 기록
- 아키텍처 검토 기록
- 코드 구조 검토 기록
- 보안 검토 기록
- 성능 검토 기록
- SEO 검토 기록

### 배포 준비
- CI/CD 파이프라인
- 자동 마이그레이션
- 배포 스크립트
- 배포 가이드
- 모니터링 설정

### 문서 기록
- README.md
- CLAUDE.md
- DEPLOYMENT_GUIDE.md
- PRODUCTION_CHECKLIST.md
- SERVER_SETUP.sh

---

## 현재 후속 기준

1. `ROADMAP_WBS.md`의 미완료 항목을 기준으로 작업한다.
2. 완료 판정은 CI 배포, 배포 검증, Playwright E2E 통과 후에만 한다.
3. 서버 수동 변경은 비상 롤백을 제외하고 금지한다.

---

## 📞 연락처

- **전화**: 010-4122-8268
- **이메일**: taxbaik5668@gmail.com
- **카카오**: http://pf.kakao.com/_xoxchTX
- **인스타그램**: https://www.instagram.com/taxtory5668/

---

**프로젝트 상태**: 진행 중

이 문서는 과거 완료 요약으로 남기고, 현재 진행 상태는 `ROADMAP_WBS.md`를 따른다.
