---
description: 프로젝트 서비스 연동 정보 + 작업 프로토콜 (서비스, 크레덴셜, API)
---

# 서비스 연동 정보

> [!CAUTION]
> 아래에는 API 토큰이 포함되어 있습니다. 외부에 노출하지 마세요.

## 런타임 환경

| 항목 | 값 |
|------|-----|
| **Python** | `C:\ProgramData\miniforge3\envs\score\python.exe` |
| **Shell** | PowerShell (`curl` = `Invoke-WebRequest` 별칭이므로 반드시 **`curl.exe`** 사용) |

> [!TIP]
> 기술 스택 상세: `.agent/references/tech-stack.md` 참조
> PowerShell 주의사항: `.agent/AGENT.md` PowerShell Notes 참조

## Gitea (Git Repository)

| 항목 | 값 |
|------|-----|
| **Base URL** | `https://git.variet.net` |
| **API Base** | `https://git.variet.net/api/v1` |
| **Repo** | `Variet/guitar_score` |
| **Token** | `3a01b4b15a39921572e64c413353e870d4d2161b` |
| **Auth Header** | `-H "Authorization: token 3a01b4b15a39921572e64c413353e870d4d2161b"` |

## Vikunja (Task Management)

| 항목 | 값 |
|------|-----|
| **Base URL** | `https://plan.variet.net` |
| **API Base** | `https://plan.variet.net/api/v1` |
| **Project ID** | `12` |
| **Token** | `tk_070f8e0b715e818bb7178c3815ed5389040eddca` |
| **Auth Header** | `-H "Authorization: Bearer tk_070f8e0b715e818bb7178c3815ed5389040eddca"` |

### Vikunja 태스크 조회

> [!TIP]
> 직접 API 호출 대신 반드시 helper 스크립트를 사용하세요.

```powershell
C:\ProgramData\miniforge3\envs\score\python.exe .agent\workflows\helpers\vikunja_helper.py list todo
```

### Vikunja 라벨 체계

**영역 라벨 (필수, 1개 이상):**

| ID | 라벨 | 적용 대상 |
|:--:|-------|-----------|
| 1 | `Backend` | 서버, DB, API |
| 2 | `Frontend` | UI, 인터페이스 |
| 3 | `Engine` | 엔진 로직/연산 |
| 4 | `Infra` | Docker, CI/CD, 배포 |
| 5 | `Test` | 테스트, E2E |
| 17 | `Agent` | 에이전트 관련 |
| 18 | `Tool` | 도구 관련 |
| 19 | `AI/LLM` | AI/LLM 관련 |

**우선순위 라벨 (필수, 1개):**

| ID | 라벨 | 기준 |
|:--:|-------|------|
| 6 | `Priority:High` | 장애, 필수 기능 |
| 7 | `Priority:Mid` | 개선, UX, 리팩토링 |
| 8 | `Priority:Low` | nice-to-have |

## 모니터링 서비스

| 서비스 | URL | 용도 |
|--------|-----|------|
| Uptime Kuma | `https://status.variet.net` | 서비스 모니터링 |
| Authentik | `https://auth.variet.net` | SSO 인증 |