47 lines
2.2 KiB
Markdown
47 lines
2.2 KiB
Markdown
# Infra DOCS
|
|
|
|
이 디렉터리는 `0_VALUE`의 가치를 실제 운영 가능한 형태로 구현하는 **전체 인프라 프로젝트**의 공식 문서 허브입니다.
|
|
|
|
여기서 인프라는 특정 서버 저장소가 아니라, 현재 우리가 직접 관리하는 핵심 물리 인프라를 뜻합니다.
|
|
|
|
- `23 서버`: 게이트웨이, 프록시, Git/CI, DB, 운영 보조
|
|
- `24 서버`: 앱 런타임, 핵심 서비스 실행
|
|
- `내부 NAS`: 백업, 로그 아카이브, 산출물/복구 기준 저장
|
|
|
|
개발 노트북, 테스트 스마트폰, 외부 NAS 같은 자산은 필요할 때 연결되는 주변 실행 환경으로 다루며, 본 문서 체계의 중심 SSOT는 위 3개입니다.
|
|
|
|
## 문서 구조
|
|
|
|
1. `00_Philosophy/`
|
|
- 인프라 프로젝트가 왜 존재하는지, 무엇을 지켜야 하는지, 무엇을 금지하는지 정의합니다.
|
|
- 반복 검증 후에도 바뀌기 어려운 기준만 둡니다.
|
|
|
|
2. `02_Architecture/`
|
|
- 23/24/NAS를 중심으로 한 실제 구성 요소, 역할 분리, 트래픽/데이터/운영 구조를 정리합니다.
|
|
- 철학을 운영 가능한 구조로 번역한 계층입니다.
|
|
|
|
3. `journey/`
|
|
- 리서치, 계획, 트러블슈팅, 워크로그를 기록합니다.
|
|
- 실행 중 사실, 조치, 검증 결과는 여기만 기록합니다.
|
|
|
|
## 인프라 프로젝트에 맞춘 구조 선택 이유
|
|
|
|
- 일반 서비스 프로젝트처럼 `제품 기획`보다 `지속성 있는 운영 기반`이 중심입니다.
|
|
- 따라서 `철학 -> 구조 -> 실행 기록`의 3층이 가장 적합합니다.
|
|
- 전략/로드맵은 필요 시 `journey/plans`에서 운영 계획으로 다루고, 고정 철학은 `00_Philosophy`로 승격합니다.
|
|
|
|
## 빠른 읽기 순서
|
|
|
|
1. `00_Philosophy/00_IDENTITY/Infra_Project_Identity.md`
|
|
2. `00_Philosophy/01_PRINCIPLES/Core_Infrastructure_Principles.md`
|
|
3. `00_Philosophy/02_GUARDRAILS/Operational_Guardrails.md`
|
|
4. `02_Architecture/Infrastructure_Project_Structure.md`
|
|
5. `journey/research/260307_value_기준_인프라철학문서_구조초안.md`
|
|
6. `journey/README.md`
|
|
|
|
## 문서 운영 규칙
|
|
|
|
- `00_Philosophy/`는 고정 기준만 둡니다.
|
|
- 실제 장애, 변경, 점검, 복구 기록은 `journey/`에만 둡니다.
|
|
- `0_VALUE` 공통 원칙과 충돌하면 `0_VALUE`를 우선합니다.
|