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. **🏭 생산회의록 시스템**

#### 🎯 **시연 포인트**
- 선택한 프로젝트의 공정표 기반 일정 관리
- 캘린더 기반 마감일자 관리 및 Follow-up 추적

#### 📱 **구현 내용**

##### **📋 프로젝트 공정표 (상단)**
- **공정별 진행 현황**:
  - 설계 → 구매 → 제작 → 검사 → 납품 단계별 표시
  - 각 공정별 진행률 (%) 및 상태 (완료/진행중/대기)
  - 담당자 및 예정 완료일
- **Gantt Chart 스타일**:
  - 시각적 타임라인 표시
  - 지연 공정 빨간색 표시
  - 임계 경로 (Critical Path) 강조

##### **📅 캘린더 기반 마감일자 관리 (중앙)**
- **주요 마감일 등록**:
  - 도장 외주: 출고일 (2024-09-20) → 입고 예정일 (2024-09-25)
  - 추가 발주품: 엘보 10EA → 입고 예정일 (2024-09-18)
  - 검사 일정: 압력시험 (2024-09-22), 고객 입회검사 (2024-09-28)
- **일정 입력 방식**:
  - 캘린더 클릭 → 일정 유형 선택 → 상세 내용 입력
  - 길어지는 내용은 클릭하여 **메모 형식**으로 상세 입력 가능
- **알림 시스템**:
  - D-3, D-1 자동 알림
  - 지연 일정 빨간색 표시

##### **📦 입고 예정 품목 (우측)**
- **해당 프로젝트 발주 현황**:
  - 발주 품목명, 수량, 공급업체
  - 발주일, 예정 입고일, 현재 상태
- **상태별 색상 구분**:
  - 🟢 **정상**: 예정일 내 입고 예상
  - 🟡 **주의**: 입고일 임박 (D-2 이내)
  - 🔴 **지연**: 예정일 초과
- **리스트 형식**:
  ```
  ✅ 파이프 4인치 x 50EA (입고완료 - 09/10)
  🟡 밸브 2인치 x 10EA (입고예정 - 09/16)
  🔴 엘보 4인치 x 20EA (지연 - 09/12 → 09/18)
  ```

##### **⚠️ Follow-up 리스트 (하단)**
- **미해결 중요 사항**:
  - 우선순위별 정렬 (긴급/높음/보통)
  - 등록일, 담당자, 예상 해결일
- **Follow-up 항목 예시**:
  - 🔴 **긴급**: 밸브 A 납기 지연 → 대체 업체 검토 중 (구매팀)
  - 🟡 **높음**: 용접 검사 일정 조정 필요 (품질팀)
  - 🟢 **보통**: 도면 수정 요청 검토 (설계팀)

#### 💡 **하드코딩 데이터**
```javascript
const productionMeeting = {
  project: "TK-2024-015",
  date: "2024-09-14",
  
  // 공정표
  processChart: {
    design: { progress: 100, status: "완료", dueDate: "2024-02-15", responsible: "박설계" },
    procurement: { progress: 85, status: "진행중", dueDate: "2024-02-28", responsible: "김구매" },
    production: { progress: 60, status: "진행중", dueDate: "2024-03-20", responsible: "이생산" },
    inspection: { progress: 0, status: "대기", dueDate: "2024-03-25", responsible: "최품질" },
    delivery: { progress: 0, status: "대기", dueDate: "2024-03-30", responsible: "박PM" }
  },
  
  // 캘린더 일정
  schedule: [
    {
      date: "2024-09-20",
      type: "외주출고",
      title: "도장 작업 출고",
      memo: "A구역 파이프 20본, B구역 밸브 5개\n업체: 대한도장\n연락처: 010-1234-5678",
      responsible: "김구매"
    },
    {
      date: "2024-09-22",
      type: "검사일정", 
      title: "압력시험",
      memo: "시험압력: 15bar, 30분간 유지\n검사자: 최품질, 이생산",
      responsible: "최품질"
    }
  ],
  
  // 입고 예정 품목
  expectedDeliveries: [
    { item: "파이프 4인치", qty: 50, supplier: "대한파이프", orderDate: "2024-09-01", expectedDate: "2024-09-10", status: "입고완료" },
    { item: "밸브 2인치", qty: 10, supplier: "코리아밸브", orderDate: "2024-09-05", expectedDate: "2024-09-16", status: "정상" },
    { item: "엘보 4인치", qty: 20, supplier: "피팅코리아", orderDate: "2024-09-08", expectedDate: "2024-09-12", actualDate: "2024-09-18", status: "지연" }
  ],
  
  // Follow-up 리스트
  followUps: [
    {
      id: 1,
      priority: "긴급",
      title: "밸브 A 납기 지연 대응",
      description: "주 공급업체 생산 지연으로 대체 업체 검토 필요",
      responsible: "김구매",
      registeredDate: "2024-09-10",
      expectedResolution: "2024-09-17",
      status: "진행중"
    },
    {
      id: 2, 
      priority: "높음",
      title: "용접 검사 일정 조정",
      description: "고객사 일정 변경으로 검사일 재조정 필요",
      responsible: "최품질",
      registeredDate: "2024-09-12",
      expectedResolution: "2024-09-20",
      status: "검토중"
    }
  ]
};
```

##### **📝 데일리 체크 (별도 페이지)**
> **참고**: 데일리 체크는 별도 기능으로 분리 예정
- **문제 발생 즉시 기록**:
  1. **즉시 해결**: 문제 → 책임 → 해결자 → 사진자료 → 완료처리
  2. **지연 해결**: 문제 기록 → Follow-up 등록 → 해결책 강구 → 해결 완료
- **생산회의록과 연동**: 미해결 문제는 Follow-up 리스트에 자동 반영

---

### 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. **프로젝트 TK-2024-015 선택** → 생산회의록 화면 진입
2. **공정표 확인** (상단)
   - 설계: 100% 완료 ✅
   - 구매: 85% 진행중 🟡 
   - 제작: 60% 진행중 🟡
   - 검사: 대기 ⏸️
3. **캘린더 일정 확인** (중앙)
   - 9/20: 도장 외주 출고 예정
   - 9/22: 압력시험 일정
   - 클릭하여 상세 메모 확인 (업체 연락처, 시험 조건 등)
4. **입고 예정 품목** (우측)
   - ✅ 파이프 4인치: 입고완료
   - 🟡 밸브 2인치: 9/16 입고예정 (D-2)
   - 🔴 엘보 4인치: 지연 (9/12 → 9/18)
5. **Follow-up 리스트** (하단)
   - 🔴 긴급: 밸브 A 납기 지연 대응 (김구매 담당)
   - 🟡 높음: 용접 검사 일정 조정 (최품질 담당)

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