핸드오버 2026-07-24 — 망남 어촌신활력 사이트 구축·허브 갱신

핸드오버 2026-07-24 — 망남 어촌신활력 홍보·업무자동화 사이트 구축 + 허브 갱신

세션 요약

이사장님 지시로 “망남생활권 어촌신활력증진사업” 공식 사이트(홍보 + 내부 업무자동화)를 신규 구축해 deka2026/mangnam-vitality에 푸시했고, 지미에게 서버 배포를 요청했다. 허브(sakyowon.co.kr)도 지시대로 갱신·배포 완료. 앞서 망남쿱 사이트의 마을식당 예약 폼도 배포했다.

1. 망남쿱 마을식당 예약 폼 (deka2026/mangnam-coop)

• /business/village-store에 마을식당 예약 폼(이름·전화·방문일·시간대·메뉴별 수량), 편의점 취급 상품 4분류, 이용안내 추가 (main 커밋 373ac1f)
• 정적 사이트(GitHub Pages)라 서버 접수가 불가 → 예약 내용을 텍스트로 생성해 복사 후 사교원 문의 폼으로 전달하는 방식. 대표전화 개통 전 임시 채널
• gh-pages 재배포·라이브 확인 완료

2. 신규 사이트: 망남생활권 어촌신활력증진사업 (deka2026/mangnam-vitality)

• Next.js 14 풀스택 + SQLite(better-sqlite3) + xlsx + @anthropic-ai/sdk, 포트 3100, output: standalone. 정적 배포 불가 — Node 서버 필요
• 공개: / 소개+방문·사업 문의폼(DB 접수), /news 블로그 소식 10건+KPI 카드+사진·영상 갤러리, /insta 인스타 콘텐츠. 좌측 사이드바에 사교원 허브 버튼·관리자 로그인 버튼
• 관리자(/admin, ADMIN_PASSWORD 쿠키 인증):
  • 문의 확인·답변
  • 사업결과보고서(PDF/텍스트) 업로드 → Claude(claude-opus-4-8)가 블로그 홍보글 초안 작성 → 검토 후 게시
  • KPI 관리, 사진·영상 업로드(data/uploads, /api/files/로 서빙)
  • 예산집행 엑셀 → 연도별·사업별·품목별 집행실적 자동 집계(집행률 막대)
  • 주민자료 엑셀 → 주민 명단 + 관계도 그래프(자체 force layout SVG, 마을별 색상)
  • 주민 연락처 단체 문자(알리고 API)
  • 구글 캘린더 ICS → 인스타 스토리 기획안(컨셉·문구·해시태그)
• 키 없이도 동작: ANTHROPIC_API_KEY 없으면 직접 작성 모드, 알리고 키 없으면 문자 시뮬레이션 모드. 기본 관리자 비번은 mangnam-dev-2026(대시보드에 경고 표시)
• 로컬 스모크 테스트 전 기능 통과. 데이터는 전부 data/ 한 폴더(gitignore)
• 상태: 배포 대기. 지미에게 sakyowon-site JIMMY-DECA.md(07-24 17:49)로 요청 — ① mangnam.poomasi.org 프록시+systemd(포트 3100, nginx client_max_body_size 200m), ② ADMIN_PASSWORD(후니 실장님→이사장님 릴레이), ANTHROPIC_API_KEY, 알리고 키, ③ data/ 백업
• 참고: 기존 mangnam-site(Supabase 기반, 구버전)와는 별개 레포. 어느 쪽을 공식으로 갈지는 이사장님 결정 사항

3. 허브 사이트 갱신 (deka2026/sakyowon-hub, 커밋 ccc0852 — 배포·라이브 확인 완료)

• ➕ “망남 어촌신활력증진사업” 카드 추가 — mangnam.poomasi.org, “(개설 준비 중)” 표기. 지미 배포 전까지는 404
• ➖ “AI활동가 교육자산 허브”(activist.poomasi.org) 카드 제거
• ✏️ “햇빛소득업무자동화” → **“전남광주햇빛소득네트워크”**로 명칭 변경

레슨

• 정적/서버 구분을 먼저 결정할 것: 문의 접수·업로드·엑셀 분석이 있으면 GitHub Pages 불가. mangnam-coop(정적)과 mangnam-vitality(서버)를 나눈 이유
• 엑셀 합계 행 함정: 합계가 어느 열에 적혀 있을지 모른다. 특정 열만 검사하면 새어 들어와 집계가 부풀려짐(2026년 예산이 4.2억으로 잡혔던 버그) → 행의 모든 셀에서 합계/총계/소계 단독 표기를 검사
• @anthropic-ai/sdk 최신 버전은 npm 레지스트리에서 확인 후 고정: ^0.116.0은 존재하지 않아 설치 실패, npm view로 확인해 ^0.114.0 사용
• pkill -f는 자기 자신을 죽일 수 있다: 명령 문자열에 패턴이 포함되면 셸째 종료됨(exit 144). 프로세스 정리는 패턴을 따옴표 밖에서 조합하거나 pgrep로 PID 확인 후 kill
• “정리해” 표준 루틴 신설(이사장님 지시): 핸드오버 작성 → 스킬 저장 → 레슨 기록 → 위키 배포. ~/workspace/.claude/skills/wrap-up/SKILL.md에 스킬로 저장함

미완료

1. 지미: mangnam-vitality 서버 배포 + 도메인(mangnam.poomasi.org) + 환경변수(ADMIN_PASSWORD 필수, ANTHROPIC_API_KEY 권장, 알리고 선택) — JIMMY-DECA.md 회신 대기
2. 이사장님: 관리자 비밀번호 수령(후니 실장님 릴레이), 알리고 문자 계정 계약 여부 결정
3. 이사장님: 구 mangnam-site(Supabase판)와 신 mangnam-vitality 중 공식 사이트 확정 — 확정되면 허브 카드·협동조합 사이트 링크 정리
4. 배포 후: 인스타 계정·구글 캘린더 ICS 주소를 관리자 화면에서 설정, KPI·첫 소식 등록