# Infra Journey

이 폴더는 인프라 운영에서 발생한 문제, 조사, 실행 결정을 시간축으로 추적하는 인덱스입니다.
상세 본문은 각 하위 폴더 문서가 소유하고, 이 README는 `어디서 시작해야 하는가`만 빠르게 안내합니다.

## 문서 흐름
- [ideas](./ideas/) : 있으면 좋은 구조나 운영 방향을 여는 문서입니다.
- [scenarios](./scenarios/) : 운영자나 사용자가 기대하는 상태와 흐름을 여는 문서입니다.
- [troubleshooting](./troubleshooting/) : 현재 문제, 장애, 구조 어긋남을 기록합니다.
- [research](./research/) : 원인 분석과 근거 수집을 기록합니다.
- [plans](./plans/) : 실행 결정과 적용 순서를 고정합니다.
- [worklog](./worklog/) : 문제 없이 끝난 실행 결과를 짧게 남깁니다.

## 지금 먼저 볼 문서

### 1. 23 서버 제어면과 런타임 SSOT
- [51123 구 IP 하드코딩과 런타임 SSOT 불일치 이슈](./troubleshooting/260309_51123_구IP하드코딩_런타임SSOT불일치_이슈.md)
- [51123 구 IP 하드코딩 실행 경로와 런타임 SSOT 불일치 리서치](./research/260309_51123_구IP하드코딩_실행경로_SSOT불일치_리서치.md)
- [51123 구 IP 하드코딩 실행 경로 제거 계획](./plans/260309_51123_구IP하드코딩_실행경로제거_계획.md)
- [51123 구IP active runtime 제거 1차](./worklog/260309_51123_구IP_active_runtime_제거_1차.md)

### 2. 24 서버 실행면과 자동배포
- [24 자동배포 0초 종료와 runtime SSOT 불일치 이슈](./troubleshooting/260311_24자동배포_0초종료_runtime_ssot불일치_이슈.md)
- [24 자동배포 0초 종료와 runtime SSOT 불일치 리서치](./research/260311_24자동배포_0초종료_runtime_ssot불일치_리서치.md)
- [24 자동배포 0초 종료 runtime SSOT 복구 계획](./plans/260311_24자동배포_0초종료_runtime_ssot복구_계획.md)
- [rb8001 24 자동배포 SSOT 복구 및 SSH 인증 수정 완료](./worklog/260311_rb8001_24자동배포_ssot복구_및_ssh인증수정_완료.md)

### 3. NAS 동기화와 운영 전환
- [내부 NAS -> 외부 NAS 경로 교정 및 Go 프로브 검증](./troubleshooting/260313_internal_nas_external_nas_route_fix_and_go_probe_verification.md)
- [외부 NAS -> 내부 NAS 컴퍼니엑스 실시간동기화 리서치](./research/260312_external_nas_companyx_실시간동기화_리서치.md)
- [내부 NAS 직접 Go 동기화 가능성 리서치](./research/260313_internal_nas_direct_go_sync_feasibility_research.md)
- [외부 NAS -> 내부 NAS 컴퍼니엑스 실시간동기화 계획](./plans/260312_external_nas_companyx_실시간동기화_계획.md)
- [Company X sync NAS 이관 및 23 cron 중지](./worklog/260314_companyx_sync_nas_이관_및_23cron_중지.md)

### 4. 포트, 네트워크, 진입면 구조
- [51123 포트경계 복잡성 및 진입구조불일치 이슈](./troubleshooting/260311_51123_포트경계_복잡성_및_진입구조불일치_이슈.md)
- [51123 포트 진입점 프로젝트 경계 리서치](./research/260310_51123_포트_진입점_프로젝트경계_리서치.md)
- [260307 51123 서버 성수 이전 네트워크 변경 운영기록](./troubleshooting/260307_51123_성수이전_네트워크변경_운영기록.md)

## 주제별 인덱스

