인터페이스 요구사항·경계·명세·데이터 표준
인터페이스 요구사항과 시스템 경계를 식별하고 데이터 명세·표준·매핑 방법을 익힌다.
인터페이스의 의미
인터페이스는 서로 다른 시스템·모듈이 기능과 데이터를 교환하기 위해 합의한 경계와 규칙이다. 단순한 통신 선이 아니라 업무 목적, 데이터, 호출 조건, 결과와 오류를 포함하는 계약이다.
- 내부 인터페이스: 분석 대상 시스템 내부의 모듈·서브시스템 사이
- 외부 인터페이스: 분석 대상 시스템과 외부 시스템·기관·장치 사이
회사 안에 있는 시스템끼리라도 분석 대상 경계를 넘으면 외부 인터페이스가 될 수 있다.
인터페이스 요구사항 확인
다음 항목을 확인한다.
| 항목 | 확인 내용 |
|---|---|
| 목적 | 어떤 업무 결과를 얻기 위한 연계인가? |
| 대상 | 송신·수신·중계 시스템은 무엇인가? |
| 기능 | 어떤 요청·조회·통지·처리가 필요한가? |
| 데이터 | 어떤 항목을 어떤 의미와 형식으로 교환하는가? |
| 시점·주기 | 실시간, 요청 시, 일정 주기, 일괄 처리인가? |
| 품질 | 처리 시간, 건수, 가용 시간, 순서·중복 조건은 무엇인가? |
| 제약 | 네트워크, 기존 시스템, 표준, 운영 시간 등의 제약은 무엇인가? |
| 오류 | 실패를 어떻게 알리고 복구·재처리할 것인가? |
연계 기술을 먼저 고르지 않고 필요한 업무 결과와 조건을 먼저 명확히 한다.
인터페이스 대상 식별
- 업무 흐름에서 시스템 경계를 넘는 데이터·기능을 찾는다.
- 송신·수신 시스템과 필요한 중계 시스템을 식별한다.
- 각 시스템의 역할과 책임을 정한다.
- 교환 데이터, 발생 조건, 주기와 처리량을 확인한다.
- 네트워크·보안 구간·운영 시간·장애 영향을 검토한다.
- 누락·중복 인터페이스를 관계자와 확인한다.
송신 시스템은 데이터를 보내는 쪽, 수신 시스템은 받아 처리하는 쪽이다. 중계 시스템은 변환·라우팅·전달을 담당할 수 있지만 업무 결과의 최종 책임을 자동으로 갖는 것은 아니다.
인터페이스 명세
인터페이스 명세 예시
기본 식별 정보
- 인터페이스 ID와 명칭
- 목적과 관련 요구사항
- 송신·수신·중계 시스템
- 호출·전송 시점과 주기
- 통신 방식과 데이터 형식
데이터 명세
| 항목 | 설명 |
|---|---|
| 항목명·표준 용어 | 동일한 의미를 같은 이름으로 사용 |
| 의미·설명 | 업무상 무엇을 나타내는지 명확히 함 |
| 자료형·길이 | 문자열·숫자·날짜와 허용 길이 |
| 필수 여부 | 누락 가능 여부와 조건 |
| 값 범위·코드 | 허용 값, 코드 체계 |
| 형식 | 날짜, 소수점, 단위, 인코딩 등 |
| 기본값·NULL | 값 없음과 기본 처리 규칙 |
| 검증 규칙 | 구문·업무 규칙 검사 |
항목이 없음, null, 빈 문자열, 숫자 0은 의미가 다를 수 있으므로 명세에서 구분한다.
데이터 표준과 매핑
데이터 매핑 흐름도
- 표준 단어: 데이터를 구성하는 최소 단어의 표준 표기
- 표준 용어: 업무 개념을 나타내는 표준 명칭과 정의
- 표준 도메인: 자료형·길이·값 범위 같은 공통 속성
- 표준 코드: 분류값과 코드 의미를 통일한 체계
데이터 매핑은 송신 항목과 수신 항목의 의미·형식 차이를 연결한다.
| 매핑 유형 | 예 |
|---|---|
| 직접 매핑 | customer_id → 고객번호 |
| 코드 변환 | Y/N → 1/0 |
| 형식 변환 | YYYYMMDD → YYYY-MM-DD |
| 단위 변환 | 원 → 천 원 |
| 결합·분리 | 성+이름 ↔ 전체 이름 |
| 기본값 처리 | 값 누락 시 명세된 기본 상태 적용 |
자료형만 맞아도 의미가 다르면 올바른 매핑이 아니다. 코드 미등록, 길이 초과, 단위·시간대 차이도 확인한다.
요구사항과 설계 명세의 차이
- 요구사항: 무엇을 어떤 수준으로 교환해야 하는지 정의
- 설계 명세: 어떤 시스템·방식·메시지와 처리 규칙으로 실현할지 구체화
설계 명세는 요구사항을 추적할 수 있어야 하며, 변경 시 관련 데이터·시스템·시험 항목의 영향을 확인한다.