3등 – 시그마차트 API와 AI를 활용한 원장별 예약 정원 관리 자동화

1. 개발 배경

안녕하세요. OOOOO한의원 대표원장 OOO입니다.

저희 한의원은 원장 두 명이 함께 진료하며, 네이버 예약을 닥프렌즈(닥톡)를 통해 시그마차트로 가져오고 있습니다.

기존 운영에서는 한 원장의 예약이 가득 차도 해당 원장의 시간만 닫기 어려웠습니다. 직원이 수시로 예약 현황을 확인하고 네이버 예약을 직접 닫거나 다시 열어야 했습니다.

또한 한약상담·추나·초진과 재진은 필요한 시간이 달라, 단순한 환자 수만으로는 실제 진료 부담을 반영하기 어려웠습니다.

이를 개선하기 위해 원장별 예약과 진료 종류별 가중치를 계산하여 네이버 예약을 자동으로 닫고 여는 프로그램을 개발했습니다.

2. 개발 도구 및 구성

구분도구 및 구성
AI 개발 도구Claude Code(Anthropic)
개발 언어TypeScript
데이터 연동시그마차트 External API, 네이버 예약 정보
자동 관리 프로그램원내에서 상시 켜 두는 컴퓨터에서 실행
예약 보드크롬·웨일 확장 프로그램
확인 주기2분
개발 규모TypeScript 약 2만 5천 줄, 자동 테스트 1,065개

3. 진료 종류별 가중치와 원장별 정원 설정

진료 부담을 반영한 정원 계산

환자 수 대신 **진료에 필요한 시간을 반영한 ‘명분’**으로 정원을 계산합니다.

진료 구분적용 가중치
한약상담2명분
추나2명분
초진2명분
초진 + 추나2명분
재진1명분
재초진1명분

여러 진료 구분이 함께 지정되면 가중치를 합산하지 않고 가장 큰 값을 적용합니다.

기본 정원은 원장 한 명당 30분에 4명분이며, 설정 화면에서 진료별 가중치와 원장별 정원을 변경할 수 있습니다.

4. 네이버 예약 자동 마감 및 재개

예약 조회 및 정원 계산

기능세부 내용
시그마 예약 조회GET /external/v2/reservations로 원장별 예약을 불러옵니다.
예약 상태 반영확정·대기 및 당일 내원 처리된 예약을 계산에 포함합니다.
네이버 예약 보완아직 시그마차트에 반영되지 않은 네이버 예약도 함께 확인합니다.
중복 제거두 서비스에 겹쳐 있는 예약은 한 번만 계산합니다.
시간대별 집계원장별·30분 단위로 진료 가중치를 합산합니다.

자동 닫기·열기

기능세부 내용
원장별 마감정원이 찬 시간은 해당 원장의 네이버 예약만 닫습니다.
취소 후 재개취소로 정원에 여유가 생기면 예약을 다시 엽니다.
공통 상품 관리‘가장 빠른 진료’ 상품은 두 원장의 정원이 모두 찼을 때만 닫습니다.
진료시간 반영시그마차트의 예약 예외를 읽어 휴진·점심시간·진료시간 밖의 예약을 닫습니다.
직원 설정 보존직원이 직접 닫은 시간은 유지하며, 프로그램이 닫은 시간만 다시 엽니다.
연결 장애 대응시그마차트에 연결되지 않으면 닫기만 하고 다시 열지는 않도록 구성했습니다.

처리 흐름: 예약 조회 → 중복 제거 → 원장별 가중치 계산 → 정원·진료시간 확인 → 네이버 예약 마감 또는 재개

5. 시그마차트 예약 보드

시그마차트 화면 옆에 여닫을 수 있는 패널을 추가하여, 원장별 하루 예약과 네이버 대기 예약을 한곳에서 확인하고 처리하도록 했습니다.

기능세부 내용
정원 표시시간대마다 ‘3/4명분’처럼 예약 상태를 표시합니다.
초과 경고정원을 초과한 시간대를 빨간색으로 표시합니다.
대기 예약 관리네이버 대기 예약을 모아 보고 승인하거나 거절합니다.
담당 원장 지정승인 시 담당 원장을 지정하여 시그마차트에 반영합니다.
진료 구분 필수 선택예약을 등록할 때 진료 종류를 반드시 선택하도록 구성했습니다.
계산·통계 기준 통일선택한 진료 구분을 external_data와 예약 메모 앞부분에 함께 저장합니다.
예약 이동끌어서 놓는 방식으로 예약 시간과 담당 원장을 변경합니다.
환자 정보 표시예약 카드에서 성별과 나이를 확인합니다.

