코딩 캣 오란 Ep4, 인간 말하기
Source: Dev.to
첫 번째 발표
보스가 전사 회의를 소집했다: 20분, 회의실, 금요일 오후 2시.
“오란, 너가 새 시스템을 발표해. 모두에게 어떻게 작동하는지 보여줘.”
오란은 준비할 시간이 3일뿐이었다. 그는 권한 레이어를 재구축하고, 재고 모듈을 재설계했으며, 승인 워크플로우를 추가했다. 엔터티‑관계 다이어그램, SQL 스니펫, 권한‑검사 로직 흐름도를 가득 담은 15장의 슬라이드 덱을 만들었다—기술적이고, 철저하며, 정확했다.
금요일이 찾아왔다. 오란은 방 앞에 섰다: 뒤쪽 열에는 듀크와 창고 직원들, 앞쪽에는 린 씨, 공장 현장 감독관, 영업팀, 그리고 GM이 있었다.
그는 첫 번째 슬라이드로 넘어갔다: 다섯 개 테이블과 외래키 화살표가 있는 ER 다이어그램. 방은 조용해졌다— 좋은 의미의 침묵이 아니다. 일곱 번째 슬라이드가 끝난 뒤, GM이 손을 들었다:
“오란. 나는 네 말을 믿는다. 시스템은 작동한다. 하지만 질문 하나가 있다.”
“예?”
“우리에게 이 시스템이 무엇을 해주는지, 어떻게 만들어졌는지가 아니라, 무엇을 하는지 평이한 말로 설명해줄 수 있겠니?”
오란은 입을 열었다가 닫았다. 그는 모든 테이블, 조인, 제약 조건을 설명할 수 있었지만, 청중에게 울림을 주는 한 문장도 떠올리지 못했다.
수정된 프레젠테이션
Slide 1 – 당신에게 바뀌는 점
“로그인하면 업무와 관련된 내용만 보게 됩니다. 창고 부서는 재고를 보고, 재무 부서는 청구서를 봅니다. 잡동사니도 없고, 혼란도 없습니다.”
Slide 2 – 당신이 신뢰할 수 있는 것
“모든 approval, change, 그리고 access grant가 기록됩니다. ‘누가 언제 이 작업을 했는지’ 물어볼 필요가 생기면, 시스템이 답을 제공합니다.”
Slide 3 – 당신이 제어하는 것
“신입 직원? 부서장이 역할을 할당합니다. IT에 ticket을 보낼 필요 없습니다. 그들은 필요한 access만 정확히 받으며, 그 이상도 이하도 없습니다.”
ER diagrams 없음. SQL 없음. 화살표 없음.
두 번째 프레젠테이션
월요일, 오란은 같은 방에서 다시 발표했다. 이번에는 듀크가 진심으로 고개를 끄덕였고, 린 씨는 휴대폰을 치웠으며, 영업팀은 실용적인 질문을 던졌다:
- “내 주문에 대한 주간 보고서를 받을 수 있을까요?”
- “분기 감사자를 위한 읽기 전용 역할을 추가할 수 있을까요?”
GM은 “이게 바로 내가 지난주에 듣고 싶었던 말이야.”라고 말했다.
오란은 어떤 강의에도 없던 교훈을 얻었다:
시스템은 사람들이 이해하기 전까지 존재하지 않는다.
가장 우아한 스키마를 만들 수 있어도, 한 문장으로 설명하지 못한다면 의미가 없다.
기술을 인간의 언어로 번역하는 것은 “단순화”가 아니다. 이는 위장된 디자인 리뷰이다. 설명이 혼란스러워 보인다면, 그 기능 자체가 혼란스러워진 것이다.
즉각적인 개선
피드백에 힘입어 Oran은 세 가지 작지만 영향력 있는 기능을 추가했습니다:
- “My Access” 페이지에서 사용자는 자신의 권한을 쉬운 언어로 확인할 수 있습니다.
- 부서장을 위한 role summary 페이지—SQL 없이 깔끔한 표만 제공합니다.
- 접근 권한이 변경될 때 알림 이메일을 발송합니다. 예: “2023년 3월 15일, Duke에 의해 Warehouse Staff 역할이 부여되었습니다.”
이 작은 추가 사항들이 큰 차이를 만들었습니다. 이제 시스템이 인간의 언어로 말했기 때문입니다.
Next Episode
Six months later, the GM asked Oran to lead the next project. He’s no longer just a developer; he decides what gets built. The orange cat has grown into a role nobody hired him for.
Oran’s journey is brought to you by SysLayer — practical backend guides for developers who build real products.