---

author: yunze last_modified_by: yunze

School Design Trends · 경기도 학교 설계 동향

경기도의 학교 설계 사례를 모아, 최근 3년의 변화와 시·군·구별 분포를 근거와 함께 살펴보는 웹 도구입니다.

웹 화면 바로 열기 →

키워드별 3D 학교 배치 · 2026-10-28

Yunze 이슈 #46의 개선으로 키워드마다 건물 형태와 배치가 다른 세 가지 가상 학교를 비교할 수 있습니다. 외부학습공간의 테라스 중정형은 낮은 교사동·중정·데크·계단형 야외 교실, 지역공유의 학교·주민시설 분리형은 높은 후면 교사동과 전면 도서관·체육관·광장, 가변학습공간의 학습동 군집형은 네 학습동·중앙 공용홀·연결 통로·이동식 구획으로 설명합니다.

같은 가상 부지와 카메라를 사용하며 키워드를 바꿔도 회전·확대·투과 값은 유지합니다. 처음에는 전체 외관을 불투명하게 보여 주고, 내부 투과는 각 배치에서 지정한 외피에만 적용합니다. 형상은 직접 만든 설명용 대안이며 자료 학습·자동 생성·실제 학교 BIM 재현이 아닙니다. 이번 변경의 전체 테스트 273개, 공간 모델 검사 18개가 통과했고 세 SVG를 렌더링해 형태 차이를 확인했습니다. 브라우저의 수동 키워드 전환·모바일 조작은 이번 검증에 포함되지 않았습니다. 공간 모델 안내와 검증 범위에 기록하며 실제 배포 확인은 PR #47 댓글로 남깁니다.

공식 데이터 연결 · 2026-10-28

나이스·학교알리미·경기데이터드림·건축HUB·KOSIS의 로컬 수집기를 제공합니다. 나이스는 인증키로 경기 응답 2,667행을 모두 받았고, 2,660행을 정규화했습니다. 같은 학교 코드가 쓰인 2행과 코드가 없는 개교 예정 학교 5행은 원문을 보존해 식별 검토 대상으로 분리했습니다. 작품집 166개 사업 중 정확한 이름이 일치하는 후보는 8건이며, 학교·주소의 동일성 검토와 작품집 연결은 아직 완료되지 않았습니다.

연결 대상	현재 확인한 범위	다음 단계
나이스	인증 조회 2,667행 · 정규화 2,660행 · 검토 보류 7행	8개 이름 일치 후보와 약칭·가칭·변경 학교명의 주소 대조
학교알리미	705개 인증 요청 · 응답 12,740행 · 정규화 12,736행 · 분류 검토 보류 4행	학교별 항목과 나이스·작품집의 동일성 대조
경기데이터드림	경기 31개 시·군 응답 3,421행 · 정규화 3,419행 · 중복 검토 보류 2행	단일 이름 후보 17곳·복수 후보 2곳의 동일성 대조, 중복 원문 검토
건축HUB	인증키 발급·활용신청 승인 후 학교 2곳의 2필지 조회 · 건물 후보 3행	학교·동의 동일성 대조, 사용승인일 누락 보완, 조회 필지 확대
KOSIS	공식 대량자료 다운로드로 31개 시·군·6–17세·2023~2025년 12월의 1,116행 수집	비교 화면 연결·경계 변화 검토. API 인증키는 미발급

건축HUB는 군포초 조회 필지에서 A·B·C동 후보 3행을 받았고 가남초 조회 필지는 0행이었습니다. 세 행 모두 사용승인일이 없어 연령을 계산할 수 있는 건물은 아직 0행입니다. 자료 생성일을 준공일로 대신하지 않으며, 한 필지의 빈 응답을 학교 건물 전체가 없다는 뜻으로 해석하지 않습니다. KOSIS의 1,116행은 31개 시·군 × 12개 연령 × 3개 12월 시점의 관측 셀이며 인구 합계가 아닙니다. 수집 방법은 공식 파일 다운로드이고 인증키 API 호출과 구분합니다.

학교알리미의 현재 시험 명령은 1개 시군구를 요청하며 225개 표본 레코드를 확인했습니다. 초기의 시도 단위 시험 300개 레코드와 요청 범위가 다르고, 어느 쪽도 고유 학교 수가 아닙니다. 구현과 실제 조회 범위는 PR #45에 기록하며, 아래의 2026-10-19 개발 이력과 구분합니다.

