Files
taxbaik/FINAL_SUMMARY.md
T
kjh2064 e0067c6f55
TaxBaik CI/CD / build-and-deploy (push) Successful in 1m13s
TaxBaik Browser E2E / browser-e2e (push) Failing after 3m26s
수정: 관리자 e2e 인증 흐름 안정화
2026-06-27 21:16:19 +09:00

6.7 KiB

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. 서버 수동 변경은 비상 롤백을 제외하고 금지한다.

📞 연락처


프로젝트 상태: 진행 중

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