~/study/architect-guidance검토일

소프트웨어 아키텍트 성장 가이드

이미 이해하고 있는 시스템을 다른 사람이 검토하고, 질문하고, 이어서 발전시킬 수 있는 의사결정으로 정리하세요.

읽기 목차

새 기술보다 먼저 경험을 증거로

만들어 본 시스템에서 시작하기

결재 워크플로, 편집기, 알림 서비스, 캡처 파이프라인, 모바일 셸 중 익숙한 시스템 하나를 고르세요.

아키텍처 연습은 제약·대안·결과·검증 방법을 드러내는 일이며, 새로운 프레임워크는 실제 제약을 해결할 때 의미가 있습니다.

이 문서는 공개 학습 가이드이며 개인의 역량 평가나 보편적인 승진 기준표가 아닙니다.

직함보다 판단과 협업의 범위

역할과 증거 살펴보기

Staff와 Principal 직함의 의미는 조직마다 다르므로, 고정된 등급으로 보기보다 의사결정·협업·성과의 범위를 확인하세요.[1]

Will Larson은 Tech Lead, Architect, Solver, Right Hand라는 네 가지 반복적인 역할을 설명하며, 이를 필수 경력 순서가 아닌 팀에 필요한 일을 논의하는 틀로 사용할 수 있습니다.[1]

역량 → 확인할 증거 → 다음 연습
역량확인할 증거다음 연습
품질 속성측정 가능한 신뢰성·지연 시간 제약자극·환경·응답·측정 방법 작성
트레이드오프 분석기각한 대안까지 설명할 수 있는 결정같은 제약으로 대안 비교
의사결정 문서화검토된 ADR결과와 재검토 조건 기록
도메인 모델링명시적인 업무 불변식과 소유권바운디드 컨텍스트·트랜잭션 경계 정리
분산 데이터재시도와 일관성에 대한 설명중복 이벤트의 처리 과정 추적
API 설계명시적인 계약과 호환성 정책오류·페이지네이션·멱등성 정의
프론트엔드 플랫폼소유자와 소비자가 있는 공유 컴포넌트기여·지원 종료 규칙 작성
보안신뢰 경계를 포함한 위협 모델인가·실패 경로 테스트
운영측정된 SLI와 대응 런북의존 서비스 장애 훈련
인프라IaC 변경과 복구 절차드리프트·복구·롤백 검토
AI 시스템버전이 관리되는 평가 데이터셋품질·지연·비용 비교
영향력동료 피드백으로 변경된 설계검토자·이견·도입 결과 기록

설계 문서는 결정을 전달하는 수단이며, 영향력의 증거에는 도입 결과, 피드백, 배포 후 운영 성과도 포함됩니다.

구체적인 산출물을 향해 읽기

써먹을 수 있는 지식 쌓기

Fundamentals of Software Architecture로 용어를 익히고, MADR로 의사결정을 기록하고, C4로 시스템 경계를 표현하며, The Staff Engineer’s Path로 기술 리더십을 공부하세요.[4][2][3][5]

현재 설계에서 복제·파티셔닝·트랜잭션·스트림에 관한 질문이 생길 때 Designing Data-Intensive Applications의 해당 내용을 참고하세요.[6]

  • 서비스 경계를 선택하기 전에 도메인 불변식과 바운디드 컨텍스트를 정의하고, 네트워크 장애 요인을 추가하지 않는 모듈러 모놀리스도 비교하세요.
  • 품질 속성 시나리오로 대안을 비교할 때는 사건의 주체, 운영 조건, 필요한 응답, 측정 방법을 명시하세요.
  • 컨텍스트 다이어그램에 장애 지점과 영향도를 표시하고 대응 책임자를 지정하는 위험 검토를 진행하세요.
  • 도메인 주도 설계, 진화적 아키텍처, 팀 경계에 관한 심화 학습은 작성 중인 산출물을 바꿀 수 있을 때 선택하세요.

상태·경계·소유권을 모델링하기

프론트엔드도 아키텍처 영역이다