npm run data:connect -- status로 상태를 확인하고 기관별로 수집할 수 있습니다. 키와 수집 원본·연결 후보는 로컬 비공개 폴더에 보관하며, 화면에는 각 기관의 연결 상태를 표시합니다. 기존 166건과 학교·사무소를 자동 합치거나 시험 응답을 전체 통계로 사용하지 않습니다. 키 발급부터 연결까지

KOSIS 공식 파일 방식은 다음과 같이 명시적으로 선택합니다. API 실패 시 자동으로 이 방식으로 바꾸지 않습니다.

npm run data:connect -- kosis --bulk --config data/config/kosis-population.example.json

연결 구현은 통합 이슈 #43과 PR #45, 원시 응답의 중복·식별 문제와 결측 검토는 자료 품질 이슈 #44에서 관리합니다. 실제 학교·사무소 동일성과 건물 사용승인일 검토가 남아 있어 공식 자료 연결 #40도 열어 둡니다. PR #45의 자동 테스트는 270개 통과·실패 0이며 당시 검사 파일 121개에서 설정된 인증키 4개의 값 노출은 없었습니다. 상세 검증 기록을 제공하며, 실제 배포 커밋과 공개 화면 확인 결과는 PR #45 댓글에 기록합니다.

처음 열면 경기도교육청 설계공모 작품집 2023·2024·2025의 당선작 166건을 볼 수 있습니다. 지역·학교급·수록연도로 사례를 찾고, 사업 규모와 설계 개념, 출처와 검수 메모를 확인합니다. 연도별 키워드를 가상 학교의 3D 공간 개념도와 연결해 살펴볼 수도 있습니다.

자료는 수작업·AI 보조 입력과 직접 작성한 요약이며, 사람의 원문 검수가 필요합니다. 경기 작품집에 실린 당선작 표본으로 학교 외 교육시설·유치원·관사 등도 포함합니다. 경기도 전체 사업을 빠짐없이 집계한 통계나 준공 실적이 아닙니다. 기능 확인용 가상 자료도 선택할 수 있습니다.

위 주소는 다른 PC에서도 열립니다. 127.0.0.1 주소는 해당 PC에서 미리보기 서버가 실행 중일 때만 사용할 수 있습니다. 저장소의 index.html은 웹페이지 소스이므로 파일을 더블클릭하기보다 온라인 주소 또는 아래 로컬 서버를 이용하세요.

공개 배포 상태 · 2026-10-19

PR #42의 경기도 지도·사례 화면·3D 개선을 main에 통합해 GitHub Pages로 공개합니다. 저장소와 웹 화면은 로그인 없이 볼 수 있습니다. 기능 공개와 자료 확보·검수 완료는 구분합니다.

공개 화면의 기능	현재 범위	담당 이슈
경기도 지도 탐색	31개 시·군과 24개 일반구, 마우스·키보드 팝업, 지도와 결과의 나란한 배치, 공통 필터·내보내기 연동	Yunze #38
사례와 연도별 화면 정리	긴 설명은 상세로 이동하고 카드 요약을 줄임. 학교·시설 9건의 확인된 도판 페이지를 공식 작품집 뷰어로 표시	Yunze #39
공식 사무소·건물 자료 연결 준비	경기도 사무소 API 표본 5건 조회, 전체 조회·건축물대장 수집 도구와 인증키 발급 안내. 실제 연결·검수는 남아 있음	Yunze #40
3D 전체 외관과 내부 보기	불투명 외관을 기본으로 표시하고 별도 투과 슬라이더·전체 외관 복귀 버튼 제공. 면이 잘못 가려지던 깊이 계산 수정	Yunze #41

배포 대상의 자동 테스트 193개가 통과했습니다. 공식 뷰어 9건도 확인했습니다. 이미지 파일을 복사해 배포하거나 개별 도판의 재사용 권한을 확인한 것은 아닙니다. API 인증키·전체 조회·자료 동일성 검수, 실제 이미지 이용 허가는 후속 작업입니다. 구현 검증 기록

지도 #38과 3D 외관·투과 #41은 구현 완료입니다. 추가 이미지 연결 #39와 공식 자료의 전체 수집·검수 #40은 진행 중으로 유지합니다. 인증키는 공개 사이트에 입력하지 않고 로컬 설정 안내에 따라 보관합니다.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