처음 꼭 알 말
ClinicOS
내 병원 사이트를 만들고 계속 바꾸며 운영하는 작업 환경- 예를 들어
- 기본 사이트를 설치한 뒤 병원 정보를 채우고, 확인용 주소에서 살펴본 다음 공개합니다. 이후에도 에이전트에게 수정을 요청하며 운영을 이어갑니다.
- 지금 기억할 것
- 홈페이지는 ClinicOS로 처음 얻는 결과입니다. 그 뒤에도 같은 원본과 에이전트로 계속 바꾸고 확장할 수 있습니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
AI 에이전트
원하는 결과를 말하면 컴퓨터 작업을 함께 해 주는 AI- 예를 들어
- “첫 화면의 인사말을 바꾸고 확인할 주소를 알려 주세요”라고 부탁하면, 필요한 파일을 찾아 수정하고 결과를 보여 줍니다.
- 지금 기억할 것
- 원장님은 목표와 최종 판단을 맡고, 에이전트는 조사와 반복 작업을 맡는다고 기억하면 됩니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
웹 시스템
보이는 화면과 내용을 관리하는 기능이 함께 있는 사이트- 예를 들어
- ClinicOS에서는 환자가 홈페이지를 보고, 병원은 관리 화면에서 정보를 바꾸며, 바뀐 내용을 다시 인터넷에 올립니다.
- 지금 기억할 것
- 웹 시스템이라는 말이 나오면 ‘홈페이지 화면과 그 뒤의 관리 기능을 합친 것’이라고 이해하면 됩니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
프로젝트 폴더
내 ClinicOS 사이트를 이루는 파일을 모아 둔 폴더- 예를 들어
- 에이전트를 시작하기 전에 창에 표시된 폴더 이름이 내 병원의 프로젝트 폴더인지 확인합니다.
- 지금 기억할 것
- 에이전트는 현재 연 폴더 안에서 일하므로, 시작할 때 폴더 이름을 확인하는 습관이 중요합니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
Starter
새 ClinicOS 설치를 시작할 때 가장 먼저 받는 폴더- 예를 들어
- 내 병원용 Starter 폴더를 받은 뒤 그 폴더 안에서 Claude Code나 Codex를 시작합니다.
- 지금 기억할 것
- 기존 운영 사이트 폴더에 덮어쓰지 말고, 새 설치는 별도의 Starter 폴더에서 시작합니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
Core
ClinicOS의 공통 화면과 기능이 들어 있는 중심 부분- 예를 들어
- Starter에서 회원 확인이 끝나면 내 병원 프로젝트가 Core를 받아 실제 ClinicOS 기능을 갖추게 됩니다.
- 지금 기억할 것
- 병원 정보는 내 병원 영역에, 함께 업데이트할 기능은 Core에 둔다고 구분하면 됩니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
터미널
글자를 입력해 컴퓨터에 작업을 시키는 창- 예를 들어
- macOS에서는 ‘Terminal’, Windows에서는 ‘Windows Terminal’이나 ‘명령 프롬프트’를 열고 그 안에서 에이전트를 시작합니다.
- 지금 기억할 것
- 처음에는 ‘에이전트를 시작하는 창’이라고만 기억하면 충분합니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
배포
내 컴퓨터의 사이트를 인터넷 주소에서 열리게 하는 일- 예를 들어
- 처음에는 확인용 사이트로 배포합니다. 주소를 열어 본 뒤 실제 공개 사이트에 반영할지 결정합니다.
- 지금 기억할 것
- 파일을 고친 것과 인터넷에 올린 것은 다른 단계입니다. 실제 주소가 열리는지까지 확인해야 합니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
Preview
새 결과를 실제 공개 전에 보는 확인용 사이트- 예를 들어
- 첫 화면 문장을 바꾸면 에이전트가 Preview 주소를 알려 줍니다. 그 주소를 컴퓨터와 휴대전화에서 열어 봅니다.
- 지금 기억할 것
- 에이전트가 끝났다고 말해도 Preview를 직접 보기 전에는 공개를 승인하지 않습니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
Production
환자와 방문자가 실제로 이용하는 공개 사이트- 예를 들어
- Preview에서 내용과 기능을 확인한 뒤 원장님이 승인하면 같은 변경을 Production에 반영합니다.
- 지금 기억할 것
- Preview는 확인용, Production은 실제 공개용이라고 구분하면 됩니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
Cloudflare
내 사이트를 인터넷에서 열리게 해 주는 외부 서비스- 예를 들어
- ClinicOS를 올리면 먼저 `pages.dev`로 끝나는 확인용 주소가 생기고, 나중에 병원 도메인을 연결할 수 있습니다.
- 지금 기억할 것
- 내 컴퓨터의 파일과 환자가 인터넷으로 보는 사이트 사이를 이어 주는 곳이라고 이해하면 됩니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
API token
프로그램에 정해진 작업만 허용하는 비밀 열쇠- 예를 들어
- Cloudflare 화면에서 필요한 최소 권한으로 발급한 뒤 프로젝트의 보호된 .env 파일에 원장님이 직접 넣습니다. 채팅창이나 GitHub에는 붙여 넣지 않습니다.
- 지금 기억할 것
- 값을 보여 주지 말고, 에이전트에게 ‘등록되어 있고 필요한 작업이 되는지만 확인해 달라’고 요청합니다.
- 주의할 점
- 대화·화면 캡처·GitHub에 노출되면 Cloudflare에서 즉시 폐기하고 새로 발급합니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
환경변수
비밀값이나 설정을 코드 밖에서 전달하는 방법- 예를 들어
- .env 안의 CLOUDFLARE_API_TOKEN은 비밀 열쇠의 값이고, 환경변수는 그 값을 배포 도구에 안전하게 전달하는 칸의 이름과 방식입니다.
- 지금 기억할 것
- API token과 환경변수는 같은 것이 아닙니다. 비밀 열쇠 자체와 그 열쇠를 안전하게 전달하는 방법을 구분하면 노출과 잘못된 저장을 피할 수 있습니다.
- 주의할 점
- .env가 Git에서 제외됐는지 확인하고 다른 병원 프로젝트나 Windows 전체 설정으로 복사하지 않습니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
도메인
사람이 입력해서 사이트를 찾아오는 고유한 인터넷 주소- 예를 들어
- 처음에는 Cloudflare가 준 임시 주소로 확인하고, 준비가 끝난 뒤 병원 도메인을 연결합니다.
- 지금 기억할 것
- 사이트를 먼저 배포할 수 있으며, 도메인 연결은 나중에 따로 해도 됩니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
검증
결과가 맞는지 검사와 실제 화면으로 확인하는 일- 예를 들어
- 에이전트는 오류 검사를 맡고, 원장님은 Preview에서 병원 정보와 화면이 원하는 모습인지 확인합니다.
- 지금 기억할 것
- 기계가 확인할 것과 사람이 판단할 것을 나눠 둘 다 확인해야 완료입니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
직접 구축
원장님이 준비물부터 설치까지 직접 진행하는 시작 방식- 예를 들어
- 준비물을 챙기고 Starter를 받아 직접 설치를 진행하면 직접 구축 경로입니다.
- 지금 기억할 것
- 위임과 달리 설치 과정 전체를 원장님이 직접 다루므로, 각 단계에서 무엇을 할지 미리 알아 두면 도움이 됩니다.
전체 사전에서 자세히 보기 →처음 꼭 알 말
초기 구축 위임
대행자가 설치와 첫 배포를 마친 사이트를 넘겨받는 시작 방식- 예를 들어
- 대행자가 배포까지 마친 사이트를 전달받아 관리자 화면부터 확인하면 초기 구축 위임 경로입니다.
- 지금 기억할 것
- 위임 경로도 이후의 문장 수정과 운영은 직접 구축과 같은 학습 자료를 따르므로, 출발점만 다르다는 것을 알아 두면 도움이 됩니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
HQ
회원과 병원, 설치 상태를 이어 주는 ClinicOS 본부 서비스- 예를 들어
- Academy에 로그인하면 새 회원을 만들지 않고 HQ의 기존 회원과 병원 정보를 이어받습니다.
- 지금 기억할 것
- 코드나 병원 데이터를 Academy에 다시 복사하지 않고도 같은 회원과 병원 맥락으로 학습을 이어가기 위해 사용합니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
사이트 식별 정보
지금 작업하는 ClinicOS가 어느 병원 것인지 구분하는 정보- 예를 들어
- AI는 수정 전에 HQ의 병원과 현재 프로젝트의 사이트 식별 정보가 같은지 확인합니다.
- 지금 기억할 것
- 다른 병원의 코드나 데이터에 작업하는 사고를 막기 위해 모든 중요한 작업 전에 확인합니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
GitHub
사이트 파일과 바뀐 기록을 온라인에 보관하는 서비스- 예를 들어
- 컴퓨터를 바꾸더라도 GitHub에 보관된 내 ClinicOS 프로젝트를 다시 받아 작업을 이어갈 수 있습니다.
- 지금 기억할 것
- GitHub는 환자가 보는 홈페이지가 아니라, 홈페이지의 원본과 변경 기록을 보관하는 곳입니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
커밋
확인한 변경에 이름을 붙여 남기는 저장 기록- 예를 들어
- 첫 화면을 확인한 뒤 ‘첫 화면 진료 안내 문구 수정’이라는 이름으로 현재 상태를 기록합니다.
- 지금 기억할 것
- 만족한 결과를 확인한 뒤 커밋을 남기면, 다음 작업의 안전한 출발점이 됩니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
Node.js
ClinicOS 설치와 검사 도구를 움직이게 하는 기본 프로그램- 예를 들어
- 본격적인 설치 전에 에이전트가 Node.js가 있는지와 ClinicOS가 지원하는 버전인지 확인합니다.
- 지금 기억할 것
- 직접 다룰 기능은 아닙니다. 설치되어 있고 맞는 버전이라는 확인을 받으면 됩니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
WSL
Windows 안에서 다른 작업 환경을 열어 쓰는 기능- 예를 들어
- 기존 WSL 프로젝트가 잘 작동한다면 Windows 네이티브로 강제 이전하지 않습니다.
- 지금 기억할 것
- 새로 시작할 때 반드시 설치할 필요는 없습니다. 기존에 잘 쓰고 있다면 그대로 유지할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
런타임 프로필
지금 쓰는 컴퓨터에 맞는 실행 방법을 적어 둔 설정- 예를 들어
- Windows에서는 컴퓨터 안의 데이터 저장 기능이 멈추면 인터넷의 확인용 사이트를 먼저 사용하도록 안내합니다.
- 지금 기억할 것
- 이 말이 보이면 ‘내 컴퓨터에 맞는 작업 경로를 고르는 설정’이라고 이해하면 됩니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
stable
일반 운영에 사용하도록 검증해 공개한 버전- 예를 들어
- 기존 병원 사이트는 별도 시험 목적이 없다면 stable 버전으로 Core를 업데이트하고 Preview에서 먼저 확인합니다.
- 지금 기억할 것
- 가장 새로운 시험 기능보다 운영 연속성과 예측 가능한 업데이트를 우선하기 위한 선택입니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
D1
ClinicOS가 정보를 기억할 때 사용하는 온라인 저장 공간- 예를 들어
- 관리자 화면에서 진료시간을 바꾸면 D1에 저장되고, 홈페이지는 그 값을 읽어 새 시간을 보여 줍니다.
- 지금 기억할 것
- 화면만 열리는지와 내 병원의 올바른 정보가 연결됐는지는 따로 확인해야 합니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
build
사이트 파일을 인터넷에 올릴 형태로 준비하는 작업- 예를 들어
- 문장을 고친 뒤 build가 성공하면 다음으로 Preview 배포를 진행합니다.
- 지금 기억할 것
- build 성공은 기본 오류 검사를 통과했다는 뜻일 뿐, 화면 내용까지 승인됐다는 뜻은 아닙니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
복구 지점
문제가 생기면 돌아갈 수 있는 확인된 상태- 예를 들어
- Core 업데이트 전에 정상 커밋과 D1 백업 날짜를 확인합니다.
- 지금 기억할 것
- 실패해도 기존 운영 사이트와 데이터를 지키며 복구할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
local 기능
공통 기능과 나눠 보관하는 내 병원만의 기능- 예를 들어
- 한 병원만의 반복 업무 도구는 먼저 local 기능으로 작게 시험합니다.
- 지금 기억할 것
- 공통 업데이트를 계속 받으면서 병원 고유 기능도 지키기 위한 구분입니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
plugin
설치·업데이트·제거할 수 있게 묶은 확장 기능- 예를 들어
- 검증된 local 기능에 설치와 제거 검사를 더해 plugin으로 만듭니다.
- 지금 기억할 것
- 공용 Core를 복잡하게 만들지 않고 좋은 기능을 재사용할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
환경 이전
기존 환경을 보존하며 새 컴퓨터로 옮기는 과정- 예를 들어
- macOS에서 Windows로 옮길 때 기존 Mac을 지우지 않고 새 Windows Preview부터 확인합니다.
- 지금 기억할 것
- 컴퓨터나 Codespaces가 바뀌어도 운영 사이트와 작업 이력을 잃지 않게 합니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
기준 자료
여러 정보가 다를 때 사용할 값을 확인해 둔 자료- 예를 들어
- 원장님이 확인한 병원 기본정보 문서를 주소와 연락처의 기준 자료로 정합니다.
- 지금 기억할 것
- 여러 화면에 서로 다른 병원 정보가 표시되는 일을 막습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
범위
바꿀 것과 그대로 둘 것을 나눈 경계- 예를 들어
- 첫 화면 문장만 바꾸고 버튼과 데이터는 그대로 둔다고 요청합니다.
- 지금 기억할 것
- 큰 작업을 확인 가능한 크기로 줄이고 뜻밖의 변경을 막습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
성공 기준
잘 끝났다고 판단할 구체적인 모습- 예를 들어
- 새 문장이 모바일 Preview에서 두 줄 안에 보이고 기존 버튼이 작동해야 합니다.
- 지금 기억할 것
- ‘좋게’ 같은 막연한 요청을 함께 확인할 수 있는 결과로 바꿉니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
피드백
결과를 본 뒤 유지하거나 고칠 점을 AI에게 다시 말하는 것- 예를 들어
- “모바일에서 제목이 세 줄이라 읽기 어렵습니다. 문구 의미는 유지하면서 두 줄 안에 보이게 다시 제안해 주세요”라고 말합니다.
- 지금 기억할 것
- AI와의 협업은 한 번의 완벽한 명령이 아니라 결과를 보고 판단하며 여러 차례 개선하는 과정입니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
변경 전후
작업하기 전과 뒤를 같은 조건에서 비교하기- 예를 들어
- 첫 화면 문구 변경 전후를 데스크톱과 모바일에서 각각 비교합니다.
- 지금 기억할 것
- 좋아진 점과 새로 생긴 문제를 기억에 의존하지 않고 확인할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
반응형 화면
화면 크기에 맞춰 읽기 쉽게 바뀌는 구성- 예를 들어
- 컴퓨터에서 한 줄인 카드가 휴대전화에서는 세로로 쌓입니다.
- 지금 기억할 것
- 환자가 어떤 기기로 접속해도 내용을 읽고 주요 버튼을 사용할 수 있어야 합니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
대비
글자와 배경이 눈에 구분되는 정도- 예를 들어
- 연한 회색 배경에는 더 진한 글자색을 사용해 작은 글씨도 읽히게 합니다.
- 지금 기억할 것
- 시력이 다르거나 밝은 환경에서도 중요한 안내와 버튼을 놓치지 않게 합니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
관리자 기능
병원에서 사이트와 운영 업무를 관리하는 기능- 예를 들어
- 관리자 화면에서 진료 프로그램 초안을 만들고 공개 상태를 정합니다.
- 지금 기억할 것
- 사이트를 매번 코드로 고치지 않고 일상 운영 내용을 관리할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
진료 프로그램
병원의 실제 진료 내용을 주제별로 설명한 페이지- 예를 들어
- 대표 진료 하나의 대상, 과정, 주의사항과 문의 방법을 한 페이지로 만듭니다.
- 지금 기억할 것
- 환자가 자신의 상황과 병원의 제공 내용을 정확히 이해하도록 돕습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
운영 문제
병원 업무에서 실제로 줄이거나 개선하려는 불편- 예를 들어
- ‘CRM이 필요하다’보다 ‘홈페이지 문의가 담당자에게 전달되지 않는다’고 문제를 설명합니다.
- 지금 기억할 것
- 기존 기능과 새 개발 중 가장 작은 해결 방법을 정확히 찾을 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
전환
방문자가 기대한 다음 행동으로 이어진 결과- 예를 들어
- 오시는 길을 본 방문자 중 전화 버튼을 누른 수를 확인합니다.
- 지금 기억할 것
- 방문 수가 아니라 실제 운영 목표와 연결된 개선을 판단할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
전환율
전체 방문 중 정한 다음 행동으로 이어진 비율- 예를 들어
- 프로그램 페이지 방문 100회 중 확인된 상담 행동이 5회라면 같은 기준에서 전환율을 계산합니다.
- 지금 기억할 것
- 분모, 기간과 실제 행동의 기준을 함께 봐야 서로 다른 시점과 화면을 정직하게 비교할 수 있습니다.
- 주의할 점
- 자료가 적거나 수집 누락이 있으면 정밀한 숫자처럼 보여도 확정적인 결론을 내리지 않습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
기준선
변경 전 상태를 나중 결과와 비교하기 위해 남긴 값- 예를 들어
- 상담 버튼 위치를 바꾸기 전 4주의 페이지 방문과 실제 상담 행동을 기준선으로 남깁니다.
- 지금 기억할 것
- 변경 뒤 숫자가 달라졌을 때 이전과 같은 기준으로 비교했는지 확인할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
집계
개인을 알아보지 않고 숫자를 합쳐 보는 방식- 예를 들어
- 개별 방문자 기록 대신 한 주의 페이지 방문 수와 문의 버튼 클릭 수를 봅니다.
- 지금 기억할 것
- 개인정보를 최소화하면서도 운영 개선에 필요한 질문에 답할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
일관성
같은 정보가 여러 곳에서 다르지 않은 상태- 예를 들어
- 첫 화면과 오시는 길, 검색 정보의 대표전화가 모두 같습니다.
- 지금 기억할 것
- 환자 혼란과 잘못된 연락을 줄이고 한 곳의 수정이 전체에 반영되게 합니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
API
프로그램끼리 정해진 방식으로 요청하는 창구- 예를 들어
- 예약 화면이 API를 통해 예약 내용을 저장하고 관리자 화면에 보여 줍니다.
- 지금 기억할 것
- 새 기능이 기존 ClinicOS 데이터와 권한 경계를 지키며 연결되게 합니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
revision
여러 수정본 중 정확한 판본을 구분하는 번호- 예를 들어
- 학습 문서 revision 2와 그 문서로 만든 영상 revision 1을 연결합니다.
- 지금 기억할 것
- 원장님이 본 설명과 에이전트가 실행한 절차가 같은 판본인지 확인할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
환자 여정
환자가 병원을 알게 된 때부터 방문 뒤까지 겪는 과정- 예를 들어
- 검색 결과에서 진료 페이지를 읽고 전화한 뒤 예약하고 내원하는 순서를 단계별로 살펴봅니다.
- 지금 기억할 것
- 홈페이지 한 화면만 보지 않고 환자가 다음 단계로 자연스럽게 이동하는지 개선할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
접점
환자가 병원과 정보를 주고받는 순간이나 장소- 예를 들어
- 홈페이지의 전화 버튼과 예약 뒤 안내 문자는 서로 다른 접점입니다.
- 지금 기억할 것
- 어느 지점에서 설명이 부족하거나 다음 행동이 끊기는지 구체적으로 찾을 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
대상 독자
이 정보가 가장 도움 되어야 하는 사람- 예를 들어
- ‘무릎 통증이 오래됐지만 어디서부터 알아볼지 모르는 사람’처럼 상황과 질문을 함께 적습니다.
- 지금 기억할 것
- 누구에게나 하는 막연한 설명 대신 실제 질문에 답하는 페이지를 만들 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
검색 의도
사람이 검색어를 입력하며 해결하려는 질문- 예를 들어
- ‘야간진료 한의원’은 일반 정보보다 지금 방문 가능한 곳을 찾으려는 의도가 큽니다.
- 지금 기억할 것
- 검색어만 반복하지 않고 방문자가 원하는 답과 다음 행동을 정확히 제공할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
자연 유입
광고 클릭 비용 없이 콘텐츠나 검색을 통해 들어온 방문- 예를 들어
- 진료 정보를 검색한 사람이 검색 결과의 병원 페이지를 눌러 들어오는 경우입니다.
- 지금 기억할 것
- 광고 예산과 별개로 사이트 정보가 꾸준히 발견되는 힘을 살펴볼 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
SEO
검색 서비스가 페이지 내용을 잘 이해하도록 돕는 작업- 예를 들어
- 한 페이지가 어떤 진료 질문에 답하는지 제목과 본문에서 분명히 설명합니다.
- 지금 기억할 것
- 검색 순위만 쫓기보다 실제로 도움이 되는 정보가 적절한 검색에서 발견되게 합니다.
- 주의할 점
- 특정 순위나 환자 유입을 보장하는 표현으로 이해하면 안 됩니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
지역 검색
특정 지역에서 갈 곳을 찾는 검색- 예를 들어
- ‘서초 야간진료 한의원’이나 지도에서 현재 영업 중인 곳을 찾는 경우입니다.
- 지금 기억할 것
- 주소, 진료시간, 연락처를 여러 채널에서 정확하고 일관되게 관리해야 하는 이유를 이해할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
퍼널
많은 방문 중 필요한 다음 행동으로 이어지는 흐름- 예를 들어
- 페이지 방문 → 전화 버튼 클릭 → 실제 상담 연결을 서로 다른 단계로 나눕니다.
- 지금 기억할 것
- 마지막 예약 수만 보지 않고 어느 단계에서 설명이나 연결이 끊기는지 찾을 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
문의 가능 고객
병원에 관심을 보이고 연락할 가능성이 생긴 사람- 예를 들어
- 진료 페이지를 읽은 뒤 상담 폼을 보내 연락처와 문의 내용을 남긴 경우입니다.
- 지금 기억할 것
- 단순 방문 숫자와 실제 응대가 필요한 요청을 구분해 놓치지 않고 처리할 수 있습니다.
- 주의할 점
- 진료 관계가 확정된 환자와 같은 뜻이 아니며, 수집한 정보는 동의한 목적과 기간 안에서만 다뤄야 합니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
CRM
문의와 관계의 흐름을 빠뜨리지 않게 관리하는 방식- 예를 들어
- 새 문의, 연락 완료, 예약 확정처럼 현재 상태와 다음 담당 행동을 구분합니다.
- 지금 기억할 것
- 개인의 기억이나 메모에 의존하지 않고 일관된 응대 과정을 만들 수 있습니다.
- 주의할 점
- 불필요한 민감정보를 모으거나 동의하지 않은 홍보 연락에 사용해서는 안 됩니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
관계 단계
문의부터 방문 이후까지 현재 위치를 나타내는 구분- 예를 들어
- 아직 연락하지 않은 문의와 예약이 확정된 문의를 서로 다른 상태로 표시합니다.
- 지금 기억할 것
- 각 단계에서 지금 필요한 안내와 담당 업무를 명확하게 정할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
그룹 나누기
같은 조건이나 필요한 안내를 가진 대상을 묶어 보는 것- 예를 들어
- 전화 문의와 온라인 문의를 나누어 어느 경로의 응답이 늦는지 확인합니다.
- 지금 기억할 것
- 모두에게 같은 대응을 하기보다 실제 문제에 맞는 운영 개선을 할 수 있습니다.
- 주의할 점
- 질환이나 민감정보로 불필요하게 분류하지 않고 목적에 꼭 필요한 최소 기준만 사용합니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
후속 안내
첫 문의나 방문 뒤에 약속한 다음 안내- 예를 들어
- 온라인 문의를 받은 뒤 담당자가 확인해 약속한 시간 안에 답변합니다.
- 지금 기억할 것
- 누락과 지연을 줄이고 환자가 다음에 무엇을 해야 하는지 알게 합니다.
- 주의할 점
- 광고성 연락은 별도 동의와 관련 규정을 확인해야 하며 진료 효과를 단정하면 안 됩니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
유입 경로
방문자나 문의가 병원을 알게 된 길- 예를 들어
- 검색 결과에서 들어온 문의와 지도에서 전화한 문의를 구분해 봅니다.
- 지금 기억할 것
- 어떤 정보와 접점이 실제 문의에 기여하는지 더 정확히 판단할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
기여 경로
어떤 접점이 결과에 얼마나 이어졌는지 해석하는 방식- 예를 들어
- 마지막 클릭만 볼지, 처음 알게 된 검색까지 함께 볼지 기준을 먼저 정합니다.
- 지금 기억할 것
- 한 숫자를 모든 원인으로 단정하지 않고 마케팅 결과를 더 신중하게 해석할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
핵심 지표
목표가 나아지는지 판단하기 위해 고른 중요한 숫자- 예를 들어
- 문의 누락을 줄이는 목표라면 방문자 수보다 미응답 문의 수와 평균 첫 응답 시간을 먼저 봅니다.
- 지금 기억할 것
- 보기 좋은 숫자가 아니라 실제 운영 개선에 필요한 판단에 집중할 수 있습니다.
- 주의할 점
- 지표 하나만으로 진료의 질이나 경영 성과 전체를 단정하지 않습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
대시보드
중요한 운영 상태를 한곳에서 보는 화면- 예를 들어
- 오늘 새 문의 수와 아직 응답하지 않은 항목을 첫 화면에서 함께 확인합니다.
- 지금 기억할 것
- 여러 화면을 찾아다니지 않고 지금 확인하거나 조치할 일을 빠르게 판단할 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
동의
어떤 정보를 왜 쓰는지 알고 허용한 기록- 예를 들어
- 상담 처리에 필요한 개인정보 동의와 광고성 안내 수신 동의를 분리해 받습니다.
- 지금 기억할 것
- 문의 기능과 CRM이 사람의 정보 자기결정권을 지키며 작동하게 합니다.
- 주의할 점
- 필수 동의와 선택 동의를 뭉치거나 미리 선택된 상태로 강요해서는 안 됩니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
개인정보
한 사람을 알아보거나 연결할 수 있는 정보- 예를 들어
- 문의 폼의 이름, 전화번호와 연결된 상담 내용은 공개 예시 데이터로 사용하지 않습니다.
- 지금 기억할 것
- 학습, 분석과 기능 시험 과정에서 실제 사람의 정보를 불필요하게 노출하지 않게 합니다.
- 주의할 점
- 필요한 최소 정보만 수집하고 대화창·코드·화면 캡처에 실제 값을 남기지 않습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
의료광고
환자의 선택에 영향을 주도록 병원이나 진료를 알리는 표현- 예를 들어
- 진료 프로그램 페이지를 공개하기 전 사실 근거, 오해 가능성과 필요한 심의 여부를 확인합니다.
- 지금 기억할 것
- 유용한 정보를 제공하면서도 과장·보장·환자 오인 가능성을 줄이기 위해 알아야 합니다.
- 주의할 점
- 구체적인 허용 여부는 표현, 매체와 시점에 따라 달라질 수 있으므로 공개 전에 현재 규정과 전문가 검토가 필요합니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
초진·재진
처음 진료와 이후 다시 이어지는 진료를 구분하는 말- 예를 들어
- 초진 안내에는 첫 방문 준비를, 재진 안내에는 이후 예약과 변경 방법을 알기 쉽게 설명합니다.
- 지금 기억할 것
- 서로 필요한 정보와 운영 절차가 다를 수 있어 안내와 현황을 정확하게 만들 수 있습니다.
- 주의할 점
- 통계 기준과 보험·진료 기준이 다를 수 있으므로 ClinicOS 화면의 정의를 먼저 확인합니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
에이전트 안내문
AI가 이 프로젝트에서 지켜야 할 작업 설명서- 예를 들어
- 에이전트는 작업 전 안내문을 읽고 실제 사이트 공개에는 별도 승인이 필요하다는 규칙을 확인합니다.
- 지금 기억할 것
- AI 도구나 컴퓨터가 바뀌어도 같은 안전 원칙을 이어 주는 문서입니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
백업
문제가 생겼을 때 복원하도록 따로 보관한 사본- 예를 들어
- Core 업데이트 전 원격 D1 백업의 생성 시간과 복원 대상을 확인합니다.
- 지금 기억할 것
- 실수나 장애가 생겨도 운영 정보와 정상 상태를 되찾을 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
진단
바꾸기 전에 현재 상태와 원인을 확인하는 일- 예를 들어
- 배포가 실패하면 토큰을 다시 만들기 전에 에이전트가 실패 단계와 권한 범위를 먼저 확인합니다.
- 지금 기억할 것
- 추측으로 여러 설정을 바꿔 문제를 더 크게 만드는 일을 막습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
재개
중단한 작업을 확인된 지점부터 다시 이어가는 것- 예를 들어
- 새 컴퓨터에서 Git 상태와 마지막 Preview 주소를 확인한 뒤 미완료 단계부터 이어갑니다.
- 지금 기억할 것
- 환경이나 에이전트가 바뀌어도 중복 작업과 뜻밖의 변경을 줄일 수 있습니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
검색용 정보
검색 결과가 페이지를 이해하고 보여줄 때 쓰는 요약 정보- 예를 들어
- 진료 프로그램 페이지마다 실제 본문과 맞는 제목과 짧은 설명을 정합니다.
- 지금 기억할 것
- 검색 결과에서 방문자가 페이지 내용을 미리 이해하고 적절한 정보를 선택하게 합니다.
- 주의할 점
- 검색용 정보만 반복 입력한다고 순위가 보장되지는 않으며 실제 본문과 달라서는 안 됩니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
DNS
인터넷 주소를 사이트와 이메일에 연결하는 안내표- 예를 들어
- 병원 도메인을 ClinicOS에 연결할 때 웹용 항목만 바꾸고 이메일에 쓰는 항목은 그대로 둡니다.
- 지금 기억할 것
- 도메인 설정을 모두 바꾸면 홈페이지뿐 아니라 이메일과 다른 서비스도 영향을 받을 수 있으므로 용도를 먼저 구분해야 합니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
HTTPS
사이트와 방문자 사이의 내용을 안전하게 전달하는 연결- 예를 들어
- 병원 도메인을 연결한 뒤 주소가 https로 열리고 브라우저에 보안 경고가 없는지 확인합니다.
- 지금 기억할 것
- 주소가 사이트를 가리키는 것과 안전한 연결이 준비된 것은 별도이므로 둘 다 확인해야 합니다.
전체 사전에서 자세히 보기 →과정에서 만날 말
대표 주소
같은 사이트의 여러 주소 가운데 기준으로 정한 하나- 예를 들어
- www.example.com을 대표 주소로 정했다면 example.com으로 들어온 방문자도 그 주소로 안전하게 이동시킵니다.
- 지금 기억할 것
- 여러 주소가 제각각 열리거나 계속 서로 이동하는 오류를 막고 방문자에게 일관된 주소를 보여 줍니다.
전체 사전에서 자세히 보기 →문제가 생겼을 때 볼 말
binding
사이트가 어느 저장 공간을 사용할지 정해 둔 연결표- 예를 들어
- 에이전트가 D1 binding을 확인한다는 말은, 현재 사이트가 내 병원의 D1을 가리키는지 살핀다는 뜻입니다.
- 지금 기억할 것
- 정상 과정에서는 외울 필요가 없습니다. 에이전트가 연결 대상을 추측하지 않고 확인했는지만 보면 됩니다.
전체 사전에서 자세히 보기 →문제가 생겼을 때 볼 말
migration
저장된 정보를 지키며 저장 형식을 바꾸는 작업- 예를 들어
- 예약 기능에 새 항목이 필요하면 에이전트가 어느 D1에 어떤 migration을 적용할지 먼저 확인합니다.
- 지금 기억할 것
- 이 말이 나오면 ‘기존 자료를 보존하는지, 어느 저장 공간에 적용하는지’ 두 가지를 확인합니다.
전체 사전에서 자세히 보기 →문제가 생겼을 때 볼 말
workerd
Cloudflare의 작동 모습을 내 컴퓨터에서 시험하는 프로그램- 예를 들어
- Windows에서 workerd가 멈추면 같은 실행을 반복하지 않고 인터넷의 Preview에서 확인하도록 경로를 바꿉니다.
- 지금 기억할 것
- 원장님이 고칠 도구는 아닙니다. 에이전트에게 ‘원격 Preview로 계속할 수 있는지’ 물으면 됩니다.
전체 사전에서 자세히 보기 →문제가 생겼을 때 볼 말
rollback
마지막 정상 상태로 되돌리는 작업- 예를 들어
- Production 배포 검사에 실패하면 새 변경을 유지하지 않고 직전 정상 배포로 돌아갑니다.
- 지금 기억할 것
- 실패가 장시간 운영 장애로 이어지지 않게 합니다.
전체 사전에서 자세히 보기 →문제가 생겼을 때 볼 말
fixture
실제 환자정보가 없는 기능 시험 자료- 예를 들어
- 가상의 이름과 연락처로 문의 흐름이 작동하는지 확인합니다.
- 지금 기억할 것
- 개인정보를 노출하지 않고도 데이터 기능과 오류 복구를 검증할 수 있습니다.
전체 사전에서 자세히 보기 →문제가 생겼을 때 볼 말
충돌
서로 다른 변경이 같은 부분을 다르게 고친 상태- 예를 들어
- 충돌이 생기면 어느 쪽도 지우지 않고 병원 고유 변경과 새 Core 변경을 비교합니다.
- 지금 기억할 것
- 기존 고객의 작업을 잃지 않고 의도에 맞게 변경을 합치기 위해 알아야 합니다.
전체 사전에서 자세히 보기 →문제가 생겼을 때 볼 말
HTTP 응답
인터넷 주소 요청에 서버가 돌려준 결과- 예를 들어
- Preview 주소가 HTTP 200을 돌려주고 실제 첫 화면이 보이는지 함께 확인합니다.
- 지금 기억할 것
- 주소가 존재한다는 것과 올바른 화면이 정상 작동한다는 것을 나누어 검증할 수 있습니다.
전체 사전에서 자세히 보기 →문제가 생겼을 때 볼 말
blocker
안전하게 다음 단계로 갈 수 없어 먼저 해결해야 하는 문제- 예를 들어
- 다른 병원의 Cloudflare 사이트가 선택됐다면 배포를 진행하지 않고 blocker로 보고합니다.
- 지금 기억할 것
- 같은 명령을 반복하거나 억지로 우회하지 않고 원인과 안전한 다음 행동을 먼저 정하게 합니다.
전체 사전에서 자세히 보기 →