상태: CURRENT PORTAL 이 파일은 문서 위치와 읽는 순서만 안내한다. 현재 구조·구현 상태·실행 계약을 다시 서술하지 않는다.
HgFinance는 Research, Quant, Trading, Risk, Accounting, QA, CEO와 Agent Workforce를 분리한 개인형 멀티에이전트 금융 연구·PAPER 운용 시스템이다. 실제 자금 주문, LIVE 주문, 외부 사용자 Auth·로그인·가입·세션은 현재 범위가 아니다.
| 질문 | 정본 |
|---|---|
| 지금 시스템 구조와 실행 흐름은 무엇인가 | Current Architecture |
| 무엇이 구현·검증됐고 무엇이 남았는가 | Implementation Status |
| Hermes·Worker·Runner·Gateway·Gate의 상세 실행 계약은 무엇인가 | Final Runtime Architecture |
| Worker 역할·권한·활성 편제는 무엇인가 | Worker Role Boundaries |
| Head/Worker 모델과 fallback은 무엇인가 | Worker Model Matrix |
| Domain API·Event·BFF 경계는 무엇인가 | Unified Domain API Specification, Contracts |
| 제품 목표와 장기 범위는 무엇인가 | Hedge Fund Master Plan |
| 문서 상태·배치·충돌은 어떻게 처리하는가 | Documentation Governance |
| 과거 시점의 감사·구조는 어디에 있는가 | Archive |
현재 구현을 설명할 때는 코드·Compose·migration·registry·test를 먼저 보고, 위 표의 정본을 보조 설명으로 사용한다. 날짜·commit에 고정된 문서와 ADR은 현재 상태를 덮어쓰지 않는다.
- Engineering Index
- Local Compose Runtime Baseline
- Hermes Docker Runbook
- Research Worker AWS Runbook
- Technology Decisions
- Research–Quant Agentic Framework
- Research Output Strategy
- MCP On-demand Architecture
- Data Governance Guide
- Database Index
- 저장소 공통 규칙은 루트
AGENTS.md와 담당 부서 README를 먼저 읽는다. - 현재 서비스 목록은 문서의 숫자를 복사하지 말고
docker compose config --services로 확인한다. - 실행 역할은 Worker registry와
hermes/config.yaml에서 확인한다. - API는 route registry와 각 FastAPI
openapi()계약을 확인한다. - 변경 후 담당 계약 테스트와 문서 링크 검사를 함께 실행한다.
문서에 없는 구현 여부를 추정하지 않는다. Compose 선언은 실행 증거가 아니며,
외부 API·DB·GPU·Broker 상태는 실제 runtime 관측이 있을 때만
RUNTIME_VERIFIED로 기록한다.