예약 승인·원장 지정에는 PATCH /external/v2/reservations/{uuid}, 환자 정보 조회에는 GET /external/v1/daily-patient-statuses를 활용했습니다.

6. AI 개발 및 검증 과정

단계진행 방식
계획 수립AI가 API 안내서와 실제 응답을 확인하고 구현 범위와 결정할 사항을 정리했습니다.
운영 기준 결정가중치, 정원, 상품 구성, 연결 장애 시 동작은 원장이 결정했습니다.
구현 및 검수구현과 검수 역할을 나누고 기능별 자동 테스트를 작성했습니다.
시험 운영시험 상품으로 먼저 확인한 뒤 실제 운영으로 전환했습니다.
실제 예약 작업원장이 지켜보는 자리에서 진행했습니다.
점검 기록 관리이름·전화번호·차트번호 대신 데이터 구조와 건수만 기록하도록 했습니다.

10월 11일 개발을 시작하여 10월 17일 새벽에 새 예약 상품을 공개했습니다. 진료를 마친 뒤와 주말 시간을 활용해 개발과 검증을 진행했습니다.

7. 실제 운영 결과

10월 18일~23일, 6일간의 운영 기록을 확인했습니다.

항목처리 횟수
네이버 예약 자동 닫기91회
└ 원장별 정원 도달52회
└ 휴진·진료시간 반영39회
취소 후 예약 다시 열기47회

자동 닫기 91회를 상품별로 구분하면 다음과 같습니다.

상품닫기 횟수
A 원장54회
B 원장25회
원장 상관없음12회

직원이 네이버 관리 화면을 열지 않아도 예약 마감과 재개가 처리되었습니다. 한 원장에게 예약이 몰려도 그 원장의 시간만 닫고 다른 원장의 빈자리는 계속 예약받을 수 있었습니다.

8. 업무 활용 효과

업무 영역활용 효과
예약 배분원장별 진료 여력을 구분하여 예약 접수
진료시간 확보진료 종류별 소요 시간을 반영하여 과도한 예약 방지
데스크 업무반복적인 네이버 예약 닫기·열기 작업 감소
예약 확인시간대별 정원과 대기 예약을 한 화면에서 확인
운영 기준 관리가중치·정원·예외 처리 기준을 설정으로 관리

예약 관리를 통해 지키고자 한 것은 환자 한 분 한 분께 필요한 진료시간을 확보하는 것입니다.

9. 향후 API 개선 제안

제안기대 효과
현재 선택된 환자 조회 API환자를 다시 검색하지 않고 예약 보드에서 바로 예약하며, 동명이인 선택 오류 감소
예약 API의 진료과목 정보 제공메모와 external_data에 별도로 기록하는 작업 감소
예약 변경 웹훅2분 주기 조회 대신 예약 생성·변경 즉시 반영

10. 첨부 이미지 안내

번호주요 내용
사진 1원장별 예약 보드와 네이버 대기 예약 화면 — 시험용 데이터 사용 및 개인정보 가림
사진 2진료 종류별 가중치를 적용한 정원 계산 방식
사진 3원장별 상품, 진료별 가중치, 정원 설정 화면 — 원장 이름은 A·B로 가림

시그마차트 External API 덕분에 원내 운영 방식에 맞는 예약 관리 기능을 직접 구현할 수 있었습니다. 개발에 힘써주신 이운희 원장님과 개발팀에 감사드립니다.


제출원본

안녕하세요.

진료실에서는 한의사로, 진료를 마친 뒤에는 AI와 함께 프로그램을 만들고 있는 OOOOO한의원 대표원장 OOO입니다.

저희 한의원은 원장 두 명이 함께 진료합니다.
네이버 예약은 닥프렌즈(닥톡)로 받아 시그마차트로 가져옵니다.

이번에 시그마차트 External API와 AI 개발 도구로 원장별로, 진료 종류마다 가중치를 두어 네이버 예약을 자동으로 닫고 여는 프로그램을 직접 만들었습니다.
그 과정을 나누고 싶어 응모합니다.

  1. 왜 만들게 되었나
    “이 시간은 이미 꽉 찼는데, 네이버는 왜 아직 열려 있을까?”

예약 화면을 볼 때마다 들던 생각입니다.

원장별로 닫을 수가 없었습니다

지금의 시그마차트와 네이버 예약 연동은 상품 하나로만 운영할 수 있습니다.
원장별로 예약 시간을 닫는 기능이 없습니다.

그래서 한 원장의 예약이 다 찬 시간에도 네이버에서는 그 시간이 계속 열려 있었습니다.
그렇다고 그 시간을 닫으면, 다른 원장의 빈자리까지 함께 닫히게 됩니다.

