코피야

조이의 AI 작업 매뉴얼
← 이전
🐍 HOW

Python + 대시보드 만들기

회사 로컬 PC에서 Excel/CSV를 집계하고 HTML 대시보드로 보여줄 때의 실전 순서.

1프로젝트 목적과 최종 결과 설명
왜 이 단계?
코드부터 만들면 규칙이 엉키기 쉬워서 먼저 ‘무엇을 자동화할지’를 정해요.
  • 입력 파일 종류 적기
  • 수작업으로 하는 일 적기
  • 최종 산출물 적기
  • 외부 업로드 불가 조건 명시
실제로 이렇게 하면 돼
  1. 먼저 ‘무슨 파일을 넣고 어떤 결과를 얻고 싶은지’를 적는다.
  2. Excel/CSV 여부와 파일 크기를 알려준다.
  3. 현재 사람이 수작업으로 하는 순서를 그대로 적는다.
  4. 회사 보안 때문에 외부 업로드/API가 안 된다는 조건을 적는다.
  5. 코드는 바로 달라고 하지 말고 먼저 처리 순서를 확인한다.
  6. 처리 순서가 맞으면 그다음 HTML 목업으로 넘어간다.
코피/Claude에게 이렇게 말하기
회사에서 반복하는 업무를 Python으로 자동화하고 싶어. [입력] Excel / CSV [현재 수작업] - [최종 결과] - 집계 파일 - HTML 대시보드 회사 보안상 외부 API와 외부 업로드는 사용할 수 없어. 먼저 처리 순서와 필요한 파일 구조부터 설계해줘. 코드는 아직 만들지 마.
2HTML 대시보드 목업 받기
왜 이 단계?
무슨 결과를 보여줄지 먼저 확정해야 Python 집계 항목도 명확해져요.
  • 임의 데이터로 카드/차트 구성
  • 보고 싶은 지표 확정
  • 필터/기간/조직 구조 확정
실제로 이렇게 하면 돼
  1. Python 코드를 만들기 전에 결과 대시보드 화면부터 정한다.
  2. 임의 데이터로 HTML 목업을 받는다.
  3. 상단 KPI, 차트, 조직 비교, 필터 등 필요한 화면을 확정한다.
  4. 화면에서 필요한 지표가 정해지면 Python이 무엇을 집계해야 하는지도 명확해진다.
  5. 목업이 마음에 들 때까지 디자인만 수정한다.
코피/Claude에게 이렇게 말하기
이 프로젝트의 결과를 보여줄 HTML 대시보드 목업을 먼저 만들어줘. 임의 데이터를 사용하고 실제 데이터는 아직 연결하지 마. 카드, 차트, 조직 비교, 필터 구조를 먼저 확정하고 싶어.
3수정할 부분 반영
왜 이 단계?
디자인을 먼저 끝내두면 Python 코드를 다시 뜯는 일이 줄어요.
  • 카드 배치 수정
  • 필터 수정
  • 표/차트 수정
  • 전체 디자인 변경 금지
실제로 이렇게 하면 돼
  1. 수정할 카드나 차트를 정확히 말한다.
  2. 전체 레이아웃 유지 여부를 명시한다.
  3. 수정 후 지표 이름과 필터 구조가 원하는 대로인지 확인한다.
  4. 완성되면 ‘이 목업 기준으로 Python을 연결해줘’라고 요청한다.
코피/Claude에게 이렇게 말하기
기존 HTML 목업의 전체 구조는 유지하고 아래 부분만 수정해줘. [수정] - [유지] - 다른 카드 - 다른 메뉴 - 전체 디자인 톤
4Python 코드와 실행 BAT 받기
왜 이 단계?
회사 PC에서 더블클릭으로 실행하려면 Python 코드만이 아니라 실행 흐름까지 필요해요.
  • 입력 컬럼 실제명 제공
  • 집계 규칙 제공
  • Python 파일 요청
  • 실행용 .bat 요청
  • 결과 파일 저장 위치 요청
실제로 이렇게 하면 돼
  1. 회사 PC에서 사용할 실제 컬럼명을 복사해 코피에게 준다.
  2. 판단/집계 규칙을 글로 적는다.
  3. Python 코드와 함께 실행 BAT도 요청한다.
  4. 결과 파일 저장 위치와 로그 파일도 요청한다.
  5. 가능하면 Python이 집계 결과(JSON/CSV)를 만들고 HTML은 그것만 읽게 한다.
코피/Claude에게 이렇게 말하기
이제 확정된 대시보드에 맞춰 Python 코드를 만들어줘. [실제 입력 컬럼] - [집계/판단 규칙] - [요청] 1. Python 코드 2. 더블클릭 실행용 BAT 3. 결과 파일 저장 4. HTML 대시보드에서 읽을 집계 결과 생성 5. 오류 발생 시 로그 표시 회사 로컬 PC에서 실행할 거야.
5로컬 PC에서 실행 확인
왜 이 단계?
실제 환경에서 경로/인코딩/권한 문제가 자주 생기기 때문에 반드시 회사 PC에서 눌러봐야 해요.
  • BAT 더블클릭
  • 검은 창에서 오류 확인
  • 결과 파일 생성 확인
  • HTML 열어서 값 확인
실제로 이렇게 하면 돼
  1. 회사 PC에서 프로젝트 폴더를 만든다.
  2. Python 파일, BAT, HTML, 샘플 데이터/설정 파일을 같은 구조로 둔다.
  3. BAT를 더블클릭한다.
  4. 검은 창에 오류가 뜨면 캡처 대신 오류 문구를 복사해 코피에게 준다.
  5. 집계 파일이 생성되는지 확인한다.
  6. HTML을 열어서 숫자가 정상인지 본다.
코피/Claude에게 이렇게 말하기
회사 PC에서 실행했는데 아래 문제가 생겼어. [실행 방법] BAT 더블클릭 [현재 증상] - [오류 메시지] - [정상이라면 나와야 하는 것] - 현재 구조를 유지하고 실행 오류만 수정해줘.
6오류·적확도 수정
왜 이 단계?
‘안돼’보다 틀린 실제 사례 2~5개를 주는 게 가장 빨라요.
  • 정상이어야 할 사례 캡처/텍스트
  • 현재 잘못된 결과
  • 반드시 유지할 정상 로직
실제로 이렇게 하면 돼
  1. 틀린 결과를 2~5개만 먼저 모은다.
  2. 각 사례마다 ‘정상이어야 하는 값 / 현재 나온 값’을 같이 적는다.
  3. 전체 로직 재작성 금지를 적는다.
  4. 수정 후 작은 샘플로 먼저 재검증한다.
  5. 정상이라면 전체 데이터에 적용한다.
코피/Claude에게 이렇게 말하기
현재 Python 결과에서 아래 사례가 틀렸어. 전체 로직을 새로 만들지 말고 해당 규칙만 수정해줘. [정상이어야 하는 사례] - [현재 결과] - [반드시 유지] - 기존 정상 규칙 - 파일 입출력 - 결과 컬럼 구조
조이 작업 팁
대용량 데이터는 Python이 먼저 집계하고 HTML은 집계 결과만 보여주는 구조가 조이 환경에 가장 안정적이었어.
예전에 어떻게 했는지 헷갈릴 때 이 순서대로 따라가면 돼.