같은 실수를 반복하지 않으려면: 자체 SaaS ‘더크(deokk.com)’에 세운 배포 전 자동 검증 기준
피트니스 센터 CRM·출석·매장 음원 상용 SaaS 더크(deokk.com)를 오픈베타 이후 실제 가맹 센터와 운영하며, 개발자의 수동 주의력에 기대던 점검을 권한 경계·회원권 산식·스키마 정합성·빌드 게이트 등 코드화된 배포 전 자동 검증 기준으로 바꾼 엔지니어링 기록입니다.
서비스가 데모 단계를 지나 실제 현장에 들어가면 엔지니어링의 성격이 완전히 바뀝니다. 피트니스 센터 CRM·출석·매장 음원 상용 SaaS인 더크 deokk.com 역시 오픈베타 이후 실제 가맹 센터를 운영하면서 전혀 다른 차원의 긴장감이 생겼습니다. 센터 운영 중에 회원권 만료일이 하루 어긋나거나 데이터가 섞이면 단순한 버그가 아니라 현장 마비로 이어집니다.
수정 속도가 빨라질수록 개발자의 “기억과 주의”에만 의존하는 수동 점검은 반드시 뚫립니다. 그래서 사람이 조심하는 방식을 버리고, 코드 자체가 배포를 막아주는 자동 확인 기준을 세웠습니다.
1. 사람 대신 코드가 확인하는 4단계 배포 전 게이트
기능을 추가하거나 버그를 고친 뒤 운영 환경으로 나가기 전, 모든 변경 사항은 다음 네 가지 자동 확인 관문을 통과해야만 배포가 허용되도록 파이프라인을 재구성했습니다.
[코드 변경 커밋]
↓
[1. 권한 경계 검증] ──→ 타 가맹 센터·역할 외 API 접근 차단 확인
↓
[2. 도메인 산식 검증] ──→ 회원권 만료일·홀딩(정지) 일수 경계값 계산
↓
[3. 스키마 정합성 검사] ──→ DB 마이그레이션·API 타입 불일치 사전 차단
↓
[4. 빌드 게이트] ──→ 정적 타입·번들 빌드 성공 시에만 운영 배포 허용
실제 운영 현장에서 가장 먼저 뼈아프게 배운 영역과 이를 코드로 고정한 기준은 아래와 같습니다.
| 검증 영역 | 수동 점검 시 발생하던 위험 | 자동 검증 기준(코드화 이후) |
|---|---|---|
| 권한 경계 | 신규 API 추가 시 센터별 테넌트 격리·관리자 권한 체크 누락 | 센터 ID 격리 및 비인가 역할 호출 시 차단 응답 자동 테스트 |
| 회원권·홀딩 산식 | 월말·윤년·연속 홀딩 해제 시 만료일 1일 오차 발생 | 홀딩 시작·종료·재적용 경계 케이스 단위 테스트 상시 실행 |
| 스키마 정합성 | DB 컬럼 수정 후 프론트·백엔드 직렬화 타입 미스매치 | 마이그레이션 정의와 타입 스키마 일치 여부 배포 전 대조 |
| 빌드 게이트 | 급한 핫픽스 중 미사용 변수·타입 오류 상태로 배포 시도 | 타입 체크 및 전체 프로덕션 빌드 오류 0건 통과 필수 |
2. “기억에 의존하지 않는 검증”이 만든 변화
특히 피트니스 센터 도메인에서는 회원권 만료와 홀딩(일시정지) 일수 계산처럼 겉보기에 단순하지만 예외가 많은 로직이 많습니다. 예전에는 수식을 손볼 때마다 개발자가 머릿속으로 경계 날짜를 떠올려 수동으로 확인해야 했습니다.
이제는 한 번 실수가 나왔거나 헷갈렸던 조건을 발견하는 즉시 검증 테스트 케이스로 편입합니다. 덕분에 새로운 기능을 배포할 때 개발자가 예전 산식을 일일이 기억해 내지 않아도, 자동 검증 스위트가 과거의 모든 실수를 대신 다시 확인해 줍니다.
권한 경계 역시 마찬가지입니다. 가맹 센터가 늘어날수록 “우리 센터 회원 목록만 조회되는지”, “트레이너 계정으로 정산 화면에 접근할 수 없는지”는 매번 눈으로 확인해서는 지킬 수 없는 영역입니다. 테스트 코드와 빌드 게이트가 먼저 거절해 주어야 현장 장애를 막을 수 있습니다.
3. 자체 SaaS를 운영하는 개발사가 고객사 시스템도 단단하게 만드는 이유
가끔 고객사로부터 “외주 개발만 하는 곳과 자체 서비스를 운영하는 곳의 차이가 무엇인가요?”라는 질문을 받습니다. 답은 장애를 대하는 기준에 있습니다.
납품하고 손을 떼는 프로젝트만 경험하면 “일단은 돌아가는 화면”을 만드는 데 그치기 쉽습니다. 반면 더크 deokk.com처럼 실제 매장이 매일 아침 문을 열면서 쓰는 상용 SaaS를 직접 운영하면, 배포 한 번의 작은 균열이 현장에 어떤 비용을 치르게 하는지 몸으로 겪게 됩니다.
그 과정에서 다져진 권한 격리 패턴, 도메인 산식 검증 습관, 스키마·빌드 게이트 구조는 그대로 고객사의 사내 업무 시스템 구축에도 적용됩니다. 제이앤코어의 개발 방식과 서비스 기준이나 실제 작동하는 라이브 데모에서도 확인하실 수 있듯, 보이지 않는 배포 전 안전망까지 함께 설계해야 납품 후에도 오래 믿고 쓰는 시스템이 완성됩니다. 사내 시스템 구축이나 운영 안정화 상담이 필요하시다면 문의 페이지를 통해 편하게 이야기를 나누어 보시기 바랍니다.
2~4주 정찰제 맞춤 개발
우리 회사 엑셀 업무도 웹 시스템으로 바꿀 수 있을까요?
사내 ERP를 무리하게 바꾸지 않고, 매달 반복되는 엑셀 병목만 독립 웹 시스템으로 2~4주 만에 전환합니다.