### 23 서버
- [23서버 워크스페이스 인프라 구조정리 이슈](./troubleshooting/260307_23서버_워크스페이스_인프라_구조정리_이슈.md)
- [23서버 워크스페이스 SSOT 구조전환 리서치](./research/260309_23서버_워크스페이스_SSOT_구조전환_리서치.md)
- [23서버 워크스페이스 SSOT 구조전환 계획](./plans/260309_23서버_워크스페이스_SSOT_구조전환_계획.md)
- [23제어면 gateway workspace-config 단일화](./worklog/260309_23제어면_gateway_workspace_config_단일화.md)

### 24 서버
- [24서버 실서비스 운영전환 리서치](./research/260309_24서버_실서비스운영전환_리서치.md)
- [24서버 실서비스 운영전환 계획](./plans/260309_24서버_실서비스운영전환_계획.md)
- [24전환 배포대상과 ingress 24IP 교정 1차](./worklog/260309_24전환_배포대상과_ingress_24IP_교정_1차.md)
- [24서버 robeing runtime workspace-config 단일화](./worklog/260310_24서버_robeing_runtime_workspace_config_단일화.md)

### NAS / 동기화
- [260307 NAS(192.168.0.101) SSOT 전환 및 CIFS 실마운트 복구](./troubleshooting/260307_NAS_192_168_0_101_SSOT_전환_및_CIFS_실마운트_복구.md)
- [260226 NAS(192.168.219.51) 접속불가 임시 백업 복구](./troubleshooting/260226_NAS_192_168_219_51_접속불가_임시백업복구.md)
- [Company X 외부 NAS 동기화 스크립트 구현 및 대표 검증](./worklog/260311_companyx_external_nas_sync_스크립트구현_및_대표검증.md)
- [Company X 30분주기 cron 적용 및 예측 검증](./worklog/260312_companyx_sync_30분주기_cron적용_및_예측검증.md)

### 보안 / 접근통제
- [260226 51123 SSH 브루트포스 차단 및 fail2ban 교정](./troubleshooting/260226_51123_SSH_브루트포스_차단_및_fail2ban_교정.md)
- [260303 51123 서버 UFW 외부 포트 차단 하드닝](./troubleshooting/260303_51123_ufw_외부포트_차단_하드닝.md)
- [260308 env backup git tracking exposure 및 차단조치](./troubleshooting/260308_env_backup_git_tracking_exposure_및_차단조치.md)

### 저장소 / 로그 / 데이터 계층
- [260307 Gitea LFS NAS 권한정렬 및 실업로드 검증](./troubleshooting/260307_Gitea_LFS_NAS_권한정렬_및_실업로드_검증.md)
- [260306 51123 Gitea LFS 권한 오류 502 복구](./troubleshooting/260306_51123_gitea_lfs_permission_denied_502_복구.md)
- [260318 51123 OpenSearch 샤드한도 로그적재 복구](./worklog/260318_51123_opensearch_샤드한도_로그적재복구.md)
- [PostgreSQL 통합 vs 전용 DB 구조성능 리서치](./research/260316_postgres_통합_vs_전용db_구조성능_리서치.md)
- [non-RDB 계층 PostgreSQL 통일 계획](./plans/260317_nonrdb_계층_postgresql_통일_계획.md)
- [non-RDB 계층 PostgreSQL 통일 1차 실행 완료](./worklog/260317_nonrdb_계층_postgresql_통일_1차_실행완료.md)

## 문서 사용 기준
- 현재 장애나 어긋남을 추적할 때는 `troubleshooting`에서 시작합니다.
- 원인과 근거를 좁힐 때는 대응 `research` 문서를 이어서 봅니다.
- 실제 적용 순서가 필요하면 대응 `plans`를 봅니다.
- 완료 여부와 검증 결과만 빠르게 확인할 때는 `worklog`를 봅니다.

## 운영 메모
- 이 README는 전체 문서 나열이 아니라, 반복해서 쓰는 진입점만 유지합니다.
- 새 사건이 생기면 먼저 해당 레이어 문서를 만들고, 여러 번 다시 찾게 되는 사건만 여기에 링크합니다.
- 장문 목록이 다시 커지면 주제별 하위 인덱스를 추가하고, 이 파일은 상위 진입점 역할만 유지합니다.