FractalOps 운영 매뉴얼 (한글)

FractalOps 운영 매뉴얼 (한글)

이 페이지는 긴 절차를 복제하지 않습니다. 실제 운영 절차와 아키텍처 정본은 아래 문서가 소유합니다. 문서가 충돌하면 이 페이지보다 연결된 정본 문서를 우선합니다.

먼저 볼 순서

1. Documentation Hub - 전체 문서 지도
2. FractalOps Constitution - 제품 법
3. Canonical Architecture - 제품 정의
4. Current Stack, Solution, and IA Map - 현재 스택/라우팅
5. FractalOps C4 Model - 시스템 경계
6. Architecture Overview - 실행/플랫폼 토폴로지
7. Engineering Handoff - 운영자 인수인계
8. Requirements Index - 스택별 요구사항

실행 표면

할 일	정본 문서
AgentSquad 운영	AgentSquad Operations
Agent execution lifecycle	Agent Execution
에이전트 PR 전달	Agent PR Submission Pipeline
Dev preview	Dev Preview Plane
프로젝트 dev 서비스	Project Development Service Plane
테스트 실행 정책	Test Execution Policy
빌드/패키지 캐시	Build & Package Cache Topology

인프라 표면

할 일	정본 문서
Gateway/Ingress/API drift	Stack API Debt Audit
PostgreSQL/CNPG 운영	PostgreSQL Storage
Kubernetes 노드 위생	K3s Node Hygiene
Cloudflare/OpenBao	Cloudflared OpenBao
Portal 배포	Portal Delivery Flow
cliproxy 자격증명	cliproxy Runtime Credentials

원칙

• Portal이 사람의 기본 작업 표면입니다.
• Studio가 run, session, report, activity, inbox 상태를 소유합니다.
• Temporal은 durable workflow를, Studio는 run/session/mailbox 상태를 맡습니다.
• DataHub, ClickHouse, Chronicle, OTel/Mimir는 증거와 관측 경로입니다.
• Headlamp가 Kubernetes 관측 표면입니다. kubectl은 bootstrap/break-glass 용도입니다.
• OpenBao/ESO는 secret lifecycle, SpiceDB는 authorization lifecycle을 맡습니다.
• 장기 절차는 이 페이지에 복제하지 말고 소유 문서로 이동합니다.

문서 변경 규칙

• 새 운영 절차는 docs/src/content/docs/operations/에 둡니다.
• 새 아키텍처 결정은 docs/src/content/docs/architecture/에 둡니다.
• 스택별 요구사항은 docs/src/content/docs/requirements/에 둡니다.
• 이 페이지는 한글 진입점만 유지합니다.