Project

General

Profile

Files » 쉴만한교회_사용가이드_개발인수인계.md

성용 양, 10/26/2026 01:10 AM

 

동백 쉴만한교회 홈페이지 사용 가이드 및 개발 인수인계

작성일: 2026-10-25 (한국 시간)
대상: 홈페이지 운영자, 프런트엔드 개발자, 후속 작업을 맡는 Codex

1. 문서의 목적과 현재 상태

현재 Figma 디자인을 이해하고, PC·모바일 디자인을 하나의 반응형 웹사이트로 구현하기 위한 문서다. 디자인 사용법, 이미지 교체법, 색상 규칙, 반응형 레이아웃, 기능 구현 및 오류 점검 기준을 포함한다.

  • 완료된 것은 Figma 디자인 및 컬러 팔레트다.
  • 실제 웹사이트 소스, 서버, 게시판 API, CMS, 배포 환경은 이 작업에서 제공되거나 검증되지 않았다.
  • 아래의 CSS와 HTML은 구현 방향을 설명하는 예시다. 완성된 웹사이트 소스나 실행 검증된 프로젝트가 아니다.
  • 현재 디자인에서 확인한 값과 개발 제안 값을 구분한다. 제안한 브레이크포인트는 실제 콘텐츠로 검증해야 한다.
  • 개발자도구 스크립트 오류는 사용자 보고만 있으며, 발생 주소·로그·소스를 받지 못해 원인을 확인하거나 수정하지 않았다.
  • 참고 사이트는 레이아웃 참고용이다. 그 사이트의 소스 코드·스크립트·브랜드 자산을 그대로 가져오는 요구사항은 아니다.

2. Figma 파일과 화면 위치

파일: 웹사이트

화면 직접 열기 노드 ID 기준 크기
메인 PC Desktop 1440 86:2 1440 × 약 2703px
메인 모바일 Mobile 390 86:136 390 × 2276px
모바일 전체 메뉴 메뉴 열림 86:292 390 × 844px
컬러 팔레트 컬러 팔레트 99:2 1120 × 1320px

모두 Page 1에 있다. 위 크기는 문서 작성 시 조회한 값이며, 이후 디자인 편집으로 달라질 수 있다. 페이지 전체 높이를 CSS 고정 높이로 사용하지 않는다.

이전 작업에서 만들었던 주보 페이지는 최신 조회에서 확인되지 않았다. 예전 대화에 등장한 1:2, 80:2 노드의 존재나 접근 가능 여부를 전제로 구현하지 않는다. 실제 주보 페이지와 링크는 별도로 확보해야 한다.

Figma 탐색 방법

  1. 직접 링크를 열거나 왼쪽 레이어 목록에서 프레임 이름을 찾는다.
  2. 프레임을 선택한 뒤 Shift + 2로 선택 영역을 확대한다.
  3. 전체 화면 위치를 잃었으면 Shift + 1로 전체를 확인한다.
  4. 섹션을 펼쳐 카드, 이미지 영역, 텍스트를 개별 선택한다.
  5. 프레젠테이션과 편집 캔버스는 다르다. 캔버스에서 폭을 줄이는 것만으로 실제 웹사이트의 미디어 쿼리가 실행되지는 않는다.

디자인 우선순위

  1. 최신 사용자 요청
  2. 현재 Figma 메인 PC·모바일 프레임
  3. 이 문서의 확정 설정
  4. 레이아웃 참고 사이트

참고 사이트: 더향상교회. 교회명, 로고, 주소, 사진, 색상은 쉴만한교회 자료를 사용한다.

3. 홈페이지 구성과 사용자 동작

섹션 순서는 아래와 같다.

  1. PC 유틸리티 메뉴: 로그인, 회원가입, 목장일기, 스마트 요람, SNS
  2. 헤더: 로고와 주 메뉴 / 모바일에서는 햄버거 버튼
  3. 메인 배너: 교회 외관 사진, 이전·다음 화살표, 페이지 표시
  4. 올해의 말씀: 배지, 말씀 본문, 성경 구절
  5. 바로가기 카드 8개
  6. 포토갤러리: 제목, 더보기 버튼, 개별 사진 영역과 제목
  7. 푸터: 링크, 교회 정보, 저작권 문구

