idea_world_labDEV JOURNAL
2026년 7월 23일 목요일

2026 년 7 월 23 일

  • 검색 결과에서 최신 날짜 아카이브가 사이트 대표 페이지처럼 표시되지 않도록, 도메인 루트를 README 소개를 읽어 보여주는 고정 페이지로 변경함
  • 도메인 루트의 사이트명 구조화 데이터, canonical, 언어별 hreflang과 파비콘을 정리해 검색 결과에서 사이트의 출처와 정체성이 더 명확하게 보이도록 개선함
  • 날짜 아카이브는 검색 색인과 sitemap에서 제외하고, 실제 개별 글은 문서에서 읽은 제목, 분류와 본문 요약으로 검색 메타데이터가 자동 생성되도록 변경함
  • 문서 경로를 직접 등록하지 않고 9개 언어의 모든 개별 글과 sitemap을 검사하는 검색 메타데이터 감사 스크립트를 추가함
  • Vercel production 배포를 self-hosted Mac 번역 작업에서 분리하고 GitHub-hosted Actions에서 실행하도록 변경함
  • 코드만 변경된 main은 즉시 배포하고, README나 docs가 변경되면 다국어 번역 파이프라인이 끝난 뒤 최신 main을 자동으로 빌드·배포하도록 구성함
  • 커밋된 SQLite와 실제 원문 Markdown 1,570개의 SHA-256, 세 테이블과 FTS5 행 수를 다시 대조하고, 레코드 내용에서 자동으로 만든 질의로 실제 JSONL 검색을 검사함
  • docs_chunks 60건, api_mapping 60건, label_prototypes 2건의 동적 표본이 모두 BM25 1위로 다시 검색됐고, SHA-256이 잘못 선언된 api_mapping 1건은 검색 후보에서 제외하도록 개선함
  • MIT 라이선스의 godotengine/godot-demo-projects 저장소 커밋 cae8dc567a56d3e7936f171bcb85f0ccb9634ad0에서 2d/hexagonal_map 프로젝트를 가져와, Source Flow Debugger GUI에서 실제 파일 6개를 134개 청크로 나눠 SQLite JSONL 검색을 검사함
  • 프로젝트 설정 청크에서 Manually editing project.godot, 이동 청크에서 2D 이동과 CharacterBody2D, 씬 청크에서 TileMapLayer 근거가 상위 결과에 포함되는지 확인함
  • 구조 테이블은 부정 패턴이나 분해된 일반 단어만 겹친 레코드를 제외하고, 원본 청크와 직접 맞는 source_api, target_api 또는 프로토타입 근거가 있을 때만 반환하도록 개선함
  • Qwen 엔드포인트는 임시 중단된 상태여서 이번 실행에서는 SQLite 검색 결과만 검사했고, Qwen 버전 판정 재시험은 엔드포인트 재개 뒤 이어서 진행해야 함
  • 현재 record_embeddings는 0건이므로 SQLite lexical/BM25 검색까지 검증했으며, embedding, reranker와 Qwen validator를 연결한 전체 F 전략 E2E는 실제 인덱스 생성 뒤 이어서 확인해야 함
  • 회고: docs/retrospectives/2026-07-23.md