프로젝트 소개

Helius는 전체 화면 터미널 UI와 직접 CLI 명령을 갖춘 단일 Rust 바이너리로 실행되는 로컬 우선 개인 금융 추적기입니다. 데이터는 하나의 로컬 SQLite 데이터베이스에 저장되며, Windows와 Linux의 기본 위치가 있고 `--db` 또는 `HELIUS_DB_PATH`로 재정의할 수 있습니다. 핵심 기능에는 계정, 카테고리, 수입, 지출 및 이체 거래; 25개의 은행 CSV 사전 설정 매핑과 제한적인 camt.053 XML 가져오기; 반복 규칙; 조정; 예산; 현금 흐름 계획이 포함됩니다. 스크립팅을 위한 JSON 출력이 제공되며, CSV 내보내기는 보고를 지원합니다. 설치 옵션에는 미리 빌드된 Windows x86_64 및 Linux x86_64 바이너리, Cargo로 소스에서 빌드, 체크아웃에서 설치, `/data/tracker.db`용 명명된 볼륨을 사용한 Docker 실행이 포함됩니다. 첫 실행 시 Helius는 통화 코드를 묻고 기본 데이터베이스를 초기화할 수 있습니다. TUI는 패널 탐색, 항목 생성/편집, 보관 또는 삭제, 도움말 및 양식 컨트롤을 제공합니다. CLI 예제는 계정 및 카테고리 관리, 거래 입력 및 편집, 예산 상태 및 월별 요약, 반복 규칙 생성 및 실행, CSV 및 camt.053 가져오기, 예측/시나리오/목표 명령을 보여줍니다. 이 프로젝트는 GNU Affero General Public License v3.0에 따라 배포됩니다.