PostGIS 공간 테이블 설계 가이드

무엇을 해주나

• GEOMETRY vs GEOGRAPHY 선택 기준을 비교표와 함께 제시해, 지역 데이터/전 지구 GPS 데이터에 맞는 타입을 고르게 합니다.
• SRID(좌표계) 규칙: 4326(WGS84) 저장 + 측정 시 UTM 등으로 변환, SRID 혼용 금지, 제약조건으로 SRID 강제.
• 공간 인덱스 선택 가이드: GiST(기본), 대용량 append-only 테이블용 BRIN, 포인트 전용 SP-GiST의 장단점과 생성 SQL.
• 바로 쓰는 테이블 설계 예시: POI, 부동산 필지, GPS 트래킹, 서비스 권역.
• 성능 패턴과 안티패턴: ST_DWithin 사용, && 바운딩박스 선필터, 인덱스 컬럼에 함수 사용 금지, 생성 컬럼 활용.
• 데이터 검증: ST_IsValid/ST_MakeValid, 좌표 범위 체크 제약, 파라미터 바인딩으로 SQL 인젝션 예방.

이런 분께 추천

• PostgreSQL + PostGIS로 배달권역, 매장 찾기, 차량 추적 같은 위치 기반 서비스를 만드는 백엔드 개발자
• 공간 쿼리가 느려서 인덱스 전략을 재검토해야 하는 데이터 엔지니어
• GIS 데이터를 처음 스키마로 옮기는 팀 (경도·위도 순서 같은 함정 회피)

활용 예시

1. "반경 1km 내 음식점 검색 API용 테이블을 설계해줘" → GEOGRAPHY(POINT,4326) + GiST 인덱스 + ST_DWithin 쿼리 제안.
2. "필지 폴리곤 면적을 미터로 계산하고 싶다" → 4326 저장 후 ::GEOGRAPHY 캐스팅 생성 컬럼 또는 UTM 변환 방식 안내.
3. "GPS 로그가 1억 행인데 인덱스가 너무 크다" → GEOMETRY 컬럼 + BRIN(pages_per_range) 대안과 트레이드오프 설명.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/timescale/pg-aiguide/HEAD/skills/design-postgis-tables/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 timescale/pg-aiguide 의 skills/design-postgis-tables 폴더를 내 ~/.claude/skills/design-postgis-tables/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.