Files
dbx-main/app/modules/inout/CLAUDE.md
T

6.1 KiB

[입출고] 입출고 관리 모듈 — app/modules/inout/, inout_db(2026-10-16)

이 모듈만 고칠 때 읽는 요약. 상세는 docs/INOUT_MODULE.md. 정적 파일: app/static/inout.css, inout.js. 템플릿: templates/. 상품은 itemcode_db.single_items 읽기 전용(itemcode.py). APP_ENCRYPTION_KEY 는 실적 모듈과 공유. 참고 모델: 이카운트 "발주 대비 미입고"·Odoo 분할 입고/종결.

발주 / 입고

  • 본사 → 공장 제품 제작 발주(발주서 PO-YYMMDD-NN). 제품 = itemcode_db.single_items 단품만, 검색 GET /inout/api/items·저장 때 서버 재확인.
  • 물류 입고를 여러 번 나눠 입력, 품목별 발주·입고·미입고.
  • 미입고 현황(제품별 합계·발주별·지연).
  • 초과 입고는 확인 화면 후 허용(트랜잭션 안에서 발주서 잠그고 판단, confirm_over).
  • 전체 입고 완료(모든 품목 입고 ≥ 발주, 상태 done·over)면 더 입고 못 함(2026-10-19) — 화면은 입고 칸·[입고 저장]·사진·[남은 수량 채우기]를 흐리게 disabled, 서버 _add_receipt 도 잠근 뒤 거절. 입고 기록을 지우면 다시 열림.
  • 잔량 종결·취소(취소는 입고 없을 때만).
  • 상태는 저장하지 않고 누적 입고로 계산(store.order_status).
  • 모든 품목 입고완료·초과입고 = "✓ 전체 입고 완료"(초과면 "초과 포함", order_badge).
  • 발주 삭제는 수퍼관리자만(발주 목록 🗑, perms.super, 입고·사진·메일 기록까지 CASCADE).

권한 / 옵션

  • 권한키 inout(조회).
  • 발주 담당·입고 담당·공장(담당자·연락처 따로, 002)은 모듈 옵션 — 상단 톱니 → 팝업(/inout/settings?panel=1, ERP 관리자, inout_roles·inout_factories). 관리자는 둘 다.
  • 공용 .erp-input·.erp-table-wrap 겹침은 .io 안에서만 바로잡음.
  • 입고 담당(발주 담당 아님)은 품목을 이름·발주 수량만(items_limited), 옵션은 관리자만.

발주 메일 (003)

  • 새 발주서 저장 → 미리보기 팝업(받는 사람 = 공장 이메일, 요약 표 본문) → 사람이 [메일 발송]을 눌러야 보냄.
  • 발주 담당 본인 Gmail(Gmail API gmail.send, 사람마다 [Gmail 연결] 1회 — 고른 구글 계정 = ERP 계정 확인). 갱신 토큰은 APP_ENCRYPTION_KEY AES-GCM 암호문(gmail.py).
  • 보낸 기록·재발송 확인.
  • 참조 기본값 king@dbxcorp.co.kr(2026-10-19) — 미리보기 참조 칸에 미리 들어감, 옵션 → 공장 탭 "발주 메일 참조"에서 고침(inout_settings order_mail_cc, 행이 없으면 기본값 — 저장만 005 필요).

입고 요청 메일 (005, 2026-10-19)

  • 입고 담당이 입고 저장 → 발주서 화면 ?rmail={입고 id} 로 미리보기 팝업이 바로 뜸 → [메일 발송](입고 담당 본인 Gmail, 발주 메일과 같은 연결 — Gmail 연결 권한은 발주·입고 담당 _require(…, "mail")). 입고 기록 줄 [보내기/다시 보내기]로 언제든.
  • 받는 사람 = 옵션 → 물류센터 탭 담당자 이메일(inout_settings logistics_emails), 참조 기본 = receipt_mail_cc(005 가 king@dbxcorp.co.kr, bj@dbxcorp.co.kr 넣음). 창에서 고칠 수 있음.
  • 제목 [입고 요청] yyyy년 mm월 dd일(요일) 입고 요청 합니다.(입고일) · 본문 "입고된 아래 리스트 상품을 전산 등록 부탁드립니다." + 표(상품 이름·상품 코드·입고 수량·비고 = 발주 품목 줄 메모, 합계) + 메모 + 맨 아래 입고증 사진 = 본문 안 이미지(CID multipart/related, 첨부 아님 — gmail.build_message(inline_images=)), 서버가 가로 600px 이하·비율 유지 JPEG 로 줄임(store.mail_images, EXIF 회전 반영, HEIC 는 빼고 안내). 미리보기는 cid → data: 로 바꿔 보여 줌.
  • 보낸 기록 inout_receipt_mails(입고 지우면 CASCADE), 이미 보낸 입고는 resend 확인.

사방넷 입고 파일 (2026-10-19, 마이그레이션 없음)

  • 입고 기록 줄 [사방넷 입고 파일](엑셀 초록 #217346) → GET /inout/orders/{id}/receipts/{rid}/sabangnet.xlsx(발주·입고 담당). 1행 제목 A 상품코드 · B 가용수량 · C 불용수량, A = 코드표 single_items.sabangnet_code(itemcode.sabangnet_codes), B = 입고 수량, C = 수량이 아니라 상품 이름(사용자 지정). A·C 는 글자 칸(앞자리 0 보존).
  • 사방넷 코드가 빈 품목이 있거나 코드표를 못 읽으면 파일을 만들지 않고 발주서로 돌아가 품목을 알려 준다(빈 칸 업로드 방지). 파일 이름 사방넷_입고_{입고일}_{발주번호}.xlsx.

입고증 사진 (003)

  • 입고 저장 때 첨부(브라우저가 2000px JPEG 로 줄임, 10장·10MB, 파일 머리 검사, 입고와 한 트랜잭션, bytea).
  • 썸네일·크게 보기·나중에 더하기. 초과 확인은 브라우저가 먼저(사진 유지).

상품 정보 (004, 옵션 세 번째 탭)

  • 테이블 inout_products·inout_products_excluded.
  • [단품 불러오기] = 코드표 단품 → 목록(값을 넣은 상품은 그대로·지운 단품은 다음에도 빠짐, 제외 목록에서 되살리기).
  • 단가(원)·무게(개당 g = PP량)·은(Ag) 함유량(%) 수기 입력(은 g = 무게 × % 자동).
  • 한 번 불러오면 발주서 제품은 이 목록에서. 발주 품목에 그때 값 사본(unit_price·weight_g·silver_pct).
  • 발주서·메일에 금액(수량 × 단가)·PP·은 함유량과 합계.
  • 발주 메일 표(2026-10-19, store.order_mail): 전체 무게(kg) = 개당 g × 수량 · PP 사용량(kg) = 전체 무게 − 은 무게(은 함유량 왼쪽 열) · 은(Ag) 함유량 = 30% (76.5kg)(괄호 = 전체 무게 × %, kg 소수 넷째). 합계 줄·요약(전체 무게·PP 사용량·은 총량)도 kg. 첫 요약 표는 항목·값 두 쌍씩 4열(4×4), 요청 사항은 맨 아래 한 줄 전체. 발주서 화면 표는 예전 그대로(PP g/개).

시각 / 날짜

  • 시각은 DB 시간대와 무관하게 KST 로 읽음(db._KstTimestamptzLoader).
  • 날짜 서식은 모두 yyyy.mm.dd(요일)(ymd·ymdhm 매크로, store.fmt_date).