392c2e13f1
[Instagram Reels] Phase 2 완성 - instagram_bot.py: publish_reels() 추가 (MP4 → Reels API) - upload_video_container(), wait_for_video_ready() 구현 - 로컬 경로 → 공개 URL 자동 변환 (image_host.get_public_video_url()) - scheduler.py: job_distribute_instagram_reels() 추가 (10:30) - image_host.py: get_public_video_url() + 로컬 비디오 서버 추가 - VIDEO_HOST_BASE_URL 환경변수 지원 (Tailscale/CDN) [writer_bot.py] 신규 — 독립 실행형 글쓰기 봇 - api_content.py manual-write 엔드포인트에서 subprocess 호출 가능 - run_pending(): 오늘 날짜 미처리 글감 자동 처리 - run_from_topic(): 직접 주제 지정 - run_from_file(): JSON 파일 지정 - CLI: python bots/writer_bot.py [--topic "..." | --file path.json | --limit N] [보조 시스템 신규] v3.1 CLI + Assist 모드 - blog.cmd: venv Python 경유 Windows 런처 - blog_runtime.py + runtime_guard.py: 실행 진입점 + venv 검증 - blog_engine_cli.py: 대시보드 API 기반 CLI (blog status, blog review 등) - bots/assist_bot.py: URL 기반 수동 어시스트 파이프라인 - dashboard/backend/api_assist.py + frontend/Assist.jsx: 수동모드 탭 [engine_loader.py] v3.1 개선 - OpenClawWriter: --json 플래그 + payloads 파싱 + plain text 폴백 - ClaudeWebWriter: Playwright 쿠키 세션 (Cloudflare 차단으로 현재 비활성) - GeminiWebWriter: gemini-webapi 비공식 클라이언트 [scheduler.py] v3.1 개선 - _call_openclaw(): 플레이스홀더 → EngineLoader 실제 호출 - _build_openclaw_prompt(): 구조화된 HTML 원고 프롬프트 - data/originals/: 원본 article JSON 저장 경로 추가 [설정/환경] 정비 - .env.example: SEEDANCE/ELEVENLABS/GEMINI/RUNWAY 복원 + VIDEO_HOST_BASE_URL, GEMINI_WEB_* , REMOTE_CLAUDE_POLLING_ENABLED 추가 - scripts/setup.bat: data/originals, outputs, assist, novels, config/novels 디렉토리 생성 + 폰트 다운로드 + blog.cmd 기반 Task Scheduler 등록 - requirements.txt: fastapi, uvicorn, python-multipart 추가 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
125 lines
3.2 KiB
Markdown
125 lines
3.2 KiB
Markdown
# The 4th Path — Control Panel
|
|
|
|
미디어 엔진 컨트롤 패널 (React + FastAPI)
|
|
|
|
## 구조
|
|
|
|
```
|
|
dashboard/
|
|
├── backend/
|
|
│ ├── server.py # FastAPI 메인
|
|
│ ├── api_overview.py # 개요 탭 API
|
|
│ ├── api_content.py # 콘텐츠 탭 API
|
|
│ ├── api_analytics.py # 분석 탭 API
|
|
│ ├── api_novels.py # 소설 탭 API
|
|
│ ├── api_settings.py # 설정 API
|
|
│ ├── api_connections.py# 연결 상태 API
|
|
│ ├── api_tools.py # 도구 선택 API
|
|
│ ├── api_cost.py # 비용 모니터 API
|
|
│ └── api_logs.py # 로그 API
|
|
└── frontend/
|
|
├── src/
|
|
│ ├── App.jsx
|
|
│ ├── pages/
|
|
│ │ ├── Overview.jsx
|
|
│ │ ├── Content.jsx
|
|
│ │ ├── Analytics.jsx
|
|
│ │ ├── Novel.jsx
|
|
│ │ ├── Settings.jsx
|
|
│ │ ├── Logs.jsx
|
|
│ │ └── settings/
|
|
│ │ ├── Connections.jsx
|
|
│ │ ├── ToolSelect.jsx
|
|
│ │ ├── Distribution.jsx
|
|
│ │ ├── Quality.jsx
|
|
│ │ └── CostMonitor.jsx
|
|
│ └── styles/
|
|
│ └── theme.css
|
|
├── package.json
|
|
├── vite.config.js
|
|
└── tailwind.config.js
|
|
```
|
|
|
|
## 설치 및 실행
|
|
|
|
### 필수 요건
|
|
|
|
- Python 3.9+
|
|
- Node.js 18+
|
|
- npm 9+
|
|
|
|
### 백엔드 의존성 설치
|
|
|
|
```bash
|
|
cd D:/workspace/blog-writer
|
|
venv\Scripts\python.exe -m pip install -r requirements.txt
|
|
```
|
|
|
|
### 프론트엔드 의존성 설치
|
|
|
|
```bash
|
|
cd D:/workspace/blog-writer/dashboard/frontend
|
|
npm install
|
|
```
|
|
|
|
## 실행 방법
|
|
|
|
### Windows (더블클릭)
|
|
|
|
- **프로덕션**: `start.bat` 더블클릭
|
|
- **개발 모드**: `start_dev.bat` 더블클릭
|
|
|
|
두 스크립트 모두 프로젝트 `venv\Scripts\python.exe`가 없으면 즉시 중단합니다.
|
|
|
|
### Linux/Mac
|
|
|
|
```bash
|
|
# 프로덕션 (프론트 빌드 후 백엔드만)
|
|
bash dashboard/start.sh
|
|
|
|
# 개발 모드 (Vite 핫리로드 + 백엔드 reload)
|
|
bash dashboard/start.sh dev
|
|
```
|
|
|
|
### 수동 실행
|
|
|
|
```bash
|
|
# 터미널 1 — 백엔드
|
|
cd D:/workspace/blog-writer
|
|
venv\Scripts\python.exe blog_runtime.py server --reload
|
|
|
|
# 터미널 2 — 프론트엔드 (개발)
|
|
cd D:/workspace/blog-writer/dashboard/frontend
|
|
npm run dev
|
|
|
|
# 또는 프론트 빌드 (프로덕션)
|
|
npm run build
|
|
```
|
|
|
|
## 접속
|
|
|
|
| 모드 | URL |
|
|
|------|-----|
|
|
| 프로덕션 | http://localhost:8080 |
|
|
| 개발(프론트) | http://localhost:5173 |
|
|
| API 문서 | http://localhost:8080/docs |
|
|
|
|
## 탭 구성
|
|
|
|
| 탭 | 기능 |
|
|
|----|------|
|
|
| 개요 | KPI 카드 · 파이프라인 상태 · 코너별 비율 · 활동 로그 |
|
|
| 콘텐츠 | 칸반 보드 · 승인/거부 |
|
|
| 분석 | 방문자 추이 · 코너별 성과 · 인기글 |
|
|
| 소설 | 연재 관리 · 에피소드 생성 |
|
|
| 설정 | AI 연결 · 도구 선택 · 배포채널 · 품질 · 비용 |
|
|
| 로그 | 시스템 로그 필터/검색 |
|
|
|
|
## Tailscale 외부 접속
|
|
|
|
```bash
|
|
# 백엔드를 0.0.0.0으로 바인딩하면 Tailscale IP로 접속 가능
|
|
venv\Scripts\python.exe blog_runtime.py server
|
|
# 접속: http://<tailscale-ip>:8080
|
|
```
|