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

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

📋 개요

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

---

🚀 핵심 기능 5선

1. 📋 프로젝트 정보 등록

🎯 시연 포인트

• 수주 정보 입력 → 자동 Job No. 생성
• 외주/자체제작 선택에 따른 워크플로우 분기

📱 구현 내용

• 프로젝트 기본 정보:
  • 프로젝트명, 고객사, 계약금액
  • 수주일, 납기일, 프로젝트 규모
• 자동 Job No. 생성: TK-YYYY-XXX 형식
• 제작 방식 선택: 외주 vs 자체제작
• 담당자 배정:
  • 설계팀, 품질팀, 구매팀, 생산팀
  • 각 팀별 담당자 및 팀장 지정

💡 하드코딩 데이터

const sampleProjects = [
  {
    jobNo: "TK-2024-015",
    name: "ABC 공장 배관공사",
    client: "ABC 케미칼",
    contractAmount: "150,000,000",
    orderDate: "2024-01-15",
    deliveryDate: "2024-03-30",
    productionType: "자체제작"
  }
];

---

2. 🏭 생산회의록 & 데일리 체크

🎯 시연 포인트

• 프로젝트별 통합 현황을 한눈에 확인
• 회의록 작성의 간편화 및 자동화

📱 구현 내용

📊 현황 대시보드

• 데일리 체크 현황:
  • 일일 진행률 (%)
  • 작업 완료 항목 / 전체 항목
  • 당일 이슈사항 요약
• 미입고 발주품 목록:
  • 발주일, 예정 입고일, 지연 일수
  • 🔴 지연 품목 별도 표시
• 생산팀 미전달 입고품:
  • 입고일, 품목명, 수량
  • 전달 대기 일수

✍️ 회의록 입력 시스템

• 간편 템플릿:
  • 드롭다운 메뉴 (진행상황, 이슈 유형)
  • 체크박스 (완료 항목)
  • 자동 완성 (자주 사용하는 문구)
• 이슈사항 빠른 입력:
  • 사전 정의된 이슈 유형
  • 담당자 자동 태그
• 액션 아이템 자동 생성:
  • 이슈별 담당자 및 완료 예정일 자동 설정

🔗 품질팀 연동

• 품질 검사 결과 실시간 반영
• 적합/부적합 상태 색상 표시
• 부적합 항목 우선 표시

💡 하드코딩 데이터

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. 완료 처리: 자동 생산팀 알림 발송

💡 하드코딩 데이터

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 리스트 전체 조회
• 자재 상태 추적:
  • 🟢 인수 완료: 생산팀에서 사용 가능
  • 🟡 입고됨 (미인수): 창고에 있지만 미전달
  • 🔴 발주됨 (미입고): 발주했지만 아직 미도착
  • ⚫ 미발주 품목: 아직 구매 진행 안됨

🔍 자재 부족시 대응

• 빠른 검색 기능:
  • 품목명, 규격으로 즉시 검색
  • 유사 품목 대체재 제안
• 자동 알림 시스템:
  • 구매팀에 긴급 요청 발송
  • 예상 입고일 자동 조회

💡 하드코딩 데이터

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 자동 생성
  • 재검사 일정 자동 등록

🔗 타 부서 연동 시스템

• 🏭 생산회의록 연동:
  • 실시간 품질 상태 표시
  • 부적합 항목 우선 표시
• 📋 출하전 보고서 연동:
  • 최종 품질 승인 여부
  • 미완료 검사 항목 차단
  • 대표 승인 전 필수 확인

💡 품질 시스템 아이디어 (향후 확장)

검사 유형별 템플릿

• 📏 치수 검사: 도면 대비 실측값 입력
• 🔬 재질 검사: 성분 분석 결과 첨부
• 💪 압력 테스트: 시험 압력/시간 기록
• 👁️ 외관 검사: 사진 첨부 + 결함 표시

자동화 기능

• 📊 통계 분석: 부적합률, 주요 결함 유형
• 🔔 알림 시스템: 검사 일정, 부적합 발생시 즉시 알림
• 📈 트렌드 분석: 공급업체별, 품목별 품질 추이

💡 하드코딩 데이터

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: 기본 기능 (시연용)

• 프로젝트 등록 시스템
• 생산회의록 대시보드
• 입고 관리 시스템
• 생산팀 작업 관리
• 품질 검사 시스템

Phase 2: 고도화

• 실제 DB 연동
• 사용자 권한 관리
• 모바일 앱 개발
• API 연동 (ERP, 회계 시스템)

Phase 3: 확장

• AI 기반 일정 예측
• IoT 센서 연동
• 고급 분석 및 리포팅
• 외부 업체 포털

---

본 문서는 TK Project 시연회를 위한 핵심 기능 정의서입니다. 실제 개발시에는 각 부서의 상세 요구사항을 추가로 수집하여 반영할 예정입니다.