## 근본 원인
Razor Pages 기본 HtmlEncoder가 한글을 유니코드 엔티티로 과도 인코딩
- 데이터: '사업자' → 렌더링: '사업자'
- 사용자에게 보이는 것: 인코딩된 엔티티 텍스트
## 해결
Program.cs에서 HtmlEncoder를 UnicodeRanges.All로 초기화
- ASP.NET Core DI에 HtmlEncoder.Create(UnicodeRanges.All) 등록
- 모든 유니코드 문자를 UTF-8 문자 그대로 렌더링
- XSS 보호는 유지 (HTML 마크업 문자는 여전히 이스케이핑)
## 결과
✅ 한글 제목 정상 표시
✅ 블로그 카테고리 정상 표시
✅ 다국어 지원
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
## 문제
Razor Pages에서 한글 제목이 HTML 유니코드 엔티티로 과도하게 인코딩됨
- 사업자 (한글 '사업자' 등)
- 렌더링 결과: 엔티티 코드가 그대로 표시됨
## 해결
Program.cs에서 WebEncoderOptions 설정
- TextEncoderSettings: UnicodeRanges.All 적용
- 한글 및 다국어 문자를 유니코드 엔티티로 변환하지 않음
- XSS 보호는 유지 (필요시 @Html.Raw() 사용)
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>
- 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>
- MigrationRunner 구현 (자동 DB 마이그레이션)
- Program.cs에 마이그레이션 자동 실행 추가
- 마이그레이션 SQL 파일을 임베드 리소스로 설정
- 완전한 배포 가이드 작성 (DEPLOYMENT_GUIDE.md)
- E2E 테스트 절차 포함
- 롤백 및 모니터링 가이드 추가
배포 준비 완료: 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