Files
dbx-main/app/modules/inout/CLAUDE.md
T
king cb69b086d7 feat(inout): 발주 메일 첫 요약 표를 4열(항목·값 두 쌍씩) 4×4로
- 예전 2열 × 8행 → 4열 × 4행, 요청 사항은 맨 아래 한 줄 전체

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 12:20:27 +09:00

3.6 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).
  • 잔량 종결·취소(취소는 입고 없을 때만).
  • 상태는 저장하지 않고 누적 입고로 계산(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).