방문자 사용 흐름

  • 로고는 홈페이지로 이동한다.
  • 주 메뉴 및 바로가기 카드는 해당 콘텐츠 페이지로 이동한다.
  • 모바일 메뉴 버튼은 전체 메뉴를 열고, 닫기 버튼 또는 Escape로 닫는다.
  • 갤러리 사진·제목은 같은 게시글 상세 페이지로 이동한다.
  • 갤러리 더보기는 갤러리 목록으로 이동한다.
  • 로그인·회원가입·요람·SNS는 실제 서비스 주소가 준비된 항목만 연결한다.

위 동작은 구현 목표다. 현재 Figma의 링크·프로토타입 또는 실제 웹 기능이 모두 완성되었다는 의미는 아니다. 카드 반응을 조회했을 때 8개 카드의 프로토타입 반응은 비어 있었다. 개발 시 링크 목록을 따로 작성해야 한다.

4. 확정 이미지와 적용 규칙

4.1 현재 적용 이미지

영역 원본 파일명 PC 노드 모바일 노드 색상 오버레이 불투명도
메인 배너 햇살 가득한 캠퍼스형 거리 풍경.png 86:48 86:157 별도 오버레이 없음
주일설교 KakaoTalk_Photo_2026-10-25-16-51-58.jpeg 86:67 86:176 15%
목장소식 KakaoTalk_Photo_2026-10-25-16-54-02.jpeg 86:75 86:187 15%
다음세대 이야기 KakaoTalk_Photo_2026-10-25-16-55-14.jpeg 86:79 86:190 15%

원본은 작업자의 Downloads 폴더에 있었으나 이 문서에 첨부·패키징하지 않았다. 다른 컴퓨터에서는 동일한 경로를 사용할 수 없다. Figma의 해당 레이어에서 추출하거나 운영자에게 원본을 받아 프로젝트 자산으로 저장한다.

메인 배너는 ‘햇살 가득한 캠퍼스형 거리 풍경.png’가 최신본이다. 이전의 ‘맑은 아침의 도심 플라자.png’나 최초 예배 사진으로 되돌리지 않는다.

4.2 아직 이미지가 없는 영역

  • 예배안내
  • 목회칼럼
  • 교회주보
  • 삶공부 이야기
  • 새가족 등록 안내
  • 포토갤러리 개별 사진 영역

위 영역에는 임의 사진이나 기존 배너 사진을 반복 삽입하지 않는다. 이미지가 제공될 때까지 현재 단색 영역을 유지한다. 실제 게시물이 없는 갤러리에 가짜 게시글 제목이나 동작하지 않는 링크를 서비스 콘텐츠처럼 노출하지 않는다.

4.3 투명도 기준

대화에서 지정한 ‘15%’는 이미지 위에 덮는 색상 레이어의 불투명도 0.15다. 사진 자체의 불투명도가 아니다.

  • 사진: 100%
  • 제목: 100%
  • 오버레이: #002E45 / 15%
  • 카드 전체에 opacity: .15를 주지 않는다. 그렇게 하면 제목까지 흐려진다.
  • 향후 사진 추가 시에도 동일한 15%를 기본값으로 사용한다. 사진 밝기에 따른 예외는 별도로 확인한다.

4.4 이미지 관리 권장 데이터

{
  "id": "sermon",
  "title": "주일설교",
  "href": null,
  "image": "/assets/card-sermon.webp",
  "objectPosition": "50% 50%",
  "overlayColor": "#002E45",
  "overlayOpacity": 0.15
}

파일명과 경로는 예시다. href: null은 목적지가 아직 미정이라는 뜻이며, 렌더링할 때 가짜 링크를 생성하지 않는다. 텍스트·이미지·링크·크롭 위치를 데이터로 관리하면 운영자가 한 번 수정해 PC와 모바일에 함께 반영할 수 있다.

5. 컬러와 서체

5.1 주요 컬러

용도 HEX 비고
메인 하늘색 #00A4F0 강조, 배지, 버튼, 갤러리
보조 파랑 #2E87B0 교회주보 카드
헤더 배경 #F3FAFF 옅은 하늘색
이미지 대기 영역 #E0EDF5 이미지 미지정 카드
본문·메뉴 #222222 기본 텍스트
보조 텍스트 #73757A 설명, 갤러리 제목
밝은 카드 제목 #214F66 이미지 없는 밝은 카드
기본 흰색 #FFFFFF 배경, 사진 위 제목
푸터 배경 #3B3836 하단 배경
푸터 텍스트 #ACB0B5 교회 정보
경계선 #E5E5E5 구분선
로고 포인트 #941B2B 로고 십자가
사진 오버레이 #002E45 불투명도 15%
유틸리티 텍스트 #888888 로그인 등

