84 lines
2.5 KiB
Markdown
84 lines
2.5 KiB
Markdown
---
|
|
description: 프로젝트 연동 서비스 URL, API 키, 프로젝트 정보 참조
|
|
---
|
|
|
|
# 서비스 연동 정보
|
|
|
|
> [!CAUTION]
|
|
> 이 파일에는 API 토큰이 포함되어 있습니다. `.gitignore`에 `.agents/` 추가를 검토하세요.
|
|
|
|
## 로컬 환경
|
|
|
|
| 항목 | 값 |
|
|
|------|-----|
|
|
| **Node.js** | 시스템 설치 (`node`, `npm`) |
|
|
| **Python (helper)** | `{{PYTHON_PATH}}` |
|
|
| **프로젝트 루트** | `{{PROJECT_ROOT}}` |
|
|
| **Shell** | PowerShell (`curl` = `Invoke-WebRequest` 별칭이므로 반드시 **`curl.exe`** 사용) |
|
|
| **서버 실행** | `{{SERVER_START_COMMAND}}` |
|
|
|
|
## Gitea (Git Repository)
|
|
|
|
| 항목 | 값 |
|
|
|------|-----|
|
|
| **Base URL** | `{{GITEA_BASE_URL}}` |
|
|
| **API Base** | `{{GITEA_BASE_URL}}/api/v1` |
|
|
| **Repo** | `{{GITEA_OWNER}}/{{GITEA_REPO}}` |
|
|
| **Token** | `{{GITEA_TOKEN}}` |
|
|
| **Auth Header** | `-H "Authorization: token {{GITEA_TOKEN}}"` |
|
|
|
|
## Vikunja (Task Management)
|
|
|
|
| 항목 | 값 |
|
|
|------|-----|
|
|
| **Base URL** | `{{VIKUNJA_BASE_URL}}` |
|
|
| **API Base** | `{{VIKUNJA_BASE_URL}}/api/v1` |
|
|
| **Project ID** | `{{VIKUNJA_PROJECT_ID}}` |
|
|
| **Token** | `{{VIKUNJA_TOKEN}}` |
|
|
| **Auth Header** | `-H "Authorization: Bearer {{VIKUNJA_TOKEN}}"` |
|
|
|
|
## Vikunja 태스크 조회
|
|
|
|
> [!TIP]
|
|
> 태스크 목록은 항상 라이브 조회를 사용합니다. 하드코딩된 매핑은 유지하지 않습니다.
|
|
|
|
```powershell
|
|
python .agents\workflows\helpers\vikunja_helper.py list todo
|
|
```
|
|
|
|
## 기타 서비스
|
|
|
|
| 서비스 | URL | 용도 |
|
|
|--------|-----|------|
|
|
| {{SERVICE_NAME}} | {{SERVICE_URL}} | {{SERVICE_PURPOSE}} |
|
|
|
|
## 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: (선택)
|
|
```
|
|
|
|
## PowerShell 주의사항
|
|
|
|
- `curl` → PowerShell에서 `Invoke-WebRequest`의 별칭. **반드시 `curl.exe`** 사용
|
|
- `npm` → PowerShell에서 실행 정책 문제 시 `cmd /c npm` 사용
|
|
- JSON 파이프 파싱 시 PowerShell 이스케이핑 문제 → `.py` 스크립트 파일로 만들어 실행 권장
|