앞붙이

이 책을 읽는 법

책의 구성, 패턴 프로필 한 건이 어떤 순서로 짜여 있는지, 그림과 상자와 표기가 무엇을 뜻하는지, 그리고 독자 유형에 따라 어디부터 읽으면 되는지를 안내한다.

이 장에서 얻을 것

책의 세 부와 부록이 각각 무엇을 다루는지 안다
패턴 프로필의 열네 부분을 순서대로 찾아 읽을 수 있다
계층 색, 상자 종류, 선과 화살표, 구현 상태 표기를 읽을 수 있다
자기 역할에 맞는 읽기 경로를 고를 수 있다

이 책은 처음부터 끝까지 읽어도 되고, 필요한 패턴 하나만 찾아 읽어도 된다. 두 번째 방식이 가능하려면 모든 패턴이 같은 형식으로 쓰여 있어야 하고, 모든 그림이 같은 기호를 써야 한다. 그 형식과 기호를 아래에 한데 모았다. 2부의 패턴 프로필을 처음 펼치기 전에 한 번 읽어 두면, 그다음부터는 어느 쪽을 펼치든 같은 정보를 같은 자리에서 찾는다.

책의 구성

책은 앞붙이, 세 부, 부록으로 이루어진다(그림 R.1). 앞붙이의 사례 배경이 가상 기관 가람시를 소개한다. 가람시 이야기는 그 뒤 1장부터 16장까지 장마다 이어진다. 17장은 이야기를 벗어나 PAX 사이트의 가이드라인과 리소스를 안내한다.

1부 기초(1~4장)는 왜 패턴 언어로 공공 AX를 읽는지(1장), 성숙도를 어떻게 재는지(2장), 디자인 패턴이 무엇이고 어디서 왔으며 왜, 어떻게 쓰는지(3장), 카탈로그의 계층·패턴 서명·환경 조건·서비스 유형이 어떻게 짜여 있는지(4장)를 다룬다.
2부 패턴 레퍼런스(5~11장)는 계층별로 한 장씩, 디렉터리 107개 항목 중 안티패턴을 뺀 91개의 패턴 프로필을 싣는다. 각 장은 계층 서론으로 시작한다. 서론에는 계층 전체의 지도, 그 안에서 패턴을 고르는 결정 흐름, 이웃 계층과의 경계가 실려 있다.
3부 적용(12~17장)에는 부품을 조립하는 절차와 서비스 유형별 템플릿(12장), 실제 조립 예시와 축 교차표(13장), 안티패턴 16종(14장), 태깅·검증·참조 구현 레지스트리(15장), PAX 564건으로 본 공공 AX의 현재(16장), PAX 가이드라인과 리소스(17장)가 차례로 놓인다.
부록은 패턴 한눈에 보기(A), 판정 규칙 R1~R28 개정 이력(B), 용어집(C), 참고문헌(D)이다.

그림 R.1 책의 구성. 1부가 읽는 법과 눈금자를, 2부가 계층별 패턴 프로필을, 3부가 조립과 점검을 다룬다. 아래 띠는 가상 기관 가람시의 이야기가 장마다 이어지는 순서다.

패턴 프로필 해부도

2부의 패턴 프로필은 모두 같은 순서로 짜여 있다. 이 형식은 두 참고서의 장치를 합친 것이다. Erl의 『SOA Design Patterns』에서는 질문형 요구(Requirement), 여섯 행의 프로필 요약표, 문제·해법 그림 한 쌍, 적용·영향·관계, 가상 기관의 사례 연구를 가져왔다. Gulli의 『Agentic Design Patterns』에서는 패턴마다 끝에 붙는 한눈에 보기(At a Glance)의 무엇·왜·경험칙 세 줄을 가져왔다. 그 사이에 카탈로그 고유 항목인 사용 현황, 환경 조건, 배선 예시, 판정(식별 신호와 구현 상태)을 끼웠다. 그림 R.2는 C1검토 큐를 예로 프로필 한 건의 부분을 위에서 아래로 보여 준다.

그림 R.2 패턴 프로필 해부도. 왼쪽은 C1 검토 큐 프로필을 축소한 지면이고, 오른쪽 번호는 각 부분의 이름과 읽는 법이다. 머리부(1~5)만 읽어도 패턴의 요지를 알 수 있고, ①~⑥은 설계하거나 판정할 때 펼친다.

열네 부분은 아래 순서로 놓인다. 같은 내용을 한 장으로 줄인 것이 표 R.1이다.

