작성일: 2026-08-17
작성 기준: 현재 작업 세션의 코드·자동 테스트·공공데이터포털 실응답 검증
이 프로젝트는 현재 세션에서 Manus Lite 호환 방식으로 수정·검증했다. 모델 전환 기능은 이 작업 세션에서 직접 제어할 수 없으므로, 이후 Manus 1.6에서 재현 가능한 명세·테스트·검증 조건을 이 문서에 남긴다. 외부 API 키 값은 이 문서, 소스 코드, 콘솔 출력에 기록하지 않으며 암호화된 관리자 설정 레코드에서만 읽는다.
| 분석 영역 | 승인된 서비스·엔드포인트 | 앱의 현재 호출 방식 | 검증 결과 | 설계상 주의점 |
|---|---|---|---|---|
| 법규 | https://apis.data.go.kr/1613000/arLandUseInfoService/DTarLandUseInfo |
areaCd, ucodeList, landUseNm을 XML 응답으로 요청 |
HTTP 200 | PNU 단독 조회가 아니다. 지역지구 코드와 행위명은 토지이음 원문·코드표로 확인해야 한다. |
| 에어코리아 측정소 | https://apis.data.go.kr/B552584/MsrstnInfoInqireSvc/getMsrstnList |
주소로 측정소 후보를 조회하는 서버 절차 추가 | HTTP 200 | 주소명과 실제 측정소명은 다를 수 있다. |
| 에어코리아 대기오염 | https://apis.data.go.kr/B552584/ArpltnInforInqireSvc/getMsrstnAcctoRltmMesureDnsty |
확인된 측정소명으로 일별 대기질 요청 | HTTP 200 | 대지 직접 관측값이 아니라 인근 관측소 값이다. |
| 광주 버스 | https://apis.data.go.kr/6290000/gj_bis |
정류장·도착정보 호출을 HTTPS로 통일 | HTTP 200 | 광주권 범위이며 실시간 정보는 시점 의존적이다. |
| 사회복지시설 | https://apis.data.go.kr/B554287/sclWlfrFcltInfoInqirService1 |
관할 시·군·구 기준 XML 명부 조회 | HTTP 200 | 원천 데이터의 좌표가 보장되지 않으므로 지오코딩 검수 전 반경·마커 분석에 사용하지 않는다. |
에어코리아 오류 원인과 조치: 기존 화면은 “광주”처럼 행정구역명을 측정소명으로 넣을 수 있었다. 이제 기본 입력을 비우고, 실제 측정소명(예:
서석동,운암동)을 요구하도록 바꿨다. 측정소 목록 API를 별도 서버 절차로 분리해, 주소 기반 후보 조회 후 정확한 측정소명을 선택·입력하는 흐름으로 확장할 수 있다.
토지이용규제는 이전의 PNU 기반 호출을 제거했다. 사용자 제공 info_arLandUseInfoService.hwp의 최신 명세에 따라 DTarLandUseInfo 메서드와 areaCd·ucodeList·landUseNm의 세 입력으로 전환했다. 해당 API는 행위제한정보의 보조 근거일 뿐이며, 자동 결과를 법적 인허가 판정으로 사용해서는 안 된다.[1]
대지 중심과 반경은 생활권·주변 맥락 조사를 위한 보조 범위로 유지한다. 사용자는 지도에서 폴리곤을 직접 그린 후 정점을 수정·삭제하고 저장할 수 있다. 경계는 WGS84 GeoJSON으로 저장되며, 서버는 최소 세 개의 고유 정점·닫힌 링·위도·경도 범위를 검증한다. 화면에는 정점 수, 면적, 둘레, 중심 좌표가 표시된다.
지도 SDK는 별도 인증 프록시 구성의 영향을 받는다. 이전 개발 로그에서는 지도 프록시 인증 오류가 발견되었으므로, 이 문서 작성 시점에는 사용자 요청대로 브라우저·미리보기 시각 검증을 보류했다. 이는 대지 경계 저장 로직이나 공공 API 키의 성공 여부와 분리해서 점검해야 한다.
| 서비스 | 승인 상태 | 현재 처리 | 보류 근거 | 다음 구현 위치 |
|---|---|---|---|---|
| 광주교통공사 역 인근 주차장 API | 승인됨 | 검증된 2022-12-08 CSV 58건을 거리 계산에 사용 | 현재 작업대에는 검증된 CSV가 있어 서비스 메서드 명세를 추정 호출할 필요가 없다. | 주차 데이터 어댑터·기준일 관리 |
| 전국도시공원정보표준데이터 | 승인됨 | 미연결 | 도시공원 API의 요청 필드·페이지네이션을 명세 기준으로 추가 검토해야 한다. | 녹지·외부공간 레이어 |
| 상가(상권)정보 API | 승인됨 | 미연결 | 설계 질문과 무관한 업종 전수 나열을 피하고, 활성 1층·생활권 분석에 필요한 경우만 켠다. | 생활권·상권 레이어 |
이 항목들은 불필요해서 제외한 것이 아니라, 현재 사용자 흐름의 핵심인 법규·환경·교통·복지·주차와 비교해 아직 데이터 계약 및 공간 해석 기준을 확정하지 않았기 때문에 보류한 것이다. 서비스 승인과 앱 내 분석 연결은 별도 상태로 관리자 설정에 표시한다.
| 순서 | 점검 항목 | 기대 결과 | 실패 시 우선 조치 |
|---|---|---|---|
| 1 | pnpm check 및 pnpm test |
타입 오류 없음, 현재 14개 테스트 통과 | 최근 API 계약·GeoJSON 검증 변경부터 비교 |
| 2 | 공공데이터포털 순차 검증 스크립트 실행 | 위 5개 서비스가 HTTP 200 | 동시 호출을 피하고, 서비스별 활용승인·정확한 입력값을 재확인 |
| 3 | 관리자 설정에서 키 마스킹·교체·비활성화 확인 | 키 원문이 화면·로그에 노출되지 않음 | 암호화 저장·감사 로그 경로 점검 |
| 4 | 로그인된 브라우저에서 지도 SDK 확인 | 지도 로드, 주소 검색, 폴리곤 그리기·정점 편집·저장 | 지도 프록시 토큰·서버 중계 응답·콘솔 오류를 순서대로 확인 |
| 5 | 법규·환경 수집 화면 확인 | 법규는 3개 입력, 환경은 실제 측정소명 입력 | 과거 PNU 입력 UI 또는 “광주” 기본 측정소명이 남아 있지 않은지 확인 |
| 6 | 실제 대지 시나리오 1건 저장 | 경계 GeoJSON, 면적·둘레, 분석 스냅샷, 출처·한계가 프로젝트 이력에 기록됨 | 대지 저장 이후 데이터 수집 순서를 다시 점검 |
[1] 사용자 제공 문서, info_arLandUseInfoService.hwp, 2024년 2월 토지이용규제 행위제한정보 표준연계모듈 연계 가이드.
[2] 사용자 제공 공공데이터포털 승인 정보, 2026-08-17 메시지.
[3] 사용자 제공 문서, 한국환경공단 에어코리아 OpenAPI 기술문서_20260630.zip.
[4] 사용자 제공 문서, OPENAPI활용가이드_광주버스v1.0.docx.
[5] 사용자 제공 문서, IROS4_OA_DV_0401_OpenAPI활용가이드_16.한국사회보장정보원(사회복지시설정보)_v2.4.docx.