사용자 요청으로 두 번째 축소를 취소한다. 달력 clamp(270px, 20.7vw, 396px),
발주 목록 글자는 원래의 90%로 되돌린다. 머지 e3b7e55 를 되돌림.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
17 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·저장 때 서버 재확인. - 물류 입고를 여러 번 나눠 입력, 품목별 발주·입고·미입고.
- 미입고 현황(제품별 합계·발주별·지연).
- 발주 목록 상태 보기(진행 중·완료·종결·취소·전체)는 사람마다 기억(2026-11-04) —
inout_settings키list_status:{이메일}(마이그레이션 없음, 005 미적용이면 기억만 안 함). 주소에status가 있으면 저장, 없으면 저장값, 그것도 없으면 진행 중. - 발주 목록 입고일 열(2026-11-05, 입고 예정일과 발주 사이,
db.list_ordersreceipt_dates) — 여러 날에 나눠 입고하면 칸 안에서 줄바꿈(오래된 날부터), 같은 날 여러 번은 한 번만, 입고 전-. - 발주 목록 거르기 줄(2026-11-05) — 상태·공장은 왼쪽, 발주일~[찾기]는 오른쪽(
.io-filter-right). - 발주 목록 표 머리글(2026-11-05,
.io-list-table) = 가운데·굵게·--text-caption× 111% × 90%·회색 배경, 표 글자 전체도 원래의 90%. 미입고 현황 등 다른 표는 그대로. - [남은 수량 모두 채우기]를 한 번 더 누르면(= [채운 수량 되돌리기]) 채우기 전 값으로(2026-10-19,
inout.js). - 초과 입고는 확인 화면 후 허용(트랜잭션 안에서 발주서 잠그고 판단,
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_KEYAES-GCM 암호문(gmail.py). 휴가 모듈도 같은 연결을 쓴다(2026-10-27) — 휴가 옵션 [Gmail 연결]은 세션_gmail_origin=vacation을 달고 같은 콜백(/inout/gmail/callback)으로 돌아오며, 콜백이_gmail_callback_vacation(휴가 권한 확인, 휴가 옵션으로 복귀)으로 넘긴다. 토큰 표·끊기는 공용 — 바꾸면 휴가 메일(vacation/notify.py)도 확인. -
보낸 기록·재발송 확인.
-
본문 고치기(2026-10-27): 발주 메일 미리보기 iframe 이
designMode(sandboxallow-same-origin, 스크립트 없음) — 고치면 [원래 본문으로]·닫을 때 확인, 보낼 때만html을 함께 POST →store.clean_mail_html(허용 태그·표·인라인 서식만, url()·이벤트·스크립트 제거) + 글 버전mail_html_to_text. 안 고치면 서버 본문 그대로. 입고 요청 메일은 고치기 없음(cid 사진). 서식 막대(initMail안RTE_BAR, 안내문 발송 편집기와 같은 구성: 크기·굵게·기울임·밑줄·취소선·글자/배경 색·정렬·목록·링크·서식 지우기·되돌리기) = iframeexecCommand(styleWithCSS → span style). Quill 은 표를 못 담아 안 씀. 크기는 fontSize 7 → px span 으로 바꿔 끼움. 선택은 본문 문서의 현재 선택 우선(막대 mousedown 때 기억은 대비용). 서버는text-decoration-line→text-decoration. -
입고 담당 발주 알림 자동 발송(2026-10-19): 발주 메일이 나가면 같은 Gmail 로 옵션 → 담당자의 입고 담당들에게 따로 보냄 — 제목은 발주 메일과 같고 내용은 발주번호·발주일·제품 코드·제품명·수량만(
store.order_notice_mail,router._send_order_notice). 실패해도 공장 메일은 그대로(안내만), 미리보기 창에 받을 사람 안내. -
참조 기본값
king@dbxcorp.co.kr(2026-10-19) — 미리보기 참조 칸에 미리 들어감, 옵션 → 공장 탭 "발주 메일 참조"에서 고침(inout_settingsorder_mail_cc, 행이 없으면 기본값 — 저장만 005 필요). -
간단 발주 메일(2026-11-04): 공장 이름에 "대성화학"·"인천공장"이 들어가면(
store.SIMPLE_MAIL_FACTORIES, 띄어쓰기 무시) 품목 표 = 번호·제품 코드·제품명·수량·박스당 수량·박스 수·비고만, 요약 표·글 본문에서도 금액·무게·PP·은을 뺀다(단가가 공장에 나가지 않게). 색상 줄 배경·합계 수량은 그대로. 박스 값은 발주 품목 사본이 아니라 메일을 만들 때의 상품 정보(router._mail_order→store.line_boxes, 뚜껑 있으면 통·뚜껑 따로, 입수 없으면-). 다른 공장 메일엔 박스 칸 없음.
입고 요청 메일 (005, 2026-10-19)
- 입고 담당이 입고 저장 → 발주서 화면
?rmail={입고 id}로 미리보기 팝업이 바로 뜸 → [메일 발송](입고 담당 본인 Gmail, 발주 메일과 같은 연결 — Gmail 연결 권한은 발주·입고 담당_require(…, "mail")). 입고 기록 줄 [보내기/다시 보내기]로 언제든. - 받는 사람 = 옵션 → 물류센터 탭 담당자 이메일(
inout_settingslogistics_emails), 참조 기본 =receipt_mail_cc(005 가king@dbxcorp.co.kr, bj@dbxcorp.co.kr넣음). 창에서 고칠 수 있음. - 제목
[입고 요청] yyyy년 mm월 dd일(요일) 입고 요청 합니다.(입고일) · 본문 "입고된 아래 리스트 상품을 전산 등록 부탁드립니다." + 표(상품 이름·상품 코드·입고 수량·비고 = 발주 품목 줄 메모, 합계) + 메모 + 맨 아래 입고증 사진 = 본문 안 이미지(CIDmultipart/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).
- 썸네일·크게 보기·나중에 더하기. 초과 확인은 브라우저가 먼저(사진 유지).
- 돌리기(2026-11-02) — 크게 보기 창 왼쪽·오른쪽 버튼(입고 담당) →
POST /inout/orders/{id}/photos/{pid}/rotate?degrees=90|270→ 서버가 저장된 사진 자체를 돌려 덮어씀(store.rotate_image, EXIF 회전을 픽셀에 반영, 같은 형식, JPEG 품질 92) — 원본 링크·입고 요청 메일도 돌린 사진. 되돌리기 = 반대로 돌리기. HEIC·움직이는 GIF 는 못 돌림(HEIC 은 버튼 숨김). 사진 응답은no-cache+ ETag(돌린 뒤 예전 사진이 캐시에 남지 않게).
상품 정보 (004, 옵션 세 번째 탭)
- 테이블
inout_products·inout_products_excluded. - [단품 불러오기] = 코드표 단품 → 목록(값을 넣은 상품은 그대로·지운 단품은 다음에도 빠짐, 제외 목록에서 되살리기).
- 단가(원)·무게(개당 g = PP량)·은(Ag) 함유량(%) 수기 입력(은 g = 무게 × % 자동).
- 한 번 불러오면 발주서 제품은 이 목록에서. 발주 품목에 그때 값 사본(
unit_price·weight_g·silver_pct). - 발주서·메일에 금액(수량 × 단가)·PP·은 함유량과 합계.
- 발주서 화면 품목 표(
.io-items-table, 2026-10-21): 제목 행 검정·굵게·가운데, 합계 줄 검정·굵게·제목 크기, "합계" = 1~3열 가운데. 열 PP 사용량·은(Ag) 함유량 = 발주 수량 전체 사용량 kg(store.line_usage— 메일 표와 같은 값), 아래 작은 글씨 = 개당 g·%. - 합계 줄(발주서 화면·발주 메일 표 같음): 금액 뒤 " 원", 무게 뒤 " kg", 무게는 소수 첫째 자리에서 반올림(정수 kg). 줄 값·메일 요약 표는 예전 자릿수 그대로.
- 발주 메일 표(2026-10-19,
store.order_mail): 전체 무게(kg) = 개당 g × 수량 · PP 사용량(kg) = 전체 무게 − 은 무게(은 함유량 왼쪽 열) · 은(Ag) 함유량 =30% (76.5kg)(괄호 = 전체 무게 × %, kg 소수 넷째). 합계 줄·요약(전체 무게·PP 사용량·은 총량)도 kg. 첫 요약 표는 항목·값 두 쌍씩 4열(4×4), 요청 사항은 맨 아래 한 줄 전체. 발주서 화면 표는 예전 그대로(PP g/개).
상품 그룹·색상 (006, 2026-10-21)
- 옵션 상품 그룹 탭(2026-10-21 상품 정보 탭에서 분리) = 그룹 표(
inout_product_groups: 이름·은 함유량·색상·순서,POST /inout/settings/groups·…/{id}/delete). 상품 줄 그룹 고르기 → 그 상품의 은 함유량·색상 = 그룹 값(자기 값 칸은 숨김·보존, 그룹 지우면 자기 값으로). 그룹 없는 상품은 상품마다. 계산은db._PRODUCT_SELECT_006(silver_pct·color = 그룹 적용 값, own_* = 자기 값) 한 곳 — 목록·발주서 제품 고르기·발주 품목 사본이 같은 값. - 색상 = 색없음·오렌지·파랑·회색·아이보리색(
store.COLORS키 none·orange·blue·gray·ivory → 이름·칸 색), 화면은 색 사각형 + 이름(_macros.swatch). - 발주 품목에 그때 색상 사본(
inout_order_lines.color, 006 전 품목 NULL = 지금 상품 색상). 발주 메일 품목 표에서 색상 있는 품목 줄 전체 배경 = 그 색(tr + 칸마다). - 006 확인(
groups_ready)은 연결을 열기 전에 — 미적용이면 1분 기억(발주 저장 트랜잭션 안에서 두 번째 연결을 잡아 동시 발주에서 풀이 바닥났었다). - 옵션 → 담당자 = 아이콘(구글 프로필 사진, 없으면 기본 아이콘) + 이름, 아래 이메일.
박스 입수·파렛트 (007, 2026-10-21)
- 옵션 → 상품 정보 통 수량(박스)·뚜껑 수량(박스) = 통·뚜껑이 한 박스에 몇 개(
inout_products.body_per_box·lid_per_box, 1 이상 정수, 뚜껑 없으면 빈칸,store.validate_box_values). 상품 정보 표 제목 행 = 가운데·굵게·13.2px(예전 12px × 110%). - 새 발주서 줄마다 "통·뚜껑 박스" 칸(
inout.js boxCell) = 통 ⌈수량 ÷ 통 입수⌉박스 · 뚜껑 ⌈수량 ÷ 뚜껑 입수⌉박스, 힌트 = 통·뚜껑 입수의 최소공배수(둘 다 꽉 차는 수량 단위, 뚜껑 없으면 통 입수)와 지금 수량에 가까운 그 배수(누르면 수량 칸에), 배수면 "✓ 꽉 찹니다". 합계 줄 = 통·뚜껑·전체 박스 → 파렛트 ⌈전체 박스 ÷ 30⌉(store.PALLET_BOXES) + 마지막 파렛트 박스 수. - 수량 칸 오른쪽 ◀ ▶ = 공배수(
unitOf)만큼 줄이기·늘리기 — 배수가 아니면 가까운 아래/위 배수로, 0 이면 빈칸. 제품을 안 골랐거나 입수가 없으면 못 누름. - 합계 줄 파렛트 그림(
palletSvg·palletVis, 6열 × 5행 박스 + 받침대) = 꽉 찬 파렛트(최대 10개 + "+N") · 잔량 파렛트(실린 박스만 색칠, 몇 %·몇 박스 더 실으면 한 파렛트), 딱 맞으면 "✓ 모든 파렛트가 꽉 찹니다". - 품목 표 제목 행 = 가운데·굵게·
--text-caption× 110%. - 화면 계산만 — 발주 품목 사본·발주서 화면·발주 메일에는 넣지 않음(사용자 지정). 값은 지금 상품 정보(
_form_page의body_per_box,/api/items). - 007 확인
db.boxes_ready(groups_ready 와 같은 방식 — 연결 열기 전, 미적용 1분 기억). 그룹·색상 조회(_PRODUCT_SELECT_006)는p.*라 새 열이 따라온다.
봉투·백 (008, 2026-11-04)
- 이름에 "미라클 봉투"·"미라클백" 이 들어간 상품(
store.is_bag, 저장 안 함 — 이름으로 판단) = 옵션 → 상품 정보에서 일반 상품과 표를 나눔(봉투·백 표가 위). 칸: 박스당 수량(body_per_box재사용)·1파렛트당 박스 수량(inout_products.boxes_per_pallet). 뚜껑 없음(저장하면lid_per_box는 NULL). 단가·무게·은 칸 없음(2026-11-04 사용자 지정) — 전에 넣은 값은 줄의 숨은 칸으로 저장 때 그대로 보내 지우지 않음. 그룹·색상 칸은 있음. 새 발주서 "단가 없는 N종"·발주서 화면과 발주 메일의 "단가 미입력 N종"(store.order_totals) 안내에서 봉투·백은 뺌. - 새 발주서 합계 줄에 봉투·백 박스·파렛트를 통·뚜껑과 따로 표시: 파렛트 = ⌈Σ(박스 ÷ 그 상품 1파렛트 박스)⌉. 파렛트 그림도 통처럼(
palletVis(all, cap, mixed), 그림 칸은 60칸까지) — 1파렛트 박스 수가 다른 상품이 섞이면 가장 큰 값으로 환산해 잔량은 %만. 입수·1파렛트 값은store.box_info(_form_page·/api/items). - 008 확인
db.bags_ready(boxes_ready 와 같은 방식). 미적용이면 모두 일반 상품으로 동작.
오른쪽 달력 (2026-10-21)
- 입출고 모든 화면 2열(
.io-split= 왼쪽section.io| 오른쪽_calendar.html, 1100px 미만은 한 열 270px). 스크롤해도 위에 붙음. 달력 크기 = 화면에 따라 270~396px(clamp(270px, 20.7vw, 396px), 2026-11-05 90% 로 줄임, 높이 ×320/300) — 입출고 화면만 ERP 공용 최대 폭 1550px 를 풀어 넓은 화면 여백을 씀(2026-10-21 "여백이 많다, 더 키워 달라"). 글자·칸은 달력 너비 기준cqw(300px 일 때 1cqw = 3px)라 같은 비율로 커진다 — 새 크기 값도 px 대신 cqw 로. - 프로젝트 달력 모양(일요일 시작·요일 줄 회색·오늘 검은 동그라미·토 파랑·일/공휴일 빨강 — 공휴일 표는
project.store.holiday_name재사용). 공휴일 이름은 숫자 아래 한 줄(.io-cal-hol, 8.5px — 5글자까지 다 보임, 더 길면 … + 말풍선에 전체 이름). - 날짜 칸 = 발주(발주일, 파랑)·입고(입고일, 초록) 건수(취소된 발주 제외), 누르면 그날 목록 팝업 → 발주서. 달 이동은 새로고침 없이
GET /inout/api/calendar?month=YYYY-MM(db.calendar). - 메뉴를 옮겨도 달력은 다시 그리지 않음(2026-10-21) — 마지막 달력(달·API 응답 글·칸 HTML)을 sessionStorage
io_cal_v1에 두고_calendar.html인라인 스크립트가 그리기 전에 붙임,inout.js는 서버 값을 다시 받아 글이 달라졌을 때만 다시 그린다(보던 달도 유지).CAL_KEY는initCalendar안에 — 바깥 const 면 위에서 먼저 부를 때 TDZ 로 복원이 조용히 꺼진다.
시각 / 날짜
- 시각은 DB 시간대와 무관하게 KST 로 읽음(
db._KstTimestamptzLoader). - 날짜 서식은 모두
yyyy.mm.dd(요일)(ymd·ymdhm매크로,store.fmt_date). - 날짜 칸 = ERP 공용 달력(2026-11-05,
erp-datepop,_datepop.html+inout.js머리) — 발주 목록 기간·발주일·입고 예정일·입고일.input[type=date]는 숨긴 값 저장소(폼 전송 그대로), 국경일·대체공휴일 빨강·이름 + 마우스를 올리면 이름(title, 표 =project.store.KR_HOLIDAYS,router._date_holidays). 필수 칸은 [지우기] 없음(숨긴 required 칸이 비면 브라우저가 안내 없이 저장을 막는다), 잠긴 입고일은 버튼도 disabled. 테스트tests/js/inout_datepop.browser.test.js(render_inout.py).