# [입출고] 입출고 관리 모듈 — `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`). - 잔량 종결·취소(취소는 입고 없을 때만). - 상태는 저장하지 않고 누적 입고로 계산(`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`). - 보낸 기록·재발송 확인. ## 입고증 사진 (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`).