# 입출고 관리(inout) 모듈
> `app/modules/inout/` · DB `inout_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`,
메일·JSON `store.fmt_date·fmt_datetime`, 2026-10-17 요청). 날짜 입력 칸(달력)은 브라우저 모양 그대로.
- **미입고 현황**(`/inout/pending`)은 종결·취소가 아닌 발주의 남은 수량만 — 제품별 합계, 발주별(입고 예정일 순, 지난 것 빨강), 초과 입고 목록.
- **초과 입고**: 입고 저장 때 발주를 넘는 품목이 있으면 저장하지 않고 확인 화면(409, 넣은 숫자 유지) → [초과 입고로 저장](`confirm_over=1`).
판단은 DB 트랜잭션 안에서 발주서 행을 잠그고(`FOR UPDATE`) 누적 입고를 다시 읽어 한다 — 동시에 입고해도 확인을 건너뛰지 않음.
Enter 키는 숨은 기본 버튼(일반 저장)으로 가게 해 확인 없이 초과가 저장되지 않게 했다.
- **[남은 수량 모두 채우기] 되돌리기**(2026-10-19 요청): 누르면 빈 칸만 남은 수량으로 채우고 버튼이 [채운 수량 되돌리기](초록)로 바뀐다 —
한 번 더 누르면 채우기 직전 값으로 모두 되돌림(채운 뒤 손으로 고친 칸도). 채울 칸이 없으면 그대로.
- **전체 입고 완료 뒤 입고 막기**(2026-10-19 요청): 모든 품목이 입고완료·초과(발주서 done·over)면 품목 머리에 "✓ 전체 입고 완료 — 더 입고할 수 없습니다",
이번 입고 칸·입고일·메모·사진·[남은 수량 모두 채우기]·[입고 저장]·숨은 기본 버튼을 `disabled` + 흐리게(`.io-receipt-bar.is-locked`).
서버도 `_add_receipt` 에서 발주서를 잠근 뒤 모든 품목 누적 입고 ≥ 발주면 ValueError(초과 확인을 해도) — 두 창에서 동시에 넣어도 막힘.
잘못 넣은 입고는 입고 기록에서 지우면 다시 입고할 수 있다. 입고 기록의 사진 더하기·입고 요청 메일·사방넷 파일은 그대로.
- 발주서 고치기: 입고된 품목은 **뺄 수 없다**(입고 기록이 사라지므로) — 수량은 바꿀 수 있다(입고보다 줄이면 초과로 보임).
- 입고 기록 지우기(입고 담당): 잘못 넣은 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) · **물류센터**(6-4). 내용은 `GET /inout/settings?panel=1`, 저장은 팝업 안에서(`X-Inout-Options: 1` → JSON, 같은 탭 그대로 다시 그림), 바뀐 게 있으면 닫을 때 화면 새로고침. 예전 주소 `/inout/settings` = 목록으로 가서 팝업(`?options=1`) |
**2열 + 오른쪽 달력(2026-10-21)** — 모든 화면이 왼쪽 화면 | 오른쪽 300px(달력 300×320, 프로젝트 달력 모양). 날짜별 발주(발주일)·입고(입고일) 건수,
누르면 그날 목록 팝업, 달 이동은 `GET /inout/api/calendar?month=YYYY-MM`(6주 칸 = 일요일 시작 42일, 취소된 발주 제외, 공휴일 이름 포함).
옵션 → 담당자 표 = 아이콘(구글 프로필 사진) + 이름, 아래 이메일.
화면은 서버 폼(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 옵션 화면 겹침). 공장 표는 진짜 `
` + 입력칸 `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_settings` | 모듈 설정(005) — `logistics_emails`(물류센터 담당자 이메일)·`receipt_mail_cc`(입고 요청 메일 참조) |
| `inout_receipt_mails` | 입고 요청 메일 보낸 기록(005, 입고 1건마다, 입고 지우면 CASCADE) |
마이그레이션 `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`, 여러 개는 쉼표). 발주서 화면에서 바꾸거나 참조를 더할 수 있다.
- **입고 담당 발주 알림**(2026-10-19 요청): [메일 발송]으로 공장 메일이 나가면 **같은 Gmail** 로 입고 담당(옵션 → 담당자 `inout_roles` receive, ERP 관리자는 자동 포함 안 함)에게
별도 메일을 자동 발송 — 제목 = 발주 메일과 같음, 본문 = 발주번호·발주일 + 표(제품 코드·제품명·수량, 합계)만(단가·무게·은 없음, `store.order_notice_mail`).
다시 보내기 때도 함께 간다. 알림 실패·입고 담당 없음은 공장 메일을 막지 않고 결과 문구에만("입고 담당 n명에게 발주 알림 메일도 보냈습니다" / 실패 이유),
기록은 공장 메일 한 건(`inout_order_mails`). 미리보기 창에 "메일 발송 시 입고 담당(…)에게 발주 알림 메일이 따로 자동 발송됩니다" 안내(`notice_to`).
- **참조 기본값**(2026-10-19 요청) = `king@dbxcorp.co.kr` — 미리보기 참조 칸에 미리 들어간다. 옵션 → 공장 탭 위 **발주 메일 참조**에서 바꾼다
(`POST /inout/settings/order-mail`, `inout_settings` 키 `order_mail_cc` — 행이 없으면 `store.SETTING_DEFAULTS` 값, 저장은 005 필요).
- **흐름**: 새 발주서를 저장하면 발주서 화면이 `?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, AAD `inout: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 클라이언트가 있는 프로젝트)
1. **API 및 서비스 → 라이브러리 → Gmail API → 사용**.
2. **OAuth 동의 화면 → 범위(데이터 액세스) → 범위 추가**: `https://www.googleapis.com/auth/gmail.send`
(사용자 유형이 **내부**(Workspace)면 구글 심사 없이 바로 쓸 수 있다).
3. **사용자 인증 정보 → 로그인용 OAuth 2.0 클라이언트 → 승인된 리디렉션 URI 추가**: `{PUBLIC_BASE_URL}/inout/gmail/callback`
(예: `https://dbx.no1king.freeddns.org/inout/gmail/callback`).
4. 서버 `.env` 에 `APP_ENCRYPTION_KEY`(실적 모듈과 같은 키)·`GOOGLE_CLIENT_ID/SECRET`·`PUBLIC_BASE_URL` 이 있어야 한다(새 변수 없음).
## 6-2. 입고증 사진(2026-10-16, 마이그레이션 003)
- 입고 담당이 **입고 저장 때** [입고증 업로드](2026-10-19 이름 변경 — 예전 "사진 고르기·찍기", 여러 장, 휴대폰은 카메라) — 브라우저가 긴 변 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_totals` `pp_use_kg`).
첫 요약 표(발주번호·발주일·입고 예정일·품목·발주 금액·전체 무게·PP 사용량·은 총량)는 **항목·값 두 쌍씩 한 줄 = 4열 × 4행**(같은 날 요청, 예전 2열 × 8행),
칸 수가 홀수면 마지막 쌍은 빈 칸, **요청 사항**(메모, 길 수 있음)은 맨 아래 한 줄 전체(`colspan=3`).
받은 메일에서 이 표 칸이 크게 늘어나 보여(같은 날) 칸마다 `font-size:14px;line-height:20px;height:20px;padding:4px 10px` 로 못 박고(요청 사항 칸은 높이 고정 없음),
두 표 사이는 표 margin 대신 높이 18px 빈 줄(``) — 메일 프로그램이 표 margin 을 무시하기도 해서. 글 본문(HTML 못 보는 메일 프로그램용)도 같은 값. 발주서 화면 표는 그대로.
- 004 미적용이면 탭에 "마이그레이션 004 필요" 안내, 발주서는 예전처럼 코드표에서(`products_ready`).
## 6-3-1. 상품 그룹·색상(2026-10-21, 마이그레이션 006)
- 사용자 요청: 은 함유량이 그룹마다 다르다 → 그룹별로 한 번만 설정. 아이템별 색상도 같은 방식(그룹에 한 번). 그룹 기준은 사용자 선택 = **옵션에서 직접 그룹을 만들고 상품마다 고름**
(코드 앞부분·이름 자동 묶음은 쓰지 않음).
- 표 `inout_product_groups`(id·name UNIQUE·silver_pct·color·sort_order), `inout_products.group_id`(FK, 그룹 지우면 NULL)·`color`, `inout_order_lines.color`.
- 적용 값: 그룹 상품 = 그룹의 은 함유량·색상, 그룹 없는 상품 = 상품 자기 값. 상품 자기 값은 그룹에 넣어도 지우지 않는다(그룹에서 빼면 다시 보임).
다시 불러오기에서 그룹·색상만 넣은 상품도 "값 있는 상품"(`store.has_values`)이라 그대로.
- 색상: 색없음(none)·오렌지(orange `#FFD8B0`)·파랑(blue `#CFE0FA`)·회색(gray `#DDDFE3`)·아이보리색(ivory `#FFF6D9`) — 메일 글자가 읽히게 옅은 색.
- 발주 메일(6-1) 품목 표: 색상 있는 품목은 줄 전체 배경을 그 색으로(`
` + 칸마다 — 메일 프로그램이 tr 배경을 무시하기도 함).
색상 = 발주 품목 사본(발주 당시), 006 전 품목은 지금 상품 색상.
- 옵션 화면: 그룹 표(이름·은 함유량·색상[사각형 + 고르기]·순서·상품 수·저장/지우기·추가), 상품 표에 그룹·색상 열. 그룹 상품은 은 함유량·색상 칸 대신 그룹 값(회색 칸),
그룹을 바꾸면 그 자리에서 그룹 값·은 g 다시 계산. 저장 안 한 상품 변경이 있으면 그룹 저장 전에 묻는다.
## 6-3-2. 박스 입수·파렛트(2026-10-21, 마이그레이션 007)
- 사용자 요청: 상품 정보에 **통 수량(박스)**·**뚜껑 수량(박스)** — 통·뚜껑이 한 박스에 몇 개씩 들어가는지(뚜껑 없는 상품은 빈칸).
새 발주서에서 상품·수량을 고르면 통·뚜껑 박스 수와 전체 파렛트 수(**1파렛트 = 30박스**)를 계산해 보여 주고, 통·뚜껑 입수가 달라 **공배수**를 힌트로.
**발주 메일은 예전 서식 그대로**(박스·파렛트 안 넣음).
- 계산(화면, `inout.js`): 통 박스 = ⌈수량 ÷ 통 입수⌉, 뚜껑 박스 = ⌈수량 ÷ 뚜껑 입수⌉, 전체 박스 = Σ(통 + 뚜껑), 파렛트 = ⌈전체 ÷ 30⌉, 마지막 파렛트 = 전체 mod 30.
힌트 단위 = lcm(통 입수, 뚜껑 입수)(뚜껑 없으면 통 입수) — 수량이 그 배수면 "✓ 통·뚜껑 박스가 모두 꽉 찹니다", 아니면 아래·위 가까운 배수 버튼(누르면 수량 칸에).
입수가 없는 상품은 "박스 입수 미설정"으로 합계에서 빼고 몇 종 빠졌는지 표시. 예: 통 120·뚜껑 300 → 공배수 600, 1,000개 = 통 9·뚜껑 4박스(600·1,200 힌트).
- 같은 날 추가 요청: 품목 표 제목 행 가운데·굵게·110%, 수량 칸 오른쪽 ◀ ▶(공배수만큼 — 배수가 아니면 가까운 배수로 맞춤),
합계 줄에 파렛트 그림(꽉 찬 파렛트 수만큼 + 잔량 파렛트는 실린 박스만 색칠·%·"N박스 더 실으면 한 파렛트").
- 옵션 상품 정보 표 제목 행 = 가운데·굵게·12px × 110%. 그룹 표는 같은 날 **상품 그룹** 탭으로 분리, 옵션 창 폭 1440px 까지.
- **달력 다시 그리기 줄이기**(같은 날): 화면을 옮겨도 마지막 달력을 sessionStorage 에서 바로 붙이고, 서버 값이 바뀐 때만 다시 그린다(보던 달 유지, [오늘]로 돌아옴).
## 6-3-3. 봉투·백 박스·파렛트(2026-11-04, 마이그레이션 008)
- 사용자 요청: 상품 정보에서 이름에 **"미라클 봉투"·"미라클백"** 이 들어간 상품은 **박스당 수량**·**1파렛트당 박스 수량**을 넣도록 일반 상품과 분리.
- 구분은 이름으로(`store.is_bag`, 저장 안 함). 옵션 → 상품 정보에 봉투·백 표를 따로 두고(위), 단가·무게·은 칸은 없다(같은 날 추가 요청 — 전에 넣은 값은 숨은 칸으로 유지). 그룹·색상 칸은 일반 상품과 같다.
- 저장: 박스당 수량 = 기존 `body_per_box`, 1파렛트당 박스 수량 = 새 열 `boxes_per_pallet`. 봉투·백을 저장하면 `lid_per_box` 는 NULL.
- 계산(새 발주서 합계 줄, `inout.js`, 요청에 명시되지 않아 구현 때 정함): 봉투·백은 통·뚜껑 파렛트(1파렛트 30박스)와 **따로** — 박스 = ⌈수량 ÷ 박스당 수량⌉, 파렛트 = ⌈Σ(박스 ÷ 그 상품의 1파렛트당 박스 수량)⌉. 값이 빠진 상품은 몇 종 빠졌는지 표시. 발주 메일에는 넣지 않음.
## 6-4. 입고 요청 메일 — 물류센터 전산 등록 부탁(2026-10-19, 마이그레이션 005)
- **왜**(사용자 요청): 물류에 들어온 입고를 물류센터 입고 담당자가 전산에 등록하도록, 입고 담당이 입고를 저장하면 메일로 알린다.
- **옵션 → 물류센터 탭**(관리자): 물류센터 담당자 이메일(받는 사람, 여러 개 쉼표)·입고 요청 메일 참조(기본 `king@dbxcorp.co.kr, bj@dbxcorp.co.kr` — 005 가 넣음).
`POST /inout/settings/logistics`, 주소 검사(`store.clean_emails`), `inout_settings` 키·값. 005 미적용이면 탭에 안내·저장 버튼 꺼짐.
- **흐름**: 입고 담당이 [입고 저장] → `/inout/orders/{id}?rmail={입고 id}` 로 돌아오며 **미리보기 팝업이 바로 뜬다**(발주 메일과 같은 창 모양, `inout.js initMail` 공용).
사람이 **[메일 발송]**을 눌러야 보낸다. 입고 기록 표의 **입고 요청 메일** 칸 = 마지막 보낸 시각·사람 + [보내기 / 다시 보내기](입고 담당).
이미 보낸 입고는 `resend: true` 확인(409 → "다시 보낼까요?").
- **보내는 계정** = 누른 사람(입고 담당)의 Gmail — 발주 메일과 같은 연결(`inout_gmail_tokens`). Gmail 연결(`/inout/gmail/connect·callback`) 권한을
발주 담당만 → **발주 담당 또는 입고 담당**으로 넓혔다(`_require(…, "mail")`). 연결 후 돌아오는 곳 = 그 입고의 메일 창(`?rmail=`).
- **제목** `[입고 요청] 2026년 10월 19일(월) 입고 요청 합니다.` — 입고일, 월·일 두 자리(`store.receipt_mail_subject`).
- **본문**(`store.receipt_mail`) = 인사 · "입고된 아래 리스트 상품을 전산 등록 부탁드립니다." · 입고일·발주번호·공장 한 줄 ·
표 **상품 이름 · 상품 코드 · 입고 수량 · 비고**(비고 = 그 발주 품목의 줄 메모) + 합계 · 입고 메모 · **맨 아래 입고 인증 사진** · 입고 담당.
HTML + 글 본문, 값은 모두 escape.
- **사진 = 본문 안 이미지(첨부 아님)**: 보낼 때 `gmail.build_message(inline_images=)` 가 HTML 쪽을 `multipart/related` 로 만들고 사진을
`Content-ID` + `Content-Disposition: inline`(파일 이름 없음)으로 붙인다 → `
`. Gmail·Outlook 은 본문 안에 그린다
(data: URI 는 Gmail 이 막아서 쓰지 않음). 크기는 서버가 **가로 최대 600px, 세로는 비율대로** JPEG(품질 85)로 다시 만든다(`store.mail_images` —
Pillow, EXIF 회전 반영, 투명 PNG 는 흰 바탕, 큰 JPEG 는 draft 로 빨리 읽음). img 에도 width·height 를 적는다. HEIC 등 서버가 못 여는 사진은 빼고
"본문에 넣지 못한 사진 n장" 안내(입고 기록 사진은 그대로). 10장 × 600px ≈ 1MB 안팎이라 Gmail API 요청 크기 걱정 없음.
- **미리보기**(`GET …/receipts/{rid}/mail`)는 cid 를 data: 로 바꾼 HTML(`store.inline_preview_html`)을 sandbox iframe 에 — 보내는 메일은 cid 그대로.
- **권한**: 미리보기·발송 = 입고 담당(관리자 포함). 발주 담당만인 사람은 403.
- **005 미적용**: 미리보기·발송은 되고(받는 사람은 직접 입력, 참조는 기본값), 보낸 기록·옵션 저장만 안 됨(창에 안내).
## 6-5. 사방넷 입고 파일(2026-10-19, 마이그레이션 없음)
- 입고 기록 표 **입고 요청 메일 · 사방넷** 칸의 **[사방넷 입고 파일]**(엑셀 초록 버튼, 발주 담당·입고 담당) → 그 입고 1건의 엑셀(`GET …/receipts/{rid}/sabangnet.xlsx`).
- 시트 1행 = 제목 **상품코드 · 가용수량 · 불용수량**(굵게·회색 바탕), 2행부터 입고 품목마다
A = 코드표(itemcode_db `single_items.sabangnet_code`, `itemcode.SingleItemReader.sabangnet_codes`) 사방넷 코드,
B = 입고 수량, **C = 상품 이름**(사용자 요청 — 불용수량 칸이지만 수량이 아니라 이름). A·C 는 글자 서식(`@`, 앞자리 0 보존), 열 너비는 내용 길이로.
- 사방넷 코드가 빈 단품이 하나라도 있으면 파일을 만들지 않고 발주서로 돌아가 "코드표에 사방넷 코드가 없는 상품: …"(빈 상품코드로 사방넷에 올리는 실수 방지),
코드표 연결이 안 되면 그 이유를 안내. 파일 이름 `사방넷_입고_YYYYMMDD_{발주번호}.xlsx`(입고일). `store.sabangnet_rows·sabangnet_xlsx·sabangnet_filename`.
## 7. 테스트
```bash
python -m pytest tests/test_inout_store.py tests/test_inout_mail_photo.py tests/test_inout_receipt_mail.py tests/test_inout_web.py # DB 없이(상태·검사·메일 본문·Gmail·사진·입고 요청 메일)
INOUT_TEST_DB_URL=postgresql://inout_app:@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·은 화면·메일 → 입고 담당은 이름·발주 수량만.