3a9374c61a
- Belkin & Suchower (1998) credit cycle index (Zt) estimation via WLS - Vasicek single-factor conditional PD/TM model - Macro-Zt OLS regression with stepwise variable selection - 3-scenario (boom/neutral/recession) 50yr PD projection - Statistical validation suite (ADF, Ljung-Box, R2, ARCH) - BOK ECOS API integration with fallback data - Visualization module (7 chart types) - Detailed theoretical methodology docs/methodology.md
4.6 KiB
4.6 KiB
description
| description |
|---|
| 프로젝트 연동 서비스 URL, API 키, 프로젝트 정보 참조 |
서비스 연동 정보
Caution
이 파일에는 API 토큰이 포함되어 있습니다. 프라이빗 레포에서만 사용하세요.
로컬 환경
| 항목 | 값 |
|---|---|
| Node.js | 시스템 설치 (node, npm) |
| Python (helper) | 시스템 설치 또는 conda 환경 |
| 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/LifetimePD |
| 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 | 10 |
| Token | tk_070f8e0b715e818bb7178c3815ed5389040eddca |
| Auth Header | -H "Authorization: Bearer tk_070f8e0b715e818bb7178c3815ed5389040eddca" |
Vikunja 태스크 조회
Tip
태스크 목록은 항상 라이브 조회를 사용합니다. 하드코딩된 매핑은 유지하지 않습니다.
python .agents\workflows\helpers\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가 유일한 작업 현황 관리 도구입니다.
- 로컬
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, 문서, 코드 정리 |
태스크 제목 규칙:
- 한글 + 핵심 키워드 (예:
WebSocket 재연결 로직 구현) - 50자 이내
작업 시작 시
git pull으로 최신 코드 동기화- Vikunja 태스크 조회 (
/check-vikunja) → 관련 태스크 ID 확인 - 관련 태스크가 있으면 Vikunja에서 진행중 표시
- 관련 태스크가 없으면 Vikunja에 새 태스크 생성 (태깅 규칙 준수)
작업 중
- 의미 있는 단위마다 자주 커밋 (대규모 변경을 한번에 커밋하지 않음)
- 커밋 메시지 규칙:
feat:,fix:,refactor:,test:,docs:,chore:,ci:접두사 사용- 관련 Vikunja 태스크가 있으면
#task-{ID}참조 포함 - 예:
feat(server): WebSocket 재연결 로직 #task-21
작업 완료 시
- 모든 변경사항 커밋 +
git push - Vikunja 태스크 완료 처리 (반드시
vikunja_helper.py사용):python .agents\workflows\helpers\vikunja_helper.py done {TASK_ID}
Caution
직접
Invoke-RestMethod -Body '{"done": true}'사용 금지! Vikunja API는 POST 시 body에 없는 필드를 빈값으로 덮어씁니다.
- 작업 중 발견된 새 TODO → Vikunja에 태스크 생성
멀티 AI 협업 시 추가 규칙
- 작업 전
git pull필수 (다른 AI가 push한 변경 반영) - 같은 파일을 동시에 수정하지 않음
- 공유 인터페이스 수정 시 즉시 commit + push
- 충돌 발생 시 유저에게 확인 요청
PowerShell 주의사항
curl→ PowerShell에서Invoke-WebRequest의 별칭. 반드시curl.exe사용npm→ PowerShell에서 실행 정책 문제 시cmd /c npm사용- JSON 파이프 파싱 시 PowerShell 이스케이핑 문제 →
.py스크립트 파일로 만들어 실행 권장