컬러 팔레트에는 갤러리의 100%·50%를 포함한 16개 항목이 있고, 쉴만한교회 / ... 이름으로 색상 스타일을 등록했다. 기존 화면 전체를 해당 스타일에 연결한 작업은 아니다. 개발에서는 CSS 변수로 관리한다.

:root {
  --color-primary: #00a4f0;
  --color-secondary: #2e87b0;
  --color-header: #f3faff;
  --color-placeholder: #e0edf5;
  --color-text: #222;
  --color-muted: #73757a;
  --color-card-text: #214f66;
  --color-white: #fff;
  --color-footer: #3b3836;
  --color-footer-text: #acb0b5;
  --color-border: #e5e5e5;
  --color-photo-overlay: rgb(0 46 69 / 15%);
}

5.2 서체

현재 Figma 서체는 Noto Sans KR이며 Regular / Medium / Bold를 사용한다. 웹에서는 필요한 굵기의 폰트 파일을 준비하고 폴백을 둔다. 폰트의 실제 배포 권한과 파일은 프로젝트에서 확인한다.

body {
  font-family: "Noto Sans KR", system-ui, sans-serif;
  color: var(--color-text);
}

6. Figma에서 콘텐츠 수정하기

이미지 교체

  1. 해당 카드 프레임 또는 이미지 사각형을 선택한다.
  2. 오른쪽 Fill에서 이미지 채우기 항목을 선택해 교체한다.
  3. 기본은 영역을 채우는 Fill 방식이다. Crop에서 얼굴이나 교회 간판이 잘리는지 확인한다.
  4. 카드에 색상 채우기와 이미지 채우기가 함께 있으면 색상 오버레이를 남긴다.
  5. 사진 위 색상 불투명도는 15%, 제목은 100%인지 확인한다.
  6. 현재 PC·모바일은 별개 프레임이므로 둘 다 교체한다. 한쪽 교체가 다른 쪽에 자동 반영되지 않는다.

텍스트 수정

텍스트 레이어를 선택해 제목·설명·주소를 수정한다. 레이어 이름이 과거 문구로 남아 있을 수 있으므로 실제 보이는 텍스트를 기준으로 확인한다. 글이 길어졌다면 모바일 줄바꿈과 높이도 확인한다.

팔레트 사용

도형이나 텍스트를 선택하고 Fill의 스타일 선택 기능에서 쉴만한교회 색상을 찾는다. 오버레이 15% 스타일과 메인 하늘색 100% 스타일을 혼동하지 않는다.

이미지 추출

사진이 배경 Fill로 들어간 카드 전체를 PNG로 내보내면 제목·오버레이까지 합쳐질 수 있다. 개발 자산은 가능하면 원본 사진을 사용한다. 로고는 벡터 레이어를 SVG로 추출하고 실제 웹에서 렌더링을 확인한다. 화면 전체 스크린샷을 홈페이지 배경으로 사용하지 않는다.

7. PC·모바일을 하나의 반응형 페이지로 통합하기

7.1 핵심 원칙

같은 URL, 같은 콘텐츠 데이터, 공통 컴포넌트를 사용하고 CSS가 화면 폭에 따라 배치를 바꾸게 한다.

  • /pc와 /mobile로 홈페이지를 복제하지 않는다.
  • PC 페이지 전체와 모바일 페이지 전체를 동시에 렌더링하고 하나를 숨기는 방식은 피한다.
  • 배너·말씀·카드·갤러리·푸터는 하나씩 구현한다.
  • 메뉴처럼 PC·모바일 인터랙션이 다른 부분만 별도 표현을 허용한다. 메뉴 데이터는 공유한다.
  • 폭 판단을 위해 JavaScript의 window.innerWidth를 매 렌더링마다 읽지 않는다. 레이아웃은 미디어 쿼리와 CSS Grid/Flex로 처리한다.
  • Figma 프레임의 좌표를 절대 위치로 그대로 옮기지 않는다.

7.2 권장 컴포넌트 구조

