Controtto

🚀 自託管投資損益追跡ツール - Controtto

Controttoは、Go言語で開発された自託管のP&L（損益）追跡ツールで、HTMXを使用し、JavaScriptを使用せずに実装されています。このツールはSQLiteファイルに取引記録を保存し、以下のような様々な計算機能を提供します。

• 平均買い付け価格
• 現在の資産価値
• 取引履歴
• 取引データのインポート/エクスポート（サンプルファイルを参照）
• 損益計算

資産価格を取得するために、Controttoは4つの主要なAPIを使用しています。

• Binance：トークン不要の公共API。
• BingX：トークン不要の公共API。
• Alpha Vantage：株式データを提供します。無料ですが、レート制限があります。トークンを取得し、CONTROTTO_AVANTAGE_TOKEN環境変数を設定してください。
• Tiingo：株式、暗号通貨、外国為替データを提供します。アカウントを作成してトークンを取得した後、CONTROTTO_TIINGO_TOKEN環境変数を設定してください。

🚀 クイックスタート

🔍 サンプルデモ

demo.contre.io で実時間のデモを確認できます。データベースは1時間ごとにリセットされます。

📦 インストールと設定

# 依存関係のインストール
go mod tidy

# 環境ファイルの設定
mv .env.example .env

# 環境変数の読み込み
. <(cat .env | grep -v -e '^$' | grep -v "#" | awk '{}')

🚀 ビルドと実行

go run ./cmd/main.go # または実行可能ファイルをビルドする場合は：go build ./cmd/main.go

💻 開発環境の設定

# Airツールのインストール
go install github.com/cosmtrek/air@latest

# Airを使用してアプリを起動
air -c air.toml

# 結果を確認するには、http://localhost:3000にアクセスします。

🐳 Podmanを使用したコンテナの実行

Dockerイメージを提供しており、イメージのアドレスは hub.docker.com/r/contre95/controtto です。使用する場合は、podman を docker に置き換えてください。

mkdir data

# コンテナの起動
podman container run --rm -p 8000:8000 -v $(pwd)/data:/data contre95/controtto

🧪 テスト部分

go test -cover ./...

# 期待される結果の例：
# ?       controtto/cmd   [テストファイルなし]
# ?       controtto/src/app/managing      [テストファイルなし]
# ?       controtto/src/domain/pnl        [テストファイルなし]
# ?       controtto/src/gateways/markets  [テストファイルなし]
# ?       controtto/src/gateways/sqlite   [テストファイルなし]
# ?       controtto/src/presenters        [テストファイルなし]
# ok      controtto/src/app/querying      0.003s  coverage: 40.7% of statements

📋 今後の予定（TODO）

• より多くのテストケースを追加する。
• ログ記録と監視機能を追加する。
• アカウント管理機能を実装し、総純資産を追跡する。
• すべてのCSSを削除し、カスタムの style.css とTailwind CDNを使用する。