조달청 MVP — proposals 테이블 구조 + 실제 데이터 시연

1TL;DR

2DB 스키마 — proposals 테이블 (단일)

컬럼 구성 (17 컬럼)

제약조건 + 인덱스

2026 패턴 적용 사항

• snake_case 컬럼명, plural 테이블명
• timezone-aware timestamps (DateTime(timezone=True))
• JSON / JSONB 가변 영역 (extraction) — Postgres JSONB / sqlite JSON 양쪽 호환
• SQLAlchemy 2.0 Mapped / mapped_column (typed annotations)
• UUID-like text PK (sqlite + postgres 호환 + BFF 가 발급)
• 정규화 컬럼 + JSONB hybrid — 자주 검색/정렬할 필드 (company_name 등) 정규화, 가변 구조 (patents 등) JSONB

3실제 데이터 — 2개 HWPX 업로드 후 DB row

김기열 주무관님 폴더에서 2개 파일 업로드:

• 1. 폐쇄형배전반_JK알에스티(2025057).hwpx (5.8MB)
• 11. 폐쇄형배전반_주식회사 스마트파워(2022190).hwpx (4.4MB)

Row 1 — JK알에스티

Row 2 — 스마트파워

4frontend 표 구성 — /upload 페이지

업로드 직후 추출 완료된 proposals 가 표로 표시. GET /api/proposals 응답을 그대로 렌더.

표 행/열 매핑

각 행은 1 proposal = 1 row. 행 수 = 업로드한 HWPX 파일 수.

5frontend 표 구성 — /eval 페이지 (비교)

여러 업체 선택 후 side-by-side 컬럼 비교. 행은 "항목", 열은 "업체".

비교 행/열 구조

각 셀 값은 extraction JSONB 에서 동적으로 계산 (count, summary, identity 필드 등). 정규화 컬럼은 빠른 접근용, JSONB 는 풍부한 비교용.

6extraction JSONB 의 풍부한 구조

정규화 컬럼은 6개지만 JSONB extraction 은 ProductRecord 통째 — 8 영역 4단 중첩 구조.

extraction = {
  product_id: "2025057",
  identity: { title_ko, designation_no, author_or_org, product_category },
  feature_summary: { summary, bullets[] },
  patents: [ { type, name, number, date, issuer, description } ],
  detailed_items: [ { item_name_ko, item_code, rows: [ { identifier, model_name, size_wxhxd_mm, specification_text, note } ] } ],
  quality_tests: [ { standard_title, test_type, test_items: [{ name, value }], confidence, missing_reason } ],
  image_assets: [ { asset_type, filename, caption_ko, related_model_names[], para_index, data_uri, extraction_confidence } ],
  manufacturing: [ { step, work, equipment, inspection } ],
  warranty: { period, conditions },
  confidence: 0.71,
  parser_version: "0.2.0",
  parse_stats: { ... }
}

비교 화면에서 extraction.patents.length 같은 식으로 카운트 / 특정 셀 클릭 시 상세 (특허 번호·등록일 등) drill-down 가능.

7API endpoint 5개

8헥사고날 구조 — domain → port → adapter

backend/app/
├── domains/proposals/              # 도메인 — 외부 의존 0
│   ├── entities/
│   │   ├── proposal.py             # Proposal entity (Pydantic v2)
│   │   └── product_record.py       # hwpx ProductRecord 도메인 모델
│   ├── ports/
│   │   ├── proposal_repository.py  # Protocol (ABC) — 영속화 contract
│   │   └── hwpx_client.py          # Protocol — HWPX 파서 contract
│   └── use_cases/
│       ├── upload_proposal.py      # UploadProposal
│       ├── apply_extraction.py     # ApplyExtraction (webhook + poller 공통)
│       └── list_proposals.py       # ListProposals + GetProposal
├── adapters/
│   ├── database/
│   │   ├── models.py               # SQLAlchemy ORM (ProposalRow)
│   │   └── proposal_repository.py  # ProposalRepository port 구현 + RepositoryFactory
│   └── hwpx_client.py              # HwpxClient port 의 httpx 구현
├── api/                            # FastAPI 진입점 (composition root)
│   ├── specs.py                    # POST /api/specs
│   ├── internal.py                 # POST /internal/done
│   └── proposals.py                # GET /api/proposals + /extracted
├── schemas/__init__.py             # API DTO (Pydantic v2)
├── services/__init__.py            # entity → DTO 매핑
├── config.py                       # Settings
├── db.py                           # SQLAlchemy engine + Base
├── main.py                         # FastAPI factory + wiring
└── models/__init__.py              # Base.metadata 등록 트리거

의존 방향

• domains/ 는 SQLAlchemy / FastAPI / httpx 등 외부 import 0 (순수 Python + Pydantic)
• adapters/ 가 domain ports/ 를 구현
• api/ 는 use case + port (DI 주입) 만 호출
• main.py 가 모든 wiring (composition root)

9검증 결과

10결론

4 기능 (다중 업로드 + 파싱 + DB 저장 + 비교표) 만 남긴 헥사고날 MVP 완성. 코드 60% 감소, DB 4 테이블 → 1 테이블, endpoint 10개 → 5개, 외부 의존 4개 → 1개 (postgres) + 1 (hwpx-intelligence 외부).

실제 김기열 주무관님 파일 2개로 e2e 검증 완료. 데모일 (5/22) 진입 준비 끝.