eomsangdonandClaude Opus 5
eb30b774f8
- `docs/` 를 .gitignore 에서 빼 git 추적 대상으로 전환 (위키·완료 이력·검증 기록) - `docs/raw/PLAN.md` · `docs/raw/OWNERS.md` 를 저장소 최상위로 이동 후 .gitignore 에 등록 — 창끼리 공유하되 저장소에는 안 올리는 장부 - 살아 있는 경로 참조 7개 파일 정정 (아카이브 107건은 그때 사실이라 그대로 둠) - graphify 날짜별 산출물(`docs/wiki/graphify-out/20*/`) 제외 — `graphify update` 가 다시 만듦 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
20 lines
870 B
Markdown
20 lines
870 B
Markdown
---
|
|
type: concept
|
|
status: draft
|
|
related_pages: ["[[architecture/shared_resources]]"]
|
|
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 모델(예: 공통 페이지네이션, 공통 좌표 타입)은 확인되지 않음. 발견 시 이 페이지에 추가.
|