HomePage
├─ SiteHeader ← 공통 메뉴 데이터
│  ├─ UtilityLinks
│  ├─ DesktopNavigation
│  └─ MobileMenu
├─ HeroBanner
├─ ScriptureSection
├─ QuickLinksGrid ← 공통 카드 데이터 8개
│  └─ QuickLinkCard
├─ PhotoGallery ← 공통 게시글 데이터
│  └─ GalleryItem
└─ SiteFooter

7.3 브레이크포인트 제안

아래는 개발 시작값이다. Figma에 정의된 자동 전환 규칙은 아니다.

폭 헤더 카드 갤러리
0–767px 모바일 메뉴 2열 2개가 보이는 가로 스크롤
768–1199px 모바일 메뉴 유지 4열 3~4개가 보이는 가로 스크롤
1200px 이상 PC 메뉴 4열 6개가 보이는 목록

태블릿은 별도 시안이 없어 제안한 규칙이다. 긴 메뉴가 겹치면 PC 헤더 전환점을 올리거나 간격을 조정한다. 기기 이름 대신 실제 콘텐츠가 들어갈 수 있는 폭을 기준으로 결정한다.

7.4 섹션별 확정 치수와 구현 방향

영역 PC 1440 기준 모바일 390 기준 구현 방향
유틸리티 높이 45.5px 별도 상단 줄 없음 모바일 전체 메뉴에 포함
메인 헤더 높이 101px 높이 100px 로고·메뉴 반응형 전환
배너 높이 605px 높이 200px 이미지 cover, 중앙 크롭
말씀 높이 약 358px 약 328px 내용에 따른 자동 높이
카드 4열 × 2행, 카드 약 290×335px 2열 × 4행, 약 175×220px Grid, 행 높이 전환
카드 간격 10px 6px breakpoint별 gap
카드 영역 좌우 약 125px 17px PC max-width, 모바일 gutter
갤러리 이미지 약 240×160px 약 195×130px 동일한 3:2 비율
푸터 높이 약 369px 최신 높이 327px 내용에 따른 자동 높이

모바일 메뉴 시안은 헤더 76px, 홈페이지는 100px로 차이가 있다. 실제 구현에서는 메뉴가 열릴 때 로고가 갑자기 뛰지 않도록 홈페이지 100px 헤더에 맞추는 것을 제안한다. 전체 메뉴 화면 844px를 고정 높이로 하드코딩하지 말고 뷰포트와 콘텐츠 스크롤을 사용한다.

7.5 반응형 기본 CSS 예시

