Archives 진화 기록

릴리스 노트

제품별로 쌓아온 구축 궤적입니다. 기반 아키텍처부터 업무 기능까지, 사용 가능한 각 버전의 꾸준한 개선을 기록합니다.

개인 웹사이트 시스템

FastAPI, Jinja2, MySQL 기반의 개인 웹사이트 콘텐츠 관리 시스템입니다. 글을 보여주는 공간을 넘어 프로필 저장소, 홈 설정, 사진 갤러리 관리, 동적 방문자 로그를 지원하는 완전한 데이터 기반입니다. 프런트엔드 구조와 백엔드 모델 추상화를 지속 개선합니다.

FastAPI Jinja2 MySQL Tailwind
GEO / SEO 프로젝트 전시: AI Crawler·구조화 데이터 거버넌스 진입점 추가 2026-06-10 ------
검색 거버넌스
  • ✨ 신규 대표 프로젝트·창작 공방에 GEO / SEO 거버넌스 탭을 추가했습니다. Qwen3-8B 미세 조정과 물류 경로 탐색 샌드박스 사이에 배치했습니다.
  • ⚡️ 최적화 프로젝트 배경, 역할, 기술 구성, 주요 성과, 기술 태그, llms.txt / sitemap.xml 진입 버튼을 보완했습니다.
  • 📝 문서 중국어·영어 i18n 문구와 JSON-LD fallback 대표 프로젝트를 동기화해 페이지 표시와 기계 판독 프로젝트 목록을 일치시켰습니다.
Progress 페이지 스타일 개선: 프로젝트 탭 전환 시 Section 가시성 문제를 수정해 보장… 2026-06-06 ------
결함 수정
  • 🐛 수정 프로젝트 탭 전환 시 Section 가시성 문제를 수정해 깜박임 없이 전환하도록 했습니다.
홈 Demo 진입점 스모크 테스트 2026-06-05 ------
시험·검증
  • ⚡️ 최적화 홈 Demo 진입점 스모크 테스트를 완료해 미활성/활성/키 만료의 세 상태를 검증했습니다.
홈 Demo 진입점 통합: 폐기된 RPA/Amazon 개발 로그 버튼을 제거하고 프로젝트별… 2026-06-05 ------
반복 개선
  • ⚡️ 최적화 폐기된 RPA/Amazon 개발 로그 버튼을 제거하고 프로젝트별로 분리했습니다.
LiteStudio 영구 Demo Link: Passport 활성화 후 이전 Demo로 자동 이동해 줄… 2026-06-05 ------
반복 개선
  • ⚡️ 최적화 Passport 활성화 후 이전에 방문한 Demo로 자동 이동해 사용자 조작 경로를 줄였습니다.
Progress 페이지 스타일 개선: 기록 정렬 출처를 수정하고 날짜 기준 정확한 내림차순 정렬. 2026-06-05 ------
결함 수정
  • 🐛 수정 기록 정렬 출처 문제를 수정해 날짜 기준으로 정확히 내림차순 정렬합니다.
Passport Demo 전 과정 테스트: 홈 진입 링크·중간 대상을 검증하는 전용 테스트 추가. 21개 테스트 모두… 2026-06-05 ------
반복 개선
  • ⚡️ 최적화 홈 링크와 중간 이동 대상을 검증하는 전용 테스트를 추가했습니다. 21개 테스트가 모두 통과했습니다.
Progress 페이지 모바일 대응 2026-06-04 ------
페이지 관리
  • ⚡️ 최적화 Progress 페이지의 모바일 타임라인 배치를 개선해 좁은 화면에서도 노드와 카드를 정렬했습니다.
사이트 README 갱신: 흩어진 문서를 공통 진입점으로 통합해 새 협업자의 컨텍스트 파악 비용 감소. 2026-06-04 ------
반복 개선
  • ⚡️ 최적화 흩어진 문서를 공통 진입점으로 통합해 새 협업자의 컨텍스트 파악 비용을 줄였습니다.
홈 Demo 진입점 통합: LiteStudio Demo 버튼 문구·이동 대상 수정… 2026-06-04 ------
결함 수정
  • 🐛 수정 LiteStudio Demo 버튼 문구와 이동 대상을 수정해 Passport 중간 이동이 올바른 곳을 가리키도록 했습니다.
LiteStudio 영구 Demo Link: LiteStudio Demo 영구 링크를 구현해 브라우저에서… 2026-06-04 ------
기능 구현
  • ✨ 신규 브라우저에서 이전 세션을 복원하는 LiteStudio Demo 영구 링크를 구현했습니다.