ID 명판. 계층 문자와 번호로 된 ID, 한국어 정식 이름, 별칭(영문 이름과 현장에서 쓰는 다른 이름), 등재 상태, 아이콘이 한 줄에 놓인다. 등재 상태는 Rule of Three를 따른다. 독립된 사용례가 3건 이상이면 확립, 1~2건이면 후보다. 안티패턴은 따로 안티패턴으로 표시한다. 아이콘은 해법을 축약한 미니 도식이다.
요구. "어떻게 하면 ~할 수 있는가?" 꼴의 질문 한 문장으로, 이 패턴이 채우는 요구를 적는다. 자기 과제의 고민이 이 질문과 같다면 그 패턴을 읽을 차례다.
의도. 패턴이 조립도 안에서 맡는 일을 한 문장으로 적는다. 디렉터리의 요약(summary)이다.
프로필 요약표. 여섯 행이다. 문제(한 문장), 해법(한 문장), 적용(어디에 어떻게 끼우나), 영향(대가·부담·위험), 원칙(관련 설계 원칙), 적용 범위(과업·서비스·기관·범정부 중). 원칙 칸에는 AX 설계 원칙 AIM01~AIM06이나 PAX 원칙(통제 우선·증거 우선·운영 증거)이 들어간다. 원칙의 뜻은 2장에서 다룬다.
사용 현황. 두 수치를 나란히 두고, 그 아래에 공공AX 패턴 성좌의 디렉터리로 가는 링크를 단다(17.10절). 링크를 열면 이 부품을 쓰는 PAX 사례 목록과 같이 쓰이는 부품이 나온다. PAX 사례 564건 중 이 패턴이 쓰인 사례 수와, 그 수를 564건으로 나눈 사용 비율이다. B는 주 부품이나 보조 부품으로 태깅된 사례를, C·S·F는 present나 implemented로 판정된 사례를 센다. 안티패턴 프로필에는 그 함정에 해당한다고 태깅된 사례 수만 싣는다.
① 문제. 동기(부품이 없을 때 사람이 겪는 문제), 맥락(적용 전제), 힘(서로 당기는 상충 요인)을 적는다. 문제 그림은 이 패턴이 빠진 조립을 보여 준다. 빠진 자리는 붉은 점선 상자다.
② 해법. 해법 서술, 해법 그림, 구조도(입력·출력·참여 부품), 변형을 싣는다. 해법 그림은 문제 그림과 배치와 크기가 같아서 두 그림을 겹쳐 보면 무엇이 바뀌었는지 드러난다.
③ 적용. 사용 절차(단계 번호), 점검 체크리스트, 환경 조건(어느 E축에 민감하고 조건별로 무엇이 바뀌는지), 배선 예시, 적용 노트를 싣는다. 2부에서 가장 긴 부분이다.
④ 영향. 이득과 대가, 쓸 때와 쓰지 말 때를 짝으로 적는다. 눈여겨볼 곳은 대가 칸이다. 이득을 되풀이하는 대신 운영 인력, 처리 지연, 감사 부담 같은 비용을 적는다.
⑤ 판정. 보고서나 사례 설명에서 이 패턴을 알아보는 식별 신호, 구현 상태 3단계(present·implemented·planned) 각각의 판정 기준, 자주 헷갈리는 이웃 패턴과의 경계를 적는다. 과제 검토자와 태깅 담당자가 가장 자주 펼치는 부분이다.
⑥ 관계. 관계도, 이 패턴이 전제하는 의존 부품, 관련 안티패턴을 싣는다. 관계도의 화살표에는 "의존한다", "함께 쓴다", "대안이다" 같은 동사구를 단다.
사례 연구 · 가람시(가상). 가람시의 한 부서가 이 패턴이 필요한 상황을 만나고, 도입하고, 무엇이 달라졌는지를 짧은 이야기로 쓴다. 이야기 끝에 조립 배선 한 줄이 붙는다.
한눈에 보기. 무엇(이 패턴이 푸는 문제), 왜(해법의 핵심 이유), 경험칙("~이면 쓴다 / ~이면 쓰지 않는다") 세 줄이다. 다 읽은 뒤 복습할 때, 또는 시간이 없을 때 여기부터 읽는다.
출처. 카탈로그의 해당 절, 패턴의 뿌리가 된 문헌, PAX 근거를 적는다.

