[이슈 #42 자동] [BE] 품목/재고 CRUD 실엔드포인트 전환 + 품목마스터 canonical 노출

[choigod1023]

Description

품목 마스터를 "data canonical" 진입점으로 노출하는 routers/item_master.py 를 추가했습니다. 표준품목 실데이터(Neon Postgres)를 GET /item-master(검색·품목군·페이지) 로 서빙하고, GET /item-master/{code} 상세와 GET /item-master/{code}/stock(품목별 전국 기관 재고, 실데이터 — mock 없음)을 제공합니다. 응답 메타(canonical)에 목표 규모(101,546)·현재 규모·전환 대기 여부를 실어 FE 가 전환 상태를 인지하게 했습니다. 인증·인가는 require_role("CENTRAL") 을 재사용합니다.
Related #42

Type

• 새로운 기능
• 버그 수정
• UI/UX 변경
• 리팩토링
• 의존성 추가/수정

Screenshots

Before	After

To Reviewer

이슈 #42 자동 구현 초안입니다 — 검토 후 머지해주세요.

이번 초안은 조회(READ) 실엔드포인트 전환에 한정한 최소 범위입니다:

• GET /item-master, /item-master/{code}, /item-master/{code}/stock 를 실데이터 소비로 추가.
• 재고 뷰는 기존 inventory_policy_rows(실데이터)를 표준코드로 필터링해 소비 — mock 아님.

다음은 선행 의존이 있어 이번 자동 초안 범위에서 제외했습니다(검토 후 별도 진행 권장):

• 쓰기 CRUD(POST/PATCH/DELETE): 현재 db/queries.py 는 읽기 전용 계층입니다. 쓰기는 스키마 쓰기 경로·트랜잭션 설계가 필요해 최소 자동 PR 범위를 벗어납니다.
• 카탈로그 17,148 → data canonical(101,546) 실제 교체: 공용 스키마 확정(DB [DB] 공용 스키마 확정 (물품마스터·기관코드·family/규격·메타코드 3계층 FK) #38)과 data 적재가 선행돼야 합니다. 이번엔 진입점과 전환-상태 메타만 마련했고 swapPending: true 로 표시합니다.

py_compile 로 문법 검증했으며, 실제 DB 응답은 프리뷰 배포에서 확인 부탁드립니다.

PR Checklist

• Commit Message Convention을 준수했습니다.
• Code Convention을 준수했습니다.
• 변경한 기능이 잘 동작하는지 테스트했습니다.

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
backend	Ready	Preview	Aug 7, 2026 2:33am

[choigod1023]

보류 (닫지 않음). DB 스키마 확정(#38) 선행 필요.

제목은 'CRUD 실엔드포인트 전환'이지만 실제로는 기존 standard_items/inventory_policy_rows를 감싼 READ 파사드에 swapPending:true·canonical 목표(101,546) 메타만 붙인 상태입니다. 쓰기 CRUD와 canonical 실제 교체는 #38(공용 스키마 확정)이 선행돼야 합니다.

방향과 배치되진 않으나 현 상태의 실질 가치가 낮고 선행 의존이 미해결입니다.

→ 재개 조건: #38 스키마 확정 후 재평가. 그때까지 Draft 유지.