Progress 페이지 스타일 개선: Progress 페이지 Release Notes 표현… 2026-06-04 ------
반복 개선
  • ⚡️ 최적화 Progress 페이지 Release Notes 표현을 개선하고 타임라인 카드를 다시 배치했습니다.
Passport Demo 전 과정 테스트: 종단간 테스트 완료: 키 생성 → … 2026-06-04 ------
보안 강화
  • 🔒 보안 Passport Demo 종단간 테스트 완료: 키 생성 → 활성화 → Access Token → Demo 이동.
Passport 활성화 보안 검증: LiteStudio Demo 알림을 최상단에 배치하고 진입 안내와… 2026-06-03 ------
기능 구현
  • ✨ 신규 LiteStudio Demo 알림 말풍선을 최상단에 두고 진입 안내와 활성 상태를 분리했습니다.
사이트 README 갱신: 개발 환경, 라우트 설명, 배포… 보완 2026-06-03 ------
문서 축적
  • 📝 문서 사이트 README에 개발 환경 설정, 라우트 설명, 배포 체크리스트를 보완했습니다.
홈 Demo 진입점 통합: 홈 프로젝트 영역에 범용 도구 플랫폼 DEMO 표시와 Demo… 추가 2026-06-03 ------
기능 구현
  • ✨ 신규 홈 프로젝트 영역에 범용 도구 플랫폼 DEMO 표시와 Demo 버튼을 추가했습니다.
홈 Demo 진입점 설계: ChatCore 대화 예시를 LiteStudio…에 반영 2026-06-02 ------
기능 구현
  • ✨ 신규 ChatCore 대화 예시를 LiteStudio Demo에 넣어 장기 기억과 MCP 도구 체인을 보여줍니다.
LiteStudio Demo 템플릿 강화: 응답 템플릿을 맞춰 온도/컨텍스트의 실제 동작과 UI 표시… 2026-06-02 ------
반복 개선
  • ⚡️ 최적화 응답 템플릿을 맞춰 온도/컨텍스트 매개변수의 실제 동작과 UI 표시가 일치하도록 했습니다.
Passport 활성화 보안 검증: Passport 키 활성화 검증을 구현하고 검증 통과 후… 2026-06-02 ------
보안 강화
  • 🔒 보안 Passport 키 활성화 검증을 구현하고 키 확인 후 영구 Access Token을 출력합니다.
홈 Demo 진입점 설계: 범용 도구와 LiteS…의 두 경로를 구분하도록 설계 2026-06-01 ------
기능 구현
  • ✨ 신규 홈 Demo 진입점을 설계해 범용 도구·LiteStudio 두 경로를 구분했습니다.
LiteStudio Demo 템플릿 강화: 메시지 편집, 매개변수 패널, 모델 전환의 상호작용 제어 능… 2026-06-01 ------
기능 구현
  • ✨ 신규 Demo 메시지 편집, 매개변수 패널, 모델 전환 등의 상호작용 제어를 강화했습니다.
CodeGraph: 페이지 템플릿 의존성 시각화 2026-05-31 ------
엔지니어링 기반
  • ✨ 신규 partials 템플릿의 의존 관계를 시각화해 페이지 렌더링 계층의 이해를 돕습니다.
CodeGraph 인덱스 생성·프런트 시각화: 코드 모듈 관계를 보여 유지보수 시 영향 범위를 빠르게 파악. 2026-05-31 ------
반복 개선
  • ⚡️ 최적화 프런트엔드에서 코드 모듈 관계를 시각화해 유지보수 시 영향 범위를 빠르게 파악합니다.
스트리밍 최적화·Passport·CodeGraph: 코드 그래프 메타데이터 수집 구조를 설계하고 모듈 의존 인덱스 구축. 2026-05-30 ------
문서 축적
  • 📝 문서 코드 그래프 메타데이터 수집 구조를 설계하고 모듈 의존성 인덱스를 구축했습니다.
CodeGraph 인덱스 생성·프런트 시각화: 생성 스크립트를 완성해 모듈 메타데이터 통계·의존 토폴로지 출력. 2026-05-30 ------
기능 구현
  • ✨ 신규 코드 그래프 인덱스 생성 스크립트를 완성해 모듈별 메타데이터 통계와 의존성 토폴로지를 출력합니다.
Demo 진입 버튼 스타일 통일 2026-05-29 ------
프런트엔드 최적화
  • ⚡️ 최적화 홈 Demo 진입 버튼의 디자인을 통일해 범용 도구와 LiteStudio 두 경로의 스타일을 맞췄습니다.
