gravity_web/.agents/workflows/services.md

description

description
Gravity Web 프로젝트 연동 서비스 URL, API 키, 프로젝트 정보 참조

서비스 연동 정보

Caution

이 파일에는 API 토큰이 포함되어 있습니다. .gitignore에 .agents/ 추가 필수.

로컬 환경

항목	값
Node.js	시스템 설치 (node, npm)
Python (helper)	C:\ProgramData\miniforge3\envs\gravity_web\python.exe
프로젝트 루트	c:\Users\Certes\Desktop\gravity_web
Shell	PowerShell (curl = Invoke-WebRequest 별칭이므로 반드시 curl.exe 사용)
서버 실행	cd server && cmd /c node index.js (port 3300)

Gitea (Git Repository)

항목	값
Base URL	https://git.variet.net
API Base	https://git.variet.net/api/v1
Repo	Variet/gravity_web
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	9
Token	tk_070f8e0b715e818bb7178c3815ed5389040eddca
Auth Header	-H "Authorization: Bearer tk_070f8e0b715e818bb7178c3815ed5389040eddca"

Vikunja 태스크 조회

Tip

태스크 목록은 항상 라이브 조회를 사용합니다. 하드코딩된 매핑은 유지하지 않습니다.

python .agents\workflows\vikunja_helper.py list todo

기타 서비스

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

AI 작업 프로토콜

Important

아래 규칙은 모든 작업에 자동 적용됩니다. 유저가 별도 지시하지 않아도 따릅니다.

Vikunja = Single Source of Truth (SSOT)

• Vikunja가 유일한 작업 현황 관리 도구입니다.
• 새 TODO 발견 시 → Vikunja에 태스크 생성
• 작업 완료 시 → Vikunja 태스크 완료 처리

Vikunja 태깅 규칙

영역 라벨 (필수, 1개 이상): Backend / Frontend / Infra / Test 우선순위 라벨 (필수, 1개): Priority:High / Priority:Mid / Priority:Low

커밋 메시지 컨벤션

<type>(<scope>): <description>

type: feat|fix|refactor|test|docs|chore|ci|infra
scope: server|frontend|cdp|infra (선택)

PowerShell 주의사항

• curl → PowerShell에서 Invoke-WebRequest의 별칭. 반드시 curl.exe 사용
• npm → PowerShell에서 실행 정책 문제 시 cmd /c npm 사용
• JSON 파이프 파싱 시 PowerShell 이스케이핑 문제 → .py 스크립트 파일로 만들어 실행 권장