2026-06-24 세션 — orderpaper '자재관리' 첫 탭 신설 + 재고량 RDS 영속

논의·대안

pfs orderpaper(원부자재 발주서) 화면에 '📦 자재관리'를 첫 탭으로 신설(webdev/ui). 발주서 정리 탭과 같은 DB값(OP_ALL = /api/orderpaper/all-items) 을 쓰되, 카드형이 아니라 순수 테이블로 보여 남은 재고 활용을 빠르게 파악하는 게 목적. 진행: HTML 목업(pfs/mockups/orderpaper_material_mgmt_mockup.html, qa_helper 내장)으로 페페와 3라운드 피드백 → 실앱 통합 → 테스트 배포 → 재고량 RDS 영속.

핵심 설계 논의: - 컬럼: 자재분류(드롭다운 R/E/S)·발주처(가구업체)·현장명·품명·규격·발주량·재고량(신규 입력)·출고처(공급 vendor)·비고(동기화)·입고일(블록 입고일 승계). NO 컬럼은 페페 요청으로 숨김. - 삼중 정렬: 1차 자재분류(원자재→엣지→부자재) · 2차 입고일↓ · 3차 발주서↑(발주일→seq→항목번호). 전 컬럼 클릭 정렬(2차 키 교체). - 빠른토글: 원자재/엣지/부자재(부자재 기본 OFF) + 블록(발주처별 묶음, 기본 OFF=플랫). 블록 ON이면 자재토글 무시하고 R/E/S 함께. - 날짜 표기 버그(중요): 운영 /all-items 가 날짜를 RFC1123(Wed, 15 Apr 2026 00:00:00 GMT, Flask datetime 직렬화)로 주는데 초기 파서가 YYYY-MM-DD만 처리해 그대로 통과 → 목업 하네스가 ISO라 가려졌던 것. toDate()가 두 형식 모두 파싱하도록 고쳐 M.D(요일) 표기 + 정렬도 날짜값(ms) 기준. - 노출 범위: 기본 최근 1개월, 검색 시 3개월 창(완료 항목 숨김은 없음).

결정

• 재고량은 서버 영속(orderpaper.stock 컬럼)으로 확정. 자재분류 드롭다운 변경만 localStorage 오버레이(전용 컬럼 없음).
• 첫 배포는 프론트만(무위험) → 페페가 RDS 컬럼 요구 후 backend+DDL 진행.
• AWS 접속 로컬 복구: aws CLI 미설치·~/.aws 미복구 상태였음 → venv pip awscli 설치 + ~/.aws/credentials(페페가 키 직접 기입, IAM poinadmin)로 SSM 가동.

산출물·커밋

• 신규: web/static/js/orderpaper_material_mgmt.js(window.opMM), web/static/css/orderpaper_material_mgmt.css.
• 수정: field_orderpaper.html(첫 탭버튼·#opMMWrap·복원/리프레시 훅·캐시버스터), orderpaper_schedule.js·orderpaper_material.js(4탭 상호배타 정리), DAO/service/controller(stock).
• 커밋 체인(master=테스트): 19399d2(탭 신설) → 8882ba7(피드백 7건) → 8c95e2c(재고량 RDS 영속). 운영 미배포.
• DDL: 테스트 DB(poin-dbinstance-test) orderpaper에 stock VARCHAR(50) NULL 추가(SSM). 운영 DB(poin-dbinstance)엔 미추가.
• 검증: 테스트서버 실 HTTP e2e(SSM) — PATCH /api/orderpaper/49/stock 200 → RDS stock='99.9' 일치 → 원복. RFC1123 날짜도 운영 데이터로 재확인. 페페 "모두 정상 작동 확인완료".
• 재사용 스크립트: pfs/scripts/_mm_stock_alter.py(env 경로 prod 교체용), pfs/scripts/_mm_http_e2e.py. ssm_run.py에 aws 실행파일 해석 보강(venv aws.cmd).

다음

• 운영 배포 시(페페 "운영 반영해줘"): ① 운영 DB(poin-dbinstance)에 동일 stock ALTER 먼저(안 하면 all-items 깨짐) ② deploy-live 머지.
• 자재분류 드롭다운 서버 영속(전용 컬럼)은 요청 시.
• 보류: 프린터 출력 첫 로딩 최적화(페페 언급 후 보류).

관계

• 주제 그룹: pfs-orderpaper
• 관련 문서: pfs-session-2026-06-22-material-spec-tab, pfs-session-2026-06-20-orderpaper-newhighlight-batch