승인 / 액션 인박스 · Agent 활동

4 분 분량

내가 처리해야 할 확인·승인·할 일을 한 화면에 모은 인박스(/inbox)와, 자동화·AI Agent의 활동을 관리하는 Agent 활동(/agents) 화면입니다.

알림 벨(08장)이 "지나간 소식"이라면, 인박스는 "처리 대기 목록" 입니다.

1. 승인 / 액션 인박스 (/inbox)

무엇: 확인, 승인, 후속 조치와 기한 초과를 서버 원장 기준으로 모은 화면입니다("확인, 승인, 후속 조치와 기한 초과를 서버 원장 기준으로 모았습니다.").
누가: 로그인한 모든 사용자. 항목은 서버가 내 몫만 보여줍니다.
어디서: 상단 헤더 오른쪽의 인박스 버튼(체크 아이콘, 알림 벨 왼쪽). 대시보드 내 작업 패널에 항목이 있으면 인박스 열기 링크로도 들어갈 수 있습니다.
네 칸 구성:

어떻게: 내가 할 일의 승인 요청은 승인, 배정된 작업은 수락 버튼으로 즉시 처리합니다(다른 세 칸은 조회 전용). "대기 중인 항목이 없습니다."는 정상 — 처리할 일이 없다는 뜻입니다.
어디서 생기나: 도면 새 버전 발행 → 변경 검증 → 알림 계획 승인·전달(10장 Change 검토) 흐름에서 만들어진 확인 요청이 이곳에 쌓입니다.
팁: 아침에 인박스부터 비우는 습관을 권장합니다 — 프로젝트를 돌아다니지 않아도 내 몫이 다 보입니다.

📷 [스크린샷: 헤더 인박스 버튼 → 4칸 인박스 화면(수락/승인 버튼)]

무엇: 상단 헤더 Agent 버튼으로 여는 Agent 활동 화면 — "개인·조직 Agent 실행, 비용, 승인 대기와 회수를 한곳에서 관리합니다."
조직 Agent: 회사 서버·자동화 시스템이 쓰는 기계 계정(IP 제한·속도 제한·만료가 강제됩니다).
이벤트 구독: 프로젝트 이벤트(예: change.verified)를 내 서버의 HTTPS 주소로 실시간 수신하는 웹훅.
실행 원장: Agent들이 무엇을 실행했는지, 비용·승인 대기 이력.
누가: 화면은 로그인한 누구나 열 수 있으나, 실사용은 사내 IT·자동화 담당자용입니다 — 고정 공인 IP(CIDR)와 웹훅 수신 서버가 전제입니다.
조직 Agent 만들기: 조직 Agent 패널에서 Name · IP CIDR(서버의 공인 IP, 예: 1.2.3.4/32 — 필수) · Rate/min · Expiry(최대 1년) 입력 → 생성. 중지는 회수.
이벤트 구독 만들기:

먼저 프로필 · 설정 → API 토큰 · Agent에서 해당 조직 Agent용 토큰을 발급해 둡니다(14장). Credential 목록이 비어 있다면 이 선행 단계가 빠진 것입니다.
이벤트 구독 패널에서 Project · Agent · Credential · HTTPS URL · Verb filters(기본 change.verified) · Expiry 지정 → 생성.
서명 secret이 한 번만 표시됩니다 — "이 서명 secret은 지금 한 번만 표시됩니다. 안전한 곳에 복사하세요." 복사 후 확인하고 닫기.

주의: secret은 재조회할 수 없습니다(분실 시 구독을 회수하고 재생성). 구독은 비활성화↔활성화로 잠시 멈출 수 있지만 회수는 영구입니다.

📷 [스크린샷: Agent 활동 — 조직 Agent 생성 · 이벤트 구독 · 실행 원장]