**표 R.1** 패턴 프로필 부분별 내용과 쓰임
부분	담는 것	참고서의 대응	주로 쓰는 때
ID 명판	ID·이름·별칭·확립/후보·아이콘	Erl 헤더 박스·아이콘	찾기
요구	질문형 한 문장	Erl Requirement	내 고민과 맞는지 확인
의도	패턴이 하는 일 한 문장	GoF intent	훑어보기
프로필 요약표	문제·해법·적용·영향·원칙·적용 범위	Erl Profile Summary	훑어보기·비교
사용 현황	PAX 564건 중 사용 사례 수와 사용 비율	카탈로그 고유	얼마나 검증됐나
① 문제	동기·맥락·힘, 문제 그림	Erl Problem	설계
② 해법	해법·해법 그림·구조도·변형	Erl Solution	설계
③ 적용	절차·체크리스트·환경 조건·배선·노트	Erl Application	구축
④ 영향	이득/대가, 쓸 때/쓰지 말 때	Erl Impacts	도입 결정
⑤ 판정	식별 신호·구현 상태·헷갈리는 이웃	카탈로그 고유(§12)	평가·태깅
⑥ 관계	관계도·의존·안티패턴	Erl Relationships	조립
사례 연구	가람시(가상) 이야기와 배선 한 줄	Erl Case Study Example	감 잡기
한눈에 보기	무엇·왜·경험칙	Gulli At a Glance	복습
출처	카탈로그 절·문헌·PAX 근거	Erl·Gulli References	더 읽기

기호·그림·표기 규칙

계층 색과 상자

책의 모든 그림은 같은 색과 같은 상자를 쓴다. 색은 계층을 뜻한다(그림 R.3 위). 본문에서 패턴 이름 앞에 붙는 ID 배지의 색도 같은 규칙을 따른다. 그림 안에서 색이 없는 흰 상자는 카탈로그 부품이 아닌 것(업무 시스템, 문서, 부서)이다. 그 밖에 네 종류의 상자에는 따로 정한 뜻이 있다(그림 R.3 아래).

그림 R.3 위는 계층 색 범례다. 같은 색은 같은 계층이다. 아래는 특수 상자다. 붉은 점선 상자는 결손 부품, 회색 점선 구역은 망이나 조직의 경계, 테두리가 진한 상자는 사람을 뜻한다.

선과 화살표

선의 모양과 색은 그 연결의 성격을 뜻한다(그림 R.4). 화살표 방향은 데이터나 산출물이 흐르는 방향이다. 배선을 본문에서 글로 적을 때도 같은 방향으로 A2.4 → B1 → C1 → C4처럼 쓴다. 화살표 왼쪽이 오른쪽에 무언가를 넘겨준다.

그림 R.4 선과 화살표의 뜻. 붉은 선은 문제 그림에서, 초록 선은 해법 그림에서 주로 쓴다. 점선은 조건이 맞을 때만 생기거나 아직 계획 단계인 연결이다.

ID와 패턴 표기

패턴 ID는 계층 문자와 번호다(A1, C9, X16). 변형이나 하위 항목은 소수점을 붙인다(A2.4 내부망 프록시, C1.2 심의 게이트, D8.3 초안·기안). 제어 흐름 원형은 프라임 기호를 붙여 B′1~B′10으로 쓰고, 기억 관리는 B′+다.
본문에서 패턴을 가리킬 때는 C1검토 큐처럼 ID 배지가 붙은 이름을 쓴다. 누르면 그 패턴의 프로필로 간다.
그림과 표 번호는 장.순번이다(그림 5.2, 표 12.2). 앞붙이는 장 번호 대신 P(서문)·R(읽는 법)·K(사례 배경)를 쓰고, 부록은 A~F를 쓴다. 본문은 그림을 먼저 언급하고 그 뒤에 그림을 둔다.
판정 규칙은 R 번호로 부른다(R1 가치 흐름, R3 구현 상태 등). 모든 규칙의 개정 이력은 부록 B에 있다.
환경 조건은 E1(배포망)·E2(모델 의존)·E3(실행 형태)·E4(권한 범위)·E5(데이터 등급)로 적고, 권한 범위의 값은 P0~P4로 적는다.

구현 상태

카탈로그는 부품이 "있다"는 말을 세 단계로 나눈다(R3, R12). 같은 부품도 어느 단계로 판정되느냐에 따라 무게가 크게 다르다. 운영 부품(C)의 present 판정은 특히 엄격하다.

**표 R.2** 구현 상태 3단계
표기	뜻	판정 기준
present	운영에서 작동함	실제 운영에서 최소 1회 완결된 실행 사이클의 기록이 있다(재학습 실행, 절체 실행, 검토 건수 등).
implemented	구현됐으나 실측 전	코드나 기능은 있으나 운영 기록이 없다. "하고 있다", "할 예정이다" 같은 진행형·의지형 서술은 이 단계가 상한이다.
planned	계획만 있음	설계서·계획서에만 있다.

