세션 개요

1MW 햇빛소득 마을발전협동조합(수익배분 50공동사업/10지역화폐배당/20적립/20상환, 상근1+단순2)의 정기업무 체계 설계부터 자동화 3단계 구축, 햇소자 사이트 운영관리 메뉴 개편·라이브 반영까지 한 세션에 수행.

산출물 위치: C:\Users\Admin\Documents\햇빛소득2026\

1) 계획·문서

  • 햇빛소득조합_정기업무_자동화계획.hwpx (+md 원고) — 월/분기/반기/연 정기업무 21건, 업무별 산출물, 사람/AI 역할 구분, 자동화 시스템 6층 구성, 구축 로드맵 3단계
  • 웹 문서판: https://claude.ai/code/artifact/86f026b2-3b4c-40da-9d65-68e2e842c923
  • 수지 개요: 연 수익 약 1.92억, 인건비 월 약 570만(2026 최저임금 10,320원, 4대보험 포함) → 공동사업 50%에서 인건비 빼면 순수 공동사업비 연 23천만 = 자동화의 목적은 상근 시간을 사무→공동사업으로

2) 1단계: 대장·템플릿 (완료)

  • 햇빛소득조합_대장양식.xlsx — 시트 8개(안내·발전·회계·급여근태·조합원명부·배당적립·설비정비·월마감체크리스트). 노란 칸(시급·보험요율·배당비율)만 고치면 전체 재계산. 수식은 파이썬 기대값 대조로 검증(이 PC는 LibreOffice 없어 recalc 불가 — Excel이 열 때 자동 계산)
  • 템플릿\템플릿_*.md 6종({{자리표시자}}) + 예시값\*.json + 예시\*.hwpx — 월간운영보고서·분기재무·반기경영·총회자료집·급여명세서·배당통지문
  • _도구\fill_and_convert.py — 템플릿+JSON→hwpx (예약키 _title_bar/_subtitle, 다중 행 값은 md 표 행 문자열)

3) 2단계: 자동 계산 (완료)

  • _도구\월마감.py 2026-08 [메모.json]보고서\<연월>\에 월간운영보고서+직원별 급여명세서+배분지시서 자동 생성 (대장 수식을 파이썬으로 재계산 — 대장 열 배치 바꾸면 스크립트도 수정)
  • _도구\통장분류.py CSV [--적용] — 분류규칙.json 키워드로 회계대장 자동 기장, 미분류=(분류필요) (실은행 CSV 미검증 — 열 매핑만 수정하면 됨)
  • _도구\마감알림.py [일수] — 원천세·부가세·법인세·월마감 임박 알림

4) 3단계: 모니터링·대시보드 (완료)

  • REMS 2.0(rems.energy.or.kr): 발전소별 데이터는 로그인 필요·공개 API 없음 → 다운로드 파일 방식 채택
  • _도구\발전반영.py <REMS파일> — 발전일별.csv 누적+발전대장 기입+이상감지(무발전일·7일 평균 급락 60%·이용률 10% 미달)
  • _도구\대시보드갱신.py대시보드\index.html+data.js (조합원 공개용, dataviz 검증 팔레트, 다크모드)
  • 로컬 미리보기: launch.json hatbit-dashboard(8765) / GitHub Pages 배포는 레포 확정 대기

5) 햇소자 운영관리 메뉴 개편 (라이브 반영 완료)

  • ★소스 위치 확인: deka2026/deka2026.github.io 레포의 hatsoja/ 폴더 (로컬 클론: 햇빛소득2026\사이트작업)
  • ★배포 구조: deka2026.github.io는 CNAME(sakyowon.co.kr)→가비아 서버(1.201.116.225) 301 리다이렉트. 라이브 반영 = 서버에서 bash /opt/sakyowon/src/deploy-www.sh 실행이 유일한 경로 (GitHub Pages는 서빙 안 함)
  • 커밋 a852d18: 발전·정산·배당(1MW 표준모델·50/10/20/20 배분표·배당적립·이상알림), 월마감·보고서 신규(#/mem/closing, 체크리스트 8단계+보고서 6종), 회계·세무에 월마감 파이프라인 카드, 일정·마감에 정기 마감 캘린더 자동계산(coopDeadlines)
  • 서버 배치 실행됨 → 라이브 전 화면 검증 완료(데스크톱+모바일 375px)

6) 필수 개선 4건 재검증 결과

8/26 점검의 필수 4건 중 3건은 이미 해결돼 있었음(9/2경 타 세션 수정): ①모바일 햄버거 ✅(작동 검증) ②개인정보처리방침+동의 체크박스 3곳 ✅ ④푸터 404→poomasi.org 링크 200 ✅. D-day 버그도 수정돼 있음.

★다음 작업 (남은 것)

  1. AI 켜기 (유일한 남은 필수): 서버 /etc/sakyowon-api.envSAKYOWON_ANTHROPIC_KEY=키 추가 → systemctl restart sakyowon-api/api/ai/chat 응답으로 검증. 키는 사용자가 직접(서버 SSH 비밀번호 방식).
  2. 햇빛 대시보드 GitHub Pages 배포(레포·계정 확정) + 사교원 허브 버튼 추가
  3. 알림톡 연동(카카오 비즈채널), REMS 로그인 자동 수집(계정 운용 방식 확정 필요), 월마감 예약 실행
  4. 실은행 CSV로 통장분류.py 열 매핑 확정

참고

  • 매월 운영 순서: REMS 다운로드→발전반영.py→(정산서 오면 단가 입력)→월마감.py→대시보드갱신.py (README.md에 정리)
  • 이 세션 기억: project-hatbit-coop-ops, project-hatsoja-site 메모리 갱신 완료