1. 해결하려는 업무문제

• 5개 이상 해외 현장(Peaking Unit, Rumah, Nairyah, PP12, Turkistan)의 커미셔닝 인력 배치 현황이 프로젝트별 개별 엑셀로 관리되어, 전사 차원에서 "지금 KR/GE 인력이 어디에 몇 명, 언제 투입 예정인지"를 한눈에 파악하기 어려움
• 담당자가 바뀌거나 파일이 이메일·공유폴더로 흩어지면서 어느 버전이 최신인지 혼선이 발생하기 쉬움
• 조직도·마일스톤·인력 배치 현황을 보려면 매번 엑셀을 열고 수작업으로 보고자료를 다시 만들어야 함
• 사내 보안 정책상 엑셀 파일 자체의 웹 업로드가 차단되어 있어, 일반적인 방식의 웹 대시보드 구축이 불가능했던 상황
• 단기 출장(1개월 미만)과 장기 파견이 구분 없이 섞여 있어 인원수 집계에 혼선

2. 해결방안 / 업무 적용 시나리오

• 기존에 쓰던 엑셀 양식을 그대로 유지 (사용자 워크플로우 변경 없음) — 담당자는 늘 하던 대로 엑셀만 채우면 됨
• 그 엑셀을 대시보드에 업로드만 하면 조직도·월별 투입현황 차트·마일스톤 타임라인·KPI가 자동으로 갱신
• 링크 하나로 사내 누구나 실시간 열람 가능 — PIN을 가진 담당자만 업데이트 권한
• 적용 시나리오: 현장 담당자가 인력 변경사항을 반영한 엑셀을 업로드 → 그 즉시 서버에 반영 → 본사 담당자·경영진이 같은 링크에서 새로고침만 눌러 최신 배치 현황 확인 → 이메일로 파일을 주고받거나 별도 보고자료를 만들 필요 없음
• 출장자와 파견 인력을 구조적으로 분리해서 관리, 주간/월간 단위로 "이번 주 현장에 갈 사람" 명단까지 바로 확인 가능
• 필요 시 현재 시스템 데이터를 다시 엑셀로 추출해 오프라인 보고·타 시스템 연동에도 활용 가능

3. AI 활용방법

• 요구사항을 대화로 설명하면 AI가 이를 구조화된 설계 명세서로 정리 → 승인 후 구현 → 검증하는 사이클을 반복하며 전 과정 진행
• 기존에 존재하던 레거시 Excel 변환 스크립트(update_data.py)를 AI가 직접 분석해서, 처음부터 새로 만들지 않고 기존 로직을 최대한 재사용하며 확장
• 사내 보안 정책으로 업로드가 막혔을 때, AI가 원인을 진단(웹 트래픽 정책이 xlsx 파일 자체를 차단)하고 브라우저 안에서 변환을 마친 뒤 JSON만 전송하는 우회 아키텍처를 직접 설계·구현
• 신규 기능(출장자 관리, 대량 Excel 추출, 주간/월간 현황 패널) 요청 시, 실 서비스에 반영하기 전 격리된 복제 환경에서 실제 데이터로 자동 테스트(파일 파싱·왕복 검증·화면 렌더링)를 수행한 뒤에만 실제 폴더에 반영
• 발생한 버그(팝업이 안 닫힘, 날짜가 하루씩 밀림, 실행 파일이 안 열림 등)를 AI가 직접 재현 스크립트를 만들어 근본 원인을 추적하고 수정
• 이 설계 문서 자체도 매 단계마다 AI가 최신 상태로 정리해 축적

4. 기대효과 / 정량효과

• 인력 현황 갱신 반영 시간: 기존 방식(파일 공유 → 수작업 취합) 대비 대폭 단축 — 업로드 후 수 초 내 전사 반영
• 보고자료 재작성 공수 절감 — 별도 보고서 없이 대시보드 링크 공유로 대체
• 데이터 버전 불일치 리스크 제거 — 단일 데이터(data.json) 기준으로 항상 최신 상태 하나만 존재
• 확장성 — 신규 현장·프로젝트 추가 시 코드 수정 없이 엑셀 업로드만으로 새 탭 자동 생성, 추가 개발 비용 사실상 0
• 정확도 향상 — 자동 검증 규칙(중복 ID, 필수 데이터 누락, 30일 이상 출장 등)으로 수작업 대비 입력 오류 조기 발견

※ 위 수치는 별도 실측(도입 전후 비교) 데이터가 아니라, 프로세스 변화의 방향성에 근거한 추정치입니다. 실 도입 후 정확한 수치 측정이 필요합니다.

5. 차별점 및 실무 적용성

• 다른 사내 시스템 도입과 달리 IT 인프라 투자나 서버 신청 절차 없이 로컬 PC 한 대로 즉시 운영 가능
• 보안 정책 위반이나 예외 승인 요청 없이, 아키텍처 설계만으로 제약을 우회 — 정책 준수와 실용성을 동시에 확보
• 사용자가 기존에 쓰던 엑셀 양식을 그대로 사용 — 별도 교육이나 워크플로우 변경 불필요, 도입 저항 최소화
• 조직도·마일스톤·인력현황을 동시에 아우르는 통합 대시보드는 개별 엑셀 관리 방식으로는 얻기 어려운 시각화
• 이 패턴(기존 엑셀 워크플로우 + 브라우저 내 변환 + 실시간 대시보드)은 인력관리 외에 자재관리·품질검사 현황·공정 진도관리 등 유사한 현장 데이터를 다루는 다른 업무 영역에도 그대로 적용 가능한 재사용 가능한 구조

6. 구현 계획

