Files
dbx-main/docs/INOUT_MODULE.md
T
king 0ba6192e95 feat(입출고): 대성화학·인천공장 발주 메일 표를 간단하게
공장 이름에 대성화학·인천공장이 들어가면 품목 표를 번호·제품 코드·
제품명·수량·박스당 수량·박스 수·비고로 만들고, 요약 표와 글 본문에서도
금액·무게·PP·은을 뺀다. 박스 값은 메일을 만들 때의 상품 정보로 계산한다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 15:43:19 +09:00

259 lines
32 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 입출고 관리(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 옵션 화면 겹침). 공장 표는 진짜 `<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_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종`.
- **간단 발주 메일**(2026-11-04, 사용자 요청): 공장 이름에 "대성화학"·"인천공장"이 들어가면(띄어쓰기 무시) 품목 표 = 번호·제품 코드·제품명·수량·박스당 수량·박스 수·비고, 요약 표·글 본문에서도 금액·무게·PP·은을 뺀다. 박스 값은 메일을 만들 때의 상품 정보(올림, 뚜껑 있으면 통·뚜껑 따로, 입수 없으면 `-`, 합계는 있는 줄만).
- **보내는 계정** = 누른 사람(발주 담당)의 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 빈 줄(`<div style="height:18px;line-height:18px;font-size:1px">`) — 메일 프로그램이 표 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 style="background:…">` + 칸마다 — 메일 프로그램이 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파렛트당 박스 수량)⌉. 값이 빠진 상품은 몇 종 빠졌는지 표시. 발주 메일에는 넣지 않음.
- 파렛트 그림(같은 날 추가 요청): 통과 같은 그림. 1파렛트 박스 수가 다른 상품이 섞이면 가장 큰 값으로 환산해 그리고 잔량은 %만 표시. 1파렛트 박스 수는 입력값이라 그림 칸은 60칸까지만 그리고 비율로 칠한다.
## 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`(파일 이름 없음)으로 붙인다 → `<img src="cid:inout-photo-{id}@dbx">`. 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:<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·은 화면·메일 → 입고 담당은 이름·발주 수량만.