KonH / InvestmentReporting

Self-hosted service to manage investments

Summary

This self-hosted service allows you to manage your long-term investments in financial instruments and see statistics. It can be especially useful in the case of different brokers' usage.

Features

Portfolio

You can see your overall portfolio with last-day-close prices, filter it by broker and history period:

Classification

You can set up multiple tags for each asset in your portfolio:

Tags is used in dashboards, for example to handle country and industry diversification:

You can set a target for each tag in the dashboard and see a difference between a real share of that tag and your target. It's useful to understand which category is under or overloaded.

Operation inspection

You can review all operations and filter them by different criteria:

For example, you can filter operations related to specific asset:

Import

You can import your broker reports to the service:

Import supported for different brokers:

Broker	Transfers	Share	ETF	Bond	Dividends	Coupons
AlphaDirect	+	+	+	+	+	+
Tinkoff	+	+	+	+	+	+

Custom

You can manually insert your operations:

Account/broker management

You can set up your brokers and accounts, assign currencies for each account:

Warranty notice

The service is in the initial prototype stage and should not be used in production. No guarantees provided, especially for complex cases, which not fully supported. Statistics data may be inexact and should not be used as financial advice without additional investigations. The service is not directed to short-term operations, data is collected with noticeable delay, which fine for a long-term period.

Installation guide

Hardware

Supports both x86_64 and ARM processors

Prerequisites

• Docker - https://docs.docker.com/get-docker/
• Docker Compose - https://docs.docker.com/compose/install/
• .NET 5 - https://dotnet.microsoft.com/download/dotnet/5.0

Recommendations

HTTPS is not provided by this service, but it's strongly recommended for security reasons. Please set up some HTTPS reverse proxy (like Nginx) to redirect requests to the service.

Getting started

• Clone repository - git clone https://github.com/KonH/InvestmentReporting.git
• Install project .NET tools: dotnet tool restore
• Create Production.env file:

MONGO_INITDB_ROOT_USERNAME=%MONGO_USERNAME%
MONGO_INITDB_ROOT_PASSWORD=%MONGO_PASSWORD%
TINKOFF_API_SANDBOX_KEY=%TINKOFF_API_KEY%

• Mongo credentials related to embedded mongo database, which will be created at start
• Tinkoff API key described here - https://tinkoffcreditsystems.github.io/invest-openapi/auth/
• Start services: dotnet nuke --target Start --configuration Production
• Navigate to http://localhost:8082

Register

• Registration is based on token, which available in service logs
• Lookup token in logs: docker-compose logs invite-service
• Use that token in the registration process
• Register is locked if you make an invalid attempt, just restart the invite-service to reset the access timer