명시적으로 결정할 가치가 있는 것들
영역설계 선택검증할 것
편집기문서 상태와 DOM을 분리하고 contenteditable·ProseMirror·Lexical 비교선택 영역·문자 조합 입력·실행 취소·오디오 동기화
결제 화면pending·confirmed·failed·unknown 상태 모델링중복 제출·타임아웃·결과 대사·같은 의도의 재시도
모바일 셸WebView·네이티브 UI·브리지 권한 비교출처 확인·인증 정보 전달·브리지 입력 검증
캡처 파이프라인플랫폼 접근과 작업 부하를 기준으로 Tauri·Electron 비교재현 가능한 처리량·프레임 손실·CPU 사용·backpressure
공유 플랫폼조합 방식보다 소유권·버전·호환성 먼저 정의소비자 업그레이드 경로·접근성·롤백

결제성 동작에서 버튼 비활성화는 인터페이스를 개선하지만, 결과가 불명확할 때의 정확성은 서버 측 멱등성과 결과 대사가 결정합니다.

라이브러리를 선택하기 전에 서버 상태·공유 클라이언트 상태·로컬 상호작용 상태를 구분하고, 특정 상태 라이브러리나 마이크로 프론트엔드를 보편적 기본값으로 두지 마세요.

SSE로 서버 업데이트를 받고 일반 HTTP 요청으로 명령을 보낼 수 있으며, 상호작용과 연결 요구사항이 양방향 채널을 정당화할 때 WebSocket을 선택하세요.[11]

실제로 운영하는 데이터베이스에서 출발

실패를 설계에 포함하기

MySQL 기반 알림 서비스에서는 업무 변경과 outbox 행을 같은 트랜잭션에 기록하고, 워커가 커밋된 행을 발행하게 구성합니다.[7]

전달 직후 완료를 기록하기 전에 릴레이가 종료되면 중복 발행이 가능하므로, 이벤트 식별자를 추적하고 소비자의 처리를 멱등하게 만드세요.[7]

  • 동시 워커가 같은 작업을 의도적으로 처리하지 않도록 행 선점이나 임대를 정의하고, 제한된 시간 후 방치된 선점을 복구하세요.
  • 엔티티별 순서, backoff와 jitter를 포함한 재시도, 재시도 한도, 검토 후 재처리·폐기할 수 있는 dead-letter queue를 명시하세요.
  • 멱등성 키를 주체와 작업에 한정하고 정규화한 요청 해시를 비교하며, 요청 변경 시 키 재사용 거부와 만료·진행 중 복구 방식을 정하세요.
  • MySQL에 원시 SHA-256 다이제스트를 저장한다면 BINARY(32)가 표현 예시이며, BYTEA는 MySQL 컬럼 타입이 아닙니다.

직접 폴링하는 워커는 별도 큐가 필요하지 않으며, pg-boss에는 PostgreSQL이, BullMQ의 Redis 백엔드에는 Redis가 추가되므로 의존성을 의식적으로 선택하세요.[9][8][17]

여러 서비스에 걸친 워크플로에서는 choreography와 orchestration을 비교하고, 보상 동작·부분 실패·운영 책임을 함께 검토하세요.

expand-contract 마이그레이션에는 백필과 호환 기간을 두고, 반복 실패가 전파되는 의존 서비스에는 타임아웃과 circuit breaker를 함께 검토하세요.

성과를 주장하기 전에 측정하기

보안과 운영을 설계의 입력으로

보안 통제를 선택하기 전에 자산, 신뢰 경계, 주체별 권한, 악용 사례를 담은 위협 모델을 그리세요.

결제 페이지에서는 PCI DSS의 스크립트 승인·무결성·목록 관리 요구사항을 확인하고, nonce 기반 CSP는 통제 수단 중 하나이며 규정 준수 평가 전체를 대체하지 않는다는 점을 구분하세요.[12]

