issue-sample/test.md

통합 원가 정산 시스템 (test.html) 상세 설명

test.html 파일은 (주)장헌의 프로젝트별 원가 산출 및 배분을 자동화하기 위한 React 기반의 웹 애플리케이션입니다.

1. 핵심 기능

📁 데이터 로드 및 전처리

• 엑셀 연동: SheetJS 라이브러리를 통해 로컬의 엑셀 데이터(지출, 근무 기록)를 즉시 파싱합니다.
• 공통 비용 배분: 팀별/계정별 배분 비율(TEAM_RATIOS)에 따라 '공통'으로 처리된 지출액을 각 팀으로 자동 분할합니다.

⚙️ 원가 배분 엔진 (Cost Allocation)

• Pool A (운영 간접비): 복리후생비 등 일반적인 운영 간접비를 투입 공수(Man-Hour) 비율에 따라 프로젝트별로 배분합니다.
• Pool B (일반 관리비): 관리팀의 인건비 및 기타 관리비를 동일하게 공수 비율로 배분합니다.
• 실시간 엔진 컨트롤: 대시보드에서 Pool A/B 배분 여부를 즉시 켜고 끌 수 있어 시뮬레이션이 가능합니다.

👤 인건비 정산

• 유연한 급여 체계: 근무자별로 '월급제' 또는 '시급제'를 설정할 수 있습니다.
• 자동 단가 계산: 전체 투입 공수 대비 개별 프로젝트 공수를 계산하여 정확한 인건비 투입 실적을 도출합니다.

📊 시각화 대시보드

• 다차원 분석: 교량(프로젝트), 형식, 팀 등 다양한 기준으로 필터링된 원가 보고서를 제공합니다.
• 상세 분석 창: 특정 항목 선택 시 직접비와 배분된 간접비의 상세 비중을 차트 형태로 확인할 수 있습니다.

2. 기술 스택

• UI 라이브러리: React 18, Lucide Icons
• 스타일링: Tailwind CSS, Custom Glassmorphism UI
• 데이터 처리: SheetJS (Excel Parsing)
• 백엔드/DB: Firebase (Authentication, Firestore)
• 컴파일러: Babel (브라우저 내 실시간 트랜스파일링)

3. 기술적 특징

• Serverless Architecture: 별도의 서버 구축 없이 Firebase를 통해 데이터를 영속적으로 관리합니다.
• High Performance: useMemo를 통한 효율적인 원가 계산 로직으로 대용량 엑셀 데이터 처리 시에도 부드러운 UI를 유지합니다.

---

본 시스템은 원가 산출의 투명성을 높이고, 수작업으로 인한 오류를 방지하여 경영 의사결정을 돕는 도구로 활용됩니다.