Files
taxbaik/docs/archive/DEPLOYMENT_SUMMARY.md
T
kjh2064 c00d002972 chore: remove committed build artifacts and dead files, archive stray root docs
Root had accumulated files that should never have been tracked:
- Committed build output: TaxBaik.Web.*.json (runtimeconfig/deps), and a
  225-file root wwwroot/ that duplicated (and was staler than)
  TaxBaik.Web/wwwroot/.
- A stale migrations/ (V001-V003 only) superseded by db/migrations/, which
  is the directory MigrationRunner and CI actually use.
- An orphaned root appsettings.json (dev DB password + JWT secret) that the
  app's content root (TaxBaik.Web/) never actually loads.
- Ad-hoc debug/log scratch files: debug-settings.js, final-test.js,
  test-settings.js, settings-page.png, login-test-output.log,
  server.{err,out}.log.
- docker-compose.yml, Dockerfile.*, web.config, SERVER_SETUP.sh, deploy.sh,
  remote_deploy.sh - none referenced by any .gitea/workflows/*.yml; leftovers
  from a Docker/manual-deploy approach superseded by deploy_gb.sh's
  systemd + Green-Blue proxy model.
- Tmp/ - screenshots and a scratch html/js, exactly the "temp work
  committed to root" problem.

None of this is destroyed - it stays recoverable via git history if ever
needed. Historical root-level docs (BLOG_TEMPLATE.md, DEPLOYMENT_GUIDE.md,
etc.) are moved into docs/archive/ rather than deleted, since docs/INDEX.md
already treats anything outside docs/ as non-canonical reference material.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-03 10:32:26 +09:00

3.5 KiB

TaxBaik 배포 요약

이 문서는 현재 WBS 기준의 검증 문서가 아니라, 과거 배포 요약의 기록이다. 최신 상태는 ROADMAP_WBS.md와 CI 로그를 기준으로 판단한다.

📊 과거 기록 현황

⚠️ 과거 기준 기록

단계 항목 상태
W0 프로젝트 기반 구축 과거 기록
W1 LLM 개발 지침 (CLAUDE.md) 과거 기록
W2 도메인/인프라/서비스 레이어 과거 기록
W3 공개 홈페이지 (Razor Pages SSR) 과거 기록
W4 관리자 백오피스 (Blazor Server) 과거 기록
W5 스타일링 및 모바일 UX 과거 기록
W6 출시 준비 (E2E 테스트) 과거 기록

🚀 과거 배포 엔드포인트 기록

공개 사이트

관리자


📁 과거 기술 구성 기록

공개 사이트

  • 기술: ASP.NET Core 10 Razor Pages (SSR)
  • SEO: Server-Side Rendering, 메타 태그, 사이트맵
  • 데이터: PostgreSQL 18, Dapper ORM
  • 스타일: Bootstrap 5, CSS 변수 시스템
  • 모바일: 반응형, 고정 CTA 바

관리자 백오피스

  • 기술: Blazor Server (Interactive)
  • UI: MudBlazor 컴포넌트
  • 인증: 쿠키 기반
  • 기능: 대시보드, 문의 관리

인프라

  • 배포: 심링크 기반 무중단 배포
  • 마이그레이션: 파일 시스템 기반 자동 실행
  • 라우팅: Nginx reverse proxy
  • 프로세스: systemd 서비스

📊 과거 데이터베이스 기록

초기 데이터

  • 5개 카테고리: 사업자세무, 부동산세금, 종합소득세, 부가가치세, 가족자산증여
  • 5개 블로그 포스트: 초기 콘텐츠 포함
  • 관리자 계정: 비밀번호는 문서화하지 않는다.

🔧 과거 배포 절차 기록

  1. 로컬 빌드

    dotnet publish TaxBaik.Web -c Release -o ./publish/web
    dotnet publish TaxBaik.Admin -c Release -o ./publish/admin
    
  2. 서버 배포 (자동)

    • tar 압축 → SCP 전송
    • 심링크 업데이트
    • 프로세스 재시작
    • 무중단 배포 (Shadow Copy)
  3. 검증

    • HTTP 상태 코드 확인
    • 엔드포인트 응답성 테스트
    • 데이터 일관성 확인

📝 Git 커밋 히스토리

fc54ba5 기능: W4 관리자 백오피스 기본 완성
66eb4ae 기능: W3 공개 홈페이지 완성 (Razor Pages SSR)
25a7fe3 수정: Blazor Server 라우팅 개선
e7e01d0 마이그레이션 및 보안 수정

주요 특징

  • SEO 항목 (Server-Side Rendering)
  • 심링크 기반 배포
  • 반응형 모바일 UI
  • 한국어 UI
  • 자동 마이그레이션
  • 인증 항목
  • 레이어 구조
  • 기록용 요약일 뿐, 현재 완료 판정 기준은 아니다.

🎯 향후 개선 후보

  1. BCrypt 실제 인증 개선
  2. Blog CRUD 관리자 기능 완성
  3. 문의 상태 변경 기능
  4. 메일 알림 통합
  5. Google Analytics 통합
  6. Sentry 모니터링

기록일: 2026-06-26 상태: 기록용 요약