부품 자동 점검
기능이 많아져 손으로 다 못 볼 때, 규칙 하나마다 점검을 붙여 두고 기계가 대신 매번 돌려 보는 방법이에요. 어디가 깨졌는지 그 자리를 이름으로 알려 줘요.
쉽게 말하면
냉장고가 다섯 대인 가게를 떠올려 보세요. 매일 저녁 문을 하나씩 열어 손을 넣어 보는 대신, 칸마다 온도 경보기를 하나씩 달아 두면 기준을 넘긴 그 칸만 콕 집어 울려요. 부품 자동 점검이 바로 그 경보기예요. 배송비 계산, 할인 규칙, 재고 차감 같은 조각마다 경보기를 하나씩 달아 두고, 코드를 고칠 때마다 전부 한꺼번에 울려 보는 거예요.
여기서 말하는 부품은 화면이 아니라 계산 한 조각이에요. "5만 원 이상이면 배송비 0원" 같은 규칙 하나가 부품 하나예요.
처음 몇 주는 돌아가요. 기능이 늘수록 훑는 시간이 길어지고, 길어진 목록은 결국 건너뛰게 돼요. 사고는 건너뛴 자리에서 나요.
울리면 어느 규칙이 깨졌는지 이름으로 나와요. 원인을 찾는 시간이 통째로 사라져요.
어디에 다는 경보기인가
점검을 다는 자리는 화면 전체가 아니라 답이 하나로 정해지는 계산이에요. 아래 왼쪽 칸은 사장님이 이미 머릿속에 갖고 있는 규칙이에요. 점검은 그 규칙을 글로 옮겨 기계에게 맡기는 일이에요.
| 내 가게 규칙 | 점검이 확인하는 것 | 점검이 없을 때 나는 사고 |
|---|---|---|
| 5만 원 이상 무료 배송 | 4만 9천 원에는 배송비가 붙고, 5만 원에는 0원이 되는지 | 경계 한 곳이 어긋나 5만 원 손님에게 배송비가 붙어요. 문의가 오기 전에는 몰라요. 예외 상황 |
| 쿠폰과 회원 할인은 중복 안 됨 | 둘을 같이 넣었을 때 하나만 먹히는지 | 둘 다 먹혀서 원가 아래로 팔려요. 그날 주문을 손으로 세서 되돌려야 해요 |
| 주문이 들어오면 재고가 하나 줄어듦 | 취소되면 그 하나가 다시 돌아오는지 | 취소분이 재고로 안 돌아와서, 팔 수 있는 물건이 품절로 보여요 |
| 마감 20분 전부터는 주문을 안 받음 | 자정을 넘길 때도 같은 판정이 나오는지 | 밤 열두 시 근처 주문만 이상하게 막히거나 열려요. 시간대와 날짜 처리 |
| 전화번호는 숫자만 열한 자리 | 하이픈이 섞이거나 앞자리 0이 빠졌을 때 걸러지는지 | 배송 직전에 연락이 안 되는 주문이 쌓여요 |
규칙을 문장으로 못 적으면 점검도 못 만들어요
점검은 "이 값을 넣으면 이 값이 나와야 한다"는 문장 한 줄에서 시작해요. 그래서 만들 때 먼저 막히는 건 코드가 아니라 규칙이에요. "회원은 얼마 할인인가요"에 답이 두 개면, 그 자리에 필요한 건 점검이 아니라 결정이에요.
손으로 훑는 것과 뭐가 달라요
점검은 층이 세 개예요. 셋 다 이름이 비슷해서 견적서에서 자주 뒤섞여요. 무엇을 보는지와 언제 도는지로 가르면 헷갈리지 않아요.
| 점검 층 | 무엇을 보나 | 언제 도나 | 못 잡는 것 |
|---|---|---|---|
| 손으로 훑기 | 화면이 실제로 어떻게 보이고 눌리는지 | 올리기 직전에 사람이 | 매번 같은 곳을 빠짐없이 볼 수는 없어요. 손으로 확인할 목록 |
| 부품 자동 점검 | 계산 한 조각의 답이 맞는지 | 코드를 고칠 때마다 기계가 | 조각들이 이어 붙었을 때 생기는 문제 |
| 화면 자동 점검 | 주문에서 결제까지 길이 실제로 이어지는지 | 올릴 때마다 기계가 | 만들고 유지하는 값이 셋 중 제일 비싸요 |
| 손님 신고 | 진짜로 무엇이 안 되는지 | 이미 사고가 난 뒤에 | 여기서 처음 알면 사과가 수리보다 길어져요 |
세 층은 서로를 대신하지 못해요. 부품 점검이 백 개 초록불이어도 화면 배치가 깨지면 손님은 주문을 못 해요. 반대로 손으로 훑는 목록만으로는 할인 경계값을 매번 다 눌러 볼 수 없어요.
언제부터 값어치가 나오나
정직하게 말할게요. 오픈 첫 주에 점검부터 만드는 건 대체로 손해예요. 규칙이 아직 매일 바뀌니까 점검도 매일 같이 고쳐야 하거든요. 넘어가는 신호는 감이 아니라 아래 셋으로 잡아요.
- 1올리기 전 손 점검이 30분을 넘겼을 때. 훑을 목록이 스무 줄이 되면 사람은 결국 건너뛰어요. 건너뛰는 목록은 없는 목록이에요.
- 2같은 자리가 두 번 깨졌을 때. 한 번은 실수지만 두 번은 구조예요. 두 번째 사고 직후가 그 자리에 경보기를 다는 가장 싼 시점이에요. 고쳤더니 딴 게 깨짐
- 3돈 계산이 두 갈래 이상으로 갈릴 때. 할인·쿠폰·정산이 겹치기 시작하면 경우의 수를 사람 머리로 다 세지 못해요.
- 4남에게 맡기기 시작할 때. 직원이나 외주가 코드를 만지면 사장님 눈이 닿지 않는 수정이 생겨요. 점검이 그 사람에게 지켜야 할 선을 대신 알려 줘요.
먼저 만들 자리는 이미 정해져 있어요
돈이 바뀌는 계산 · 재고가 바뀌는 계산 · 법으로 정해진 판정. 이 셋만 골라도 사고의 대부분을 덮어요. 반대로 화면 색이나 문구처럼 자주 바뀌는 곳에 점검을 달면, 고칠 때마다 점검도 같이 고쳐야 해서 짐만 늘어요.
점검 하나가 만들어지는 순서
- 1지킬 규칙을 한 문장으로 적어요. "주문 금액이 5만 원 이상이면 배송비는 0원."
- 2그 문장을 값으로 펴요. 4만 9천 원 · 5만 원 · 5만 1천 원. 경계의 양옆이 점검의 핵심이에요.
- 3그 값을 넣었을 때 나오는 답을 정답과 맞춰 보는 코드를 한 벌 적어요. 이 한 벌이 점검 하나예요.
- 4일부러 규칙을 틀리게 만들어 점검이 울리는지 확인해요. 안 울리면 그 점검은 아무것도 안 보고 있는 거예요.
- 5코드를 고칠 때마다 점검 전부를 한 번에 돌려요. 개수가 수십 개로 늘어도 사람이 한 바퀴 도는 것보다 훨씬 빨리 끝나요.
4번이 이 순서의 심장이에요. 처음부터 초록불인 점검은 지키는 것이 없는 점검일 수 있어요. 한 번 울려 본 경보기만 진짜 경보기예요.
장면 1 · 외주 개발자가 말했다
“테스트 커버리지 80%를 맞췄으니 이제 안심하셔도 됩니다.”
숫자는 사실이지만 뜻이 달라요. 커버리지는 코드의 몇 퍼센트를 점검이 지나갔는지를 셀 뿐이고, 지나갔다는 것과 답을 따졌다는 것은 다른 이야기예요. 되물을 말은 하나예요. "배송비·할인·정산 계산은 그 안에 들어 있나요?" 돈이 걸린 자리가 빠져 있으면 숫자가 높아도 안심할 곳이 아니에요.
견적서와 인수인계에서 보는 말
| 문서에 적힌 문장 | 실제로 하는 말 | 이렇게 되물으세요 |
|---|---|---|
| 유닛 테스트 24건 작성 | 부품 점검을 스물네 개 만들었다는 뜻이에요. 개수보다 무엇을 지키는지가 중요해요 | 그 스물네 개가 각각 무슨 규칙을 지키는지 한 줄씩 적어 주세요 |
| 테스트 커버리지 80% 확보 | 코드의 열 줄 중 여덟 줄을 점검이 한 번은 지나갔다는 뜻이에요 | 돈이 오가는 계산이 그 안에 다 들어 있나요? |
| 테스트 코드는 범위에서 제외 | 점검을 안 만든다는 뜻이에요. 지금 값이 싼 대신 나중에 고치는 값이 올라가요 | 돈 계산 세 곳만이라도 넣으면 얼마가 더 드나요? |
| 빌드 시 테스트 자동 실행 | 코드를 올릴 때마다 점검이 자동으로 돌고, 하나라도 울리면 올리기가 멈춘다는 뜻이에요 | 울리면 실제로 배포가 막히나요, 경고만 뜨고 그냥 올라가나요? 자동 배포 흐름 |
| 실패하는 테스트는 임시로 꺼 둠 | 울리는 경보기를 껐다는 뜻이에요. 사고 직전 신호가 그대로 남아 있어요 | 무엇을 왜 껐고 언제 다시 켜나요? 목록으로 주세요 |
장면 2 · 코드를 넘겨받은 업체가 말했다
“점검이 하나도 없어서 뭘 건드리면 뭐가 깨지는지 알 수가 없습니다. 견적을 두 배로 보셔야 합니다.”
값을 올리려는 말로만 듣지 마세요. 확인하는 방법이 있어요. "할인 규칙 한 줄만 바꾸는 작업"의 견적을 물어보세요. 점검이 있으면 반나절, 없으면 며칠이 나와요. 그 차이가 곧 점검의 값이에요. 외주 맡기기 전에 물어볼 항목이에요.
AI에게 그대로 말할 문장
전문어로 옮기려고 애쓰지 마세요. 지켜야 할 규칙을 문장으로 주는 것이 가장 잘 통해요. 오른쪽 칸은 그대로 복사해 붙여도 되는 말이에요.
| 내가 겪는 상황 | 그대로 말할 문장 |
|---|---|
| 할인이 이상하게 먹혀요 | 쿠폰과 회원 할인이 같이 들어가면 하나만 적용되어야 해요. 지금 계산을 확인하고, 이 규칙을 자동으로 점검하는 코드도 같이 만들어 주세요 |
| 같은 사고가 또 났어요 | 이 사고를 먼저 잡아내는 점검을 하나 만들고, 그 점검이 실패하는 것을 확인한 다음에 코드를 고쳐 주세요 |
| 무엇이 점검되고 있는지 모르겠어요 | 지금 있는 점검 목록을 한국어로 한 줄씩 설명해 주세요. 각각 무슨 규칙을 지키는 점검인지 알고 싶어요 |
| 돈 계산이 제일 겁나요 | 배송비·할인·정산 계산만 골라서 경계값까지 점검을 만들어 주세요. 나머지는 지금 안 해도 돼요 |
| 점검이 자꾸 빨간불이에요 | 실패하는 점검을 지우지 말고, 왜 실패하는지 한국어로 설명해 주세요. 규칙이 바뀐 건지 코드가 틀린 건지 알고 싶어요 |
직접 해보기
내 서비스에 어떤 규칙이 들어 있는지 물어보세요
스튜디오 대화창에 이렇게 그대로 붙여 넣어 보세요. "이 서비스 안에서 값이 정해진 대로 계산되어야 하는 규칙을 전부 목록으로 뽑고, 각각 틀리면 무슨 일이 생기는지 한국어로 적어 주세요." 점검을 만들지 말지는 그다음 판단이에요. 먼저 지킬 규칙이 몇 개인지 보는 것이 시작이에요.
스튜디오 열기빨간불은 끄는 게 아니라 읽는 거예요
점검이 울릴 때 가장 쉬운 해결은 그 점검을 지우는 것이에요. 그러면 화면은 초록불이 되고 사고는 그대로 남아요. 울린 점검은 둘 중 하나예요. 규칙이 바뀌었거나(그러면 점검을 고쳐요), 코드가 틀렸거나(그러면 코드를 고쳐요). 세 번째 선택지는 없어요.
흔한 사고 세 가지
점검은 성실해요. 잘못 적어 둔 기준도 아주 성실하게 지켜요. 실제로 자주 나는 순서예요.
- 1빨간불을 끄는 것으로 끝내기. 급한 날 점검 하나를 지우고 올려요. 다음 달에 같은 자리에서 사고가 나고, 이번에는 경보기가 없어요. 급한 수정 뒤에 되돌려 놓는 일까지가 한 세트예요.
- 2개수를 목표로 삼기. 숫자를 맞추려고 아무 값이나 넣는 점검을 잔뜩 만들면, 고칠 때마다 같이 고쳐야 할 짐만 늘어요. 지키는 규칙이 없는 점검은 없느니만 못해요.
- 3초록불을 안전으로 착각하기. 부품이 전부 멀쩡해도 조립이 틀리면 손님은 주문을 못 해요. 손으로 훑는 목록을 끝까지 남겨 두는 이유예요. 고치고 나서 확인하기
확인해 보세요
받은 작업 보고서에 "실패하는 테스트는 임시로 꺼 둠"이라고 적혀 있어요. 무슨 뜻일까요?
자주 묻는 것
- Q. 점검을 만들면 개발이 느려지지 않나요?
- 처음에는 느려져요. 대신 같은 자리를 두 번 고치는 일이 줄어요. 그래서 규칙이 매일 바뀌는 초기 화면에는 안 만들고, 돈 계산처럼 잘 안 바뀌는 규칙부터 만들어요. 값이 가장 잘 나오는 순서예요.
- Q. 손으로 확인하는 목록은 이제 없어도 되나요?
- 필요해요. 부품이 다 멀쩡해도 버튼이 화면 밖으로 밀려나 있을 수 있어요. 손으로 확인할 목록은 그대로 두고, 매번 똑같이 반복되는 계산만 기계에 넘기는 거예요.
- Q. 점검은 초록불인데 손님이 안 된다고 해요.
- 흔한 일이에요. 점검은 만든 사람이 생각한 상황만 봐요. 생각 못 한 입력에서 사고가 나요. 그럴 때는 그 상황을 먼저 재현하고(재현 절차 쓰기), 그 상황을 잡는 점검을 하나 더 만들어요. 사고 하나가 점검 하나로 남는 게 가장 좋은 결말이에요.
- Q. 저는 코드를 못 읽는데 이걸 알아야 하나요?
- 코드를 읽을 필요는 없어요. 사장님이 하실 일은 지켜야 할 규칙을 문장으로 적어 주는 것이에요. "5만 원부터 무료 배송" 한 줄이 점검 한 개가 돼요. 나머지는 만드는 사람의 일이에요.
- Q. 몇 개나 만들어야 하나요?
- 개수를 목표로 두지 마세요. 대신 목록을 만들어요. 돈이 바뀌는 계산 · 재고가 바뀌는 계산 · 법으로 정해진 판정. 이 셋을 세어 보면 대개 손에 꼽을 만큼 나와요. 거기서 시작하면 충분해요.
- Q. AI가 만들어 준 점검도 믿을 수 있나요?
- 점검이 무엇을 확인하는지 한국어로 설명하게 하고, 그 문장이 내 규칙과 같은지 눈으로 보세요. 규칙을 잘못 이해한 점검은 틀린 동작을 초록불로 지켜 줘요. 그건 점검이 없는 것보다 나쁠 수 있어요.
하나 더
오픈 첫 주예요. 하루 주문 다섯 건, 할인 규칙은 하나뿐이에요. 개발자가 전체 점검 코드를 지금 다 만들자며 견적을 올렸어요.
더 깊이 (안 읽어도 괜찮아요)
비유가 어디까지 맞고 어디부터 다른가 · 경보기 비유는 "칸마다 하나씩 달아 두고 그 칸만 콕 집어 울린다"까지 정확해요. 다른 점은 기준이 저절로 따라오지 않는다는 거예요. 냉장고 온도 기준은 계절이 바뀌어도 그대로지만, 가게 규칙은 사장님이 바꿔요. 무료 배송 기준을 5만 원에서 3만 원으로 내리면 점검도 같이 고쳐야 해요. 안 고치면 옛 규칙을 성실하게 지키며 빨간불을 켜요.
먼저 울려 보고 고치는 순서가 왜 중요한가 · 점검을 만들자마자 초록불이면 두 가지 중 하나예요. 코드가 정말 맞거나, 그 점검이 아무것도 안 보고 있거나. 둘은 화면에서 똑같이 보여요. 그래서 규칙을 일부러 한 번 틀리게 만들어 빨간불을 확인하고 되돌려요. 이 한 번이 "이 경보기는 진짜 이 자리를 본다"는 증거예요.
점검은 넘겨줄 때 자산이 돼요 · 새 업체가 코드를 받았을 때 설명서가 부실해도, 점검을 읽으면 이 서비스가 지키기로 한 약속이 보여요. 배송비 규칙도 할인 규칙도 값과 함께 적혀 있으니까요. 그래서 점검은 코드보다 먼저 읽히는 문서 노릇을 해요. 개발자에게 넘기기나 내 것을 가지고 나가기 전에 몇 개라도 남겨 두면 다음 사람의 첫 주가 짧아져요.
이것만 기억하세요
- ·부품 자동 점검은 규칙 하나마다 다는 경보기예요. 화면이 아니라 계산 조각을 봐요
- ·만들 자리는 셋이에요. 돈이 바뀌는 계산, 재고가 바뀌는 계산, 법으로 정해진 판정
- ·점검을 만들기 전에 막히는 건 코드가 아니라 규칙이에요. 문장으로 못 적으면 결정이 먼저예요
- ·한 번도 울려 본 적 없는 점검은 아무것도 안 보고 있을 수 있어요
- ·빨간불이 뜨면 점검을 지우지 말고 읽어요. 규칙이 바뀌었거나 코드가 틀렸거나 둘 중 하나예요