Files

harang-ai b469a1337a 📋 Sprint 006~008 계획 추가

- SPRINT-006: 버그 수정 3건 + JWT 인증 시스템 (초대 코드 가입)
- SPRINT-007: Gitea 연동 + 활동 로그 실시간화
- SPRINT-008: 실시간 전환 + 설정 구현 + 자매 강화 + 스켈레톤 UI

2026-04-04 14:53:42 +09:00

SPRINT-008: 실시간 전환 + 설정 + 자매 강화

목표

모든 하드코딩 데이터를 실시간 전환 + 설정 페이지 구현 + 자매 프로필 강화

SistersService 확장:
- SSH로 실제 uptime 조회: cat /proc/uptime
- CPU 사용률: top -bn1 | grep Cpu
- 메모리: free -m
- 디스크: df -h /

API 응답에 시스템 정보 추가:

{
  "uptime": "342:12:05",
  "cpu": 23.4,
  "memory": { "used": 1024, "total": 4096 },
  "disk": { "used": "12G", "total": "50G" }
}

API: GET /api/sisters/:name/avatar
SSH로 각 자매 서버에서 프로필 사진 가져오기:
- 경로: ~/.openclaw/avatar.png 또는 ~/.openclaw/avatar.jpg
- SCP/SSH cat으로 바이너리 전송
- 캐싱: 메모리 캐시 (5분 TTL) — 매번 SSH 호출 방지
대체(fallback): 프로필 사진 없으면 이름 이니셜 아바타 생성
FE: 자매 카드/상세 페이지에서 아바타 이미지 교체

SystemSettings 테이블 (Prisma):

model SystemSettings {
  id    Int    @id @default(autoincrement())
  key   String @unique
  value String @db.Text
  updatedAt DateTime @updatedAt
}

API:
- GET /api/admin/settings — 전체 설정 조회
- PUT /api/admin/settings — 설정 일괄 저장
설정 항목 (settings-design.md 기반):
- 강제 2FA (boolean)
- 세션 유효 시간 (number, 분)
- IP 화이트리스트 (boolean)
- 자동 백업 (boolean)
- 백업 주기 (string, HH:mm)
- 보관 주기 (number, 일)
- 대기열 경고 임계값 (number)
- 자동 스케일링 (boolean)
- CPU 임계값 (number, %)
- 레이턴시 경보 (number, ms)
- 노드 오프라인 알림 (boolean)
FE /settings 페이지:
- 마운트 시 설정 로드 (API fetch)
- 토글/인풋 변경 → 로컬 state
- "설정 저장" → PUT API → 성공 토스트
- "초기화" → 기본값 복원

대상 목록:

모든 API 호출에 스켈레톤 UI 추가:
- 카드 스켈레톤: 회색 박스 펄스 애니메이션
- 테이블 스켈레톤: 행 placeholder
- 타임라인 스켈레톤: 도트 + 라인 placeholder
에러 상태: "데이터를 불러올 수 없습니다" fallback UI