📊 Control

Un sistema de seguimiento de pérdidas y ganancias autoalojado, creado con Go, HTMX y sin JavaScript . Controtto registra tus transacciones, las guarda en un archivo SQLite y devuelve todo tipo de cálculos, incluyendo:

Precio medio de compra
Valor actual de los activos
Historial de transacciones
Transacción de importación/exportación (ver ejemplo )
Ganancias y pérdidas

Para obtener el precio de un activo, Controtto se basa principalmente en 4 API ( ver código ).

Binance - API pública, no se necesita token.
BingX - API pública, no se necesita token.
Alpha Vantage : Acciones, gratis pero con límite de tasa corto. ( Obtén un token y configura CONTROTTO_AVANTAGE_TOKEN )
Tiingo - Acciones, criptomonedas y Forex. ( crear cuenta/token y configurar CONTROTTO_TIINGO_TOKEN )

Manifestación

También puedes consultar la demostración en demo.contre.io , la base de datos se reinicia cada hora.

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

Todas las configuraciones se establecen en el archivo .env y se transfieren como variables de entorno. Las variables CONTROTTO_PORT y CONTROTTO_DB_PATH están disponibles.

# 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: DependencyMCP Server

Construir y ejecutar

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

Entorno de desarrollo

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

y acceder a localhost:3000

Corre con Podman

Hay una imagen de contenedor disponible en el registro público de Docker. Si desea usar Docker, simplemente reemplace podman por docker .

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

Ejecutar pruebas

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