연수

연수구립도서관 개발 작업 가이드 & 페이지 인덱스 ver.2025. 9. 4.

63
운영중인 페이지
25
UI 컴포넌트
동적메뉴
1depth 기반
Vanilla JS
순수 자바스크립트
📚 메인 페이지
# 페이지명 URL 상태 설명
01 메인 홈페이지 index.astro 완료 도서관 메인 페이지, 배너 슬라이더, 퀵링크, 이벤트 섹션
📄 도서검색 시스템
# 페이지명 URL 상태 설명
S01 소장도서검색 소장도서검색.astro 완료 도서관 필터, 상세검색, 자료유형 탭, 소장정보 모달
S01-1 소장도서검색_상세 소장도서검색_상세.astro 완료 도서 상세 정보 페이지, 소장정보 모달
S01-2 소장도서검색_고급검색 소장도서검색_고급검색.astro 완료 고급 검색 옵션, 상세 필터링 기능
S02 스마트도서관비치도서 스마트도서관비치도서.astro 완료 스마트도서관 전용 검색 페이지
S03 도서관에 바란다 도서관에바란다.astro 완료 건의사항 게시판, 테이블 기반 목록
S04 공지사항 공지사항.astro 완료 공지사항 게시판, 테이블 기반 목록
S05 통합검색 통합검색.astro 완료 통합검색 결과 페이지, 다양한 검색 결과 표시
S05-1 통합검색_Empty 통합검색_Empty.astro 완료 통합검색 빈 상태 페이지, UiEmpty 컴포넌트 활용
S06 인기도서 인기도서.astro 완료 인기도서 목록, UiBookListCard 그리드
S07 신착도서 신착도서.astro 완료 신착도서 목록, 최신 입고 도서 정보
S08 추천도서 추천도서.astro 완료 추천도서 목록, 사서 추천 및 테마별 도서
S09 카테고리분류 카테고리분류.astro 완료 주제별 카테고리 도서 분류
S10 한국십진분류 한국십진분류.astro 완료 한국십진분류법 기반 도서 검색
S11 전자도서관 전자도서관.astro 완료 전자도서관 접속 페이지
📚 나의 서재
# 페이지명 URL 상태 설명
M01 대출현황 대출현황.astro 완료 현재 대출중인 도서 목록 및 반납 예정일
M02 대출이력 대출이력.astro 완료 과거 대출 이력 조회
M03 일반예약현황 일반예약현황.astro 완료 예약중인 도서 현황
M04 상호대차현황 상호대차현황.astro 완료 타 도서관 상호대차 신청 현황
M05 희망도서신청현황 희망도서신청현황.astro 완료 희망도서 신청 및 처리 현황
M06 희망전자책신청현황 희망전자책신청현황.astro 완료 희망전자책 신청 및 처리 현황
M07 내책장 내책장.astro 완료 개인 북마크 관리, 태그 클라우드 및 통계 차트 포함
M08 내책장-상세 내책장-상세.astro 완료 내책장 상세 정보 페이지
M09 내정보 내정보.astro 완료 회원 정보 관리 메인 페이지
M10 내정보-정회원인증 내정보-정회원인증.astro 완료 정회원 인증 페이지
M11 회원정보수정-step1 회원정보수정-step1.astro 완료 회원정보 수정 1단계 - 본인인증
M12 회원정보수정-step2 회원정보수정-step2.astro 완료 회원정보 수정 2단계 - 정보입력
M13 회원탈퇴 회원탈퇴.astro 완료 회원 탈퇴 페이지
M14 정회원인증 정회원인증.astro 완료 정회원 인증 페이지
M15 모바일회원증 모바일회원증.astro 완료 모바일 회원증 페이지
M16 통합회원조회 통합회원조회.astro 완료 통합 회원 조회 페이지
🎭 행사/프로그램
# 페이지명 URL 상태 설명
E01 행사신청조회 행사신청조회.astro 완료 도서관 행사 신청 및 조회
E02 프로그램신청조회 프로그램신청조회.astro 완료 교육 프로그램 신청 및 조회
E02-1 프로그램신청-상세 프로그램신청-상세.astro 완료 교육 프로그램 신청 상세 보기
E02-2 프로그램신청 프로그램신청.astro 완료 교육 프로그램 신청 폼
E03 견학신청조회 견학신청조회.astro 완료 도서관 견학 프로그램 신청
E04 대관신청조회 대관신청조회.astro 완료 도서관 시설 대관 신청
E05 영유아전집신청조회 영유아전집신청조회.astro 완료 영유아 대상 전집 대출 신청
E06 공연장대관신청조회 공연장대관신청조회.astro 완료 공연장 대관 신청 및 조회
E07 공연장 공연장.astro 완료 공연장 시설 안내 페이지
📋 서비스 신청 페이지
# 페이지명 URL 상태 설명
S12 희망도서신청-서비스안내 희망도서신청-서비스안내.astro 완료 희망도서 신청 서비스 안내
S13 희망도서신청-서비스신청 희망도서신청-서비스신청.astro 완료 희망도서 신청 폼
S14 희망도서신청 희망도서신청.astro 완료 희망도서 신청 메인
S15 희망전자책신청-서비스안내 희망전자책신청-서비스안내.astro 완료 희망전자책 신청 서비스 안내
S16 희망전자책신청-서비스신청 희망전자책신청-서비스신청.astro 완료 희망전자책 신청 폼
S17 무료택배도서대출-서비스안내 무료택배도서대출-서비스안내.astro 완료 무료택배 도서대출 서비스 안내
S18 무료택배도서대출-서비스신청 무료택배도서대출-서비스신청.astro 완료 무료택배 도서대출 신청 폼
S19 무료택배도서대출-서비스신청-수정 무료택배도서대출-서비스신청-수정.astro 완료 무료택배 도서대출 신청 수정
S20 무료택배도서대출-서비스신청-상세 무료택배도서대출-서비스신청-상세.astro 완료 무료택배 도서대출 신청 상세 보기
🔧 공통/기타 페이지
# 페이지명 URL 상태 설명
C01 공통팝업 0.공통팝업.astro 완료 공통 팝업 컴포넌트 모음
C02 회원가입 회원가입.astro 완료 회원가입 페이지
C03 회원가입-14세미만회원가입 회원가입-14세미만회원가입.astro 완료 14세 미만 회원가입 페이지
C04 회원가입-14세이상회원가입 회원가입-14세이상회원가입.astro 완료 14세 이상 회원가입 페이지
C05 회원가입-대출자정보 회원가입-대출자정보.astro 완료 회원가입 대출자 정보 입력 페이지
C06 회원가입-대출자정보회원가입 회원가입-대출자정보회원가입.astro 완료 회원가입 대출자 정보 회원가입 페이지
C07 회원가입-본인인증 회원가입-본인인증.astro 완료 회원가입 본인인증 페이지
C08 회원가입-이용약관 회원가입-이용약관.astro 완료 회원가입 이용약관 페이지
C09 회원가입-해당유형 회원가입-해당유형.astro 완료 회원가입 해당유형 선택 페이지
C10 회원가입-결과 회원가입-결과.astro 완료 회원가입/로그인/비밀번호 관련 결과 페이지 (4가지 타입 지원)
C11 로그인 로그인.astro 완료 로그인 페이지 (좌측 환영 배너 + 우측 로그인 폼)
C12 비밀번호찾기 비밀번호찾기.astro 완료 비밀번호 찾기 1단계 - 아이디 입력
C13 비밀번호찾기-step2 비밀번호찾기-step2.astro 완료 비밀번호 찾기 2단계 - 본인인증 방법 선택 (I-PIN/휴대폰)
C14 비밀번호찾기-step3 비밀번호찾기-step3.astro 완료 비밀번호 찾기 3단계 - 새 비밀번호 설정
C15 guide guide.astro 완료 개발 작업 가이드 & 페이지 인덱스
🎨 UI 컴포넌트 라이브러리
# 컴포넌트 파일 기능 스타일
U01 UiButton UiButton.astro 다양한 버튼 스타일 (primary, secondary, outline) 완료
U02 UiInput UiInput.astro 텍스트 입력 필드, 검색 필드 완료
U03 UiSelect UiSelect.astro 드롭다운 선택 박스 완료
U04 UiTab UiTab.astro 탭 네비게이션 (기본, 연결형) 완료
U05 UiRadio UiRadio.astro 라디오 버튼 그룹 완료
U06 UiCheckbox UiCheckbox.astro 체크박스 완료
U07 UiSwitch UiSwitch.astro 토글 스위치 완료
U08 UiLibraryFilter UiLibraryFilter.astro 도서관 필터 (확장/축소 기능) 완료
U09 UiBookCard UiBookCard.astro 도서 정보 카드 완료
U10 UiPagination UiPagination.astro 페이지네이션 완료
U11 UiCollectionModal UiCollectionModal.astro 소장정보 팝업 모달 완료
U12 UiNavButton UiNavButton.astro 네비게이션 버튼 완료
U13 UiRelatedSiteButton UiRelatedSiteButton.astro 관련사이트 버튼 완료
U14 UiSearchbar UiSearchbar.astro 3개 셀렉트박스 검색바 (검색타입, 도서관, 제목) 완료
U15 UiSmartLibraryBookCard UiSmartLibraryBookCard.astro 스마트도서관 전용 도서 카드 완료
U16 UiTable UiTable.astro 게시판용 테이블 (체크박스, 정렬, 상태배지) 완료
U17 UiDatePicker UiDatePicker.astro 날짜 범위 선택 (시작일 ~ 종료일) 완료
U18 UiEmpty UiEmpty.astro 빈 상태 컴포넌트 (검색 결과 없음, 검색어 하이라이트) 완료
U19 UiSearchFilter UiSearchFilter.astro 검색 필터 섹션 (셀렉트 박스들) 완료
U20 UiImageTitleResult UiImageTitleResult.astro 이미지+제목 검색 결과 (검색어 하이라이트) 완료
U21 UiTitleOnlyResult UiTitleOnlyResult.astro 제목만 검색 결과 (검색어 하이라이트) 완료
U22 UiSubTab UiSubTab.astro 서브 탭 컴포넌트 (슬롯 기반, 탭 전환 기능) 완료
U23 UiBookListCard UiBookListCard.astro 도서 목록 카드 (랭킹, 이미지, 좋아요 기능) 완료
U24 Grid System _grid-system.scss PC to Mobile 반응형 그리드 (1-12열) 완료
🏗️ 레이아웃 컴포넌트
# 컴포넌트 파일 용도 상태
L01 Header Header.astro 사이트 헤더, 로고, 주 메뉴 완료
L02 Footer Footer.astro 사이트 푸터, 링크, 저작권 완료
L03 Gnb Gnb.astro 글로벌 네비게이션 완료
L04 LeftMenu LeftMenu.astro 1depth 기반 동적 좌측 메뉴 (2/3depth 지원) 완료
L05 SubLayout SubLayout.astro 서브페이지 레이아웃 완료
L06 Breadcrumb Breadcrumb.astro 브레드크럼 네비게이션 완료
🎨 최신 개선사항
# 개선내용 설명 적용일 상태
R01 동적 메뉴 시스템 1depth에 따라 자동 변경되는 좌측 메뉴, URL 기반 감지 2025.08 적용완료
R02 다중 셀렉트 검색바 검색타입, 도서관, 제목 3개 필터 동시 지원 2025.08 적용완료
R03 테이블 컴포넌트 게시판 전용, 제목 링크, 상태 배지, 반응형 지원 2025.08 적용완료
R04 한글 URL 인코딩 한글 페이지명 URL 자동 매칭 처리 2025.08 적용완료
R05 검색 결과 컴포넌트 UiEmpty, UiImageTitleResult, UiTitleOnlyResult 컴포넌트 개발 2025.08 적용완료
R06 서브 탭 시스템 UiSubTab 컴포넌트 슬롯 기반으로 개발, 탭 전환 기능 2025.08 적용완료
R07 도서 카드 컴포넌트 UiBookListCard 컴포넌트 랭킹, 좋아요 기능 포함 2025.08 적용완료
R08 반응형 그리드 시스템 PC to Mobile 자동 변환 그리드 (1-12열, 갭 조정) 2025.08 적용완료
R09 인기도서 페이지 인기도서 목록 페이지, UiBookListCard 활용 2025.08 적용완료
R10 통합검색 페이지 통합검색 결과 및 빈 상태 페이지, UiEmpty 컴포넌트 구현 2025.08 적용완료
R11 내책장 페이지 Figma 디자인 기반 내책장 UI, 태그 클라우드 및 통계 차트 구현 2025.08 적용완료
R12 태그 클라우드 시스템 WordCloud2.js, Chart.js, jQuery 통합 라이브러리 구현 2025.08 적용완료
R13 나의 서재 전체 시스템 대출현황, 예약현황, 희망도서 등 개인 서비스 페이지 완성 2025.08 적용완료
R14 로그인 시스템 구현 Figma 디자인 기반 로그인 페이지, 좌측 환영 배너와 우측 로그인 폼 구조 2025.08 적용완료
R15 비밀번호 찾기 플로우 3단계 비밀번호 찾기 시스템 (아이디 입력 → 본인인증 → 비밀번호 변경) 2025.08 적용완료
R16 통합 결과 페이지 시스템 URL 파라미터 기반 4가지 결과 타입 지원 (성공/실패/아이디찾기/대출자번호) 2025.08 적용완료
R17 회원가입 스타일 통일 로그인/비밀번호찾기 페이지를 회원가입 스타일 구조로 통일화 2025.08 적용완료
R18 복사 기능 구현 Clipboard API 활용한 대출자번호 복사 기능, 시각적 피드백 포함 2025.08 적용완료
💻 기술 스택 & 아키텍처
# 기술 버전 용도 상태
T01 Astro 4.15.0 정적 사이트 생성 프레임워크 완료
T02 SCSS Latest CSS 전처리기 (7-1 아키텍처) 완료
T03 Vanilla JavaScript ES6+ 순수 자바스크립트 (타입스크립트 사용 금지) 완료
T04 Swiper.js 11.2.10 슬라이더 컴포넌트 완료
T05 jQuery 3.7.1 태그 클라우드 및 차트 라이브러리 지원 완료
T06 Chart.js Latest 통계 차트 (막대, 선형) 완료
T07 WordCloud2.js Latest 태그 클라우드 시각화 완료
T08 Netlify - 배포 플랫폼 완료
📁 데이터 구조 & 설정
파일 용도 구조 비고
menuData.ts 메뉴 설정 MenuConfig 타입, URL 자동감지 1depth별 좌측메뉴 정의
CLAUDE.md 개발 가이드 명령어, 아키텍처, 규칙 AI 개발 지침서
components/index.ts 컴포넌트 관리 중앙집중식 export 24개 UI 컴포넌트
astro.config.mjs 프레임워크 설정 Path aliases, 빌드옵션 @/ 경로 설정
📐 SCSS 아키텍처 (7-1 Pattern)
폴더 용도 주요 파일 실제 사용 예시
abstracts/ 함수, 믹스인 _functions.scss, _mixins.scss to-rem(16), @include flex-center, @include mobile
variables/ 디자인 토큰 _colors.scss, _typography.scss $primary-color, $font-bold, $gray-900
components/ 컴포넌트 스타일 _left-menu.scss, _buttons.scss, _ui-subtab.scss, _ui-book-list-card.scss, _my-bookshelf.scss .menu-section-title.active, .book-list-card, .subtab-container, .my-bookshelf, .bookshelf-card
utilities/ 유틸리티 _flex.scss, _spacing.scss, _grid-system.scss .mt24, .flex-center, .grid .grid-5 클래스
🚀 배포 정보
항목 정보 상태 비고
배포 플랫폼 Netlify 완료 자동 배포 설정 완료
빌드 명령어 npm run build 완료 netlify.toml 설정 완료
출력 디렉토리 dist 완료 정적 파일 생성
Node.js 버전 18 완료 환경 변수 설정