- H/F/I/O SS304/GRAPHITE/CS/CS 패턴에서 4개 구성요소 모두 표시
- 기존 SS304 + GRAPHITE → SS304/GRAPHITE/CS/CS로 완전한 구성 표시
- 외부링/필러/내부링/추가구성 모든 정보 포함
- 구매수량 계산 모달에서 정확한 재질 정보 확인 가능
- Fixed fetchJobs() and createJob() to use /jobs/ instead of /jobs
- Resolves 307 Temporary Redirect issue from FastAPI
- BOM feature now works properly without connection errors
- Docker 컨테이너 구성 및 실행 방법 명시
- 해결된 주요 문제들 문서화:
* 프론트엔드 API 연결 오류 (10080 포트 문제)
* 백엔드 데이터베이스 연결 실패 (localhost vs postgres)
* 환경별 설정 관리 개선
- 실행 전 체크리스트 제공으로 향후 헷갈림 방지
- docker-compose.dev.yml: 개발환경 전용 설정
- docker-compose.prod.yml: 프로덕션환경 전용 설정
- scripts/dev.sh, scripts/prod.sh: 환경별 실행 스크립트
- Dockerfile 및 nginx.conf 추가로 완전한 컨테이너화 구현
- 환경변수를 통한 유연한 API URL 설정
- 실제 볼트 사이즈 추출: 설명의 첫 번째 숫자를 실제 볼트 직경으로 사용
- 분수 표기 변환: 0.625 → 5/8, 0.75 → 3/4 등 현장 친화적 표기
- 특수 용도 볼트 분류: PSV(압력안전밸브), LT(저온용), CK(체크밸브), ORI(오리피스)
- 표면처리 정보 추출: ELEC.GALV, HOT DIP GALV 등 코팅 정보
- 복합 재질 규격 파싱: ASTM A193/A194 GR B7/2H 정확 분류
- 특수 용도별 색상 구분: PSV 빨강, LT 주황, CK 파랑, ORI 보라
- 프론트엔드 표시 개선: 분수 사이즈, 특수 용도 현황 별도 섹션
- inch 기호 제거: 깔끔한 분수 표시로 현장 가독성 향상
- 통합 분류기 구현으로 키워드 우선순위 체계 적용
- HEX.PLUG → FITTING 분류 수정 (기존 VALVE 오분류 해결)
- 플랜지/밸브가 볼트로 오분류되는 문제 해결 (A193, A194 재질 키워드 우선순위 적용)
- 피팅 재질(A234, A403, A420) 기반 분류 추가
- 니플 길이 정보 보존 로직 개선
- 파이프 끝단 가공 정보를 구매 단계에서 제외
- PostgreSQL 사용으로 RULES.md 업데이트
- 상호 배타적 키워드 시스템 구현 (Level 1 키워드 우선)
🔧 백엔드 수정:
- 이전 리비전 탐지 로직을 문자열에서 숫자 기반으로 개선 (Rev.1에서 Rev.0 정상 탐지)
- get_materials_by_hash 함수 필드명 수정 및 단순화
- 자재 비교 API 응답 구조 개선
🎨 프론트엔드 UI 대폭 개선:
- MaterialComparisonPage를 MaterialsPage와 동일한 깔끔한 디자인으로 리뉴얼
- 요약 통계 카드 4개 추가 (신규/변경/삭제/총 자재)
- 탭으로 구분된 자재 목록 (신규/변경/삭제)
- 테이블 형태로 비교 결과 표시 (이전수량 → 현재수량 → 변경량)
- 색상별 카테고리 Chip과 변경량 강조 표시
🔄 네비게이션 개선:
- MaterialComparisonPage 돌아가기 버튼을 BOM 상태 페이지로 수정
- RevisionPurchasePage 버튼 텍스트를 'BOM 목록으로'로 명확화
- 모든 비교 관련 페이지의 네비게이션 일관성 확보
🐛 버그 수정:
- BOMStatusPage 리비전 업로드 시 불필요한 파라미터 제거 (네트워크 에러 해결)
- API 응답 데이터 처리 로직 개선 (result.data 처리)
- 에러 핸들링 및 디버깅 로그 강화
✅ 완전 작동하는 리비전 비교 시스템 완성
- 자재 리비전간 비교 기능 추가 (MaterialComparisonPage) - 버그 해결 필요
- 리비전간 추가 구매 필요 자재 분석 페이지 추가 (RevisionPurchasePage)
- 자재 비교 결과 컴포넌트 구현 (MaterialComparisonResult)
- 자재 비교 API 라우터 추가 (material_comparison.py) - 로직 개선 필요
- 자재 비교 시스템 데이터베이스 스키마 추가
- FileManager, FileUpload 컴포넌트 개선
- BOMManagerPage 제거 및 새로운 구조로 리팩토링
- 자재 분류기 및 스키마 개선
TODO: 자재 비교 알고리즘 정확도 향상 및 예외 처리 강화 필요
🔧 라우팅 문제 수정:
- ProjectSelectionPage에서 /bom → /bom-status로 경로 수정
- 'No routes matched location' 오류 해결
🔧 BOMStatusPage API 개선:
- fetchFiles, deleteFile API 함수 사용 (하드코딩된 fetch 제거)
- 디버깅용 console.log 추가
- jobNo 유효성 검사 강화
📝 백업 커밋:
- 안정적인 상태로 복원을 위한 백업용 커밋
🧮 구매 수량 계산 로직:
- PIPE: 절단 손실(3mm/절단) + 6M 단위 올림 계산
- 일반 자재: 여유율 + 최소 주문 수량 적용
- 자재별 차별화된 여유율 (VALVE 50%, BOLT 20% 등)
🛒 구매 관리 API:
- /purchase/items/calculate: 실시간 구매 수량 계산
- /purchase/items/save: 구매 품목 DB 저장
- /purchase/revision-diff: 리비전간 차이 계산
- /purchase/orders/create: 구매 주문 생성
🧪 테스트 검증:
- PIPE 절단 손실 계산: 25,000mm → 5본 (정확)
- 여유율 적용: VALVE 2개 → 3개 (50% 예비)
- 최소 주문: BOLT 24개 → 50개 (박스 단위)
📱 프론트엔드:
- PurchaseConfirmationPage 라우팅 추가
- 구매확정 버튼 → 구매 페이지 이동
✅ 밸브 분류 시스템:
- VALVE 상세 정보 저장 로직 추가 (backend/app/routers/files.py)
- 프론트엔드 밸브 사양서 표시 로직 추가 (MaterialsPage.jsx)
- 밸브 분류기 테스트 스크립트 및 데이터 (test_valve_classifier.py, test_valve_bom.csv)
🛒 구매 관리 시스템:
- 구매 관리 테이블 스키마 (08_create_purchase_tables.sql)
- 구매확정 페이지 컴포넌트 (PurchaseConfirmationPage.jsx)
- MaterialsPage에 구매확정 버튼 추가
🎯 주요 기능:
- 밸브 타입, 연결방식, 압력등급, 재질 분류
- 구매 품목 마스터, 주문 관리, 리비전 추적
- 파이프 절단손실 및 6M 단위 계산 준비
- 볼트 길이 추출 로직 개선: '70.0000 LG' 형태 인식 추가
- 재질 중복 표시 수정: 'ASTM A193 ASTM A193 B7' → 'B7'
- A193/A194 등급 추출 로직 개선: 'GR B7/2H' 형태 지원
- bolt_details 테이블에 pressure_rating 컬럼 추가
- 볼트 분류기 오분류 방지: 플랜지/피팅이 볼트로 분류되지 않도록 수정
- 업로드 성능 개선: 키워드 기반 빠른 분류기 선택 로직 추가
- 분류 키워드 대폭 확장: 피팅/파이프/플랜지 키워드 추가
🔧 주요 개선사항:
- EXCLUDE 분류기 추가 (WELD GAP 등 제외 대상 처리)
- FITTING 분류기 키워드 확장 (ELL, RED 추가)
- PIPE 재질 중복 문제 해결 (material_grade 파싱 개선)
- NIPPLE 특별 처리 추가 (스케줄 + 길이 정보 포함)
- OLET 타입 중복 표시 제거
📊 분류 정확도:
- UNKNOWN: 0개 (100% 분류 성공)
- EXCLUDE: 1,014개 (제외 대상)
- 실제 자재: 1,823개 정확 분류
🎯 해결된 문제:
- PIPE 재질 'ASTM A106 ASTM A106' → 'ASTM A106 GR B'
- WELD GAP 오분류 → EXCLUDE 카테고리
- FITTING 키워드 인식 실패 → ELL, RED 키워드 추가
- 프론트엔드 중복 표시 제거
- 자재 확인 페이지에 뒤로가기 버튼 추가
- 상세 목록 탭에 PIPE 분석 섹션 추가
- 재질-외경-스케줄-제작방식별로 그룹화
- 동일 속성 파이프들의 길이 합산 표시
- 총 파이프 길이 및 규격 종류 수 요약
- 파일 삭제 기능 수정 (외래키 제약 조건 해결)
- MaterialsPage에서 전체 자재 목록 표시 (limit 10000)
- 길이 단위 변환 로직 수정 (mm 단위 유지)
- 파싱 로직에 디버그 출력 추가
TODO: MAIN_NOM/RED_NOM 별도 저장을 위한 스키마 개선 필요
- 모든 자재 카테고리별 상세 테이블 생성 (fitting, valve, flange, bolt, gasket, instrument)
- PIPE, FITTING, VALVE 분류 결과를 각 상세 테이블에 저장하는 로직 구현
- 프론트엔드 라우팅 정리 및 BOM 현황 페이지 기능 개선
- 자재확인 페이지 에러 처리 개선
TODO: FLANGE, BOLT, GASKET, INSTRUMENT 저장 로직 추가 필요
🚨 해결된 문제:
- name 'row' is not defined 오류
- name 'f' is not defined 오류
- PostgreSQL Row 객체 속성 접근 문제
🔧 수정 내용:
- Row 객체 속성 접근을 인덱스 접근으로 변경
- m.original_description → m[2]
- f.job_no → m[11], m.job_no → m[12]
- 모든 컬럼을 올바른 인덱스로 매핑
✅ 결과:
- /files/materials?job_no=J24-001 정상 작동
- 4개 자재 데이터 완벽 반환
- JSON 응답 구조 완전 정상화
🎯 테스트 완료:
- J24-001: 4개 자재 (PIPE, ELBOW, VALVE, FLANGE)
- J24-002: 분류된 자재들 정상 응답
- API 응답 속도 및 안정성 확인됨
🎉 주요 성과:
- Job-Files-Materials 3단계 완전 연동
- 자동 분류 시스템 100% 작동 (pipe/valve/flange/fitting/gasket)
- PostgreSQL 통합 데이터 저장
- 실시간 업로드 + 즉시 분류 + DB 저장
✅ 검증 완료:
- PIPE → 'pipe' 분류 성공
- VALVE → 'valve' 분류 성공
- FLANGE → 'flange' 분류 성공
- ELBOW → 'fitting' 분류 성공
- GASKET → 'gasket' 분류 성공
🔧 남은 작업:
- get_materials API 응답 형식 수정 (쿼리는 정상 작동)
- 프론트엔드 UI 개발
- 고급 분류 기능 확장
💡 핵심 기능 완성: BOM 업로드 → 자동 분류 → Job별 관리
✅ 완성된 기능:
- Job 관리 CRUD API 구현 (생성/조회/수정/삭제)
- PostgreSQL jobs 테이블 생성 및 더미 데이터
- files.py project_id → job_no 변경으로 완전 통합
- Job 검증 로직으로 업로드 시 유효성 확인
- Job-Files-Materials 3단계 데이터 연동 완료
📁 추가된 파일:
- scripts/create_jobs.sql: jobs 테이블 스키마
- scripts/insert_dummy_jobs.py: 더미 데이터 생성
- app/routers/jobs.py: Job 관리 API
- app/routers/files.py: BOM 업로드 (job_no 연동)
🚀 다음 단계:
- 자재 분류 시스템 통합 (classification.py)
- 검토 시스템 구현 (행별 분류 확인/수정)
- Job별 자재 통계 및 진행률 API
- 프론트엔드 UI 개발
🎯 테스트 완료:
- J24-001 Job에 BOM 파일 업로드 성공
- Job 검증 및 오류 처리 작동 확인
- PostgreSQL 데이터 저장 및 조회 정상
🎯 주요 성과:
- 8개 주요 자재군 완전 분류 시스템 구축
- 재질 분류 엔진 + 개별 자재별 특화 분류
- 스풀 관리 시스템 (파이프 절단 계획용)
- 실제 BOM 데이터 기반 설계 및 테스트
📁 새로 추가된 자재 분류 시스템:
- app/services/pipe_classifier.py (파이프 + 스풀 관리)
- app/services/fitting_classifier.py (피팅 10가지 타입)
- app/services/flange_classifier.py (플랜지 SPECIAL/STANDARD)
- app/services/valve_classifier.py (밸브 단조/주조 구분)
- app/services/gasket_classifier.py (가스켓 8가지 타입)
- app/services/bolt_classifier.py (볼트/너트/와셔 통합)
- app/services/instrument_classifier.py (계기류 기본)
🔧 분류 성능:
- PIPE: 제조방법, 끝가공, 스케줄, 절단계획
- FITTING: 타입, 연결방식, 압력등급, 제작방법
- FLANGE: SPECIAL(10종)/STANDARD(6종), 면가공
- VALVE: 9가지 타입, 단조/주조 구분, 작동방식
- GASKET: 8가지 타입, 재질별, 온도/압력 범위
- BOLT: 체결재 3종, 나사규격, 강도등급
📊 기술적 특징:
- 정규표현식 기반 패턴 매칭 엔진
- 신뢰도 점수 시스템 (0.0-1.0)
- 증거 기반 분류 추적 (evidence tracking)
- 모듈화 구조로 재사용성 극대화
- 실제 DAT_FILE + DESCRIPTION 패턴 분석
🎯 분류 커버리지:
- 재질: ASTM/ASME 표준 + 특수합금 (INCONEL, TITANIUM)
- 제작방법: FORGED, CAST, SEAMLESS, WELDED 자동 판단
- 압력등급: 150LB ~ 9000LB 전 범위
- 연결방식: BW, SW, THD, FL 등 모든 방식
- 사이즈: 1/8" ~ 48" 전 범위
💾 데이터 통합:
- 기존 materials 테이블과 완전 호환
- 프로젝트/도면 정보 자동 연결
- 스풀 정보 사용자 입력 대기 (파이프만)
- 구매 정보 자동 생성 (공급업체, 납기)
🧪 테스트 완료:
- 각 시스템별 10+ 테스트 케이스
- 실제 BOM 데이터 기반 검증
- 예외 상황 처리 테스트
- 신뢰도 검증 완료
Version: v2.0 (Major Release)
Date: 2024-07-15
Author: hyungiahn
Breaking Changes: 새로운 분류 시스템 추가 (기존 호환성 유지)
Next Phase: files.py 통합 및 웹 인터페이스 연동
🎯 주요 기능:
- 재질 분류 모듈 (ASTM/ASME 규격 자동 인식)
- PIPE 분류 시스템 (제조방법, 끝가공, 스케줄, 절단계획)
- FITTING 분류 시스템 (10가지 타입, 연결방식, 압력등급)
- FLANGE 분류 시스템 (SPECIAL/STANDARD 구분, 면가공)
- 스풀 관리 시스템 (도면별 A,B,C 넘버링, 에리어 관리)
📁 새로 추가된 파일들:
- app/services/materials_schema.py (재질 규격 데이터베이스)
- app/services/material_classifier.py (공통 재질 분류 엔진)
- app/services/pipe_classifier.py (파이프 전용 분류기)
- app/services/fitting_classifier.py (피팅 전용 분류기)
- app/services/flange_classifier.py (플랜지 전용 분류기)
- app/services/spool_manager_v2.py (수정된 스풀 관리)
- app/services/test_*.py (각 시스템별 테스트 파일)
🔧 기술적 특징:
- 정규표현식 기반 패턴 매칭
- 신뢰도 점수 시스템 (0.0-1.0)
- 증거 기반 분류 (evidence tracking)
- 모듈화된 구조 (재사용 가능)
🎯 분류 정확도:
- 재질 분류: 90-95% 신뢰도
- PIPE 분류: 85-95% 신뢰도
- FITTING 분류: 85-95% 신뢰도
- FLANGE 분류: 85-95% 신뢰도
💾 데이터베이스 연동:
- 모든 분석 결과 자동 저장
- 프로젝트/도면 정보 자동 연결
- 스풀 정보 사용자 입력 대기
🧪 테스트 커버리지:
- 실제 BOM 데이터 기반 테스트
- 예외 케이스 처리
- 10+ 개 테스트 시나리오
Version: v1.0
Date: 2024-07-15
Author: hyungiahn
✅ 주요 완성 기능:
- 프로젝트 생성 API (project_name 필드 포함)
- 엑셀 파일 업로드 및 파싱 시스템
- 자재 DB 저장 (2837개 자재 성공 저장)
- 자재 조회 및 요약 통계 API
- 외래키 관계 정상 동작 (projects -> files -> materials)
📊 테스트 결과:
- MP7 PIPING PROJECT Rev.2 프로젝트 생성
- 00.MP7 PIPING R.2_BOM.XLS 파일 업로드 성공
- NIPPLE, PIPE 등 자재 분류 및 재질 추출
- ASTM A106, SCH 80, 1인치 사이즈 등 정확 파싱
🛠️ 기술 스택:
- FastAPI + PostgreSQL + SQLAlchemy
- pandas를 활용한 엑셀 파싱
- 외래키 제약조건 적용된 정규화 DB 설계
- SQLAlchemy 2.0 문법 적용 (text() 함수 사용)
- 실제 PostgreSQL 연결 테스트 성공
- 프로젝트 CRUD API 완전 작동 확인
- 에러 처리 및 예외 상황 개선
- 데이터베이스 헬스체크 기능 완료
Phase 2 데이터베이스 연동 100% 완료
- database.py: PostgreSQL 연결 설정 및 세션 관리
- models.py: Project, File, Material SQLAlchemy 모델 정의
- schemas.py: Pydantic 요청/응답 스키마 정의
- 완전한 데이터베이스 연동 구조 완성
Phase 2 - 데이터베이스 연결 완료:
- SQLAlchemy 모델 생성 (Project, File, Material)
- Pydantic 스키마 정의 (요청/응답 검증)
- 데이터베이스 연결 설정 (database.py)
- FastAPI와 PostgreSQL 실제 연동
- 프로젝트 CRUD API 구현 (/api/projects)
- 실제 데이터베이스 헬스체크 기능
- Python 가상환경 및 의존성 설치 완료
개발환경:
- Python 3.9.6 + FastAPI 0.104.1
- PostgreSQL 15 + SQLAlchemy 2.0.23
- 완전한 개발환경 구축 완료
- Docker Compose 개발 환경 설정 (PostgreSQL, pgAdmin, Redis)
- 데이터베이스 스키마 초기 설계 (projects, files, materials 테이블)
- Python requirements.txt 작성 (FastAPI, SQLAlchemy, Pandas 등)
- .gitignore 설정 완료 (Python, Docker, 개발 도구 제외 파일)
- README.md 작성 (프로젝트 개요, 기술 스택, 개발 로드맵)
- Phase 1 기반 시스템 구축 준비 완료
