Doctor

설치 후 한 번 실행해 환경이 제대로 잡혔는지 확인하는 명령입니다. API 키, 데이터베이스, FX 캐시를 점검하고, 빠진 항목이 있으면 바로 해결 명령까지 보여줍니다.

firma doctor

일곱 가지 검사를 순서대로 실행합니다. 각 행에는 상태, 검사 항목, 결과 값이 표시됩니다. 전부 녹색이면 바로 사용할 준비가 된 상태입니다.
$firma doctor
✓Finnhub API keyset
✓FRED API keyset
✓Display currencyKRW
✓Transactions117 recorded · 4 active holdings
✓Balance entries36 entries
✓Cash flow entries36 entries
✓FX rate cache9525 rows · 5 currencies · 2018-08-28 → 2026-04-17
All systems ready. Run firma brief for a daily snapshot.

문제가 있을 때

실패한 검사 바로 아래에는 → 형태로 해결 명령이 표시됩니다. 각 항목을 고친 뒤 firma doctor를 다시 실행해 확인하면 됩니다.
$firma doctor
✓Finnhub API keyset
✗FRED API keynot set
→ firma config set fred-key <key>
✓Display currencyUSD (default)
✗FX rate cacheempty
→ firma sync fx
2 issues found. Fix them and re-run firma doctor.

검사 항목

Finnhub API key가격 동기화, 뉴스, 내부자 거래, 실적, 재무제표에 필요
FRED API key거시경제, 스트레스 지수, 레짐, 환율 이력에 필요
Display currency기본값은 USD. firma config set currency KRW로 변경
Transactions기록된 거래 수와 현재 보유 종목 수
Balance entries월별 순자산 스냅샷. 0이면 아직 자산 이력 없음
Cash flow entries월별 수입/지출 기록
FX rate cache행 수, 통화, 기간. firma sync fx로 채워집니다
firma doctor는 데이터베이스를 읽기만 합니다. 데이터를 쓰거나 수정하지 않으니, 설정을 바꾸거나 sync를 돌린 뒤에도 부담 없이 다시 실행해도 됩니다.

옵션

firma doctor사람이 읽기 좋은 출력 + 해결 제안
firma doctor --json기계가 읽기 좋은 JSON 출력. 각 검사 항목에 status, detail, fix가 포함됩니다
MIT License