# 바탕화면 서비스 현황

> 작성: 2026-09-10
> 갱신: 2026-09-16 — TicTech·VisionIvy 원격 점검 반영
> 목적: LivekitDev 서비스·헬스 상태를 화면 오른쪽 위 작은 창에 항상 표시

복구는 기존 `LivekitDev-Stack-Ensure`가 담당합니다. 이 창은 **표시만** 합니다.

현재 서비스 목록은 [Caddy 서비스 현황](/guides/caddy-services/)을 참고합니다.

## 구성

| 경로 | 역할 |
|------|------|
| `scripts/desktop_status.ps1` | 서비스 상태와 로컬 HTTP 헬스 출력 |
| `scripts/desktop_status_loop.ps1` | 15초마다 상태 파일 갱신 |
| `scripts/desktop_status_hud.ps1` | 오른쪽 위 항상 위 창 |
| `scripts/start_desktop_status.ps1` | 중복 없이 HUD·루프 기동 |
| `scripts/register_desktopinfo_startup.ps1` | 로그온·부팅 자동 시작 등록 |
| `tools/desktopinfo/status-targets.json` | 외부 서버 HTTP/TCP 점검 목록 |

표시 항목: Caddy, Meet, LiveKit, FileShare, Overlord `:3001`, CelloTutor `:8081/healthz`. 외부 대상은 JSON에 추가합니다.

현재 `tools/desktopinfo/status-targets.json`에는 다음이 들어 있습니다.

| 이름 | 점검 URL |
|------|----------|
| TicTech | https://tictechtoeai.com/ |
| VisionIvy | https://visionivy.sparklabsacademy.dev/ |

두 사이트는 2026-09-15에 이 머신 Caddy로 이전했습니다. 상세는 [Caddy 서비스 현황](/guides/caddy-services/)을 참고합니다.

## 외부 서버 추가

`tools/desktopinfo/status-targets.json`의 `targets` 배열에 넣습니다. 저장 후 최대 15초 안에 HUD Remote 줄에 반영됩니다. HUD를 다시 시작할 필요는 없습니다.

```json
{
  "targets": [
    { "name": "Docs", "url": "https://docs.example.com/" },
    { "name": "SSH", "host": "203.0.113.10", "port": 22 }
  ]
}
```

- `url`: HTTP/S GET, 2초 제한. 숫자(200 등) 또는 `DOWN`
- `host` + `port`: TCP 연결, 2초 제한. `OK` 또는 `DOWN`
- `name`: HUD에 보이는 이름 (10자 안쪽이 잘 맞음)

방화벽에서 이 머신이 대상 포트로 나갈 수 있어야 합니다. 인증이 필요한 페이지, VPN 뒤 호스트는 이 머신에서 실제로 닿는 주소로 적습니다.

## 자동 시작 (이 머신)

| 항목 | 내용 |
|------|------|
| 작업 스케줄러 | `LivekitDev-DesktopStatus` — 로그온 20초 후, 부팅 90초 후 |
| Startup 바로가기 | `LivekitDev Desktop Status HUD.lnk` |
| 실행 계정 | `Administrator` (대화형 로그온) |

창은 로그온된 데스크톱이 있어야 보입니다. SYSTEM 서비스로는 띄우지 않습니다.

등록:

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File C:\Developments\LivekitDev\scripts\register_desktopinfo_startup.ps1
```

지금 바로 띄우기:

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File C:\Developments\LivekitDev\scripts\start_desktop_status.ps1
```

## 끄기

LivekitDev 창을 닫고, 작업 스케줄러에서 `LivekitDev-DesktopStatus`를 사용 안 함으로 바꾸거나 삭제합니다. Startup의 `LivekitDev Desktop Status HUD.lnk`도 지웁니다.