전체 템플릿 분리·트래픽 제어·아이콘 수정: Quan_icon 정적 경로와 정적 라우트 500… 수정 2026-05-29 ------
결함 수정
  • 🐛 수정 Quan_icon 정적 리소스 경로와 정적 라우트 500 오류를 수정했습니다.
스트리밍 최적화·Passport·CodeGraph: Passport Key 관리와 접근 로그를 추가해 D… 보장 2026-05-29 ------
보안 강화
  • 🔒 보안 Passport Key 관리와 접근 로그를 추가해 Demo 진입을 감사 가능하게 했습니다.
제한 허용 목록 보완: traffic_guard 허용 목록을 추가하고 제한 발생 시… 2026-05-29 ------
보안 강화
  • 🔒 보안 traffic_guard 허용 목록을 보완하고 제한 발생 시 구조화 JSON을 반환합니다.
Passport: Token 만료·갱신 메커니즘 2026-05-28 ------
보안 체인
  • 🔒 보안 Access Token 만료 시간과 자동 갱신 방식을 설계·구현해 사용 경험을 개선했습니다.
템플릿 전반 분리·공개 라우트·아이콘: Quan_icon 브랜드 아이콘·favicon 소… 설계 2026-05-28 ------
기능 구현
  • ✨ 신규 Quan_icon 브랜드 아이콘과 favicon 소재 방안을 설계해 전체 시각 스타일을 통일했습니다.
전체 템플릿 분리·트래픽 제어·아이콘 수정: traffic_guard 인증 모듈과 DDoS… 구현 2026-05-28 ------
기능 구현
  • ✨ 신규 traffic_guard 인증 모듈과 DDoS 방어 다차원 판단 전략을 구현했습니다.
스트리밍 최적화·Passport·CodeGraph: partials 로딩 후 탐색 탭 전환·앵커 매칭 로… 개선 2026-05-28 ------
반복 개선
  • ⚡️ 최적화 partials 로딩 후 탐색 탭 전환과 앵커 매칭 로직을 개선했습니다.
템플릿 전반 분리·공개 라우트·아이콘: 공개 라우트를 등록해 LiteStudio Demo와… 2026-05-27 ------
기능 구현
  • ✨ 신규 공개 진입 라우트를 등록해 LiteStudio Demo와 후원 링크에 안정적인 URL 엔드포인트를 제공합니다.
전체 템플릿 분리·트래픽 제어·아이콘 수정: 남은 partials를 분리하고 템플릿을 3,783… 2026-05-27 ------
리팩터링 관리
  • ♻️ 리팩터링 남은 partials를 분리해 템플릿을 3,783줄에서 2,060줄로 줄였습니다(-46%).
홈 템플릿 모듈 분리·보안 제한 설계: 전체 트래픽 평가 후 IP·세션·인터페이스 세 계층 제한… 2026-05-26 ------
보안 강화
  • 🔒 보안 전체 트래픽 모델을 평가하고 IP·세션·인터페이스의 세 계층 제한 전략을 설계했습니다.
템플릿 전반 분리·공개 라우트·아이콘: about, biography, skills, pr… 분리 2026-05-26 ------
리팩터링 관리
  • ♻️ 리팩터링 about, biography, skills, projects, experience를 독립 partials로 분리했습니다.
빈도 제한: 인터페이스별 임계값 설정화 2026-05-25 ------
사이트 보안
  • 🔒 보안 인터페이스별 제한 임계값을 설정 매개변수로 추출하고 중요도에 따라 다른 QPS 상한을 정했습니다.
방명록 제거 후 검증·Passport 설계: Passport 키 활성화·Demo 진입 보호 방… 설계 2026-05-25 ------
문서 축적
  • 📝 문서 Passport 키 활성화와 Demo 진입 보호를 설계해 공개 접근과 권한 부여 경로를 구분했습니다.
홈 템플릿 모듈 분리·보안 제한 설계: index.html 모듈 분리를 계획해 3,783… 2026-05-25 ------
리팩터링 관리
  • ♻️ 리팩터링 index.html 모듈화 방안을 수립해 3,783줄의 단일 템플릿을 10개 partial로 분리합니다.
Passport: 키 생성·검증 로직 2026-05-24 ------
보안 체인
  • ✨ 신규 Passport 키 생성·검증을 구현하고 HMAC-SHA256 서명으로 키 위조를 방지합니다.
