Files
web-page/CHECK_POINT.md

110 lines
5.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# web-ui CHECK_POINT
> React 18 + Vite + react-router-dom v6. Dev port 3007. NAS Docker 백엔드의 프론트엔드 (nginx :8080).
> 2026-05-22 갱신.
---
## 🟢 현재 상태 (양호)
- 라우트 16개 (12 메인 + 4 서브) 정상 운영
- agent-office 3×3 그리드 재설계 완료 (5/7~14, WebP 93% 축소, WS 재연결 백오프)
- `/insta` 슬레이트 캐러셀 + 반응형 (5/15~16)
- Vite proxy 7개 (NAS API + Fear&Greed + VIX + Treasury + WTI + Brent)
---
## ✅ 최근 완료 (5/18~22)
- 2026-05-22: **거래 데스크 AI 투자 탭 제거** (e42b643) — web-ai signal_v1 legacy 이전과 정합 (V2 단독 운영 반영)
- 2026-05-22: stock 총 매입을 각 종목 매입가 단순 합으로 표시 (6533743)
- 2026-05-22: agent-office 모바일 사이드패널 전체화면 토글 + music 에이전트 이미지 교체 (ee5700d)
- 2026-05-14: agent-office Grid 재설계 (canvas 폐기), AGENT_META + GRID_SLOTS 중앙화
- 2026-05-15~16: `/insta` 신규 페이지 + InstaCards.jsx + src/api.js(530줄) 음악·인스타·텔레그램 API 확장
---
## 🔴 즉시 (1~3일)
### 1. `/insta` 비동기 폴링 구현 ⭐ (백엔드 준비 완료 → 구현 시점 도래)
- **배경**: web-backend insta-lab이 Redis 분할(SP-4) 완료 → `_bg_render`가 Redis push, `GET /api/insta/tasks/{task_id}` 폴링 엔드포인트 존재. **이제 frontend가 비동기 폴링으로 전환해야 정합**
- **파일**: `src/pages/insta/InstaCards.jsx`
- [ ] 슬레이트 생성 → `task_id` 받고 폴링 (2~5초 간격, NAS 부담 ↓)
- [ ] progress bar UI (0~100%) + `queue:paused` 상태 표시 (박재오 작업 중 = Windows 워커 정지)
- [ ] failed 상태 처리 (오류 메시지·재시도 버튼)
### 2. agent-office WebSocket 안정성 점검
- 5/7~14 재설계 + 5/22 모바일 토글 직후 운영 확인
- [ ] 브라우저 콘솔 WS 끊김 → 재연결 지수 백오프 실제 작동
- [ ] 4 테스트(TaskTab·CommandTab·AgentCard·ScoreNodeCard) 통과 재확인
### 3. agent-office lotto sim_consensus 노출
- **배경**: web-backend `/api/lotto/best`에 5종 점수 array 노출됨 (lotto-signals) + weight-evolver 자율 학습 도입
- [ ] agent-office lotto 에이전트 카드에 5종 점수·시그널 상태 표시
- [ ] (선택) weight-evolver 진화 상태 미니 패널
---
## 🟡 중기 (1~2주)
### 4. `/insta` 카드 템플릿 UI 고도화
- 현재 default theme PNG 미리보기만. hedgy75 테마 추가 시 theme 선택 UI 필요
- [ ] 테마 선택 dropdown (default / hedgy75)
- [ ] 미리보기 컴포넌트 페이지 종류별 분기
### 5. `/music` Sonic Forge 발행 모니터링
- music-lab Redis 분할(SP-6) + Windows music-render 도입 → 발행 상태 모니터링 패널 필요
- [ ] 발행 큐·실패·재시도 로그 표시 (Redis 큐 길이 연동)
- [ ] 텔레그램 5단계 승인 UX 점검
### 6. NAS↔Windows 작업 흐름 가시화 (신규)
- web-ai 워커 3종 + Redis 큐 도입으로 작업 분산 흐름이 복잡해짐
- [ ] agent-office 또는 신규 `/node` 페이지에 큐 상태·Windows 노드 헬스 표시 (web-ai/web-backend 추가 아이디어와 연동)
---
## 🟢 장기 (1개월+)
### 7. 모바일 UX 일관 적용
- BottomNav + PullToRefresh + MobileSheet + SwipeableView 있음. 신규 페이지 적용 부족
- [ ] `/insta` 모바일 캐러셀 swipe + `/agent-office` 모바일 그리드 압축
### 8. `/lab` 페이지 확장
- 현재 sword-stream · day-calc 2개
- [ ] 박재오 데모 콘텐츠 큐 결정 (예: weight-evolver 진화 그래프, AI 음악 빠른 청취)
---
## 💡 추가 아이디어 (신규 2026-05-22)
- **`/node` Windows AI 노드 대시보드** — ai_trade + insta/music/video-render + task-watcher 상태, Redis 큐 길이, `queue:paused` 토글 버튼(task-watcher C안 = "토글 UI 1개"). web-ai/web-backend 모니터링 아이디어의 frontend 진입점
- **video 생성 미리보기 페이지** — video-lab(SP-8) + Windows video-render 4 provider 결과 비교 그리드. 무신사 공모전 MU-진 영상 버전 관리에 활용
- **weight-evolver 진화 시각화** — auto_picks 적중 추이 + weight base diff 그래프 (`/lab` 또는 lotto 페이지)
- **위키 페이지 수 정합** — [[사업-개인-웹-플랫폼]]에 "17개" 박혀 있으나 실제 16개 (12 메인 + 4 서브). *박재오 위키 갱신 항목* (web-ui 코드 아님)
---
## 🚀 빌드 & 배포
```bash
npm run dev # 개발 (port 3007, Vite proxy)
npm run build # 빌드 (rimraf dist + Vite build)
npm run release:nas # 자동 배포 (deploy-nas.cjs)
```
배포: Windows `robocopy dist Z:\docker\webpage\frontend\` / macOS `rsync` → nginx 자동 reload
---
## 📚 참고
- 위키: [[사업-개인-웹-플랫폼]] (백엔드 통합 인덱스)
- 라우트: `src/routes.jsx` (navLinks 메타) / Vite 프록시: `vite.config.js`
- API: 모든 페이지 `/api/` 상대 경로 (Mixed Content 방지)
- 백엔드 짝: web-backend CHECK_POINT (insta-lab Redis 분할 → /insta 비동기 폴링 정합 필요)
## 변경 이력
- 2026-05-18: 페이지 신설. 즉시 3 + 중기 3 + 장기 2.
- 2026-05-22: 최근 완료 3건 반영(AI 투자 탭 제거·stock 매입 표시·모바일 사이드패널). **`/insta` 비동기 폴링을 즉시 1순위로 승격** (백엔드 insta-lab Redis 분할 완료 → frontend 정합 필요). lotto sim_consensus 노출 + NAS↔Windows 작업 흐름 가시화 항목 추가. 추가 아이디어 4건 신설 (/node 대시보드·video 미리보기·evolver 시각화·위키 페이지 수 정합).