커스텀 홈페이지
Clinic-OS Core · Clinic-OS
🏛️ Core
🌐 공개
v1.2.0
코어 코드를 건드리지 않고 메인 홈페이지를 완전히 커스터마이징할 수 있는 코어 플러그인입니다. 바이브코딩으로 자유롭게 페이지를 수정하면서도, 플러그인 비활성화로 언제든 원본으로 복구할 수 있습니다.
주요 기능
- 홈페이지 완전 오버라이드
- 코어 업데이트와 독립적 운영
- 플러그인 on/off로 간편 전환
- 바이브코딩으로 자유로운 수정
- Astro 컴포넌트 전체 활용 가능
수정 방법
src/plugins/custom-homepage/pages/index.astro 파일을 직접 수정하거나, Claude에게 수정을 요청하세요.
필요 조건
없음 (바로 사용 가능)
📖 상세 문서
커스텀 홈페이지 플러그인
코어 코드를 건드리지 않고 홈페이지를 완전히 커스터마이징할 수 있는 코어 플러그인입니다.
왜 플러그인 방식인가요?
Clinic-OS는 3레이어 아키텍처를 따릅니다:
| 레이어 | 역할 | 수정 방식 |
|---|---|---|
| 코어 | 관리자 페이지, API, 인증 | 수정 금지 (업데이트 시 덮어쓰기) |
| 데이터 | seed 파일, DB 데이터 | 자유롭게 수정 가능 |
| 플러그인 | 퍼블릭 페이지, 커스텀 기능 | 자유롭게 수정 가능 |
홈페이지는 각 한의원마다 다르게 표현해야 하므로, 플러그인으로 분리했습니다.
사용 방법
1. 홈페이지 수정
src/plugins/custom-homepage/pages/index.astro
"홈페이지에 진료 시간 안내 섹션을 추가해줘"
2. 플러그인 비활성화
원본 홈페이지로 돌아가려면: 1. 관리자 > 기능 허브 > 커스텀 홈페이지 2. 토글 버튼으로 비활성화3. 새 페이지 추가
src/plugins/custom-homepage/pages/ 디렉토리에 새 파일 추가:
about.astro→ manifest.json의 overrides에 등록
오버라이드 우선순위
manifest.json의 priority 값으로 우선순위를 설정합니다.
숫자가 높을수록 우선 적용됩니다.
{
"overrides": [
{ "path": "/", "file": "pages/index.astro", "priority": 10 }
]
}
기술 상세
- 오버라이드 경로:
/ - 컴포넌트:
pages/index.astro - 우선순위: 10 (높을수록 우선)