홈 방문자 방명록 제거: 페이지 초기화의 loadMessages() 호출 제거… 2026-05-24 ------
결함 수정
  • 🐛 수정 페이지 초기화의 loadMessages() 호출을 제거해 블록 삭제 후에도 인터페이스를 계속 요청하는 문제를 막았습니다.
방명록 제거 후 검증·Passport 설계: 백엔드 메시지 정상 응답과 기존 메시지 전체 보존 확인. 2026-05-24 ------
반복 개선
  • ⚡️ 최적화 백엔드 메시지 인터페이스가 정상 응답하고 기존 메시지가 완전히 보존됨을 확인했습니다.
방명록 제거 사전 평가: 의존 체인을 정리하고 데이터 손실 방지를 위해 백엔드 인터페이스 유지. 2026-05-23 ------
문서 축적
  • 📝 문서 방명록 의존 체인을 정리하고 데이터 손실 방지를 위해 백엔드 인터페이스를 유지했습니다.
홈 방문자 방명록 제거: 홈 index.html의 #guestbook… 삭제 2026-05-23 ------
결함 수정
  • 🐛 수정 홈 index.html에서 #guestbook DOM 전체와 메시지 폼 컨테이너를 삭제했습니다.
방명록 제거 사전 평가: 출시 후 실제 이용 데이터를 확인해 이용률이 매우 낮음을 확인하고 결정… 2026-05-22 ------
반복 개선
  • ⚡️ 최적화 방명록 출시 후 실제 이용 데이터를 평가해 이용률이 매우 낮음을 확인하고 제거하기로 결정했습니다.
홈 다중 이미지 잔상 누락 수정: 서비스 계층의 thumbnail 대체 로직을 보완하고 템플릿 유지… 2026-05-21 ------
결함 수정
  • 🐛 수정 서비스 계층의 thumbnail 대체 로직을 보완하고 템플릿은 유지해 뷰 계층의 연쇄 수정을 피했습니다.
글 고정·삭제 구현: 글 기록만 삭제하고 미디어 원본은 직접 지우지 않아 오삭제 방지… 2026-05-21 ------
보안 강화
  • 🔒 보안 삭제는 글 기록에만 적용하고 기본 미디어 리소스를 직접 지우지 않아 잘못된 삭제를 방지합니다.
홈 다중 이미지 잔상 누락 수정: 4번째 사진 묶음의 잔상 누락 원인 조사: 미리보기 수가 본문 이미지보다 적음. 2026-05-20 ------
결함 수정
  • 🐛 수정 홈 4번째 사진 묶음의 잔상 누락 원인 조사: 미리보기 수가 본문 이미지보다 적었습니다.
글 고정·삭제 구현: 프런트·관리 화면 모두 고정 우선 정렬하고 표시를 관리 설정에 맞춤. 2026-05-20 ------
반복 개선
  • ⚡️ 최적화 프런트·관리 화면 모두 고정 글을 우선 정렬하며 프런트 표시를 관리 설정에 맞췄습니다.
글 고정·삭제 구현: Admin Workspace에 글 고정/해제와… 추가 2026-05-19 ------
기능 구현
  • ✨ 신규 Admin Workspace에 글 고정/해제·삭제 인터페이스를 추가했습니다.
홈 타자기 출력 흔들림 수정: notranslate 보호로 브라우저 번역 플러그인의 간… 방지 2026-05-19 ------
반복 개선
  • ⚡️ 최적화 notranslate 보호를 추가해 브라우저 번역 플러그인의 타자기 콘텐츠 간섭을 막았습니다.
방명록 검토·제한·IP 인식: IP 지역 인식 실패 시 Pending으로 자동 전환하고 막지… 2026-05-19 ------
반복 개선
  • ⚡️ 최적화 IP 지역 인식 실패 시 자동으로 Pending으로 전환해 정상 제출을 막지 않습니다.
홈 타자기 출력 흔들림 수정: 고정 폭 렌더링으로 글자 길이 변화가 유…하는 가로 흔들림 해결 2026-05-18 ------
결함 수정
  • 🐛 수정 타자기 영역을 고정 폭으로 렌더링해 글자 출력 중 길이 변화로 인한 가로 흔들림을 해결했습니다.
방명록 검토·제한·IP 인식: 제출에 IP별·전체 사이트 제한을 추가해 악성 대량 입력 방지. 2026-05-18 ------
보안 강화
  • 🔒 보안 제출 체인에 IP별·전체 사이트 제한을 추가해 악성 대량 입력을 방지합니다.
Claude Opus 백엔드 프록시·할당량: 대화 기록 저장으로 경험 연속성·문제 추적성 향상. 2026-05-18 ------
반복 개선
  • ⚡️ 최적화 대화 기록을 파일에 저장해 사용자 경험의 연속성과 문제 추적 가능성을 높였습니다.