SLO를 정하기 전에 SLI의 측정 대상과 관측 기간을 정의하고, 제안한 지연 시간은 실제 측정으로 뒷받침되기 전까지 목표값으로 표시하세요.[10]

  • 브라우저 측정·백엔드 트레이스·구조화 로그를 요청 식별자로 연결하고 인증 정보와 개인 정보는 제거하세요.
  • 증상, 담당자, 완화 조치·롤백·복구 검증을 담은 런북을 작성하고 의존 서비스 장애를 훈련하세요.
  • 도구를 바꾸기 위해 기존 스택을 다시 구축하기보다 infrastructure as code의 권한·시크릿·드리프트·백업 복구·비용·배포 안전성을 검토하세요.
  • Kubernetes는 시니어 역량의 증명으로 취급하기보다 리소스 제한·프로브·외부 시크릿 관리를 포함한 선택적 배포 연습으로 다루세요.

이 저장소에는 Amplify/CDK 인프라, 일부 리더 화면의 Web Vitals 수집, 채팅 평가 도구가 있지만, 코드 존재만으로 배포 범위나 운영 성과 개선을 입증하지는 않습니다.

데모를 출발점으로 삼기

AI 시스템에도 증거가 필요하다

요구를 충족하는 가장 단순한 워크플로부터 시작하고, 평가가 추가 비용과 실패 요인을 정당화할 때만 routing·parallelization·에이전트 자율성을 더하세요.[14]

RAG·긴 컨텍스트·fine-tuning을 교체 가능한 업그레이드로 보기보다 지식의 최신성·추적 가능성·행동·지연·비용을 기준으로 비교하세요.

범위가 명확한 실험 하나 선택하기
실습산출물통과 근거
도메인 문서 RAG검색·청킹·원문 접근에 대한 결정답변 가능성·인용 정확성·검색 실패가 표시된 데이터셋
읽기 전용 MCP 도구도구 계약·신원 범위·감사 설계인가 테스트·악의적 출력 테스트·호출 상한
채팅 평가 루프불변 프롬프트·데이터셋 버전기준 버전 대비 품질·비용·지연 비교

합성 데이터나 공개 가능한 데이터를 쓰고 도구·데이터 계층에서 권한을 강제하며, 검색한 텍스트는 명령 실행 권한이 아닌 신뢰할 수 없는 입력으로 취급하세요.

문제 → 제약 → 결정 → 증거

판단 과정을 검토 가능하게 만들기

설계 문서에는 맥락, 목표와 비목표, 인터페이스와 데이터, 대안·위험·테스트·배포·롤백·성공 기준을 담으세요.

MADR로 핵심 결정을 기록하고 C4 컨텍스트·컨테이너 다이어그램으로 경계를 설명하되, 동작 설명이 필요한 곳에만 시퀀스·상태 다이어그램을 추가하세요.[2][3]

재사용할 수 있는 사례 연구 다섯 가지
시스템설명할 트레이드오프포함할 증거
결재 워크플로명시적 라우팅과 범용 규칙 엔진상태 전이·불변식·권한 경계
알림 서비스동기 발송과 내구성 있는 비동기 전달실패 시퀀스·중복·재처리·운영 비용
전사 편집기문서 모델과 암묵적 DOM 상태문자 조합 입력·선택 영역·동기화 테스트
화면 캡처네이티브 접근·이식성·처리 비용측정 방법·작업 부하·프레임 손실·병목
모바일 셸네이티브 기능과 웹 코드 공유브리지 신뢰 경계·인증·복구

공개·합성 예시로 방법을 설명하고 회사 스키마·고객 식별자·인증 정보·비공개 트래픽은 게시하지 않으며, 앱이 공개되었다고 구현까지 공개된 것은 아님을 기억하세요.

상자를 그리기 전에 가정을 드러내기

설명을 연습하기

프론트엔드 설계에는 RADIO의 Requirements·Architecture·Data model·Interface·Optimizations를 활용하고, 각 단계의 깊이를 정하기 전에 면접 범위를 합의하세요.[15]

백엔드·풀스택 연습에서는 모든 면접에 고정 시간표를 강요하기보다 요구사항·엔티티·인터페이스·데이터 흐름·상위 설계·실패 분석을 다루세요.

