메인 페이지를 우리 한의원답게 정리하기
ClinicOS 설치와 기본 설정을 마친 뒤, 처음 방문한 사람이 어떤 한의원인지, 누구에게 어떤 도움을 주는지, 다음에 무엇을 누르면 되는지 알 수 있도록 메인 페이지를 정리하는 단계입니다.
기존 가이드에서 안내하던 메인 문구, 진료·프로그램 소개, 의료진, 후기와 글 섹션은 여전히 중요한 구성 요소입니다. 다만 ClinicOS 설치 상태에 따라 메인 페이지의 내용을 가져오는 곳이 다를 수 있습니다. 관리자 콘텐츠 > 페이지에서 저장한 내용이 공개 홈페이지에 바로 연결된다고 가정하지 말고, 에이전트가 현재 연결 경로를 먼저 확인하게 하세요.
이 단계에서 완성할 것
메인 페이지를 화려하게 만드는 것이 목표는 아닙니다. 처음 방문한 사람이 아래 네 가지를 빠르게 이해하면 됩니다.
- 어떤 환자와 고민을 주로 돕는가
- 어떤 진료나 프로그램을 제공하는가
- 믿고 문의할 수 있는 근거는 무엇인가
- 문의, 예약 또는 전화 가운데 다음 행동은 무엇인가
이 네 가지가 이미 잘 드러나는 부분은 유지하고, 비어 있거나 실제 운영과 다른 부분만 고칩니다.
시작 전에 원장님이 정할 내용
| 정할 내용 | 적어둘 예시 |
|---|---|
| 가장 먼저 만나고 싶은 환자 | 오래 반복되는 목·허리 불편으로 일상에 지장이 있는 분 |
| 첫 화면에서 답할 질문 | 이 한의원이 내 고민을 이해하고 진료할 수 있는가 |
| 대표 진료·프로그램 | 실제로 상담과 진료가 가능한 항목 2~4개 |
| 신뢰 근거 | 의료진 경력, 진료 원칙, 실제 시설·운영 정보 |
| 가장 중요한 다음 행동 | 온라인 문의, 예약, 전화 중 하나 |
| 반드시 맞아야 할 정보 | 진료시간, 주소, 전화번호, 휴진 안내 |
환자 후기나 치료 결과를 넣을 때는 사실을 과장하지 말고, 현재 공개해도 되는 내용과 동의 범위를 확인하세요.
에이전트에게 이렇게 요청하세요
아래 요청은 기존 내용을 지우기 전에 현재 구조와 공개 결과를 먼저 확인하도록 만든 요청입니다.
ClinicOS 메인 페이지를 우리 한의원 내용으로 정리해줘.
먼저 현재 공개 홈페이지를 캡처하고, 메인 페이지가
1) 홈페이지 교체 플러그인,
2) 공개된 home-page 번역 데이터,
3) 기본 템플릿
중 어디에서 만들어지는지 확인해줘.
관리자 콘텐츠 > 페이지에서 저장하는 데이터와 공개 홈페이지가 실제로 연결되는지도
코드와 데이터 기준으로 검증해줘. 연결되지 않았다면 관리자에서 저장만 하고
완료했다고 보고하지 말아줘.
기존에 잘 되어 있는 문구와 섹션은 보존하고, 아래 내용을 기준으로 최소한의 수정안을 먼저 보여줘.
- 주요 환자: [입력]
- 대표 진료·프로그램: [입력]
- 신뢰 근거: [입력]
- 우선 행동: [문의/예약/전화 중 선택]
- 진료시간·주소·전화번호: [입력]
내 확인을 받은 뒤 적용하고, 데스크톱과 모바일 공개 화면에서
문구, 링크, 진료정보, 문의 동선까지 검수해줘.에이전트의 첫 보고에는 현재 공개 화면, 실제로 내용을 가져오는 곳, 유지할 부분, 고칠 부분, 변경 전 확인이 필요한 사항이 들어가야 합니다.
1. 현재 메인 페이지가 어디에서 만들어지는지 확인하기
ClinicOS 메인 페이지는 설치 상태에 따라 다음 순서로 결정됩니다.
- 홈페이지 전체를 교체하는 플러그인이 켜져 있으면 그 화면을 사용합니다.
- 공개 상태인
home-page번역 데이터가 있으면 그 제목, 설명과 섹션을 사용합니다. - 둘 다 없으면 ClinicOS의 기본 메인 페이지 구성을 사용합니다.
관리자 콘텐츠 > 페이지에는 섹션 편집기, 미리보기, 공개 여부 설정이 있습니다. 하지만 현재 기본 코드에서 이 편집기가 저장하는 곳과 공개 메인 페이지가 읽는 곳은 서로 다릅니다. 병원별 설치 과정에서 별도 연결 기능을 추가했을 수도 있으므로, 에이전트가 실제 프로젝트에서 연결 여부를 확인해야 합니다.
연결되지 않은 상태라면 다음 가운데 하나를 선택합니다.
- 현재 공개 메인 페이지의 실제 데이터만 안전하게 수정한다.
- 관리자 편집기와 공개 메인 페이지를 잇는 기능을 별도 개발 과제로 잡는다.
- 홈페이지 교체 플러그인을 유지하고 그 플러그인의 관리 방법을 따른다.
원장님 확인 없이 저장 위치를 바꾸거나 기존 플러그인을 끄지 마세요.
2. 환자가 읽는 순서로 내용 정리하기
현재 구조를 확인했다면 필요한 섹션만 아래 순서에 맞춰 정리합니다. 병원에 없는 진료나 근거를 채우기 위해 섹션을 억지로 늘릴 필요는 없습니다.
첫 화면
한의원 이름만 반복하기보다 누구의 어떤 고민을 돕는지 한 문장으로 설명합니다. 버튼은 가장 중요한 행동 하나를 먼저 보여주고, 실제로 열리는 문의·예약·전화 경로에 연결합니다.
진료·프로그램
내부 분류명보다 환자가 알아듣는 고민과 상황으로 소개합니다. 상세 페이지가 있다면 연결하고, 아직 준비되지 않은 링크는 공개하지 않습니다.
의료진과 진료 원칙
경력의 나열만으로 끝내지 말고 상담과 진료에서 무엇을 중요하게 보는지 함께 설명합니다. 공개 프로필, 자격과 실제 진료 일정이 서로 맞는지 확인합니다.
후기와 신뢰 정보
후기를 사용할 수 있는 설치라면 동의와 공개 범위를 확인합니다. 후기가 없거나 공개하기 어렵다면 시설, 진료 과정, 위치, 운영시간처럼 직접 확인할 수 있는 정보를 먼저 제공합니다.
문의 전 마지막 안내
진료시간, 주소, 주차나 대중교통, 전화번호를 확인하고 첫 화면에서 선택한 행동으로 다시 연결합니다.
3. 미리보기와 공개 화면을 따로 확인하기
관리자 페이지 편집기에는 데스크톱과 모바일 폭으로 섹션을 미리 보는 기능이 있습니다. 섹션 순서는 위·아래 이동으로 조정할 수 있고, 작성 화면과 코드 화면을 전환할 수도 있습니다.
다만 미리보기가 정상이라고 공개 홈페이지까지 정상인 것은 아닙니다. 저장 뒤에는 반드시 실제 주소를 새 창에서 열어 다음을 확인하세요.
- 첫 화면 제목과 버튼이 작은 화면에서도 잘리지 않는가
- 글자가 너무 작거나 한 줄이 지나치게 길지 않은가
- 문의·예약·전화 버튼이 실제 경로로 열리는가
- 진료시간, 주소와 전화번호가 현재 정보와 같은가
- 존재하지 않는 프로그램이나 준비되지 않은 상세 페이지로 연결되지 않는가
- 원장님이 확인한 기존 문구와 섹션이 사라지지 않았는가
변경 전과 변경 후 화면을 데스크톱과 모바일에서 각각 남겨 두면 되돌리거나 다음 수정을 결정하기 쉽습니다.
문제가 생겼을 때
관리자에서 저장했는데 공개 홈페이지가 바뀌지 않아요
공개 메인 페이지가 관리자 콘텐츠 > 페이지와 다른 데이터를 읽고 있을 가능성이 큽니다. 같은 내용을 반복 저장하지 말고, 에이전트에게 플러그인·home-page 번역 데이터·기본 템플릿 가운데 실제 사용 경로를 다시 확인해 달라고 요청하세요.
수정 뒤 기존 디자인이나 문구가 사라졌어요
새 구조로 덮어쓰기 전에 남긴 화면과 변경 내역으로 되돌립니다. 홈페이지 교체 플러그인이 있었는지, 공개 번역 데이터가 빈 값으로 바뀌었는지, 기본 템플릿으로 돌아간 것은 아닌지 확인하세요.
미리보기와 실제 화면이 달라요
미리보기 데이터와 공개 데이터가 같은지 확인하고, 공개 페이지 캐시를 새로고침한 뒤 다시 봅니다. 그래도 다르면 두 화면의 주소와 캡처, 확인 시각을 에이전트에게 전달하세요.
원장님 온보딩 완료로 보기 전 확인
- [ ] 메인 페이지가 실제로 내용을 가져오는 곳을 확인했다.
- [ ] 기존 내용 중 유지할 부분과 바꿀 부분을 구분했다.
- [ ] 주요 환자, 대표 진료, 신뢰 근거와 우선 행동이 실제 운영과 맞다.
- [ ] 원장님이 수정안을 확인한 뒤 적용했다.
- [ ] 데스크톱과 모바일 공개 화면을 모두 확인했다.
- [ ] 문의·예약·전화 링크를 직접 눌러 봤다.
- [ ] 진료시간, 주소와 전화번호가 현재 정보와 같다.
- [ ] 변경 전·후 화면과 적용 위치를 기록했다.
이 확인을 마치면 다음 단계에서 메뉴와 이동 경로 정리하기와 진료·프로그램 등록하기를 이어서 진행하세요.
에이전트 검수용 코드 기준
설치 상태를 확인하는 에이전트는 최소한 아래 파일을 함께 봅니다.
src/pages/index.astro: 플러그인 교체 화면과 기본 메인 페이지의 우선순위src/lib/page-builders/homepage.ts:home-page번역 데이터와 기본 섹션 구성src/pages/admin/pages/index.astro: 관리자 페이지 목록src/pages/admin/pages/[id].astro: 섹션 편집, 순서 이동, 미리보기와 저장 화면src/pages/api/admin/pages/[id].ts: 관리자 페이지 저장 APIsrc/lib/PageService.ts: 관리자 페이지가 저장되는 데이터 경로
이 파일 이름은 원장님이 직접 수정하라는 뜻이 아닙니다. 에이전트가 현재 설치본의 동작을 추측하지 않고 확인하기 위한 기준입니다.
이 페이지의 요약
ClinicOS 메인 페이지는 설치 상태에 따라 플러그인, 공개된 home-page 번역 데이터 또는 기본 템플릿에서 만들어집니다. 기존 메인 문구와 진료·의료진·후기 같은 좋은 구성은 살리되, 먼저 실제 연결 경로를 확인해야 합니다. 수정 뒤에는 관리자 미리보기만 보지 말고 데스크톱과 모바일 공개 화면에서 문구, 진료정보와 문의 동선을 끝까지 확인하세요.