문제:
- VersionInfo.cs가 namespace를 가지고 있음
- Program.cs (top-level statements)에서 직접 접근 불가능
- 빌드 시 "The type or namespace name 'VersionInfo' could not be found" 오류
해결:
- TaxBaik.Web/VersionInfo.cs에서 namespace 제거
- TaxBaik.Admin/VersionInfo.cs에서 namespace 제거
- Program.cs에서 직접 접근 가능하도록 변경
결과:
- 빌드 성공 (오류 0개, 경고만 있음)
- 경고는 Npgsql 보안 취약성 (이미 알려진 것)
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
### 버전 정보 표시 기능
- CI/CD에서 빌드 시간과 git commit hash를 version.txt에 기록
- Web과 Admin 앱이 시작 시 version.txt를 읽어 VersionInfo 싱글톤으로 등록
- 홈페이지 푸터에 "버전: <커밋해시> | 배포: <빌드시간>" 표시
- 최신 소스 반영 여부를 즉시 확인 가능
### 포트 충돌 해결
- 배포 후 기존 프로세스 종료 시 포트 릴리스 대기 로직 추가
- lsof 명령으로 포트 사용 여부 확인 (최대 30초 대기)
- 5001/5002 포트가 완전히 릴리스될 때까지 new process 시작 지연
- "Address already in use" 오류 해결
파일 변경:
- .gitea/workflows/deploy.yml: 버전 파일 생성 + 포트 대기 로직
- TaxBaik.Web/Program.cs: version.txt 읽기 + VersionInfo 등록
- TaxBaik.Admin/Program.cs: version.txt 읽기 + VersionInfo 등록
- TaxBaik.Web/Pages/Shared/_Footer.cshtml: 버전 정보 표시
- TaxBaik.Web/VersionInfo.cs: 새로 추가
- TaxBaik.Admin/VersionInfo.cs: 새로 추가
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
- Login.razor: BCrypt 기반 실제 비밀번호 검증
- TaxBaik.Admin.csproj: BCrypt.Net-Next 패키지 추가
- HttpContext.SignInAsync로 쿠키 인증 처리
주의: 아직 런타임 이슈 수정 필요
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
- Dashboard: @page "/dashboard"만 사용 (라우팅 중복 제거)
- Login: 간단한 로그인 폼으로 단순화
- 미인증 사용자가 보호된 페이지 접근 시 로그인으로 자동 리다이렉트 (302)
테스트 결과:
- 로그인 페이지: 200 OK
- 대시보드 (미인증): 302 Found (로그인으로 리다이렉트)
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
- MigrationRunner: 이미 존재하는 테이블에 대한 "relation already exists" 오류 처리
- V002, V003 마이그레이션: ON CONFLICT DO NOTHING으로 멱등성 보장
- Web, Admin Program.cs: app.UseAntiforgery() 미들웨어 추가 (anti-forgery 토큰 검증)
변경사항:
- 마이그레이션 재실행 시에도 안전하게 처리
- 폼 제출 시 CSRF 공격 방지
- 관리자 로그인 페이지 405 에러 해결
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
- CLAUDE.md: Hot Deploy 배포 절차 명시 (Graceful shutdown)
- 모든 프로젝트: TargetFramework net10.0 통일
- systemd 서비스: TimeoutStopSec=35, KillMode=mixed 추가
- Infrastructure.csproj: 마이그레이션 SQL 파일 포함 경로 수정
배포 후 실제 서버 검증 완료:
✅ Web 서비스 정상 실행 (포트 5001)
✅ Admin 서비스 정상 실행 (포트 5002)
✅ PostgreSQL 인증 및 마이그레이션 통과
✅ HTTP 응답 정상
- MigrationRunner 구현 (자동 DB 마이그레이션)
- Program.cs에 마이그레이션 자동 실행 추가
- 마이그레이션 SQL 파일을 임베드 리소스로 설정
- 완전한 배포 가이드 작성 (DEPLOYMENT_GUIDE.md)
- E2E 테스트 절차 포함
- 롤백 및 모니터링 가이드 추가
배포 준비 완료: Gitea CI/CD 자동 배포 활성화 가능
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
- 모든 빌드 오류 해결 (PageModel, Blazor, ResponseCompression)
- Admin 컴포넌트 MudBlazor 6.x 호환성 확보
- IBlogPostRepository 메서드 통일
- ResponseCompression gzip 활성화
W0~W6 전체 작업 완료:
✅ 프로젝트 기반 구축
✅ LLM 개발 지침 (CLAUDE.md)
✅ 도메인/인프라/서비스 레이어
✅ 공개 홈페이지 (Razor Pages SSR)
✅ 관리자 백오피스 (Blazor Server + MudBlazor)
✅ CSS 디자인 시스템 + 모바일 UX
✅ 초기 데이터 + 블로그 포스트 5개
다음 단계: 서버 배포 (Gitea CI/CD)
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
- 대시보드: KPI 카드 (이번달 문의, 신규 문의, 포스트 수)
- 블로그 관리: 목록/작성/수정 페이지
- 문의 관리: 목록 및 상태 변경
- 설정: 사이트 연락처 정보
- 인증: Cookie 기반 8시간 세션
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
kjh2064