feat(inout): 입출고 관리 모듈 — 공장 제작 발주 · 물류 입고 · 미입고/초과 관리

- 새 모듈 app/modules/inout(/inout/, 권한키 inout) + 새 DB inout_db(사용자 승인, scripts/sql/inout_db_init.sql — 멱등).
- 발주 담당이 공장에 발주서(PO-YYMMDD-NN, 제품 = itemcode_db 단품만 — 검색 + 저장 때 서버 재확인),
  입고 담당이 물류에 들어온 수량을 여러 번 나눠 입력 → 품목별 발주·입고·미입고, 진행률, 입고 예정일 지연.
- 미입고 현황: 제품별 합계 · 발주별(예정일 순) · 초과 입고. 잔량 종결/풀기, 입고 없는 발주 취소, 입고 기록 지우기.
- 초과 입고: 확인 화면(409, 입력 유지) 후 [초과 입고로 저장] — 트랜잭션 안에서 발주서 잠그고 판단, Enter 는 일반 저장.
- 옵션(ERP 관리자): 공장 목록, 발주 담당·입고 담당 지정(inout_roles). 관리자는 둘 다.
- 상태는 저장하지 않고 누적 입고로 계산(store.order_status). 이카운트 "발주 대비 미입고"·Odoo 분할 입고/종결 참고.
- 테스트: 순수 로직, 실제 PostgreSQL(앱 계정 inout_app — 권한 포함), 실제 앱 화면 흐름(권한별). 문서 INOUT_MODULE.md 등.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-16 15:21:05 +09:00
parent 80b7becd45
commit 6f3bffd840
26 changed files with 2712 additions and 0 deletions
+152
View File
@@ -0,0 +1,152 @@
-- =====================================================================
-- inout_db 초기화 스크립트 (PostgreSQL) — 입출고 관리 모듈(2026-10-16)
-- =====================================================================
-- 본사 → 공장 제품 제작 발주, 공장 → 물류 입고(여러 번 나눠 입고) 기록, 발주 대비 미입고·초과 관리.
-- 멱등(idempotent): 여러 번 실행해도 안전. 기존 데이터를 삭제하지 않는다. DROP/TRUNCATE 없음.
--
-- 실행 방법 (운영 PostgreSQL 컨테이너명: postgres-db, 백업 먼저):
--
-- 1) DB / 역할 / 테이블 생성 (superuser 로 1회)
-- read -s -p "inout_app password: " APP_PWD; echo
-- docker exec -i postgres-db psql -U postgres -v app_password="$APP_PWD" < scripts/sql/inout_db_init.sql
--
-- 2) main-app .env 에 연결 정보 등록
-- INOUT_DB_URL=postgresql://inout_app:<APP_PWD>@postgres-db:5432/inout_db
--
-- 3) main-app 재기동
-- cd /opt/www/main && docker compose up -d --build web
--
-- 제품(단품)은 itemcode_db.single_items 를 읽기 전용으로 고른다(ITEMCODE_DB_URL 재사용) — 여기엔 코드·이름 사본만 둔다.
-- =====================================================================
\set ON_ERROR_STOP on
SELECT 'CREATE DATABASE inout_db ENCODING ''UTF8'' TEMPLATE template0'
WHERE NOT EXISTS (SELECT 1 FROM pg_database WHERE datname = 'inout_db')
\gexec
SELECT 'CREATE ROLE inout_app LOGIN PASSWORD ' || quote_literal(:'app_password')
WHERE NOT EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'inout_app')
\gexec
SELECT 'ALTER ROLE inout_app WITH LOGIN PASSWORD ' || quote_literal(:'app_password')
\gexec
GRANT CONNECT ON DATABASE inout_db TO inout_app;
\connect inout_db
CREATE OR REPLACE FUNCTION inout_set_updated_at() RETURNS trigger AS $$
BEGIN
NEW.updated_at := now();
RETURN NEW;
END;
$$ LANGUAGE plpgsql;
-- ════════════════════════════════════════════════════════════
-- 1) 공장(발주처) — 옵션에서 추가·수정, 쓰지 않으면 숨김(발주 기록이 있으면 지우지 않는다)
-- ════════════════════════════════════════════════════════════
CREATE TABLE IF NOT EXISTS inout_factories (
id SERIAL PRIMARY KEY,
name TEXT NOT NULL CHECK (char_length(name) BETWEEN 1 AND 100),
contact TEXT NOT NULL DEFAULT '', -- 담당자·연락처(자유 글)
memo TEXT NOT NULL DEFAULT '',
is_active BOOLEAN NOT NULL DEFAULT TRUE,
sort_order INTEGER NOT NULL DEFAULT 0,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
CREATE UNIQUE INDEX IF NOT EXISTS uq_inout_factories_name ON inout_factories (lower(name));
DROP TRIGGER IF EXISTS trg_inout_factories_updated ON inout_factories;
CREATE TRIGGER trg_inout_factories_updated BEFORE UPDATE ON inout_factories
FOR EACH ROW EXECUTE FUNCTION inout_set_updated_at();
COMMENT ON TABLE inout_factories IS '입출고 — 공장(발주처) 목록';
-- ════════════════════════════════════════════════════════════
-- 2) 담당자 — 옵션에서 지정. order = 발주 담당(발주서 작성·수정·종결), receive = 입고 담당(입고 수량 입력)
-- ERP 관리자는 지정 없이도 둘 다 할 수 있다(앱에서 판단).
-- ════════════════════════════════════════════════════════════
CREATE TABLE IF NOT EXISTS inout_roles (
email TEXT NOT NULL,
role TEXT NOT NULL CHECK (role IN ('order', 'receive')),
created_by TEXT NOT NULL DEFAULT '',
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
PRIMARY KEY (email, role)
);
COMMENT ON TABLE inout_roles IS '입출고 — 발주 담당(order)·입고 담당(receive)';
-- ════════════════════════════════════════════════════════════
-- 3) 발주서(헤더) — 상태는 줄의 입고 합계로 앱이 계산(closed_at = 잔량 종결, cancelled_at = 취소)
-- ════════════════════════════════════════════════════════════
CREATE TABLE IF NOT EXISTS inout_orders (
id BIGSERIAL PRIMARY KEY,
order_no TEXT NOT NULL UNIQUE, -- PO-YYMMDD-NN (발주일 기준 순번)
factory_id INTEGER NOT NULL REFERENCES inout_factories(id),
order_date DATE NOT NULL,
due_date DATE NULL, -- 입고 예정일(납기)
memo TEXT NOT NULL DEFAULT '',
closed_at TIMESTAMPTZ NULL, -- 종결: 남은 미입고를 더 기다리지 않음
closed_by TEXT NOT NULL DEFAULT '',
close_reason TEXT NOT NULL DEFAULT '',
cancelled_at TIMESTAMPTZ NULL, -- 취소(입고 기록이 없을 때만)
cancelled_by TEXT NOT NULL DEFAULT '',
created_by TEXT NOT NULL DEFAULT '',
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_by TEXT NOT NULL DEFAULT '',
updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
CREATE INDEX IF NOT EXISTS idx_inout_orders_date ON inout_orders (order_date DESC, id DESC);
CREATE INDEX IF NOT EXISTS idx_inout_orders_factory ON inout_orders (factory_id);
DROP TRIGGER IF EXISTS trg_inout_orders_updated ON inout_orders;
CREATE TRIGGER trg_inout_orders_updated BEFORE UPDATE ON inout_orders
FOR EACH ROW EXECUTE FUNCTION inout_set_updated_at();
COMMENT ON TABLE inout_orders IS '입출고 — 공장 제품 제작 발주서';
-- 발주 품목 — 제품은 itemcode_db.single_items(단품)의 코드·이름 사본(발주 당시 이름)
CREATE TABLE IF NOT EXISTS inout_order_lines (
id BIGSERIAL PRIMARY KEY,
order_id BIGINT NOT NULL REFERENCES inout_orders(id) ON DELETE CASCADE,
line_no INTEGER NOT NULL,
item_code TEXT NOT NULL CHECK (char_length(item_code) BETWEEN 1 AND 64),
item_name TEXT NOT NULL DEFAULT '',
qty INTEGER NOT NULL CHECK (qty > 0),
memo TEXT NOT NULL DEFAULT '',
UNIQUE (order_id, item_code)
);
CREATE INDEX IF NOT EXISTS idx_inout_order_lines_item ON inout_order_lines (item_code);
COMMENT ON TABLE inout_order_lines IS '입출고 — 발주 품목(단품 코드·발주 수량)';
-- ════════════════════════════════════════════════════════════
-- 4) 입고 — 한 번 들어온 것(날짜) = 입고 1건, 그 안에 품목별 수량. 한 발주에 여러 번 나눠 입고 가능.
-- ════════════════════════════════════════════════════════════
CREATE TABLE IF NOT EXISTS inout_receipts (
id BIGSERIAL PRIMARY KEY,
order_id BIGINT NOT NULL REFERENCES inout_orders(id) ON DELETE CASCADE,
receipt_date DATE NOT NULL,
memo TEXT NOT NULL DEFAULT '',
created_by TEXT NOT NULL DEFAULT '',
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
CREATE INDEX IF NOT EXISTS idx_inout_receipts_order ON inout_receipts (order_id, receipt_date);
CREATE TABLE IF NOT EXISTS inout_receipt_lines (
id BIGSERIAL PRIMARY KEY,
receipt_id BIGINT NOT NULL REFERENCES inout_receipts(id) ON DELETE CASCADE,
order_line_id BIGINT NOT NULL REFERENCES inout_order_lines(id) ON DELETE CASCADE,
qty INTEGER NOT NULL CHECK (qty > 0),
UNIQUE (receipt_id, order_line_id)
);
CREATE INDEX IF NOT EXISTS idx_inout_receipt_lines_line ON inout_receipt_lines (order_line_id);
COMMENT ON TABLE inout_receipts IS '입출고 — 물류 입고(한 번 들어온 것)';
COMMENT ON TABLE inout_receipt_lines IS '입출고 — 입고 품목별 수량';
-- ════════════════════════════════════════════════════════════
-- 권한 — 앱 계정은 읽기·쓰기만(스키마 변경 없음)
-- ════════════════════════════════════════════════════════════
GRANT USAGE ON SCHEMA public TO inout_app;
GRANT SELECT, INSERT, UPDATE, DELETE ON
inout_factories, inout_roles, inout_orders, inout_order_lines, inout_receipts, inout_receipt_lines
TO inout_app;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO inout_app;
SELECT 'inout_db ready' AS status;