From b2b61e7624d728fa6eea07df71789cd1f5762158 Mon Sep 17 00:00:00 2001
From: Hyungi Ahn <hyungiahn@Hyungiui-MacBookPro.local>
Date: Mon, 15 Sep 2025 08:09:13 +0900
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=8B=20=EC=8B=9C=EC=97=B0=ED=9A=8C?=
 =?UTF-8?q?=EC=9A=A9=20=ED=95=B5=EC=8B=AC=20=EA=B8=B0=EB=8A=A5=205?=
 =?UTF-8?q?=EC=84=A0=20=EB=AC=B8=EC=84=9C=20=EC=9E=91=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 프로젝트 정보 등록 시스템
- 생산회의록 & 데일리 체크
- 입고 검수 & 창고 관리
- 생산팀 작업 관리 (TK-FB 통합)
- 품질 관리 & 검사 시스템

시연 시나리오 및 하드코딩 데이터 포함
---
 TK_Project_Workflow.md | 146 ++++++++++++++++
 시연회_핵심기능_5선.md | 380 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 526 insertions(+)
 create mode 100644 TK_Project_Workflow.md
 create mode 100644 시연회_핵심기능_5선.md

diff --git a/TK_Project_Workflow.md b/TK_Project_Workflow.md
new file mode 100644
index 0000000..fe527e4
--- /dev/null
+++ b/TK_Project_Workflow.md
@@ -0,0 +1,146 @@
+# TK Project 워크플로우 시스템
+
+## 📋 개요
+TK Project는 수주부터 납품까지의 전체 프로젝트 라이프사이클을 관리하는 통합 시스템입니다.
+
+---
+
+## 🚀 1. 준비 단계
+
+### 1.1 프로젝트 등록
+- **수주에 따른 Job No. 부여**
+- **담당자**: 영업 또는 PM
+- **업무 내용**:
+  - 관련 정보 업로드 (관련 자료 + 담당자 정리본)
+  - 일정을 고려한 외주 & 자체제작 여부 확정
+
+### 1.2 업무 분기 및 일정 수립
+등록된 정보와 확정된 일정을 토대로 각 부서별 업무 분기:
+
+#### 🏗️ **설계팀**
+- 도면 일정 수립
+
+#### 🔍 **품질팀**
+- 검사 포인트 확인 및 일정 수립
+- ITP(Inspection and Test Plan) 작성
+
+#### 💰 **구매팀**
+- 외주 제작 일정 관리
+- 항목별 소요 기간 입력 (견적 진행 포함)
+
+#### 🏭 **생산팀**
+- 납기일 확인 후 제작일정 수립
+
+---
+
+## 🔄 2. 프로젝트 진행 단계 (발주)
+
+### 2.1 외주 제작 프로세스
+```
+도면 업로드 → 견적 진행 → 발주 → 관리페이지 (납기, 검사포인트 등)
+```
+
+### 2.2 자체 제작 프로세스
+```
+도면(BOM) 업로드 → 분류 → 구매신청 → 견적/발주 → 입고 → 검수 및 보관 → 검사 → 불출
+```
+
+#### 📦 **보관 단계 주요사항**
+- **입고 위치 정보 입력 필수**
+- 추가분 발생시 **리비전 로직**으로 진행
+
+#### ⚡ **긴급/가공건 처리**
+```
+구두 신청 (근거 필수) → 긴급 진행 → 사후 처리 (발주 담당자)
+```
+
+---
+
+## 🛠️ 3. 제작 단계
+
+### 3.1 외주 제작 관리
+
+#### 👥 **담당 부서**: 구매팀
+- 납기 관리
+- 업체 공정표 정보 입력 페이지 운영
+- 품질팀은 입력된 정보를 토대로 검사일정 수립
+
+#### 📋 **NCR (Non-Conformance Report) 처리 프로세스**
+```
+품질팀 작성 → 구매팀 전달 → 업체 송부 → 구매팀 업체 답변 수령 → 품질팀 전달
+```
+
+### 3.2 자체 제작 관리
+
+#### 🏭 **생산팀**
+- 공정표를 이용한 공정관리
+- 생산회의 활용 (관련 프로젝트 발주현황 확인 가능)
+
+#### 📦 **구매팀 → 생산팀 자재 인수인계**
+- 자재 상태 변경 관리
+- 미수령 자재 검색 지원 (위치정보 등)
+
+#### 🚨 **문제 발생시 처리**
+다음 문제들에 대한 종류와 발생 사유 입력 시스템:
+- 자재 문제
+- 설계 미스
+- 품질 미스  
+- 생산 미스
+
+**목적**: 차후 프로젝트 활용을 위한 데이터 축적
+
+#### 📊 **데일리 체크 개선**
+- 일일 진행상황 체크 시스템
+
+---
+
+## 🏢 4. 생산회의
+
+### 4.1 현황 관리
+- **제작 전, 제작 중** 모든 공정에 대한 현황 확인 가능
+- 공정표 표시 개선
+
+---
+
+## 📦 5. 납품 (출하전 보고서)
+
+### 5.1 출하 승인 프로세스
+```
+공정별 필수 확인점 완료 → 승인 요청 → 대표 승인 → 출하 가능
+```
+
+#### ✅ **필수 확인사항**
+- 상기 공정별 필수 확인점 여부 표시
+- **미완료 항목 있으면 승인요청 불가**
+
+---
+
+## ⚠️ 특이사항 (중요 요구사항)
+
+### 🔧 **시스템 유연성**
+- **각 업무별 관련 담당자(팀장)가 자유롭게 변형 가능** (UI 지원)
+
+### 📋 **정형화된 루틴**
+다음 프로세스는 **정형화된 루틴**으로 진행:
+```
+프로젝트 등록 → 구매신청 → 구매 → 생산팀 인계 → 비용 지불 → 계산서 업무
+```
+
+### 📊 **실시간 현황 확인**
+- **프로젝트 진행 중**: 생산회의록을 통한 필수 포인트 확인
+- **FAT 완료 후 납품 대기**: 출하전 보고서를 통한 남은 해결 포인트 확인
+- **불편함 없는 확인 시스템** 설계 필수
+
+---
+
+## 🎯 핵심 목표
+
+1. **통합 관리**: 수주부터 납품까지 원스톱 관리
+2. **실시간 현황**: 언제든 프로젝트 상태 확인 가능
+3. **유연성**: 각 부서별 맞춤형 워크플로우 지원
+4. **데이터 축적**: 문제 발생 이력을 통한 개선점 도출
+5. **승인 체계**: 단계별 필수 확인을 통한 품질 보장
+
+---
+
+*본 문서는 TK Project 시스템 개발을 위한 요구사항 정의서입니다.*
diff --git a/시연회_핵심기능_5선.md b/시연회_핵심기능_5선.md
new file mode 100644
index 0000000..05fe848
--- /dev/null
+++ b/시연회_핵심기능_5선.md
@@ -0,0 +1,380 @@
+# 🎯 TK Project 시연회용 핵심 기능 5선
+
+## 📋 개요
+시연회를 위해 선별된 TK Project의 핵심 기능들입니다. 
+DB 연동 없이 하드코딩으로 구현하여 전체 워크플로우를 효과적으로 시연할 예정입니다.
+
+---
+
+## 🚀 핵심 기능 5선
+
+### 1. **📋 프로젝트 정보 등록**
+
+#### 🎯 **시연 포인트**
+- 수주 정보 입력 → 자동 Job No. 생성
+- 외주/자체제작 선택에 따른 워크플로우 분기
+
+#### 📱 **구현 내용**
+- **프로젝트 기본 정보**:
+  - 프로젝트명, 고객사, 계약금액
+  - 수주일, 납기일, 프로젝트 규모
+- **자동 Job No. 생성**: `TK-YYYY-XXX` 형식
+- **제작 방식 선택**: 외주 vs 자체제작
+- **담당자 배정**:
+  - 설계팀, 품질팀, 구매팀, 생산팀
+  - 각 팀별 담당자 및 팀장 지정
+
+#### 💡 **하드코딩 데이터**
+```javascript
+const sampleProjects = [
+  {
+    jobNo: "TK-2024-015",
+    name: "ABC 공장 배관공사",
+    client: "ABC 케미칼",
+    contractAmount: "150,000,000",
+    orderDate: "2024-01-15",
+    deliveryDate: "2024-03-30",
+    productionType: "자체제작"
+  }
+];
+```
+
+---
+
+### 2. **🏭 생산회의록 & 데일리 체크**
+
+#### 🎯 **시연 포인트**
+- 프로젝트별 통합 현황을 한눈에 확인
+- 회의록 작성의 간편화 및 자동화
+
+#### 📱 **구현 내용**
+
+##### **📊 현황 대시보드**
+- **데일리 체크 현황**:
+  - 일일 진행률 (%)
+  - 작업 완료 항목 / 전체 항목
+  - 당일 이슈사항 요약
+- **미입고 발주품 목록**:
+  - 발주일, 예정 입고일, 지연 일수
+  - 🔴 지연 품목 별도 표시
+- **생산팀 미전달 입고품**:
+  - 입고일, 품목명, 수량
+  - 전달 대기 일수
+
+##### **✍️ 회의록 입력 시스템**
+- **간편 템플릿**:
+  - 드롭다운 메뉴 (진행상황, 이슈 유형)
+  - 체크박스 (완료 항목)
+  - 자동 완성 (자주 사용하는 문구)
+- **이슈사항 빠른 입력**:
+  - 사전 정의된 이슈 유형
+  - 담당자 자동 태그
+- **액션 아이템 자동 생성**:
+  - 이슈별 담당자 및 완료 예정일 자동 설정
+
+##### **🔗 품질팀 연동**
+- 품질 검사 결과 실시간 반영
+- 적합/부적합 상태 색상 표시
+- 부적합 항목 우선 표시
+
+#### 💡 **하드코딩 데이터**
+```javascript
+const meetingData = {
+  date: "2024-09-14",
+  attendees: ["김팀장", "이과장", "박대리"],
+  progress: {
+    overall: 75,
+    design: 100,
+    procurement: 80,
+    production: 60,
+    quality: 90
+  },
+  pendingItems: [
+    { item: "밸브 A", orderDate: "2024-09-01", expectedDate: "2024-09-10", delayDays: 4 },
+    { item: "파이프 B", orderDate: "2024-09-05", expectedDate: "2024-09-15", delayDays: 0 }
+  ]
+};
+```
+
+---
+
+### 3. **📦 입고 검수 & 창고 관리**
+
+#### 🎯 **시연 포인트**
+- 실시간 입고 현황 관리
+- 직관적인 창고 위치 지정 시스템
+
+#### 📱 **구현 내용**
+
+##### **🗺️ 가상 창고 지도**
+- **구역별 색상 구분**:
+  - 🟢 A구역 (파이프류)
+  - 🔵 B구역 (밸브류)  
+  - 🟡 C구역 (피팅류)
+  - 🔴 D구역 (기타)
+- **선반별 세부 위치**:
+  - 각 구역당 1~10번 선반
+  - 선반별 재고 현황 표시
+
+##### **📋 오늘 입고 예정 품목**
+- **실시간 입고 리스트**:
+  - 품목명, 수량, 공급업체
+  - 예정 시간, 담당자 연락처
+- **입고 상태 관리**:
+  - ✅ **정시 입고**: 예정 시간 내 도착
+  - ⚡ **조기 입고**: 예정보다 빠른 도착 (검색 기능)
+  - 🔴 **지연 품목**: 예정 시간 초과 (별도 알림)
+
+##### **🔍 입고 처리 프로세스**
+1. **품목 선택**: 입고된 품목 클릭
+2. **검수 진행**: 
+   - 수량 확인
+   - 외관 검사
+   - 규격 확인
+3. **위치 지정**: 구역 → 선반 → 세부 위치
+4. **완료 처리**: 자동 생산팀 알림 발송
+
+#### 💡 **하드코딩 데이터**
+```javascript
+const warehouseMap = {
+  zones: [
+    { id: "A", name: "파이프류", color: "#4CAF50", shelves: 10 },
+    { id: "B", name: "밸브류", color: "#2196F3", shelves: 8 },
+    { id: "C", name: "피팅류", color: "#FF9800", shelves: 12 },
+    { id: "D", name: "기타", color: "#F44336", shelves: 6 }
+  ]
+};
+
+const todayDeliveries = [
+  { item: "스테인리스 파이프 4인치", qty: 50, supplier: "대한파이프", time: "09:00", status: "정시" },
+  { item: "게이트밸브 2인치", qty: 10, supplier: "코리아밸브", time: "14:00", status: "조기" }
+];
+```
+
+---
+
+### 4. **🔧 생산팀 작업 관리 (TK-FB 통합)**
+
+#### 🎯 **시연 포인트**
+- TK-FB Project 기존 UI 활용한 친숙한 인터페이스
+- 통합된 자재 추적 시스템
+
+#### 📱 **구현 내용**
+
+##### **📝 일일 작업 입력 (TK-FB 스타일)**
+- **작업자별 업무 내용**:
+  - 담당 프로젝트, 작업 내용
+  - 시작/종료 시간, 작업 인원
+- **진행률 입력**:
+  - 슬라이더 또는 퍼센트 직접 입력
+  - 완료 예정일 자동 계산
+- **이슈사항 등록**:
+  - 자재 부족, 설계 변경, 품질 문제 등
+  - 사진 첨부 가능
+  - 담당 부서 자동 태그
+
+##### **📊 자재 현황 통합 뷰**
+- **프로젝트별 자재 검색**:
+  - 프로젝트명 또는 Job No.로 검색
+  - BOM 리스트 전체 조회
+- **자재 상태 추적**:
+  - 🟢 **인수 완료**: 생산팀에서 사용 가능
+  - 🟡 **입고됨 (미인수)**: 창고에 있지만 미전달
+  - 🔴 **발주됨 (미입고)**: 발주했지만 아직 미도착
+  - ⚫ **미발주 품목**: 아직 구매 진행 안됨
+
+##### **🔍 자재 부족시 대응**
+- **빠른 검색 기능**:
+  - 품목명, 규격으로 즉시 검색
+  - 유사 품목 대체재 제안
+- **자동 알림 시스템**:
+  - 구매팀에 긴급 요청 발송
+  - 예상 입고일 자동 조회
+
+#### 💡 **하드코딩 데이터**
+```javascript
+const dailyWork = {
+  date: "2024-09-14",
+  worker: "김철수",
+  tasks: [
+    {
+      project: "TK-2024-015",
+      work: "파이프 용접 작업",
+      startTime: "08:00",
+      endTime: "17:00",
+      progress: 85,
+      issues: ["밸브 A 미입고로 인한 작업 지연"]
+    }
+  ]
+};
+
+const materialStatus = {
+  "TK-2024-015": [
+    { item: "파이프 4인치", status: "인수완료", location: "A-3" },
+    { item: "밸브 2인치", status: "입고됨", location: "B-5" },
+    { item: "엘보 4인치", status: "발주됨", expectedDate: "2024-09-20" },
+    { item: "플랜지 4인치", status: "미발주", urgency: "높음" }
+  ]
+};
+```
+
+---
+
+### 5. **🔍 품질 관리 & 검사 시스템**
+
+#### 🎯 **시연 포인트**
+- 전 공정 품질 검사 및 적합성 판정
+- 타 부서와의 실시간 연동 시스템
+
+#### 📱 **구현 내용**
+
+##### **📊 검사 대시보드**
+- **프로젝트별 검사 일정**:
+  - 금주/금일 검사 예정 항목
+  - 검사 유형별 분류 (입고, 공정, 최종)
+- **검사 대기 품목 목록**:
+  - 우선순위별 정렬
+  - 검사 소요 예상 시간
+- **적합/부적합 현황 통계**:
+  - 일별/주별/월별 통계
+  - 부적합률 트렌드 분석
+
+##### **✅ 검사 처리 시스템**
+- **검사 항목 체크리스트**:
+  - 품목별 맞춤형 체크리스트
+  - 필수/선택 항목 구분
+- **증빙 자료 관리**:
+  - 사진/문서 첨부
+  - 측정값 입력 (치수, 압력 등)
+- **판정 및 처리**:
+  - 적합/부적합 판정
+  - 부적합시 NCR 자동 생성
+  - 재검사 일정 자동 등록
+
+##### **🔗 타 부서 연동 시스템**
+- **🏭 생산회의록 연동**:
+  - 실시간 품질 상태 표시
+  - 부적합 항목 우선 표시
+- **📋 출하전 보고서 연동**:
+  - 최종 품질 승인 여부
+  - 미완료 검사 항목 차단
+  - 대표 승인 전 필수 확인
+
+#### 💡 **품질 시스템 아이디어 (향후 확장)**
+
+##### **검사 유형별 템플릿**
+- 📏 **치수 검사**: 도면 대비 실측값 입력
+- 🔬 **재질 검사**: 성분 분석 결과 첨부  
+- 💪 **압력 테스트**: 시험 압력/시간 기록
+- 👁️ **외관 검사**: 사진 첨부 + 결함 표시
+
+##### **자동화 기능**
+- 📊 **통계 분석**: 부적합률, 주요 결함 유형
+- 🔔 **알림 시스템**: 검사 일정, 부적합 발생시 즉시 알림  
+- 📈 **트렌드 분석**: 공급업체별, 품목별 품질 추이
+
+#### 💡 **하드코딩 데이터**
+```javascript
+const qualityData = {
+  inspections: [
+    {
+      project: "TK-2024-015",
+      item: "게이트밸브 2인치",
+      type: "입고검사",
+      scheduled: "2024-09-14 14:00",
+      status: "대기중",
+      checklist: ["외관검사", "치수확인", "압력테스트"]
+    }
+  ],
+  statistics: {
+    daily: { total: 15, passed: 14, failed: 1 },
+    weekly: { total: 89, passed: 85, failed: 4 },
+    passRate: 95.5
+  }
+};
+```
+
+---
+
+## 🎪 통합 시연 시나리오
+
+### **🎬 시나리오: "ABC 공장 배관공사 프로젝트"**
+
+#### **Scene 1: 프로젝트 시작** (기능 1)
+1. 새 프로젝트 "ABC 공장 배관공사" 등록
+2. Job No. `TK-2024-015` 자동 생성
+3. 자체제작 선택, 각 팀 담당자 배정
+
+#### **Scene 2: 생산회의** (기능 2)
+1. 프로젝트 현황 대시보드 확인
+   - 전체 진행률 75%
+   - 미입고 품목: 밸브 A (4일 지연)
+   - 미전달 품목: 파이프 B (2일 대기)
+2. 회의록 작성
+   - 이슈: 밸브 납기 지연으로 인한 일정 조정 필요
+   - 액션: 구매팀 대체 업체 검토
+
+#### **Scene 3: 입고 처리** (기능 3)
+1. 오늘 입고 예정 5개 품목 확인
+2. 조기 입고된 "스테인리스 파이프 4인치" 검색
+3. 검수 완료 후 A구역-3번 선반에 위치 지정
+4. 자동으로 생산팀에 알림 발송
+
+#### **Scene 4: 품질 검사** (기능 5)
+1. 입고된 "게이트밸브 2인치" 검사 진행
+2. 체크리스트 완료: 외관검사 ✅, 치수확인 ✅, 압력테스트 ✅
+3. "적합" 판정 → 자동으로 생산회의록에 반영
+
+#### **Scene 5: 생산 작업** (기능 4)
+1. 김철수 팀장 일일 작업 입력
+   - 파이프 용접 작업 85% 완료
+2. 자재 현황 확인
+   - 파이프: 인수완료 ✅
+   - 밸브: 입고됨 (미인수) → 즉시 인수 처리
+3. 이슈 등록: "엘보 4인치 부족" → 구매팀 자동 알림
+
+---
+
+## 🚀 기대 효과
+
+### **👥 각 부서별 혜택**
+- **영업/PM**: 프로젝트 전체 현황 실시간 파악
+- **구매팀**: 발주 현황 및 입고 일정 통합 관리  
+- **생산팀**: 자재 추적 및 작업 일정 최적화
+- **품질팀**: 체계적인 검사 관리 및 이력 추적
+- **경영진**: 프로젝트별 진행 현황 및 문제점 즉시 파악
+
+### **💡 핵심 가치**
+1. **통합 관리**: 수주부터 납품까지 원스톱 시스템
+2. **실시간 현황**: 언제든 프로젝트 상태 확인 가능
+3. **자동화**: 반복 업무 최소화 및 휴먼 에러 방지
+4. **데이터 축적**: 문제 발생 이력을 통한 지속적 개선
+5. **의사소통**: 부서간 정보 공유 및 협업 강화
+
+---
+
+## 📋 개발 우선순위
+
+### **Phase 1: 기본 기능 (시연용)**
+- [x] 프로젝트 등록 시스템
+- [x] 생산회의록 대시보드  
+- [x] 입고 관리 시스템
+- [x] 생산팀 작업 관리
+- [x] 품질 검사 시스템
+
+### **Phase 2: 고도화**
+- [ ] 실제 DB 연동
+- [ ] 사용자 권한 관리
+- [ ] 모바일 앱 개발
+- [ ] API 연동 (ERP, 회계 시스템)
+
+### **Phase 3: 확장**
+- [ ] AI 기반 일정 예측
+- [ ] IoT 센서 연동
+- [ ] 고급 분석 및 리포팅
+- [ ] 외부 업체 포털
+
+---
+
+*본 문서는 TK Project 시연회를 위한 핵심 기능 정의서입니다.*
+*실제 개발시에는 각 부서의 상세 요구사항을 추가로 수집하여 반영할 예정입니다.*