FractalOps 코드베이스 승격/강등 정책

FractalOps 코드베이스 승격/강등 정책

목적

• SSOT 우선 원칙 유지: 실행 경로에 테넌트/도메인/IP 하드코딩 금지
• 멱등성과 재현성 보장: 인프라/커넥터 연산은 반복 실행 가능해야 함
• 단기 전술 코드는 빠르게 강등하고, 재사용 가능한 모듈만 승격

티어 정의

Tier S (승격: 재사용 코어)

• 조건
  • 런타임 값은 FRACTALOPS_* SSOT에서만 읽는다.
  • 멱등 실행 보장(같은 입력으로 재실행 시 상태 안정).
  • 특정 조직값 하드코딩 없음.
  • 자동화 가능한 출력(JSON 요약/머신리더블)을 제공.
• 예시
  • ops/infra/cloudflare_access_plan.py
  • ops/lxc/apply_nexus_plugin_pack.py
  • backend/src/fractalops/contexts/* 하위 도메인 모듈

Tier A (후보: 거의 충족, 정규화 필요)

• 증상
  • helper 중복/유사 로직 중복
  • 플래그/옵션 네이밍 불일치
  • 일부 fallback이 실행 코드로 유입
• 조치
  • 공통 helper로 흡수
  • SSOT 키 네이밍 통일
  • preflight/wizard 템플릿 경로로 입력 강제

Tier B (강등: 전술/레거시)

• 증상
  • 특정 호스트/테넌트 전제 스크립트
  • 수동 절차 없이는 재현 불가능
  • side effect가 크고 가드레일 없음
• 조치
  • 운영 재사용 금지
  • Tier S/A 모듈로 대체 후 제거

승격 게이트

1) SSOT 스캔

make infra-ssot-scan
make infra-ssot-scan-strict

2) 멱등 검증

• 동일 입력으로 2회 실행해 결과가 안정적인지 확인

3) 런타임 검증

• 배포 경로에서 preflight/readiness가 정상인지 확인

운영 규칙

• 신규 기능은 Tier A로 시작
• 다음 3가지 충족 시 Tier S 승격
  1. SSOT 스캔 high=0
  2. 멱등 재실행 성공
  3. 배포/검증 파이프라인 통과