docs: add project docs and test updates

This commit is contained in:
taekyoungc
2026-04-08 00:23:55 +09:00
parent 06fedc866a
commit 06aa401048
238 changed files with 8373 additions and 148 deletions

View File

@@ -0,0 +1,74 @@
# 결정 필요: 기능 명세 보완
> 회의 내용 참고·기능목록에서 **"확인 필요"·"조합"·"구청마다"** 등으로 남은 사항.
---
## 1. 전화 주문·구청별 기본 단위 (회의 내용 참고)
**자료**: `종량제_개발목록_20260127(회의 내용 참고).csv`
- "**주문시 구청마다 기본 단위가 달리 설정** 될 수 있어야 함"
- "**조합 방식 확인 필요** - 전화 주문 관리"
**결정 필요**:
- [ ] "기본 단위" 의미: 주문 수량 입력 시 **박스/팩/낱장** 중 기본 선택 단위를 구청(지자체)별로 다르게 둘지.
- [ ] 해당 설정을 저장할 **테이블·컬럼**: 지자체(또는 구/군)별 설정 1행에 "기본 주문 단위" 등.
- [ ] "조합 방식": 전화 주문과 웹/앱 주문의 **처리 흐름 통합** 여부, 조합(패키지) 상품 존재 여부 등 — 요구사항 구체화 필요.
---
## 2. 봉투 단가 (회의 내용 참고)
- "**봉투단가는 지자체마다 정해져있지는 않음**"
- "현재는 구청으로 부터 7원 받음" 등
**결정 필요**:
- [ ] 단가 테이블 구조: **지자체별**로 다를 수 있게 할지, **공통 단가 + 지자체별 오버라이드** 구조로 할지.
- [ ] "지자체마다 정해져있지는 않음"을 **기능으로 어떻게 반영**할지(기본 단가만 사용, 지자체별 단가 선택 사용 등).
---
## 3. 대행소·권한 (회의·기능목록)
- "**대행소 : ex 달성군은 읍, 면에서 판매**"
- "**권한별 메뉴 접근 제어 필요**"
- 재고 현황은 "**로그인 한 구/군과 대행소**의 봉투 및 스티커 종류별 재고량 표시"
**결정 필요**:
- [ ] **대행소**가 지자체(구/군)와 동급인지, 하위인지(구/군 소속 대행소). 재고·판매 단위가 "구/군"과 "대행소" 둘 다 필요한지.
- [ ] 메뉴 접근 제어: **메뉴별로** super admin / 지자체관리자 / 지정판매소 / 일반 **노출 여부**를 DB(메뉴·권한 테이블)로 관리할지, 코드로만 제어할지.
---
## 4. 접수·배달일·수령 (회의 내용 참고)
- "**접수는 당일, 배달일은 익일로 표시**"
- "**창구 수령인 경우 '수령' 처리** 가능해야함"
**결정 필요**:
- [ ] 주문(전화 접수) 테이블에 **접수일**, **배달일**, **수령 구분**(배달/창구수령) 등 컬럼 정의.
- [ ] "수령" 처리 시 재고·정산 반영 방식 일치 여부.
---
## 5. 가상계좌·입금 조회 (회의·기능목록)
- "**가상계좌 입금 실시간 조회** 가능해야함 - **헥토파이낸셜 연계?**"
- 지정판매소마다 할당된 가상계좌 표시
**결정 필요**:
- [ ] 가상계좌·입금 조회를 **헥토파이낸셜(또는 특정 PG사)** API로 할지, 수동 입력만 할지.
- [ ] 가상계좌를 **지정판매소별**로 저장할지(기능목록에는 "지정판매소마다 할당된 가상계좌"로 나옴).
---
## 6. 기타
- **무료용 불출**: "구청 있는 구청 없는 구청 있기 때문에 구분 필요" — 구청 유무에 따른 **화면/프로세스 분기** 정의 필요.
- **인쇄 시 결재란**: "인쇄 시 결재란 출력되어야 함" — 어떤 메뉴/리포트에 적용할지, 레이아웃 정의.
- **블록 해싱·블록 저장**: 발주에 "블록 해싱값", "블록에는 … 저장" — **블록**을 별도 테이블로 둘지, 발주 테이블 컬럼만으로 둘지, Phase 1에서 제외할지.
---
**정리**: 위 항목은 **업무·정책·외부 연동** 쪽 결정이 필요하므로, 실무·발주처와 정리 후 기능 명세·DB 설계에 반영하는 것이 좋음.