* { box-sizing: border-box; }
body { margin: 0; }
img { display: block; max-width: 100%; }
.container { width: min(1190px, calc(100% - 34px)); margin-inline: auto; }
.desktop-nav, .utility-links { display: none; }
.site-header { min-height: 100px; background: var(--color-header); }
.hero { position: relative; height: 200px; overflow: hidden; }
.hero > img { width: 100%; height: 100%; object-fit: cover; object-position: 50% 50%; }
.quick-links { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 6px; }
.quick-card {
  position: relative;
  display: grid;
  place-items: center;
  height: 220px;
  min-width: 0;
  padding: 8px;
  overflow: hidden;
  border-radius: 5px;
  isolation: isolate;
}
.quick-card__image { position: absolute; inset: 0; width: 100%; height: 100%; object-fit: cover; }
.quick-card.has-image::after { content: ""; position: absolute; inset: 0; background: var(--color-photo-overlay); }
.quick-card__title { position: relative; z-index: 1; font-size: 20px; text-align: center; }
.quick-card.has-image .quick-card__title { color: white; }
.quick-card:not(.has-image) { background: var(--color-placeholder); color: var(--color-card-text); }
.gallery-track { display: grid; grid-auto-flow: column; grid-auto-columns: 50%; overflow-x: auto; scroll-snap-type: x mandatory; }
.gallery-item { min-width: 0; scroll-snap-align: start; }
.gallery-image { width: 100%; aspect-ratio: 3 / 2; object-fit: cover; }
.gallery-placeholder { aspect-ratio: 3 / 2; background: #00a4f0; }
.gallery-item:nth-child(even) .gallery-placeholder { background: rgb(0 164 240 / 50%); }
.site-footer { background: var(--color-footer); color: var(--color-footer-text); overflow-wrap: anywhere; }

@media (min-width: 768px) {
  .quick-links { grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 10px; }
  .quick-card { height: 280px; }
  .gallery-track { grid-auto-columns: 25%; }
}
@media (min-width: 1200px) {
  .desktop-nav, .utility-links { display: flex; }
  .mobile-menu-button { display: none; }
  .site-header { min-height: 101px; }
  .hero { height: 605px; }
  .quick-card { height: 335px; }
  .quick-card__title { font-size: 28px; }
  .gallery-track { grid-auto-columns: calc(100% / 6); }
}

これはレイアウトの抜粋で、メニュー・カードごとの背景色・余白・リンク・画像の読み込み制御などは別途必要。overflow-x: hiddenをページ全体に付けてレイアウト不具合を隠さない。

HTMLのheadには次を入れる。

<meta name="viewport" content="width=device-width, initial-scale=1">

7.6 カード順序の違い

現在のFigmaではPCとモバイルで一部順序が違う。

順番 PC モバイル
1 예배안내 예배안내
2 주일설교 주일설교
3 목회칼럼 교회주보
4 교회주보 목회칼럼
5 목장소식 삶공부 이야기
6 삶공부 이야기 목장소식
7 다음세대 이야기 다음세대 이야기
8 새가족 등록 안내 새가족 등록 안내

공통 데이터는 하나로 유지하고 카드 ID별로 표시 순서를 지정한다. 아래는 현재 화면의 순서를 맞추는 예시다.

.quick-card[data-id="worship"] { order: 1; }
.quick-card[data-id="sermon"] { order: 2; }
.quick-card[data-id="bulletin"] { order: 3; }
.quick-card[data-id="column"] { order: 4; }
.quick-card[data-id="study"] { order: 5; }
.quick-card[data-id="groups"] { order: 6; }
.quick-card[data-id="nextgen"] { order: 7; }
.quick-card[data-id="newcomer"] { order: 8; }
@media (min-width: 768px) {
  .quick-card[data-id="column"] { order: 3; }
  .quick-card[data-id="bulletin"] { order: 4; }
  .quick-card[data-id="groups"] { order: 5; }
  .quick-card[data-id="study"] { order: 6; }
}

주의: CSS order는 시각적 순서만 바꿔 키보드 탐색·스크린리더 순서와 달라질 수 있다. 실제 배포 전 운영자와 공통 순서 통일 여부를 결정하는 것이 좋다. 카드 8개를 PC·모바일용으로 중복 렌더링하는 방식으로 해결하지 않는다.

8. 영역별 구현·운영 상세

메인 배너

  • 최신 외관 사진 한 장은 확정되어 있다. 현재 페이지 표시 4개는 디자인 요소이며 네 장의 이미지가 준비되었다는 뜻은 아니다.
  • 한 장만 운영하면 이전·다음 버튼과 페이지 표시는 숨기거나 실제 준비된 슬라이드 수와 맞춘다.
  • 여러 장이 준비되면 각각의 사진·대체 텍스트·선택적 링크를 데이터로 관리한다.
  • 이미지가 과도하게 늘어나거나 찌그러지지 않도록 object-fit: cover를 사용한다.
  • 모바일에서 간판이 잘리면 모바일 전용 object-position만 조정한다.
  • 자동 재생은 필수 요구사항이 아니다. 추가하면 정지 기능과 움직임 감소 설정을 고려한다.

말씀

  • 배지, 본문, 구절을 각각 편집 가능하게 유지한다.
  • PC에서 쓰던 강제 줄바꿈을 모바일에 그대로 강요하지 않는다. 컨테이너 폭에 따라 자연스럽게 줄바꿈한다.
  • 구절이 길어져도 다음 섹션과 겹치지 않도록 고정 높이를 피한다.
  • 현재 말씀은 참고 레이아웃에서 가져온 요한복음 13:34–35 문구다. 쉴만한교회의 실제 올해 말씀인지 게시 전 확인한다.

바로가기

  • 카드 전체를 의미 있는 링크 영역으로 만든다. 클릭 가능한 링크 안에 다른 버튼·링크를 중첩하지 않는다.
  • 이미지가 없으면 현재의 단색 배경을 사용한다.
  • 사진 위 흰 제목과 15% 오버레이를 유지한다. 밝은 사진에서 대비가 부족하면 임의로 전체 투명도를 바꾸지 말고 디자인 확인 후 보완한다.
  • 키보드 포커스가 보이게 하고 hover 효과는 터치 조작의 필수 조건으로 쓰지 않는다.

모바일 메뉴

  • 여닫기 버튼은 <button>으로 구현하고 접근 가능한 이름을 제공한다.
  • 열림 상태를 aria-expanded와 연결한다.
  • 모달 방식이면 배경 상호작용 제한, 포커스 이동·복원, Escape 닫기를 구현한다. 네이티브 <dialog> 또는 프로젝트의 검증된 모달 컴포넌트를 사용할 수 있다.
  • 화면 높이를 넘으면 메뉴 내부를 스크롤할 수 있게 한다.
  • PC 폭으로 전환되면 열린 모바일 메뉴를 닫고 스크롤 잠금을 해제한다.
  • 하위 메뉴 항목의 실제 목적지와 메뉴 펼침 동작을 구분한다.

포토갤러리

  • PC에는 이미지 영역 6개, 모바일에는 2개가 보이는 시안이다. 웹 데이터는 같은 목록을 사용한다.
  • 모바일에서 두 개만 데이터로 가져오는 것이 아니라 더 많은 사진을 가로로 탐색할 수 있게 한다.
  • 현재 자리표시 색상은 첫 번째 100% → 두 번째 50% → 반복이다. 배경색만 바꾸고 카드 전체 투명도를 바꾸지 않는다.
  • 실제 이미지가 들어오면 자리표시 색을 이미지로 교체한다. 갤러리 사진에 15% 오버레이를 덮는 요구는 아직 없다.
  • 제목이 길면 줄바꿈 또는 말줄임 규칙을 명확히 정하고 전체 제목에 접근할 수 있게 한다.
  • 실제 게시물 ID·제목·날짜·이미지·상세 주소를 함께 관리한다.

푸터

현재 보이는 텍스트는 아래와 같다. 실제 게시 전 운영자가 확인한다.

  • 담임목사: 김형욱
  • 주소: 경기도 용인시 기흥구 평촌2로 1번길 29, DRC센터
  • 전화: 031-282-4408
  • 팩스: 031-282-4408
  • 이메일: 쉴만한교회@gmail.com

이메일·팩스 등은 디자인 텍스트를 옮긴 값이며 실제 수신 가능 여부는 검증하지 않았다. 참고 교회의 연락처로 교체하지 않는다. 기존 SSL 인증마크는 실제 인증 상태·사용 권한을 확인한 후 서비스에 노출한다.

9. 개발자도구 스크립트 오류 처리 가이드

아직 오류를 확인하거나 수정한 상태가 아니다. 다음 순서로 실제 서비스에서 진단한다.

  1. 문제가 발생하는 정확한 주소, 브라우저, 화면 폭, 재현 동작을 기록한다.
  2. Console의 첫 번째 관련 오류와 전체 스택을 확보한다. 반복되는 후속 오류보다 최초 원인을 먼저 찾는다.
  3. Network에서 JS/CSS/이미지의 404, 인증 실패, CORS, 잘못된 MIME 응답을 확인한다.
  4. 오류가 서비스 코드, 외부 스크립트, 브라우저 확장 프로그램 중 어디에서 발생하는지 분류한다.
  5. 기존 프로젝트의 초기화 순서와 이벤트 리스너 중복 등록, 없는 DOM 접근, API 응답 예외 처리를 확인한다.
  6. 슬라이더를 쓴다면 초기화·해제 수명주기와 리사이즈 시 중복 인스턴스를 확인한다.
  7. 필요한 기능만 수정하고 Console 숨김, 오류 무시, 무조건적인 try/catch로 감추지 않는다.
  8. 수정 후 새로고침, 모바일 메뉴 열기·닫기, 화면 폭 변경, 카드 클릭, 갤러리 탐색을 다시 검증한다.
  9. 수정 내용과 재현·검증 결과를 기록한다. 실제 로그를 보지 않고 ‘모든 오류 해결’이라고 보고하지 않는다.

이전 참고 사이트의 오래된 플러그인 스크립트를 통째로 복사할 필요는 없다. 기존 프로젝트 기술 스택과 이미 사용하는 도구를 먼저 확인하고 변경 범위를 정한다.

10. 구현 순서

  1. 저장소, 실행 명령, 프레임워크, 라우팅, 기존 CSS, AGENTS.md 등 프로젝트 지침 확인
  2. 현재 Figma 화면과 이 문서의 차이 확인
  3. 원본 이미지·로고 확보 및 프로젝트 자산 경로 정리
  4. 색상·서체·콘텐츠 데이터를 공통 정의
  5. 모바일 기준 공통 섹션 구현
  6. 미디어 쿼리로 태블릿·PC 배치 확장
  7. 실제 메뉴·게시판·갤러리 목적지 연결
  8. 모바일 메뉴와 갤러리 기능 구현
  9. 스크립트 오류 재현 및 필요한 수정
  10. 화면 비교, 키보드·터치 테스트, 빌드 확인

이미지가 미정인 영역이나 연결할 페이지가 없으면 임의 콘텐츠로 채우지 말고 미정 목록에 기록한다.

11. 검수 체크리스트

디자인

  • 최신 메인 배너 사진이 적용되어 있다.
  • 주일설교·목장소식·다음세대 이야기에 올바른 이미지가 있다.
  • 세 카드의 색상 오버레이만 15%이며 사진·제목은 100%다.
  • 다른 카드에 임의 사진이 추가되지 않았다.
  • 갤러리 자리표시가 100%·50%로 번갈아 보인다.
  • PC 4열, 모바일 2열이며 카드 제목이 잘리지 않는다.
  • 로고, 하늘색 계열, Noto Sans KR을 유지한다.

반응형

  • 360 / 390 / 430 / 768 / 1024 / 1200 / 1440px에서 확인한다.
  • 브레이크포인트 바로 전후에서도 확인한다.
  • 가로 넘침과 메뉴 겹침이 없다.
  • 모바일 메뉴가 화면 폭 변경 후에도 정상 동작한다.
  • 긴 제목·주소·이메일, 텍스트 확대 시에도 레이아웃이 유지된다.
  • 모바일·PC가 같은 데이터와 목적지 URL을 사용한다.
  • 시각 순서와 키보드 탐색 순서의 차이를 검토했다.

기능·품질

  • 모든 링크의 목적지가 확정되어 있다.
  • 사진이 한 장인 배너에 동작하지 않는 슬라이드 버튼을 노출하지 않는다.
  • 메뉴를 키보드로 열고 닫을 수 있고 포커스가 복원된다.
  • 정보성 이미지에는 적절한 대체 텍스트가 있다.
  • 첫 배너는 불필요하게 지연 로딩하지 않고, 아래쪽 사진은 적절히 지연 로딩한다.
  • 이미지에 크기 또는 비율을 지정해 로딩 중 레이아웃 이동을 줄인다.
  • Console 및 Network의 서비스 관련 오류를 확인했다.
  • 실제 프로젝트의 빌드·린트·필요한 기능 테스트를 통과했다.
  • 실제 교회 정보와 올해 말씀을 운영자가 확인했다.

12. 다른 Codex에게 전달할 작업 요청 예시

아래 문구와 함께 이 Markdown 파일, Figma 링크, 프로젝트 저장소를 전달한다.

첨부한 ‘쉴만한교회_사용가이드_개발인수인계.md’를 읽고 현재 저장소를 확인한 뒤,
Figma의 메인 PC·모바일 디자인을 하나의 반응형 홈페이지로 구현해줘.

Figma 파일: https://www.figma.com/design/xUVDANZTLthZgwqFmXpHZk
PC: node-id=86-2
모바일: node-id=86-136
모바일 메뉴: node-id=86-292
컬러 팔레트: node-id=99-2

PC와 모바일 전체 페이지를 복제하지 말고 공통 컴포넌트와 데이터,
CSS Grid/Flex 및 미디어 쿼리로 통합해줘.
최신 배너 사진, 카드별 사진, 카드 오버레이 15%,
갤러리 자리표시 100%·50% 반복을 유지해줘.
이미지가 없는 곳에는 임의 이미지를 넣지 말아줘.
실제 링크·API·이미지 파일이 없는 항목은 확인 가능한 미정 목록으로 남겨줘.

현재 프로젝트 구조와 기존 구현을 먼저 확인하고 변경해줘.
개발자도구 오류는 실제 로그로 원인을 확인해 수정하고,
360~1440px 화면 검증 및 프로젝트 빌드 결과를 보고해줘.
배포는 요청하지 않았으므로 구현 결과를 로컬에서 검토할 수 있게 준비해줘.

13. 구현 참고 문서

이 문서의 코드와 브레이크포인트는 현재 프로젝트에 맞춰 조정한다. 참고 문서 링크는 API 확인용이며, 실제 프로젝트에서 실행 검증을 대신하지 않는다.

(5-5/5)