TK-Project/시연회_핵심기능_5선.md

# 🎯 TK Project 시연회용 핵심 기능 5선

## 📋 개요
시연회를 위해 선별된 TK Project의 핵심 기능들입니다. 
DB 연동 없이 하드코딩으로 구현하여 전체 워크플로우를 효과적으로 시연할 예정입니다.

---

## 🚀 핵심 기능 5선

### 1. **📋 프로젝트 정보 등록 (2단계 시스템)**

#### 🎯 **시연 포인트**
- 1단계: 프로젝트 생성 및 기본 정보 입력
- 2단계: 킥오프 미팅 후 세부 사양 및 요구사항 입력

---

#### **📝 1단계: 프로젝트 생성**

##### **📱 구현 내용**
- **프로젝트 기본 정보**:
  - 프로젝트명, 고객사, 계약금액
  - 수주일, **납기일**, 프로젝트 규모
  - **납품방식**: 현장납품/공장인도/부분납품
- **자동 Job No. 생성**: `TK-YYYY-XXX` 형식
- **제작 방식 선택**: 외주 vs 자체제작
- **담당자 배정**:
  - 영업담당, PM, 설계팀장, 품질팀장, 구매팀장, 생산팀장

##### **💡 하드코딩 데이터**
```javascript
const projectBasicInfo = {
  jobNo: "TK-2024-015",
  name: "ABC 공장 배관공사",
  client: "ABC 케미칼",
  contractAmount: "150,000,000",
  orderDate: "2024-01-15",
  deliveryDate: "2024-03-30",
  deliveryMethod: "현장납품", // 현장납품/공장인도/부분납품
  productionType: "자체제작",
  scale: "중형", // 소형/중형/대형
  status: "승인완료" // 기본정보입력 = 프로젝트승인
};
```

---

#### **🎯 2단계: 세부 사양 입력**

##### **📱 구현 내용**
- **킥오프 미팅 결과**:
  - 미팅 일자, 참석자, 주요 결정사항
  - 고객 요구사항 변경점
- **기술 사양서 (User Spec)**:
  - 설계 기준 (ASME, KS, JIS 등)
  - 사용 압력, 온도, 유체 종류
  - 특수 요구사항 (내식성, 내압성 등)
- **프로젝트 세부 일정**:
  - 설계 완료일, 자재 발주 완료일
  - 제작 시작일, FAT 일정, 납품 일정
- **품질 요구사항**:
  - 필수 검사 항목, 성적서 요구사항
  - 고객 입회 검사 여부
- **특이사항 및 리스크**:
  - 기술적 난이도, 일정상 제약
  - 고객사 특수 요구사항

##### **💡 하드코딩 데이터**
```javascript
const projectDetailInfo = {
  jobNo: "TK-2024-015",
  kickoffMeeting: {
    date: "2024-01-20",
    attendees: ["김영업", "이PM", "박설계", "최고객"],
    decisions: ["압력등급 150LB로 확정", "재질 SS316L로 변경"]
  },
  technicalSpec: {
    designStandard: "ASME B31.3",
    workingPressure: "10 bar",
    workingTemperature: "80°C",
    fluid: "화학용매",
    specialRequirements: ["내식성 강화", "고온 대응"]
  },
  schedule: {
    designComplete: "2024-02-15",
    procurementComplete: "2024-02-28",
    productionStart: "2024-03-01",
    fatDate: "2024-03-25",
    deliveryDate: "2024-03-30"
  },
  qualityRequirements: {
    mandatoryTests: ["압력시험", "재질성분분석", "용접검사"],
    certificates: ["재질증명서", "압력시험성적서", "용접검사성적서"],
    customerWitness: true
  },
  risks: [
    { type: "기술", description: "특수 합금 용접 기술 필요", level: "중" },
    { type: "일정", description: "납기 단축 요구", level: "높음" },
    { type: "품질", description: "고객사 높은 품질 기준", level: "중" }
  ],
  status: "진행중", // 세부사양은 지속적으로 업데이트
  lastUpdated: "2024-01-25"
};
```

---

#### **🔄 프로젝트 진행 워크플로우**

##### **Step 1: 프로젝트 생성 및 승인** (영업팀)
```
수주 확정 → 기본 정보 입력 → Job No. 생성 → 담당자 배정 → 프로젝트 승인 ✅
```
**⚠️ 중요**: 기본 정보 입력 완료 = 프로젝트 승인 완료 (프로젝트 시작)

##### **Step 2: 킥오프 미팅** (선택적, 프로젝트 진행 중)
```
고객 미팅 → 요구사항 정리 → 내부 검토 → 세부 일정 수립
```
**📝 특징**: 프로젝트 진행 중 언제든 추가/수정 가능

##### **Step 3: 세부 사양 입력** (지속적, PM 주도)
```
기술사양 입력 → 품질요구사항 정리 → 리스크 분석 → 정보 업데이트
```
**📝 특징**: 납품까지 지속적으로 추가/수정 가능

##### **Step 4: 지속적 정보 관리** (전 기간)
```
설계 변경 → 고객 요구사항 변경 → 일정 조정 → 품질 기준 변경
```
**📝 특징**: 프로젝트 전 기간에 걸쳐 필요시 언제든 업데이트

---

### 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단계: 프로젝트 생성 및 승인**
1. 영업팀에서 새 프로젝트 "ABC 공장 배관공사" 등록
2. Job No. `TK-2024-015` 자동 생성
3. 납기일 2024-03-30, 납품방식 "현장납품" 설정
4. 자체제작 선택, 각 팀 담당자 배정
5. **✅ 기본정보 입력 완료 = 프로젝트 승인 완료** (프로젝트 시작)

##### **2단계: 세부 사양 입력** (프로젝트 진행 중 지속적 업데이트)
1. 킥오프 미팅 결과 입력 (2024-01-20)
   - 참석자: 김영업, 이PM, 박설계, 최고객
   - 주요 결정: 압력등급 150LB, 재질 SS316L 변경
2. 기술 사양서 입력
   - 설계기준: ASME B31.3
   - 사용압력: 10 bar, 온도: 80°C
   - 유체: 화학용매, 특수요구: 내식성 강화
3. 품질 요구사항 설정
   - 필수검사: 압력시험, 재질분석, 용접검사
   - 고객 입회검사 필요
4. 리스크 분석 완료 → **정보 업데이트** (납품까지 지속적 관리)

#### **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 시연회를 위한 핵심 기능 정의서입니다.*
*실제 개발시에는 각 부서의 상세 요구사항을 추가로 수집하여 반영할 예정입니다.*