본문 상자

본문 사이에 끼는 상자는 일곱 종류다. 상자마다 테두리와 머리글이 다르다.

**표 R.3** 본문 상자의 종류
머리글	담는 것
핵심	정의나 원칙처럼 기억해야 할 한두 문장
핵심 요약	개념이 무거운 절의 끝에서 그 절의 결론을 2~4개로 압축
참고	범위 단서, 다른 장 참조, 오해 방지
주의	흔한 실수와 함정
판정 규칙	카탈로그 판정 규칙 R1~R28의 원문 요지
사례 연구 · 가람시(가상)	가상 기관 가람시의 이야기. 실재 기관·제품·수치는 쓰지 않는다.
한눈에 보기	무엇·왜·경험칙 세 줄 요약

수치의 출처

책에 나오는 수치는 PAX 사례 아카이브 564건(2026년 10월 16일 원장 기준)에서 온다. 패턴 태깅과 4축 평가 모두 564건 전수를 대상으로 다시 집계했다. 사용 수를 세는 기준은 계층마다 다르다. B는 주 부품과 보조 부품을 함께 세고, C·S·F는 present와 implemented를 센다. present만 따로 센 수치는 본문에 그렇다고 밝혔다. 카탈로그 v0.7.1 문서가 작성될 당시의 수치를 인용할 때는 "카탈로그 v0.7.1 작성 당시(459건)"처럼 시점을 붙였다. 어느 기준인지는 그림과 표의 캡션에도 밝혀 두었다.

독자 유형별 읽기 경로

이 책의 독자는 넷으로 나뉜다. 기관에서 AX 과제를 기획하고 조립하는 담당자와 정보화 부서, 과제를 검토하고 판정하는 과제 검토자·감사 담당자, 업무 도구를 직접 만드는 공직 개인 개발자다. 그림 R.5와 표 R.4가 각자 먼저 읽을 장을 권한다. 어느 경로든 1장과 이 장은 공통이다.

그림 R.5 독자 유형별 권장 읽기 순서. 담당자는 서명을 쓰고 조립하는 순서로, 과제 검토자는 눈금자와 판정 절 중심으로, 개인 개발자는 자기 도구가 속하는 부품과 공유·인수인계 쪽으로 읽는다.

**표 R.4** 독자 유형별 출발점과 이 책에서 얻을 것
독자	먼저 읽을 곳	얻을 것
AX 담당자·정보화 부서	1장, 4장, 12장, 해당 계층 장, 부록 E	과제를 패턴 서명으로 쓰고, 환경 조건에 맞는 의존 부품을 끼우고, 기관 공통 부품을 찾는 법, 사업 단계마다 펼칠 안내서
과제 검토자	2장(2.12~2.16 판정 예시와 워크시트), 4장, 각 프로필의 ⑤ 판정, 15장	보고서에서 부품을 식별하고 present·implemented·planned를 가르는 기준, 안티패턴 점검표
공직 개인 개발자	5장 B0·B1, 7장 A7~A10, 9장, 14장 X9, 부록 F	자기 도구가 어느 부품인지, 부서 밖으로 퍼지려면 무엇을 갖춰야 하는지, 레지스트리 등재 방법, 비슷한 실제 사례의 배선
처음 읽는 모든 독자	사례 배경, 1장, 부록 A	가람시 이야기의 출발점과 107개 항목의 지도

핵심 정리

책은 1부 기초(1~4장), 2부 계층별 패턴 레퍼런스(5~11장), 3부 적용(12~17장), 부록 A~F로 이루어지고, 가람시(가상) 이야기가 1장부터 16장까지 이어진다.
패턴 프로필은 명판·요구·의도·요약표·사용 현황, ①문제~⑥관계, 사례 연구·한눈에 보기·출처의 열네 부분으로 짜여 있다.
색은 계층을 뜻한다. 붉은 점선 상자는 빠진 부품, 붉은 선은 문제 경로, 초록 선은 개선된 경로다.
구현 상태는 present(운영 작동 기록)·implemented(구현, 실측 전)·planned(계획)로 나눈다.
패턴은 ID 배지가 붙은 이름으로 가리키고, 배선은 화살표로 적는다(A2.4 → B1 → C1 → C4).
담당자는 서명과 조립, 과제 검토자는 판정 절, 개인 개발자는 B0·A7~A10과 공유·인수인계 쪽에서 출발한다.