방명록 검토·제한·IP 인식: 방명록과 연락 폼을 통일 저장하고 관리자 검토에 연결. 2026-05-17 ------
기능 구현
  • ✨ 신규 방명록과 연락 폼을 통일해 데이터베이스에 저장하고 관리자 검토에 연결했습니다.
Claude Opus 백엔드 프록시·할당량: 입력 검증, 호출 할당량, 위반 차단 추가. 2026-05-17 ------
보안 강화
  • 🔒 보안 인터페이스에 입력 검증, 호출 할당량, 위반 차단을 추가했습니다.
Claude Opus 백엔드 프록시·할당량: 홈 AI 대화를 백엔드 /api/ai/chat 프록시로 전환… 2026-05-16 ------
리팩터링 관리
  • ♻️ 리팩터링 홈 AI 대화를 백엔드 /api/ai/chat 프록시로 전환하고 Claude Opus 키는 환경 변수로만 전달합니다.
사진 표시·세로 캐러셀 재구성: 템플릿의 쉼표 파싱·데이터 추론을 제거해 책임 경계 명확화. 2026-05-16 ------
반복 개선
  • ⚡️ 최적화 템플릿에서 쉼표 문자열 파싱이나 데이터 추론을 제거해 책임 경계를 명확히 했습니다.
사진 표시·세로 캐러셀 재구성: 다중 사진·세로 캐러셀을 재구성하고 서비스 계층 표시 필드 통일. 2026-05-15 ------
리팩터링 관리
  • ♻️ 리팩터링 다중 사진 표시와 세로형 캐러셀을 재구성하고 서비스 계층에서 표시 필드를 통일해 출력합니다.
관리 템플릿 통합·유지보수 범위 축소: page/form_type으로 분기 경계를 제어해 신규 기… 2026-05-15 ------
반복 개선
  • ⚡️ 최적화 page/form_type으로 분기 경계를 제어해 신규 기능마다 전체 페이지를 만들 필요가 없도록 했습니다.
관리 템플릿 통합·유지보수 범위 축소: admin.html로 모듈을 통합해 분산 관리… 감소 2026-05-14 ------
리팩터링 관리
  • ♻️ 리팩터링 관리 모듈을 admin.html에 통합해 분산 템플릿의 유지보수 비용을 줄였습니다.
배포 설명·설정 기준 통일: 환경 변수·관리자 계정 등 핵심 설정 관리 방식을 정해 인수인계… 감소 2026-05-14 ------
문서 축적
  • 📝 문서 환경 변수, 관리자 계정 설정 등 핵심 항목의 관리 방식을 명확히 해 인수인계 편차를 줄였습니다.
콘텐츠·미디어·로그 구축 계획 마무리: ‘관리 화면 쓰기 → DB 읽기 → 프런트 표시 → 접근 기록…’ 2026-05-14 ------
반복 개선
  • ⚡️ 최적화 ‘관리 화면 쓰기 → 데이터베이스 읽기 → 프런트 표시 → 접근 기록’을 하나의 연속 체인으로 정리했습니다.
배포 설명·설정 기준 통일: 새 문서로 서버 환경, 데이터베이스 설정, 초기화… 통일 2026-05-13 ------
문서 축적
  • 📝 문서 사이트 배포 설명서를 추가하고 서버 환경, 데이터베이스 설정, 초기화 절차를 통일했습니다.
콘텐츠·미디어·로그 구축 계획 마무리: 관리자 콘텐츠 계획에 자료 읽기, 미디어 관리, 홈 설… 보완 2026-05-13 ------
문서 축적
  • 📝 문서 관리자 콘텐츠 페이지 구축 계획에 자료 읽기, 미디어 관리, 홈 설정, 방문자 기록을 보완했습니다.
홈·소식 시스템 통합 완료: 버튼·이동 세부를 수정해 홈, 상세, 타임라인의 경… 연결 2026-05-10 ------
결함 수정
  • 🐛 수정 여러 버튼 동작과 이동 세부를 수정해 홈에서 상세 페이지, 타임라인까지 경험이 이어지게 했습니다.
홈·소식 시스템 통합 완료: 홈 모듈 정리, 최근 소식 상세 연결, 프로젝트 진행 시각… 완료 2026-05-09 ------
기능 구현
  • ✨ 신규 홈 모듈 정리, 최근 소식 상세 체인 연결, 프로젝트 진행 페이지 시각화 개선을 완료했습니다.