원장 여러 명이 진료하는 예약제 한의원이라면, 원장별로 닫는 기능은 선택이 아니라 필수라고 생각했습니다.

데스크 직원이 놓칠 수밖에 없었습니다

예약이 찰 때마다 데스크 직원이 차트를 보고, 네이버 관리 화면을 열어 그 칸을 닫아야 했습니다.
취소가 나면 다시 열어야 했습니다.

전화를 받고, 접수를 하고, 수납을 하다 보면 이 일은 쉽게 잊힙니다.
직원의 잘못이 아닙니다. 사람이 손으로 하기에는 너무 잦은 일이었습니다.

한 번 놓치면 이미 찬 시간에 예약이 더 들어오고, 그 부담은 환자분과 직원 모두에게 돌아갑니다.
누락을 나중에 수습하는 것이 아니라, 미리 막고 싶었습니다.

진료마다 걸리는 시간이 다릅니다

한약상담, 추나, 초진은 재진보다 시간이 두 배쯤 걸립니다.

그런데 사람 수로만 세면 이렇게 됩니다.
한약상담 환자 두 분이 잡힌 칸은 실제로 네 명분의 시간이 드는데, 숫자로는 아직 “2명”입니다. 그래서 예약이 두 건 더 들어옵니다.

그러면 그 시간의 진료가 밀리고, 뒤 시간에 오신 분들까지 기다리시게 됩니다.
상담이 길어져야 할 분께 충분한 시간을 드리지 못하는 일도 생깁니다.

저희 한의원은 “끝까지 듣습니다” 를 환자분들께 드리는 약속으로 삼고 있습니다.
예약이 넘치면 이 약속부터 지키기 어려워집니다.

그래서 “사람 수”가 아니라 “명분”으로 세기로 했습니다.
한약상담·추나·초진은 2명분, 재진은 1명분입니다.
원장 한 명이 30분에 4명분까지만 받고, 정원이 차면 그 원장의 네이버 예약 시간만 미리 닫습니다.

사진 2. 사람 수가 아니라 명분으로 셉니다
사진 2. 사람 수가 아니라 명분으로 셉니다

  1. 무엇을 만들었나
    원장별 정원 마감 관리기

한의원에 늘 켜 두는 컴퓨터 한 대에서 도는 프로그램입니다.
2분마다 이렇게 일합니다.

시그마차트 External API(GET /external/v2/reservations)로 원장별 예약을 읽습니다. 확정, 대기, 오늘 내원한 예약까지 모두 셉니다.
아직 시그마차트에 들어오지 않은 네이버 예약도 함께 읽고, 겹치는 예약은 한 번만 셉니다.
원장 × 30분 칸마다 명분을 더합니다. 초진+추나처럼 진료가 여럿 붙으면 큰 값을 씁니다.
4명분이 찬 칸은 그 원장의 네이버 예약만 닫고, 취소로 자리가 나면 다시 엽니다.
진료 구분 명분
한약상담 2
추나 2
초진 2
초진 + 추나 2
재진 1
재초진 1
몇 가지는 꼭 지키도록 했습니다.

가중치와 정원은 설정 화면에서 바로 고칠 수 있습니다. 원장마다 정원을 다르게 둘 수도 있습니다.
“가장 빠른 진료” 상품(원장 상관없음)은 두 원장이 모두 찼을 때만 닫습니다.
휴진, 점심시간, 진료시간 밖도 시그마차트의 예약 예외를 읽어 자동으로 닫습니다.
직원이 직접 닫아 둔 칸은 건드리지 않습니다. 프로그램은 자기가 닫은 칸만 엽니다.
시그마차트에 잠시 닿지 못하면 닫기만 하고 열지는 않습니다. 넘치게 받는 것보다 덜 받는 편이 환자분께 낫다고 판단했습니다.
사진 3. 하니옵스 지점 설정 화면: 원장별 상품, 진료별 가중치, 정원 (원장 이름은 A·B로 가림)
사진 3. : 원장별 상품, 진료별 가중치, 정원 (원장 이름은 A·B로 가림)

시그마차트 위 예약 보드

시그마차트 화면 옆에 여닫는 패널을 붙여, 원장별 하루 예약을 한눈에 보게 했습니다(크롬·웨일 확장 프로그램).

