Files
guitar_score/.agent/workflows/services.md
CD 3d3f74b082 feat(pipeline): YouTube Tab → PDF 자동 추출 파이프라인 초기 구현
- 5단계 파이프라인: 다운로드 → 프레임 추출 → 패턴 감지 → 중복 제거 → PDF 생성
- 3가지 패턴 지원: overlay, split, scroll
- MSE 기반 픽셀 비교 프레임 중복 제거
- split 모드: 42% 크롭 + 밝기 필터 + Tab 라인 검증
- overlay 모드: 320x120 정규화 + 슬라이딩 윈도우 비교
- 프로젝트 문서 초기 작성 (architecture, tech-stack, STATUS, known-issues)
2026-03-24 23:29:25 +09:00

2.3 KiB

description
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 스크립트를 사용하세요.

C:\ProgramData\miniforge3\envs\variet-agent\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 인증