반복 가능한 연습 순환
회차시스템깊이 살펴볼 것
1–2알림 서비스전달 보장·실패 메시지 재처리
3–4협업 전사 편집기충돌 해결·선택 영역·지연
5–6결제 화면멱등성·불명확한 결과
7–8알림 확장용량 추산·순서·운영 비용
9–10스트리밍 전사흐름 제어·연결 종료·공급자 장애
11–12공유 프론트엔드 마이그레이션소유권·호환성·배포·롤백

가상의 부하로 일간 사용자 100만 명이 알림을 10개씩 받는다면 평균은 초당 약 116개이며, 피크를 10배로 가정하면 초당 약 1,160개이므로 실제 트래픽으로 가정을 확인해야 합니다.

시작일은 자유롭게, 단계마다 증거를 남기기

지속 가능한 성장 로드맵

주 6시간을 하나의 예산으로 두고 문서 작성 2시간, 목적 있는 읽기 2시간, 구현 1시간, 연습 1시간으로 배분하세요.

아래 마일스톤은 납기 약속이 아닌 제안이며, 검토·접근 권한·실제 업무가 시간을 차지하면 단계의 범위를 줄이거나 기간을 늘리세요.

같은 주간 예산 안에서 진행하는 상대적 일정
단계초점검토 가능한 산출물
1–2주익숙한 의사결정 문서화ADR 하나·시스템 컨텍스트 다이어그램 하나
1–3개월공개·검토·수정사례 연구 하나·위험 검토·동료 피드백
4–6개월실패하기 쉬운 경로 하나 심화측정을 포함한 outbox 실험 또는 신뢰성 훈련
7–12개월인프라 또는 AI의 빈틈 하나 선택복구 훈련 또는 평가 근거가 있는 데모
13–18개월다른 사람과 함께 의사결정 주도검토된 제안·도입 근거·배포 결과
19–24개월정리하고 전달하기의사결정 재검토·회고·발표 또는 글

자격증은 자신의 업무나 확인된 채용 요건에 필요한 역량과 맞을 때 선택하고, 시험명·응시 가능 여부·비용은 제공 기관에서 확인하세요.

출처의 사실과 학습 제안을 구분하기

참고 자료와 검증 범위

아래 자료는 개별 개념의 근거이며, 실습·학습 순서·완료 기준은 해당 출처가 요구하는 조건이 아닌 편집상의 제안입니다.

이번 공개판에서는 개인 점수·지원 전략·연봉 비교, 추측에 기반한 출시 전망, 검증하지 않은 기업별 면접 기대치를 제외했습니다.

기초 서적과 실무 문서를 함께 읽고, AWS Well-Architected Framework로 운영 우수성·보안·신뢰성·성능·비용·지속 가능성을 검토하세요.[13]

구현 시점에는 변경 가능한 문서를 다시 확인하고 실제 시스템의 개인 정보·계약·적용 법규를 검토하며, 이 가이드를 규정 준수 의견서로 사용하지 마세요.

  1. [1]Will Larson · Staff archetypes
  2. [2]MADR · Markdown Architectural Decision Records
  3. [3]Simon Brown · C4 model
  4. [4]Richards & Ford · Fundamentals of Software Architecture, 2nd edition
  5. [5]Tanya Reilly · The Staff Engineer’s Path
  6. [6]Kleppmann & Riccomini · Designing Data-Intensive Applications, 2nd edition
  7. [7]AWS · Transactional outbox pattern
  8. [8]MySQL · BINARY and VARBINARY
  9. [9]pg-boss · Introduction
  10. [10]Google SRE Workbook · Implementing SLOs
  11. [11]MDN · Using server-sent events
  12. [12]PCI SSC · Payment Page Security and Preventing E-Skimming
  13. [13]AWS · Well-Architected Framework
  14. [14]Anthropic · Building effective agents
  15. [15]GreatFrontEnd · The RADIO Framework
  16. [16]Neal Ford · Architectural Katas
  17. [17]BullMQ · Introduction and storage backends
↑ 맨 위로