칸마다 “3/4명분”처럼 찬 정도를 보여 주고, 넘치면 빨갛게 표시합니다.
네이버 대기 예약을 한곳에 모아, 데스크가 정원 초과 여부를 보면서 바로 승인하거나 거절합니다. 승인하면서 담당 원장을 정하면 External API(PATCH /external/v2/reservations/{uuid})로 시그마차트에 바로 들어갑니다.
예약을 잡을 때 진료 구분을 반드시 고르게 했습니다. 고른 값은 external_data와 예약 메모 앞머리에 함께 남아, 명분 계산과 초진·재진 통계가 같은 값을 씁니다.
끌어서 옮기기로 시간과 원장을 바꾸고, 성별·나이도 카드에서 바로 봅니다(GET /external/v1/daily-patient-statuses).
사진 1. 원장별 예약 보드와 네이버 대기 서랍 (시험용 가짜 값, 개인정보 가림)
사진 1. 원장별 예약 보드와 네이버 대기 서랍 (시험용 가짜 값, 개인정보 가림)

  1. AI와 어떻게 만들었나
    도구는 Claude Code(Anthropic) 를 썼습니다.

AI에게 “알아서 만들어 줘”라고 맡기지는 않았습니다.
진료할 때 진단을 먼저 하고 치료 계획을 세우듯, 순서를 정해 두었습니다.

계획서를 먼저 씁니다. AI가 시그마차트 API 안내서와 실제 응답을 점검하고, 만들 것과 정해야 할 것을 정리합니다.
결정은 제가 합니다. 가중치를 몇으로 둘지, 상품을 몇 개로 나눌지, 시그마에 닿지 않을 때 닫을지 열지. 이런 결정은 제가 내리고 계획서에 남겼습니다.
만드는 AI와 검수하는 AI를 나눕니다. 기능마다 자동 테스트도 함께 쓰게 했습니다.
실제 예약에 손대는 일은 제가 지켜보는 자리에서만 합니다. 시험 상품으로 먼저 확인한 뒤에 실제 운영으로 넘겼습니다.
환자 정보는 남기지 않습니다. 점검 기록에는 이름·전화·차트번호 없이 모양과 건수만 적게 했습니다.
10월 11일에 시작해, 10월 17일 새벽 두 시가 다 되어서야 새 예약 상품을 네이버에 열었습니다. 작업 기록 128개 가운데 47개가 밤 9시부터 새벽 3시 사이에, 56개가 주말에 남아 있습니다.
진료를 마친 뒤의 시간을 이 일에 썼습니다.

그렇게 쌓인 것이 TypeScript 약 2만 5천 줄, 자동 테스트 1,065개입니다.

  1. 무엇이 달라졌나
    실제 운영 6일(10월 18일~23일)의 기록을 세어 보았습니다.

네이버 예약 칸을 91번 자동으로 닫았습니다. 52번은 원장 정원(4명분)이 차서, 39번은 휴진·진료시간 때문이었습니다.
취소로 자리가 나서 다시 연 것은 47번입니다.
이 모두를 직원이 네이버 관리 화면을 열지 않고 처리했습니다.
원장마다 닫힌 횟수가 달랐습니다. A 원장 54번, B 원장 25번, 원장 상관없음 상품 12번입니다. 예약이 한 원장에게 몰린 날에도 그 원장 칸만 닫히고, 다른 원장 칸은 계속 열려 있었습니다.
무엇보다, 예약 화면을 볼 때마다 들던 그 질문을 이제는 하지 않게 되었습니다.

  1. 시그마차트에 바라는 점
    External API가 있었기에 차트 화면을 건드리지 않고도 이런 프로그램을 만들 수 있었습니다. 감사합니다.

차트에서 지금 선택된 환자를 알려 주는 API가 있으면 좋겠습니다. 차트 예약창은 선택된 환자로 바로 예약할 수 있는데, 예약 보드에서는 직원이 같은 환자를 한 번 더 검색해야 합니다. 이 값을 받을 수 있으면 차트에서 환자를 고른 채 보드의 빈 칸만 누르면 예약이 잡히고, 동명이인을 잘못 고르는 일도 막을 수 있습니다.
예약 API에 내장 예약창의 진료과목 값이 함께 실리면 좋겠습니다. 지금은 메모와 external_data에 따로 적고 있습니다.
예약이 생기거나 바뀔 때 알려 주는 웹훅이 있으면, 2분마다 확인하지 않고도 바로 반영할 수 있습니다.
마치며
예약 마감은 작은 일처럼 보이지만, 결국 진료실의 시간을 지키는 일이었습니다.
한 분 한 분께 필요한 만큼의 시간을 드리기 위해 이 프로그램을 만들었습니다. 이런게 가능해진 게 시그마차트 덕분입니다. 개발에 힘써주고 계신 이운희원장님, 개발팀 감사합니다.

긴 글 읽어 주셔서 감사합니다.