📊 Kontrolle

Ein selbstgehosteter Gewinn- und Verlust-Tracker, der mit Go, HTML und ohne JavaScript erstellt wurde. Controtto verfolgt Ihre Transaktionen, speichert sie in einer SQLite-Datei und gibt alle möglichen Berechnungen zurück, darunter:

• Durchschnittlicher Kaufpreis

• Aktueller Vermögenswert

• Transaktionsverlauf

• Import-/Exporttransaktion (siehe Beispiel )

• Gewinn und Verlust

Um den Preis eines Vermögenswerts abzurufen, verlässt sich Controtto hauptsächlich auf 4 APIs ( siehe Code ).

• Binance – Öffentliche API, kein Token erforderlich.

• BingX – Öffentliche API, kein Token erforderlich.

• Alpha Vantage – Aktien, kostenlos, aber mit kurzer Kursbegrenzung. ( Holen Sie sich ein Token und legen Sie CONTROTTO_AVANTAGE_TOKEN fest)

• Tiingo – Aktien, Kryptowährungen und Forex. (Konto/Token erstellen und CONTROTTO_TIINGO_TOKEN festlegen)

Demo

Sie können sich die Demo auch unter demo.contre.io ansehen, die Datenbank wird stündlich zurückgesetzt.

https://github.com/user-attachments/assets/28bf8782-6118-47c0-a94b-085e1a7045b2

Alle Konfigurationen werden in der .env Datei festgelegt und als Umgebungsvariablen übergeben. Die Variablen CONTROTTO_PORT und CONTROTTO_DB_PATH sind verfügbar.

# Install the dependencies
go mod tidy
# Set the .env
mv .env.example .env
# Source the env variables
. <(cat .env | grep -v -e '^$' | grep -v "#" | awk '{}')

Related MCP server: Arch-Expert-MCP

Erstellen und Ausführen

go run ./cmd/main.go # go build ./cmd/main.go to just build it

Entwicklungsumgebung

go install github.com/cosmtrek/air@latest # Download air
air -c air.toml

und greifen Sie auf localhost:3000 zu

Lauf mit Podman

Ein Container-Image ist im öffentlichen Docker-Register verfügbar. Wenn Sie Docker verwenden möchten, ersetzen Sie einfach podman durch docker .

mkdir data
podman container run --rm -p 8000:8000 -v $(pwd)/data:/data contre95/controtto

Führen Sie Tests durch

go test -cover ./...
#   Expected result
#   ?       controtto/cmd   [no test files]
#   ?       controtto/src/app/managing      [no test files]
#   ?       controtto/src/domain/pnl        [no test files]
#   ?       controtto/src/gateways/markets  [no test files]
#   ?       controtto/src/gateways/sqlite   [no test files]
#   ?       controtto/src/presenters        [no test files]
#   ok      controtto/src/app/querying      0.003s  coverage: 40.7% of statements

ZU TUN

• Weitere Tests

• Wrapper für Protokollierung und Metriken wären auch schön.

• Fügen Sie Konten hinzu, um den Überblick über das gesamte Nettovermögen zu behalten.

• Entfernen Sie das gesamte CSS und verwenden Sie benutzerdefiniertes style.css + Tailwind CDN.