From 06d6196fc0769857791d41f0abf8f1f31ecf503b Mon Sep 17 00:00:00 2001
From: Hyein <hikim2@samaneng.com>
Date: Fri, 20 Feb 2026 16:38:23 +0900
Subject: [PATCH] docs: add test.md explaining features of test.html

---
 test.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 test.md

diff --git a/test.md b/test.md
new file mode 100644
index 0000000..2ade43e
--- /dev/null
+++ b/test.md
@@ -0,0 +1,36 @@
+# 통합 원가 정산 시스템 (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를 유지합니다.
+
+---
+본 시스템은 원가 산출의 투명성을 높이고, 수작업으로 인한 오류를 방지하여 경영 의사결정을 돕는 도구로 활용됩니다.
\ No newline at end of file