검증된 조각을 연결하되, 책임의 경계부터 세우기

시작 전

연결은 편의 버튼이 아니라 새로운 책임입니다

외부 서비스와 닿는 순간 권한 만료·형식 불일치·응답 지연·민감정보 노출이 생깁니다. 연결 개수보다 안전한 한 바퀴가 목표입니다.

• 경계: 내 파일과 외부 시스템 사이에서 입력·결과·권한이 바뀌는 지점
• 최소 권한: 필요한 동작·대상·기간만 허용하는 권한
• 승인 게이트: 되돌리기 어려운 동작 직전에 사람이 확인하는 정지점
• 기록하고 정지: 실패 위치와 이유를 남기고 다음 단계로 보내지 않는 규칙

01 · 경계

파일 안과 밖을 한 줄로 나누기

무엇을 연결할지보다 어떤 정보가 어디로 넘어가는지를 먼저 씁니다.

1. 01

   W07 결과의 입력·출력 확인하기

   왜 하나요? 검증되지 않은 기능을 넓히지 않습니다.

   할 일 통과한 조각의 실제 입력·결과·사람 검토 위치를 목록으로 냅니다.

   복사해서 써도 되는 요청

   W07 기록에서 외부로 보내거나 받아야 하는 값만 표시해줘. 근거가 없는 데이터는 보내지 않는 것으로 표시해줘.

   정상이라면 연결 전후에 어떤 값이 이동하는지 압니다.

2. 02

   실패 지점을 먼저 예상하기

   왜 하나요? 성공 경로만 연결하지 않습니다.

   할 일 형식 불일치·권한 거부·지연·중복 전달을 적습니다.

   정상이라면 연결을 끊어 볼 위치와 기록할 신호가 정해집니다.

02 · 권한

연결 방식과 권한을 필요한 만큼만 고르기

도구가 먼저가 아니라 빈도·형식·권한 조건이 먼저입니다.

1. 01

   빈도·형식·권한 비용으로 선택하기

   왜 하나요? 편한 연결이 운영 부담으로 바뀌지 않게 합니다.

   할 일 수동/반복, 형식 안정성, 열어야 할 권한을 비교합니다.

   복사해서 써도 되는 요청

   연결 후보를 빈도·형식·권한·복구로 비교해줘. 근거 없는 추천은 하지 마.

   정상이라면 조건별 선택 이유가 남습니다.

2. 02

   동작·대상·기간을 좁히기

   왜 하나요? 전체 계정 권한을 열지 않습니다.

   할 일 읽기/쓰기, 대상 항목, 유효 기간을 각각 최소로 적습니다.

   정상이라면 “이 폴더 새 파일 읽기만, 오늘 하루”처럼 요청합니다.

3. 03

   민감정보를 경계 밖으로 보내지 않기

   왜 하나요? 필요하지 않은 개인·계정 정보를 전파하지 않습니다.

   할 일 필요 필드만 남기고 식별자·토큰·비밀값은 마스킹합니다.

   정상이라면 보내는 데이터와 보내지 않는 이유가 남습니다.

03 · 승인과 정지

되돌리기 어려운 순간에는 흐름을 멈추기

모든 단계를 사람이 확인할 필요는 없지만 외부 영향 전에는 승인과 복구를 설계합니다.

1. 01

   자동 구간과 승인 게이트 나누기

   왜 하나요? 사람의 시간을 아끼면서 책임을 남깁니다.

   할 일 판정 가능한 변환은 자동으로, 외부 영향은 승인 후 실행하게 표시합니다.

   정상이라면 게이트 앞에 사람이 볼 정보와 선택지가 정해집니다.

2. 02

   실패를 주입하고 기록하고 정지하기

   왜 하나요? 조용한 실패를 막습니다.

   할 일 권한 거부나 잘못된 형식을 넣고 멈춤 위치·이유·재개 값을 기록합니다.

   복사해서 써도 되는 요청

   이 연결에서 안전하게 주입할 실패와 반드시 남길 로그 필드를 제안해줘.

   정상이라면 실패 위치와 다음 행동이 남습니다.

3. 03

   재개 절차를 한 번 실행하기

   왜 하나요? 문서가 실제로 흐름을 살리는지 확인합니다.

   할 일 원인을 해결하고 멈춘 위치에서 다시 시작해 중복 결과를 확인합니다.

   정상이라면 성공 한 번이 아니라 실패 후 복귀까지 한 바퀴가 됩니다.