1) 대상 사용자와 핵심 가치

• 대상: 일반적인 엔터프라이즈 Ops/IT 팀(SRE/Infra/IT Ops)
• 구매 가치: 수동 런북 단계 감소, 더 빠른 장애 대응, 누락 감소, 감사 가능성
• 핵심 약속: 기본적으로 안전한 워크플로 자동화
  • 위험한 작업에 대한 승인 게이트
  • 중복 제거 / 멱등성
  • 타임아웃 / 재시도 / 백오프
  • 감사 추적

2) 배포 모드(동일 코드, 다른 설정)

3) 채널(v0.1)

주요 채널(v0.1): Slack

v0.1 에 포함되는 채널:

• Email(SMTP)
• Telegram
• 공급자 추상화를 통한 Kakao 알림톡
• Teams direct webhook targets

4) 워크플로 정의(YAML)

5) 수신자와 그룹(v0.1)

AisOpsFlow 는 수신자와 그룹을 중앙에서 관리합니다.

현재 저장소 메모:

• recipient CRUD, group CRUD, group membership 교체/조회 API 구현됨

• Kakao send-test 는 group:<name> 과 recipient:<id> 를 전화번호로 확장함

• 일반 workflow notify 단계도 실행 시 디렉터리 참조를 확장함

• Recipient 최소 필드:

  • name
  • phone?
  • email?
  • slack_id?
  • telegram_id?
  • teams_id? (향후)

• Group:

  • name
  • members[] (recipient 참조)

6) Kakao 알림톡 공급자 추상화

- kakao:
    mode: alimtalk
    provider: "<provider-id>"
    template_id: "ops_alert_v1"
    to:
      - "01012345678"
      - group:oncall-l1
    vars:
      system: "prod"
      host: "{{body.host}}"
      summary: "{{steps.run.body.summary}}"
    fallback:
      - slack.ops-alerts
      - email:oncall@company.com

{
  "tenant_id": "t_...",
  "provider_id": "...",
  "template_id": "ops_alert_v1",
  "to": ["01012345678"],
  "vars": {"host": "..."},
  "trace_id": "..."
}

{
  "ok": true,
  "provider_message_id": "...",
  "result": {"accepted": 1, "failed": 0},
  "error": null
}

7) API 표면(v0.1)

8) 저장소(SQLite schema, v0.1)

모든 테이블은 tenant_id 를 포함합니다. 온프렘은 단일 테넌트를 사용합니다.

현재 저장소 메모:

• canonical schema 는 Beam 에서 관리
• SQLite, Postgres, MySQL backend 가 이 저장소에 구현되어 있음

Core 테이블:

• tenants(id, name, mode, created_at)
• users(id, tenant_id, email, password_hash, role, created_at)
• workflows(id, tenant_id, name, yaml, enabled, created_at, updated_at)
• executions(id, tenant_id, workflow_id, status, dedupe_key, trigger_type, trigger_ref, started_at, ended_at, error_summary)
• step_runs(id, tenant_id, execution_id, step_id, status, started_at, ended_at, input_redacted, output_redacted, error)

Recipients & groups:

• recipients(id, tenant_id, name, phone, email, slack_id, telegram_id, created_at)
• groups(id, tenant_id, name)
• group_members(group_id, recipient_id)

Kakao templates:

• kakao_templates(id, tenant_id, provider_id, template_id, required_vars_json, description, active, created_at)

Security & ops:

• secrets(key, tenant_id, ciphertext, created_at, rotated_at)
• audit_log(id, tenant_id, actor, action, target, ts, metadata_redacted)

9) 플러그인과 런타임 모델

• 플러그인은 별도 프로세스/컨테이너로 실행됩니다.
• Core 는 HTTP 로 플러그인을 호출합니다.

공통 엔드포인트(모든 플러그인):

• POST /probe

채널 플러그인의 표준 엔드포인트:

• POST /send

Slack 승인 흐름(v0.1):

• Core 가 Slack 플러그인으로 interactive button 이 포함된 메시지를 전송
• Slack 플러그인이 interaction callback 을 수신
• Slack 플러그인이 Core 호출
  • POST /api/approvals/{executionId}/{stepId}/resolve

10) 온프렘 패키징(Docker Compose)

서비스:

• aisopsflow-core
• plugin-slack
• plugin-email
• plugin-telegram
• plugin-kakao-provider-<id> (최소 하나)

볼륨:

• SQLite DB 파일
• secrets store
• 선택적 workflows directory

11) MVP 마일스톤(권장)

• 이 저장소에 이미 구현됨:
  • webhook workflow, executions, retries, approvals, audit logs
  • cron trigger, condition step, when expression
  • Slack/Email/Telegram 알림 플러그인
  • Teams direct notify 플러그인
  • Kakao template CRUD, mock provider, delivery-event simulator, directory-backed notify expansion, fallback automation
  • SQLite/Postgres/MySQL 을 위한 멀티테넌트 API 와 backend 지원
  • managed provider config API, administrative write rate limit, backup export/validate/import, runner denylist control, Beam tenant slug backfill
  • Core↔︎Runner gRPC dispatch, job result, heartbeat, log, signed dispatch/result validation, enrollment, token rotation, durable outbox replay, inventory, Core-signed CSR renewal, operator-managed fallback renewal hook
• 남은 로드맵 항목:
  • 더 엄격한 컴플라이언스가 필요할 경우 certificate fingerprint 또는 CRL/OCSP 스타일 폐기
  • merge 스타일 import 를 넘어서는 destructive replace/rollback restore 모드
  • Teams 도 group: / recipient: 확장에 참여해야 할 경우 directory-backed recipient field