다음 단계(조직도 화면 인력 추가 기능)는 SHEET 13 — 다음 작업 예정 참고.

Doosan Enerbility 현장 커미셔닝 인력 배치 현황을 보여주는 대시보드. 관리자가 프로젝트별 Excel(고정 양식)을 업로드하면 즉시 대시보드에 반영된다. 원래 Flask 백엔드로 시작했으나, 사내 보안 정책이 xlsx 파일의 웹 업로드 자체를 차단한다는 사실이 확인되어 최종적으로 아래 구조로 전환했다.

• 백엔드를 Streamlit으로 전환 (Flask는 더 이상 사용하지 않음, 파일은 남겨둠)
• Excel → JSON 변환을 서버가 아니라 사용자 브라우저 안에서 수행 — 네트워크로는 변환된 JSON만 나가므로 xlsx 업로드 차단 정책에 걸리지 않음
• 반대로 JSON → Excel(추출/다운로드)은 서버(Python)에서 생성 — 다운로드 방향은 업로드 차단 정책과 무관하다고 보고 서버 생성 방식으로 설계
• 사용자 경험은 "그냥 Excel 파일을 업로드/다운로드하는 것"과 동일하게 유지

구성 요소

project: {
  key, id, name, active, display_order, config, gm, pcod,
  stats: { total, named, tbd },
  manpower: [ manpower record, ... ],
  milestones: [ milestone record, ... ],
  business_trips: [ business trip record, ... ]   // 신규
}
manpower record: {
  id, pid, part, role, name, nat, ps, pe, as_, ae, note, count_yn
}
milestone record: {
  id, phase, name, planned, forecast, actual, status
}
business trip record: {                              // 신규
  id, name, nat, dept, purpose, start, end, note
}

Excel 원본 시트 매핑: 05_BUSINESS_TRIP — Trip_ID, Name, Nationality, Department, Purpose, Trip_Start, Trip_End, Note. 조직도 계층 정보(Parent_Org_ID 등)는 없음 — 출장자는 현장 조직도에 속하지 않는 본사 소속 인원이기 때문.

흐름

날짜 처리

JSON엔 "2026-12-15" 형태 문자열로 저장되어 있는데, 추출 시 진짜 Excel 날짜 셀로 복원(TBD/빈값은 텍스트 그대로)하여, 재업로드해도 문제없게 함. Python(openpyxl)만 사용한 순수 서버 사이드 왕복이라 브라우저 변환에서 발생했던 부동소수점 오차 문제(10번 항목 참고) 없음 — 실제 재파싱 테스트로 모든 필드 100% 일치 확인.

한계

시트 구조·컬럼·데이터 값은 원본과 완전히 동일하지만, 셀 서식(글꼴/색상/테두리/열너비), 원본에 있었을 수 있는 메모나 수식은 애초에 JSON 변환 단계에서 값만 추출했기 때문에 복원되지 않음 — 기본 스타일의 Excel 파일로 생성됨.

왜 인력(파견) 데이터와 분리했나

02_MANPOWER_ORG는 조직도 한 자리를 차지하는 장기 배치 포지션이 기본 단위인데, 출장자는:

• 한 사람이 같은 현장에 여러 번(예: 2주씩 여러 번) 다녀올 수 있어 "한 사람 = 한 자리" 가정이 안 맞음
• 본사 소속이라 현장 조직도상 자리(Part/Role/상위 리더) 자체가 없음
• 기간이 항상 1개월 미만으로 짧아 장기 파견과 성격이 다름

그래서 완전히 독립된 데이터(business_trips / 05_BUSINESS_TRIP 시트)로 설계했고, 기존 인원수 KPI(예상 투입/현재 근무 인력)에는 포함시키지 않음.

검증 규칙

출장 기간이 30일 이상이면 warning — "파견으로 등록해야 하는 건 아닌지 확인" 안내 (막지는 않음). 실제 50일짜리 테스트 데이터로 정상적으로 경고가 뜨는 것 확인, 3일·5일짜리는 경고 없이 정상 통과하는 것도 확인.

화면 반영

실제 테스트: 이번 주 걸친 출장(진행중), 다음 달 출장(주간·월간 패널 모두 제외), 과거 50일 출장(제외 + 경고)까지 프로젝트 페이지 테이블에서 전부 정확히 표시되는 것을 실제 데이터로 확인함.

배치 순서 (기존 화면 요소는 그대로, 추가만)

1. 예상 투입 인력 KPI
2. 현재 근무 인력 KPI
3. 월별 현장 인력 투입 현황 (기존 차트)
4. 주간 인력 파견 현황 (신규)
5. 월간 투입인력 현황 (신규)
6. 주간 출장 현황 (신규)
7. 월간 출장 현황 (신규)
8. Project Overview 카드
9. 인력 상세 현황 테이블

포함 기준

상태는 오늘 날짜 기준 자동 판정(예정/진행중/종료). 실제 데이터(기존 Turkistan TBD 인원 포함)로 월간 파견 패널에 교차 검증까지 완료.

조직도 화면에서 인력을 바로 추가하는 기능 — 아직 설계만 되어있고 구현 전.

• 조직도 각 트리 말단(리프) 노드 아래 (+) 버튼, 조직도 패널 우측 상단 "인력 추가" 버튼 — 클릭 시 팝업으로 직무/직책/이름/국적/계획·실제 파견기간 입력
• 저장 시 해당 프로젝트 데이터에 실제 행으로 추가되고, 다른 차트·테이블에도 자동 반영
• PIN 보호, Role은 고정 드롭다운(Leader/Manager/Engineer), 저장은 아카이브 없이 같은 파일에 바로 append하는 방향으로 설계됨 (착수 시 상세 재확인 필요)