281 lines
6.7 KiB
Markdown
281 lines
6.7 KiB
Markdown
# 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`를 따른다.
|