- 예전 2열 × 8행 → 4열 × 4행, 요청 사항은 맨 아래 한 줄 전체 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
18 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) — 어긋날 수 없다. - 품목 상태: 미입고 / 부분입고 / 입고완료 / 초과입고. 발주서는 하나라도 남으면 부분입고(초과가 섞여 있어도).
- 모든 품목이 입고완료 또는 초과입고(발주서 done·over)면 목록·발주서 머리에 초록 "✓ 전체 입고 완료", 초과가 있으면 옆에 빨강 "초과 포함"
(
_macros.html order_badge, 2026-10-17 요청). 품목 줄의 초과입고 배지는 그대로 빨강. - 날짜 서식은 모두
yyyy.mm.dd(요일)— 예2026.10.17(토), 시각이 있으면2026.10.17(토) 15:14(화면_macros.html ymd·ymdhm, 메일·JSONstore.fmt_date·fmt_datetime, 2026-10-17 요청). 날짜 입력 칸(달력)은 브라우저 모양 그대로. - 미입고 현황(
/inout/pending)은 종결·취소가 아닌 발주의 남은 수량만 — 제품별 합계, 발주별(입고 예정일 순, 지난 것 빨강), 초과 입고 목록. - 초과 입고: 입고 저장 때 발주를 넘는 품목이 있으면 저장하지 않고 확인 화면(409, 넣은 숫자 유지) → 초과 입고로 저장.
판단은 DB 트랜잭션 안에서 발주서 행을 잠그고(
FOR UPDATE) 누적 입고를 다시 읽어 한다 — 동시에 입고해도 확인을 건너뛰지 않음. Enter 키는 숨은 기본 버튼(일반 저장)으로 가게 해 확인 없이 초과가 저장되지 않게 했다. - 발주서 고치기: 입고된 품목은 뺄 수 없다(입고 기록이 사라지므로) — 수량은 바꿀 수 있다(입고보다 줄이면 초과로 보임).
- 입고 기록 지우기(입고 담당): 잘못 넣은 1건을 지우면 그만큼 다시 미입고.
- 발주번호:
PO-YYMMDD-NN(발주일 기준 그날 순번, advisory lock 으로 동시 생성해도 겹치지 않음). 순번은 숫자로 비교한다 — 100번째부터 세 자리(-100). - 시각(입력·보낸·종결 시각 등)은 DB 서버 시간대와 무관하게 한국 시각 — 연결마다 TIMESTAMPTZ 를 KST 로 읽는다(
db._KstTimestamptzLoader).
3. 권한·담당자
| 누구 | 할 수 있는 것 |
|---|---|
모듈 권한 inout |
발주 목록·발주서·미입고 현황 조회 |
| 발주 담당(옵션에서 지정) | 발주서 작성·고치기·잔량 종결/풀기·취소 |
| 입고 담당(옵션에서 지정) | 입고 수량 입력·입고 기록 지우기. 발주 담당이 아니면 발주서 품목은 제품 이름·발주 수량(+ 이번 입고 칸)만 보인다 — 코드·입고·미입고·상태·단가·금액 숨김, 입고 기록 칩도 이름(2026-10-16 요청) |
수퍼관리자(SUPER_ADMIN_EMAIL) |
위 전부 + 발주 목록 줄 끝 🗑 발주 삭제(POST /inout/orders/{id}/delete) — 확인 후 품목·입고 기록·입고증 사진·발주 메일 기록까지 완전히 지움(CASCADE, 되돌릴 수 없음), 서버 로그에 남김, 보던 목록(거르기)으로 돌아감(2026-10-17) |
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) — 없으면 "코드표 단품에 없는 제품". 발주 줄에는 코드·발주 당시 이름 사본을 둔다.
이미 발주서에 있던 코드는 나중에 코드표에서 빠져도 그대로 고칠 수 있다. 코드표 연결이 안 되면 새 제품을 넣는 저장만 막힌다(안내 문구).
옵션 → 상품 정보에 단품을 한 번이라도 불러오면 그때부터 발주서 제품은 그 목록에서만 고른다(지운 단품 제외, 단가 함께) — 6-3.
5. 화면
| 주소 | 내용 |
|---|---|
/inout/ |
발주 목록 — 상태(진행 중·완료·종결·취소·전체)·공장·발주일 기간·검색(발주번호·제품 코드·이름), 진행률 막대, 지연 표시 |
/inout/pending |
미입고 현황 — 요약 숫자, 제품별 합계, 발주별, 초과 입고 |
/inout/orders/new, /{id}/edit |
발주서 폼 — 공장·발주일·입고 예정일·메모, 제품 줄(검색 드롭다운·수량·단가·금액·줄 메모), 합계(수량·종·금액) |
/inout/orders/{id} |
발주서 — 품목별 발주·(발주 담당) 단가·금액·PP(g/개)·은(Ag) ·입고·미입고·상태 + 합계 줄(금액·PP kg·은 g), 이번 입고 칸(입고 담당) + [남은 수량 모두 채우기], 입고 기록, 종결·취소. 입고 담당만이면 이름·발주 수량만 |
| 톱니 → 옵션 팝업 | 관리자만. 탭 담당자(발주·입고 체크) · 공장(이름·담당자·연락처·메모·순서·사용, 발주 기록 없을 때만 지우기) · 상품 정보(6-3). 내용은 GET /inout/settings?panel=1, 저장은 팝업 안에서(X-Inout-Options: 1 → JSON, 같은 탭 그대로 다시 그림), 바뀐 게 있으면 닫을 때 화면 새로고침. 예전 주소 /inout/settings = 목록으로 가서 팝업(?options=1) |
화면은 서버 폼(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 };
.erp-input 이 min-width 240px + content-box 라 좁은 칸에서 옆 칸을 덮음, .erp-table-wrap 이 카드 모양(그림자·둥근 모서리)이라 카드 안에서 상자가 겹쳐 보임
→ .io·.io-dlg 안은 border-box·최소폭 없음·카드 안 표는 평평하게(2026-10-16 옵션 화면 겹침). 공장 표는 진짜 <table> + 입력칸 form="…" 속성(줄마다 표 밖 폼)으로 열을 맞춘다.
6. DB (inout_db, scripts/sql/inout_db_init.sql)
| 표 | 내용 |
|---|---|
inout_factories |
공장 — 이름(대소문자 무시 유일)·담당자(manager, 002)·연락처(contact)·이메일(email, 003)·메모·사용·순서 |
inout_gmail_tokens |
사람별 Gmail 연결 — 갱신 토큰 암호문만(003) |
inout_order_mails |
발주 메일 보낸 기록(003) |
inout_receipt_photos |
입고증 사진(bytea, 003) |
inout_roles |
담당자 — (email, role: order/receive) |
inout_orders |
발주서 — 번호·공장·발주일·입고 예정일·메모·종결(시각·사람·사유)·취소 |
inout_order_lines |
발주 품목 — 단품 코드·이름 사본·수량·줄 메모, 발주서 안에서 코드 유일. 004: 발주할 때의 unit_price·weight_g·silver_pct 사본 |
inout_products |
상품 정보(004) — 코드표에서 불러온 단품 + 단가(원)·무게(개당 g = PP량)·은(Ag) 함유량(%) |
inout_products_excluded |
상품 정보에서 지운 단품(004) — 다음 불러오기에서 빠진다 |
inout_receipts |
입고 1건(한 번 들어온 것) — 입고일·메모·입력자 |
inout_receipt_lines |
입고 품목별 수량 |
마이그레이션 inout_db_002_factory_manager.sql(2026-10-16): manager 열 추가, 예전 한 칸에 숫자 없이 이름만 있던 값은 담당자로 옮김(숫자가 있으면 연락처로 둠).
002 미적용이어도 발주서 화면은 열리고(담당자 = to_jsonb(f)->>'manager'), 공장 저장만 "002 필요" 안내.
앱 계정 inout_app 은 SELECT/INSERT/UPDATE/DELETE + 시퀀스만. 초기화는 멱등(DROP·TRUNCATE 없음). 백업 권장: 매일 pg_dump inout_db.
6-1. 발주 메일 — 발주 담당자 본인 Gmail(2026-10-16, 마이그레이션 003)
- 받는 사람 = 옵션 → 공장 이메일(
inout_factories.email, 여러 개는 쉼표). 발주서 화면에서 바꾸거나 참조를 더할 수 있다. - 흐름: 새 발주서를 저장하면 발주서 화면이
?mail=1로 열려 메일 미리보기 팝업이 바로 뜬다(받는 사람·제목·본문). 사람이 **[메일 발송]**을 눌러야만 보낸다(자동 발송 없음). 머리 **[발주 메일 보내기 / 다시 보내기]**로 언제든 다시 연다. - 본문(
store.order_mail) = 인사(공장 담당자 이름) · 발주번호·발주일·입고 예정일·품목 수·총수량·요청 사항(메모) 표 · 품목 표(No·제품 코드·제품명·수량·비고, 합계) · 보낸 사람. HTML + 글 본문(둘 다), 값은 모두 escape. 제목[발주] {번호} · {공장} · {첫 품목} 외 n종. - 보내는 계정 = 누른 사람(발주 담당)의 Gmail — Gmail API
users.messages.send(gmail.py). 사람마다 처음 한 번 [Gmail 연결]: 구글 동의 화면(로그인과 같은 OAuth 클라이언트, 범위openid email gmail.send만,hd=회사 도메인,login_hint= ERP 계정) →/inout/gmail/callback에서 고른 구글 계정 = ERP 로그인 계정인지(다르면 거절), gmail.send 허락·갱신 토큰 확인 → 갱신 토큰을APP_ENCRYPTION_KEY(실적 모듈과 같은 마스터 키, AES-256-GCM, AADinout:gmail:{email})로 암호화해inout_gmail_tokens. 원문·접근 토큰은 저장·출력하지 않는다. 연결 끊기 = 구글 권한 취소(revoke) + 토큰 삭제. - 기록:
inout_order_mails(보낸 사람·받는 사람·참조·제목·Gmail id·시각) — 머리 "발주 메일: 보냄 MM-DD HH:MM … · 모두 n번". 이미 보낸 발주서는resend: true를 같이 보내야 한다(409 → 화면이 "다시 보낼까요?" 확인) — 실수로 두 번 안 가게. - 오류: 구글이 연결을 끊었으면(invalid_grant·권한 없음) 토큰을 지우고 "다시 연결" 안내, Gmail API 꺼짐은 관리자 안내, 그 밖은 구글 문구.
- 권한: 미리보기·발송·연결 = 발주 담당(관리자 포함). 취소된 발주서는 보낼 수 없다.
구글 클라우드 준비(관리자 1회 — 로그인에 쓰는 OAuth 클라이언트가 있는 프로젝트)
- API 및 서비스 → 라이브러리 → Gmail API → 사용.
- OAuth 동의 화면 → 범위(데이터 액세스) → 범위 추가:
https://www.googleapis.com/auth/gmail.send(사용자 유형이 내부(Workspace)면 구글 심사 없이 바로 쓸 수 있다). - 사용자 인증 정보 → 로그인용 OAuth 2.0 클라이언트 → 승인된 리디렉션 URI 추가:
{PUBLIC_BASE_URL}/inout/gmail/callback(예:https://dbx.no1king.freeddns.org/inout/gmail/callback). - 서버
.env에APP_ENCRYPTION_KEY(실적 모듈과 같은 키)·GOOGLE_CLIENT_ID/SECRET·PUBLIC_BASE_URL이 있어야 한다(새 변수 없음).
6-2. 입고증 사진(2026-10-16, 마이그레이션 003)
- 입고 담당이 입고 저장 때 [사진 고르기·찍기](여러 장, 휴대폰은 카메라) — 브라우저가 긴 변 2000px JPEG 로 줄여 올린다 (4032×3024 7.9MB → 2000×1500 약 0.8MB, 줄인 게 더 크면 원본, HEIC·GIF 는 그대로). 입고 한 건에 10장, 한 장 10MB까지.
- 서버는 파일 머리로 종류를 판단(
store.sniff_image— JPG·PNG·WEBP·GIF·HEIC, SVG·PDF 등 거절)하고 입고와 한 트랜잭션으로inout_receipt_photos(bytea — 백업에 함께)에 넣는다 — 사진이 틀리면 입고도 저장 안 함, 초과 확인에 막혀도 사진 저장 안 함. - 초과 입고는 브라우저가 먼저 확인한다(저장 전 확인 창 →
confirm_over=1) — 서버 확인 화면으로 돌아가면 고른 파일이 사라지기 때문. 그래도 서버까지 가서 막히면(동시 입고 등) "사진은 다시 첨부" 안내. - 입고 기록 입고증 칸 = 썸네일(누르면 크게 보기 — ←/→ 넘기기, [원본], [지우기](입고 담당)) + [+] 로 나중에 더하기. 입고 기록을 지우면 사진도 함께 지워진다(CASCADE).
- 보기
GET /inout/photos/{id}— 모듈 권한자,X-Content-Type-Options: nosniff·CSP sandbox, HEIC 는 내려받기(브라우저가 못 보여 줌).
6-3. 상품 정보 — 단가·무게(PP)·은 함유량(2026-10-16, 마이그레이션 004)
- 옵션 팝업 세 번째 탭 상품 정보(관리자만). [단품 불러오기] = 코드표(
itemcode_db.single_items) 단품 전체 →inout_products(itemcode.list_all,POST /inout/settings/products/import).- 새 단품은 추가, 값(단가·무게·은 함유량 중 하나라도)을 넣은 상품은 그대로(이름도), 값이 없는 상품은 이름만 최신으로.
- 지운 단품(제외 목록
inout_products_excluded)은 건너뛴다. 코드표에서 빠진 단품을 지우지는 않는다.
- 표: 코드·제품명·단가(원)·무게·PP(g/개)·은 함유량(%)·은(g/개) = 무게 × % ÷ 100(자동, 화면에서 바로 계산).
찾기 칸, 바뀐 줄은 노랗게 + [변경 저장 (n)](
POST …/products/save, 바뀐 줄만, 하나라도 틀리면 아무것도 저장 안 함), 저장 안 하고 닫거나 다시 불러오면 확인. 빈칸 = 미입력. 단가 소수 둘째·무게 둘째·함유량 넷째 자리까지(넘치면 사사오입), 함유량 0~100%.- 사용자 확인(2026-10-16): 요청의 "PP함유량" = 은(Ag) 함유량(%), "PP량" = 무게(개당 g).
- 줄 오른쪽 ✕ = 지우기(
…/products/{code}/exclude) — 목록·발주서 고르기에서 빠지고 제외 목록에 남는다. 아래 제외 목록에서 [되살리기](…/restore, 값은 빈칸). 지난 발주서는 그대로. - 발주서: 상품 정보가 하나라도 있으면 제품 검색·저장 확인이 상품 정보 기준(없는 코드 = "상품 정보에 없는 단품", 그 전에는 코드표).
저장할 때 그때 값의 사본을 발주 품목에 남긴다(
_insert_line) — 나중에 단가를 바꿔도 지난 발주서·메일은 그대로. 고치기에서 새로 넣은 줄만 지금 값, 원래 있던 줄은 사본 유지. 004 전 발주서는 단가 칸이 "-". - 금액 = 수량 × 단가(
store.line_amount), 합계는 단가 있는 줄만(없는 줄 수 표시), PP 총량(kg) = Σ 무게 × 수량, 은 총량(g) = Σ 무게 × % × 수량 (store.order_totals, 개당 은 g 를 반올림하기 전 값으로 곱함). - 발주 메일 본문(6-1)에 발주 금액·전체 무게·PP 사용량·은(Ag) 총량 줄과 품목 표 단가(원)·금액(원)·전체 무게(kg)·PP 사용량(kg)·은(Ag) 함유량(% (kg)), 합계 줄.
- 2026-10-19 사용자 요청으로 바꿈(예전 = PP(g/개)·개당 은 g): 전체 무게 = 개당 무게 × 수량(kg) · PP 사용량 = 전체 무게 − 은 무게(은 함유량 바로 왼쪽 열) ·
은 함유량 괄호 = 전체 무게 × %(kg, 소수 넷째까지). 예: 5,000개 × 51g = 255kg, 은 30% (76.5kg), PP 사용량 178.5kg.
합계 줄 PP 사용량 = 무게·은 함유량이 다 있는 줄만(
order_totalspp_use_kg). 첫 요약 표(발주번호·발주일·입고 예정일·품목·발주 금액·전체 무게·PP 사용량·은 총량)는 항목·값 두 쌍씩 한 줄 = 4열 × 4행(같은 날 요청, 예전 2열 × 8행), 칸 수가 홀수면 마지막 쌍은 빈 칸, 요청 사항(메모, 길 수 있음)은 맨 아래 한 줄 전체(colspan=3). 글 본문(HTML 못 보는 메일 프로그램용)도 같은 값. 발주서 화면 표는 그대로.
- 2026-10-19 사용자 요청으로 바꿈(예전 = PP(g/개)·개당 은 g): 전체 무게 = 개당 무게 × 수량(kg) · PP 사용량 = 전체 무게 − 은 무게(은 함유량 바로 왼쪽 열) ·
은 함유량 괄호 = 전체 무게 × %(kg, 소수 넷째까지). 예: 5,000개 × 51g = 255kg, 은 30% (76.5kg), PP 사용량 178.5kg.
합계 줄 PP 사용량 = 무게·은 함유량이 다 있는 줄만(
- 004 미적용이면 탭에 "마이그레이션 004 필요" 안내, 발주서는 예전처럼 코드표에서(
products_ready).
7. 테스트
python -m pytest tests/test_inout_store.py tests/test_inout_mail_photo.py tests/test_inout_web.py # DB 없이(상태·검사·메일 본문·Gmail·사진)
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 테스트: 분할 입고·완료, 초과 확인, 미입고·종결·풀기·취소, 고치기(입고 품목 보호), 입고 지우기, 동시 발주번호, 담당자·공장, 시각 KST, 상품 정보(불러오기 유지·이름 갱신·제외·되살리기, 발주 품목 값 사본 — 끝나면 테스트 단품을 지워 목록을 처음 상태로). 화면 흐름 테스트: 옵션 → 발주 담당 발주(코드표 아닌 제품 거부) → 입고 담당 분할·초과 확인 → 미입고 현황 → 종결, 권한별 403, 상품 정보(관리자만·저장 검사·다시 불러와도 값 유지·지우기) → 단가로 발주 → 금액·PP·은 화면·메일 → 입고 담당은 이름·발주 수량만.