# 프로젝트 홈과 채팅 접근 규칙

적용일: 2026-09-30. 이 문서의 탐색 규칙은 이전 문서의 모호한 홈 연결·이중 인증 표현보다 우선합니다.

전체 프로젝트 → 공개 GitHub Pages 프로젝트 홈 → 공개·비공개 채팅 목록 → 선택한 원문.

- 프로젝트명과 프로젝트 홈 버튼은 `https://softm.github.io/projects/<project>/`로 연결합니다. GitHub 저장소 화면이나 비공개 홈으로 대체하지 않습니다.
- 모든 프로젝트 홈은 로그인 없이 읽는 공개 목차입니다. 공개·비공개 채팅 목록을 각각 표시하며, 없는 목록은 미등록으로 표시합니다.
- 공개 저장소와 비공개 저장소 링크를 함께 표시합니다. 존재하지 않는 저장소 링크는 표시하지 않습니다.
- 홈에는 안전한 제목·목록·접근 링크만 표시합니다. 비공개 본문·이미지·영상·음성·문서는 해당 원본 저장소와 인증 서버에 유지합니다.
- 비공개 항목은 루트 홈이 아닌 개별 채팅의 원문 주소로 연결합니다. 해당 서버의 비밀번호 또는 활성화된 Vercel 인증을 통과한 후 원래 선택한 경로로 돌아가야 합니다.
- 같은 URL에 인증 버튼 이름만 다르게 붙이지 않습니다. Vercel 계정 선택 인증은 실제 활성화·동작을 검증하기 전에는 구현 완료로 표시하지 않습니다. 선택형 인증 요청을 필수 이중 인증으로 바꾸지 않습니다.
- `projects.json`의 기존 상세 링크와 자산 메타데이터는 그대로 보존하고 `project-home.js`가 프로젝트 홈 주소 및 안전한 추가 채팅 목록을 결합합니다. 기존 상세 정리를 새 요약문으로 바꾸지 않습니다.
- GitHub Pages 운영 반영, 인증 후 원문 열람, 실제 미디어 표시는 별도 검증 대상입니다.

등록된 프로젝트 홈: 화곡농장, 광명, 나, 온수힐, 연서, 웅도, 화곡리 개간허가, 아버지 병원 치료, 돌봄한눈, 메디찾기, 경주김씨, 서해박속낙지, 가족여행.

## 공개 서비스·기록 홈의 채팅 링크 동기화

- 각 프로젝트의 기존 공개 서비스·기록 홈(예: `publicUrl`)도 중앙 프로젝트 홈과 동일한 채팅별 상세 기록 링크를 제공해야 합니다.
- 공개 서비스 홈의 기록 카드·목록 제목과 “상세 기록 열기”는 GitHub 저장소 폴더가 아니라 실제 운영 상세 페이지 URL로 연결합니다.
- 동일 기록의 링크는 `projects/projects.json`에 등록된 공개 상세 URL을 기준값으로 삼고, 서비스 홈에 별도 목록 데이터를 둘 경우 배포 시 동일성을 검증합니다.
- GitHub 저장소 경로는 “원본 저장소 보기” 같은 별도 보조 링크로만 제공할 수 있으며 사용자용 상세 기록 링크를 대체하지 않습니다.
- 프로젝트 홈 → 공개 서비스 홈 → 채팅별 상세 기록의 모든 경로를 실제 운영 URL에서 확인한 뒤 완료로 처리합니다.


## 기록 slug·GitHub 디렉토리 링크

- 중앙 프로젝트 홈(`/projects/<project>/`)과 각 프로젝트의 서비스·기록 홈에서 기록의 slug/디렉토리명(예: `20260527-moskill`)을 표시할 경우, 해당 텍스트는 그 기록이 실제 보관된 GitHub 디렉토리로 연결합니다.
- 사용자용 기록 제목과 “기록 열기/상세 기록 열기”는 실제 운영 상세 페이지 URL로 연결하고, slug 링크와 역할을 구분합니다.
- `projects.json`에는 가능하면 각 기록의 `repoUrl`, `directory`, `recordPath`를 함께 등록하여 GitHub 디렉토리 링크를 추측하지 않고 실제 저장 위치를 기준으로 생성합니다.
- 배포 완료 확인 시 중앙 프로젝트 홈의 상세 기록 링크와 slug GitHub 디렉토리 링크를 각각 실제로 열어 검증합니다.


## 운영 반영 완료 판정

- 새 기록 또는 새 프로젝트를 등록할 때 `projects/projects.json` 수정과 `projects/<project>/index.html` 생성만으로 완료 처리하지 않습니다.
- 운영 `https://softm.github.io/projects/<project>/`에서 새 기록이 실제 목록/카드로 표시되어야 합니다.
- 운영 `https://softm.github.io/projects/`에서 해당 프로젝트가 실제 프로젝트 카드로 표시되어야 합니다.
- 양쪽 화면의 프로젝트명·기록 제목·링크를 실제 브라우저에서 확인하며, Pages 배포 지연·취소·캐시로 이전 화면이 보이면 재배포 후 다시 확인합니다.
- 위 두 운영 화면 중 하나라도 반영되지 않으면 아카이브 배포의 “프로젝트 홈 반영/전체 projects 반영”은 미완료입니다.