리브레토 마케팅 — Setup

DB 연결 · 테이블 생성 · 마이그레이션 · CLI / 자산 / 권한 점검

설정 완료됨 — 운영도구로 이동 127.0.0.1:3311:oworks
1 데이터베이스 연결
Synology NAS의 MariaDB에 연결합니다. 기존 DB를 선택하면 geo_ 접두어 테이블만 생성됩니다.
3 Claude API 키 (선택 — 레거시)
모든 AI 호출은 기본적으로 STEP 6 의 Claude Code CLI (구독) 를 사용합니다. 이 항목은 CLI 가 설치 불가능한 환경(예: 일부 호스팅) 에서만 폴백 용도로 사용됩니다. 평소엔 비워둬도 됩니다.
현재 키: sk-ant-api03...MgAA
📘 책 라이브러리 — ISBN 자동기입 키 (선택)
ISBN 입력 한 번으로 도서관 메타(제목/저자/출판사/페이지/판형 등) 가 자동 채워집니다.
발급: 국립중앙도서관 서지정보 유통 API (무료)
등록: .geo_secrets.json 파일에 "nl_seoji_key": "발급받은키" 추가 후 어드민 재로그인.
✓ 등록됨 — b3c90a...1cc4
4 신규 마이그레이션 적용
db/migrations/*.sql 안의 모든 SQL을 적용합니다. 카드뉴스 테이블(geo_cardnews_projects, geo_cardnews_generations) 과 키-값 저장소(geo_kv) 가 추가됩니다. 이미 적용된 테이블은 안전하게 스킵됩니다.
5 기존 파일 데이터 이관 (이미 운영 중이던 사이트만)
기존 storage/kv/{namespace}/{key}.json 파일에 저장돼 있던 채널 운영 데이터를 geo_kv 테이블로 옮깁니다. 동일 키가 DB 에 이미 있으면 SKIP 합니다.
6 Claude Code CLI 진단 (카드뉴스 생성기용)
카드뉴스 생성기는 Anthropic API 키 대신 Claude Pro/Max 구독 의 claude CLI 를 사용합니다. 서버에 설치되어 있고 OAuth 로그인된 상태인지 확인합니다.
설치: npm install -g @anthropic-ai/claude-code → claude 실행 후 로그인.
7 카드뉴스 자산 점검
assets/cardnews/ 폴더에 다음 PNG 가 있어야 카드뉴스 디자인이 완성됩니다. 파일명 그대로 직접 업로드 (FTP/SFTP/파일관리자) 후 [점검] 버튼.
8 디렉토리 권한 점검
업로드/캐시 디렉토리가 PHP 프로세스로 쓰기 가능한지 확인합니다. 누락 시 자동 생성을 시도합니다.