107 lines
3.9 KiB
Markdown
107 lines
3.9 KiB
Markdown
---
|
|
description: 프로젝트 연동 서비스 URL, API 키, 프로젝트 정보 참조
|
|
---
|
|
|
|
# 서비스 연동 정보
|
|
|
|
> [!CAUTION]
|
|
> 이 파일에는 API 토큰이 포함되어 있습니다. 프라이빗 레포에서만 사용하세요.
|
|
|
|
## 로컬 환경
|
|
|
|
| 항목 | 값 |
|
|
|------|-----|
|
|
| **Python** | `C:\ProgramData\miniforge3\envs\edf\python.exe` (**항상 이 경로 사용**) |
|
|
| **Shell** | PowerShell (`curl` = `Invoke-WebRequest` 별칭이므로 반드시 **`curl.exe`** 사용) |
|
|
|
|
## Gitea (Git Repository)
|
|
|
|
| 항목 | 값 |
|
|
|------|-----|
|
|
| **Base URL** | `https://git.variet.net` |
|
|
| **API Base** | `https://git.variet.net/api/v1` |
|
|
| **Repo** | `Variet/edf` |
|
|
| **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** | `11` |
|
|
| **Token** | `tk_070f8e0b715e818bb7178c3815ed5389040eddca` |
|
|
| **Auth Header** | `-H "Authorization: Bearer tk_070f8e0b715e818bb7178c3815ed5389040eddca"` |
|
|
|
|
## Vikunja 태스크 조회
|
|
|
|
> [!TIP]
|
|
> 태스크 목록은 항상 라이브 조회를 사용합니다. 하드코딩된 매핑은 유지하지 않습니다.
|
|
|
|
```powershell
|
|
C:\ProgramData\miniforge3\envs\edf\python.exe .agents\workflows\helpers\vikunja_helper.py list todo
|
|
```
|
|
|
|
## AI 작업 프로토콜
|
|
|
|
> [!IMPORTANT]
|
|
> 아래 규칙은 모든 작업에 자동 적용됩니다. 유저가 별도 지시하지 않아도 따릅니다.
|
|
|
|
### Vikunja = Single Source of Truth (SSOT)
|
|
|
|
- **Vikunja가 유일한 작업 현황 관리 도구**입니다.
|
|
- 로컬 `task.md`는 현재 대화 내 세부 체크리스트용으로만 사용합니다.
|
|
- 새 TODO 발견 시 → Vikunja에 태스크 생성 (로컬 파일에만 적는 것은 금지)
|
|
- 작업 완료 시 → Vikunja 태스크 완료 처리 (로컬 체크만 하는 것은 금지)
|
|
|
|
### Vikunja 태깅 규칙
|
|
|
|
태스크 생성 시 반드시 아래 라벨을 적절히 부여합니다:
|
|
|
|
**영역 라벨 (필수, 1개 이상):**
|
|
|
|
| ID | 라벨 | 적용 대상 |
|
|
|:--:|-------|-----------:|
|
|
| 1 | `Backend` | 서버, DB, API |
|
|
| 2 | `Frontend` | UI, 웹 프론트엔드 |
|
|
| 3 | `Engine` | 핵심 엔진/로직 |
|
|
| 4 | `Infra` | Docker, CI/CD, 모니터링 |
|
|
| 5 | `Test` | 테스트, E2E |
|
|
|
|
**우선순위 라벨 (필수, 1개):**
|
|
|
|
| ID | 라벨 | 기준 |
|
|
|:--:|-------|------:|
|
|
| 6 | `Priority:High` | 핵심 기능 미완성, 블로커 |
|
|
| 7 | `Priority:Mid` | 기능 개선, UX 향상, 리팩터링 |
|
|
| 8 | `Priority:Low` | nice-to-have, 문서, 코드 정리 |
|
|
|
|
### 작업 시작 시
|
|
1. `git pull` 으로 최신 코드 동기화
|
|
2. Vikunja 태스크 조회 (`/check-vikunja`) → 관련 태스크 ID 확인
|
|
3. 관련 태스크가 있으면 Vikunja에서 진행중 표시
|
|
4. 관련 태스크가 없으면 Vikunja에 새 태스크 생성 (태깅 규칙 준수)
|
|
|
|
### 작업 중
|
|
5. 의미 있는 단위마다 자주 커밋 (대규모 변경을 한번에 커밋하지 않음)
|
|
6. 커밋 메시지 규칙:
|
|
- `feat:`, `fix:`, `refactor:`, `test:`, `docs:`, `chore:`, `ci:` 접두사 사용
|
|
- 관련 Vikunja 태스크가 있으면 `#task-{ID}` 참조 포함
|
|
|
|
### 작업 완료 시
|
|
7. 모든 변경사항 커밋 + `git push`
|
|
8. Vikunja 태스크 완료 처리 (**반드시 `vikunja_helper.py` 사용**):
|
|
```powershell
|
|
C:\ProgramData\miniforge3\envs\edf\python.exe .agents\workflows\helpers\vikunja_helper.py done {TASK_ID}
|
|
```
|
|
|
|
> [!CAUTION]
|
|
> **직접 `Invoke-RestMethod -Body '{"done": true}'` 사용 금지!**
|
|
> Vikunja API는 POST 시 body에 없는 필드를 빈값으로 덮어씁니다.
|
|
|
|
## PowerShell 주의사항
|
|
|
|
- `curl` → PowerShell에서 `Invoke-WebRequest`의 별칭. **반드시 `curl.exe`** 사용
|
|
- JSON 파이프 파싱 시 PowerShell 이스케이핑 문제 → `.py` 스크립트 파일로 만들어 실행 권장
|