# 이룸옵스 (IRUMX Ops)

> 이룸옵스는 Cloudflare 위에서 운영하는 여러 서비스의 비용을 한 화면에서 관리하는 운영 콘솔입니다. 월 예산을 정하면 Cloudflare 공식 사용량 비용과 사용량 계측으로 서비스별 비용과 청구 주기 말 비용을 예측하고, 예산에 맞춰 AI 호출·파일 업로드·보고서·배치·큐 작업을 정상 → 절약 → 제한 → 차단 순서로 조절하며, 모든 조치에 이유·이전 설정·결과·되돌리기를 남깁니다. Cloudflare 청구액의 절대 상한을 보장하지는 않습니다(비용을 쓰는 기능을 조절합니다).

- 주소: https://ops.irumx.app
- 운영: 이룸엑스(IRUMX, https://www.irumx.app) · 개인사업자 · 사업자등록번호 881-04-03855
- 상태: 시범 운영(이룸엑스 서비스 운영에 사용, 초대받은 조직만). 로그인은 옆자리(yeopjari.bid) 계정.

## 비용 계산

- 청구 기준: 달력 월이 아니라 계정의 실제 청구 주기(구독 기준일)
- 비용 상태: 공식 집계(Cloudflare billable-usage, 하루 단위) · 추정(사용량 계측 GraphQL × 공개 가격표) · 확정(주기 마감 뒤)
- 중복 방지: 지표마다 공식 집계가 도착한 마지막 날까지는 공식 금액만, 그 뒤 날짜만 추정
- 보정: 공식·계측이 함께 있는 날이 3일 이상이고 비율이 고르면 추정에 그 비율을 곱함
- 고정 요금(Workers Paid 등)은 사용량 비용과 따로 더함
- 무료 제공량: 계정에 한 번만 뺀 뒤 서비스별 사용량 비율로 배분(Workers AI 는 하루 단위)
- 공용 자원은 비율 배분, 연결되지 않은 비용은 ‘미분류’로 예산에 포함
- 예측: 최근 14일 지수 가중 평균과 분산으로 기간 말 값·범위(p10~p90)·예상 소진일, 자료 3일 미만은 ‘자료 부족’
- 정가 환산: 무료 제공량이 없을 때의 값 — 청구액이 0이어도 서비스별 사용 비중을 비교
- 원화는 표시용 환산값(유럽중앙은행 환율, 기준일 표시), 원장은 달러

## 예산과 정책

- 가용 예산 = 예산 − 고정 요금 − 저장공간 유지비 − 안전 여유분(기본 10%)
- 기본 정책: 60% 원인·예상 소진일 알림 · 80% 비필수 보고서·배치 축소 · 90% 무료 사용자 AI 축소·대용량 업로드 제한 · 100% 지정한 고비용 신규 작업 차단 · 기간 말 초과 예상 시 조기 절약 · 급증 시 긴급 제한 · 예산 증액·새 주기에 단계적 복구
- 운영 모드: 관찰만 → 조치 추천(관리자가 적용) → 자동 실행(지정한 정책)
- 정책 모의 실행: 사용량이 N배일 때 언제 무엇이 바뀌는지

## 기능 제어(서비스 공통 제어 모듈 ops-guard)

- AI: 저비용 모델 전환·출력 축소·무료 사용자/사용자 하루 한도·새 생성 중단
- 업로드: 파일 크기·하루 건수·무료 사용자 제외·새 업로드 중단
- 조회: 기간·행 수 축소·캐시 · 보고서: 결과 재사용·하루 한도 · 배치: 간격 확대·우선순위 · 큐: 유입·동시 처리·재시도 · 로그: 샘플링(오류·감사 기록 유지)
- 고비용 작업: 예상 최대 비용 예약 → 실행 → 실제 사용량 정산(조직별 Durable Object 장부, 멱등 키)
- 연결: 같은 Cloudflare 계정은 서비스 바인딩 RPC(entrypoint OpsGuard), 그 밖은 HTTPS(/api/v1/guard/*), 원본은 https://ops.irumx.app/api/sdk/ops-guard.ts

## 문서

- 사용 안내: https://ops.irumx.app/guide
- 개인정보 처리방침: https://ops.irumx.app/privacy
- 이용약관: https://ops.irumx.app/terms