260715_0

docs/wiki/concepts/schema_common.md

@@ -0,0 +1,19 @@
+---
+type: concept
+status: stable
+related_pages: []
+last_updated: 2026-07-12
+source: raw/guidelines/backend.md
+---
+
+# 공통 스키마 (Pydantic 요청/응답 규칙)
+
+## 검증 원칙 (backend.md 4절)
+- 모든 JSON 요청은 라우터 진입 전 Pydantic 모델로 타입·범위 검증.
+- 모든 지형/메쉬 연산은 `try-except` 필수.
+- 에러 응답 표준 포맷: `{"status": "error", "message": "원인"}` — 전 라우터 공통, 프론트도 동일 포맷 기대.
+
+## 명명 규칙
+파일명 `[폴더명]_Schema.py`, 페이지 폴더 내부 배치 (전역 공유 스키마 폴더 없음 — 필요 시 여기에 항목 추가).
+
+> 현재 raw 자료에서 페이지 간 공유되는 구체적 Pydantic 모델(예: 공통 페이지네이션, 공통 좌표 타입)은 확인되지 않음. 발견 시 이 페이지에 추가.