- 새 모듈 app/modules/inout(/inout/, 권한키 inout) + 새 DB inout_db(사용자 승인, scripts/sql/inout_db_init.sql — 멱등). - 발주 담당이 공장에 발주서(PO-YYMMDD-NN, 제품 = itemcode_db 단품만 — 검색 + 저장 때 서버 재확인), 입고 담당이 물류에 들어온 수량을 여러 번 나눠 입력 → 품목별 발주·입고·미입고, 진행률, 입고 예정일 지연. - 미입고 현황: 제품별 합계 · 발주별(예정일 순) · 초과 입고. 잔량 종결/풀기, 입고 없는 발주 취소, 입고 기록 지우기. - 초과 입고: 확인 화면(409, 입력 유지) 후 [초과 입고로 저장] — 트랜잭션 안에서 발주서 잠그고 판단, Enter 는 일반 저장. - 옵션(ERP 관리자): 공장 목록, 발주 담당·입고 담당 지정(inout_roles). 관리자는 둘 다. - 상태는 저장하지 않고 누적 입고로 계산(store.order_status). 이카운트 "발주 대비 미입고"·Odoo 분할 입고/종결 참고. - 테스트: 순수 로직, 실제 PostgreSQL(앱 계정 inout_app — 권한 포함), 실제 앱 화면 흐름(권한별). 문서 INOUT_MODULE.md 등. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
6.8 KiB
입출고 관리(inout) 모듈
app/modules/inout/· DBinout_db· URL/inout/· 권한키inout· 2026-10-16 신설
본사가 공장에 제품 제작 발주를 넣고, 공장 물건이 물류에 입고될 때마다 입고 수량을 입력해서 발주한 제품이 다 들어왔는지, 미입고(덜 들어옴)·초과 입고(더 들어옴)가 있는지 관리한다.
1. 참고한 상용 프로그램
| 프로그램 | 가져온 것 |
|---|---|
| 이카운트 ERP | 입고(구매입력)를 발주서를 불러와서 처리(발주번호 + 품목코드가 기준), 발주 대비 미입고 현황(거래처별·품목별) |
| Odoo | 한 발주를 여러 번 나눠 입고, 덜 들어온 잔량은 "나중에 받기" 또는 "더 안 받음(종결)" 선택, 초과 입고는 확인 후 허용 |
2. 흐름과 상태
발주(open) ──입고 일부──▶ 부분입고(partial) ──남은 것 다 입고──▶ 입고완료(done)
│ │ └─발주보다 많이──▶ 초과입고(over)
│ └─[잔량 종결]──▶ 종결(closed) ─[종결 풀기]─▶ 원래 상태
└─[발주 취소](입고 기록 없을 때만)──▶ 취소(cancelled)
- 상태는 저장하지 않고 품목별 누적 입고로 계산한다(
store.order_status,store.line_status) — 어긋날 수 없다. - 품목 상태: 미입고 / 부분입고 / 입고완료 / 초과입고. 발주서는 하나라도 남으면 부분입고(초과가 섞여 있어도).
- 미입고 현황(
/inout/pending)은 종결·취소가 아닌 발주의 남은 수량만 — 제품별 합계, 발주별(입고 예정일 순, 지난 것 빨강), 초과 입고 목록. - 초과 입고: 입고 저장 때 발주를 넘는 품목이 있으면 저장하지 않고 확인 화면(409, 넣은 숫자 유지) → 초과 입고로 저장.
판단은 DB 트랜잭션 안에서 발주서 행을 잠그고(
FOR UPDATE) 누적 입고를 다시 읽어 한다 — 동시에 입고해도 확인을 건너뛰지 않음. Enter 키는 숨은 기본 버튼(일반 저장)으로 가게 해 확인 없이 초과가 저장되지 않게 했다. - 발주서 고치기: 입고된 품목은 뺄 수 없다(입고 기록이 사라지므로) — 수량은 바꿀 수 있다(입고보다 줄이면 초과로 보임).
- 입고 기록 지우기(입고 담당): 잘못 넣은 1건을 지우면 그만큼 다시 미입고.
- 발주번호:
PO-YYMMDD-NN(발주일 기준 그날 순번, advisory lock 으로 동시 생성해도 겹치지 않음).
3. 권한·담당자
| 누구 | 할 수 있는 것 |
|---|---|
모듈 권한 inout |
발주 목록·발주서·미입고 현황 조회 |
| 발주 담당(옵션에서 지정) | 발주서 작성·고치기·잔량 종결/풀기·취소 |
| 입고 담당(옵션에서 지정) | 입고 수량 입력·입고 기록 지우기 |
ERP 관리자(role=admin) |
위 전부 + 옵션(공장 목록·담당자) |
담당자 후보 = ERP 관리자 화면에서 inout 권한을 받은 사용자. 권한이 빠졌는데 담당으로 남은 사람도 옵션에 보여서 뺄 수 있다.
담당은 inout_roles(email, role) — role order(발주)·receive(입고).
4. 제품 = 코드표 단품
발주 품목은 itemcode_db.single_items(단품)에서만 고른다(세트 아님) — itemcode.py SingleItemReader(읽기 전용, ITEMCODE_DB_URL 재사용,
cupang·malaysia 와 같은 DSN). 화면에서 코드·이름으로 검색(GET /inout/api/items?q=, 코드 앞부분 일치 먼저 30개),
저장할 때 서버가 다시 코드표에 있는지 확인(lookup) — 없으면 "코드표 단품에 없는 제품". 발주 줄에는 코드·발주 당시 이름 사본을 둔다.
이미 발주서에 있던 코드는 나중에 코드표에서 빠져도 그대로 고칠 수 있다. 코드표 연결이 안 되면 새 제품을 넣는 저장만 막힌다(안내 문구).
5. 화면
| 주소 | 내용 |
|---|---|
/inout/ |
발주 목록 — 상태(진행 중·완료·종결·취소·전체)·공장·발주일 기간·검색(발주번호·제품 코드·이름), 진행률 막대, 지연 표시 |
/inout/pending |
미입고 현황 — 요약 숫자, 제품별 합계, 발주별, 초과 입고 |
/inout/orders/new, /{id}/edit |
발주서 폼 — 공장·발주일·입고 예정일·메모, 제품 줄(검색 드롭다운·수량·줄 메모), 합계 |
/inout/orders/{id} |
발주서 — 품목별 발주·입고·미입고·상태, 이번 입고 칸(입고 담당) + [남은 수량 모두 채우기], 입고 기록, 종결·취소 |
/inout/settings |
옵션(관리자) — 담당자(발주·입고 체크), 공장(이름·연락처·메모·순서·사용, 발주 기록 없을 때만 지우기) |
화면은 서버 폼(POST → 303 + ?msg= 안내). static/inout.js 는 입력 보조만(제품 검색 드롭다운 — position: fixed 로 body 에 붙여
표 가로 스크롤에 잘리지 않음, 줄 추가·삭제·합계, 남은 수량 채우기, 버튼별 확인 data-erp-confirm-btn).
공용 .erp-page 가 content-box 라 넓은 표에서 48px 넘치므로 이 화면만 .erp-page:has(> .io) { box-sizing: border-box }.
6. DB (inout_db, scripts/sql/inout_db_init.sql)
| 표 | 내용 |
|---|---|
inout_factories |
공장 — 이름(대소문자 무시 유일)·연락처·메모·사용·순서 |
inout_roles |
담당자 — (email, role: order/receive) |
inout_orders |
발주서 — 번호·공장·발주일·입고 예정일·메모·종결(시각·사람·사유)·취소 |
inout_order_lines |
발주 품목 — 단품 코드·이름 사본·수량·줄 메모, 발주서 안에서 코드 유일 |
inout_receipts |
입고 1건(한 번 들어온 것) — 입고일·메모·입력자 |
inout_receipt_lines |
입고 품목별 수량 |
앱 계정 inout_app 은 SELECT/INSERT/UPDATE/DELETE + 시퀀스만. 초기화는 멱등(DROP·TRUNCATE 없음). 백업 권장: 매일 pg_dump inout_db.
7. 테스트
python -m pytest tests/test_inout_store.py tests/test_inout_web.py # DB 없이(등록·미설정 화면·상태·검사)
INOUT_TEST_DB_URL=postgresql://inout_app:<pw>@127.0.0.1:5432/inout_db \
python -m pytest tests/test_inout_db.py tests/test_inout_web.py # 로컬 테스트 DB(초기화 SQL 적용, 앱 계정 — 권한도 확인)
DB 테스트: 분할 입고·완료, 초과 확인, 미입고·종결·풀기·취소, 고치기(입고 품목 보호), 입고 지우기, 동시 발주번호, 담당자·공장. 화면 흐름 테스트: 옵션 → 발주 담당 발주(코드표 아닌 제품 거부) → 입고 담당 분할·초과 확인 → 미입고 현황 → 종결, 권한별 403.