mirror of
https://github.com/eitchtee/WYGIWYH.git
synced 2026-11-19 23:28:54 +01:00
Splits a transaction into named parts whose amounts add up to its amount, e.g. the items of a big purchase or the fees inside an investment contribution. Parts can be set on transactions, installment plans, recurring and quick transactions, and are copied to the transactions they generate. Transfers can't have parts. Transactions show their parts under a tab on the card and in the investment detail. The content filter matches part names, and bulk edits leave the amount of split transactions alone.
462 lines
14 KiB
Python
462 lines
14 KiB
Python
from collections import defaultdict
|
|
|
|
from dateutil.relativedelta import relativedelta
|
|
from django.contrib.auth.decorators import login_required
|
|
from django.db.models import Sum
|
|
from django.shortcuts import render
|
|
from django.utils import timezone
|
|
from django.utils.translation import gettext_lazy as _
|
|
from django.views.decorators.http import require_http_methods
|
|
|
|
from apps.common.decorators.htmx import only_htmx
|
|
from apps.insights.forms import (
|
|
SingleMonthForm,
|
|
SingleYearForm,
|
|
MonthRangeForm,
|
|
YearRangeForm,
|
|
DateRangeForm,
|
|
CategoryForm,
|
|
)
|
|
from apps.insights.utils.category_explorer import (
|
|
get_category_sums_by_account,
|
|
get_category_sums_by_currency,
|
|
)
|
|
from apps.insights.utils.overview import (
|
|
LEVEL_KEYS,
|
|
clean_chain,
|
|
clean_levels,
|
|
get_grouped_totals,
|
|
)
|
|
from apps.insights.utils.sankey import (
|
|
generate_sankey_data_by_account,
|
|
generate_sankey_data_by_currency,
|
|
)
|
|
from apps.insights.utils.transactions import get_transactions
|
|
from apps.insights.utils.year_by_year import get_year_by_year_data
|
|
from apps.insights.utils.month_by_month import get_month_by_month_data
|
|
from apps.transactions.models import TransactionCategory, Transaction
|
|
from apps.transactions.utils.calculations import calculate_currency_totals
|
|
|
|
# Labels for the grouping levels the overview can be built from.
|
|
OVERVIEW_LEVELS = {
|
|
"categories": {
|
|
"label": _("Categories"),
|
|
"singular": _("Category"),
|
|
"empty": _("Uncategorized"),
|
|
"empty_message": _("No categories"),
|
|
"icon": "fa-solid fa-icons",
|
|
},
|
|
"tags": {
|
|
"label": _("Tags"),
|
|
"singular": _("Tag"),
|
|
"empty": _("Untagged"),
|
|
"empty_message": _("No tags"),
|
|
"icon": "fa-solid fa-hashtag",
|
|
},
|
|
"entities": {
|
|
"label": _("Entities"),
|
|
"singular": _("Entity"),
|
|
"empty": _("No entity"),
|
|
"empty_message": _("No entities"),
|
|
"icon": "fa-solid fa-user-group",
|
|
},
|
|
}
|
|
|
|
|
|
@login_required
|
|
@require_http_methods(["GET"])
|
|
def index(request):
|
|
date = timezone.localdate(timezone.now())
|
|
month_form = SingleMonthForm(initial={"month": date.replace(day=1)})
|
|
year_form = SingleYearForm(initial={"year": date.replace(day=1)})
|
|
month_range_form = MonthRangeForm(
|
|
initial={
|
|
"month_from": date.replace(day=1),
|
|
"month_to": date.replace(day=1) + relativedelta(months=1),
|
|
}
|
|
)
|
|
year_range_form = YearRangeForm(
|
|
initial={
|
|
"year_from": date.replace(day=1, month=1),
|
|
"year_to": date.replace(day=1, month=1) + relativedelta(years=1),
|
|
}
|
|
)
|
|
date_range_form = DateRangeForm(
|
|
initial={
|
|
"date_from": date,
|
|
"date_to": date + relativedelta(months=1),
|
|
}
|
|
)
|
|
|
|
return render(
|
|
request,
|
|
"insights/pages/index.html",
|
|
context={
|
|
"month_form": month_form,
|
|
"year_form": year_form,
|
|
"month_range_form": month_range_form,
|
|
"year_range_form": year_range_form,
|
|
"date_range_form": date_range_form,
|
|
},
|
|
)
|
|
|
|
|
|
@only_htmx
|
|
@login_required
|
|
@require_http_methods(["GET"])
|
|
def sankey_by_account(request):
|
|
# Get filtered transactions
|
|
|
|
transactions = get_transactions(
|
|
request, include_untracked_accounts=True, include_silent=True
|
|
)
|
|
|
|
# Generate Sankey data
|
|
sankey_data = generate_sankey_data_by_account(transactions)
|
|
|
|
return render(
|
|
request,
|
|
"insights/fragments/sankey.html",
|
|
{"sankey_data": sankey_data, "type": "account"},
|
|
)
|
|
|
|
|
|
@only_htmx
|
|
@login_required
|
|
@require_http_methods(["GET"])
|
|
def sankey_by_currency(request):
|
|
# Get filtered transactions
|
|
transactions = get_transactions(
|
|
request, include_silent=True, include_untracked_accounts=True
|
|
)
|
|
|
|
# Generate Sankey data
|
|
sankey_data = generate_sankey_data_by_currency(transactions)
|
|
|
|
return render(
|
|
request,
|
|
"insights/fragments/sankey.html",
|
|
{"sankey_data": sankey_data, "type": "currency"},
|
|
)
|
|
|
|
|
|
@only_htmx
|
|
@login_required
|
|
@require_http_methods(["GET"])
|
|
def category_explorer_index(request):
|
|
category_form = CategoryForm()
|
|
|
|
return render(
|
|
request,
|
|
"insights/fragments/category_explorer/index.html",
|
|
{"category_form": category_form},
|
|
)
|
|
|
|
|
|
@only_htmx
|
|
@login_required
|
|
@require_http_methods(["GET"])
|
|
def category_sum_by_account(request):
|
|
# Get filtered transactions
|
|
transactions = get_transactions(request, include_silent=True)
|
|
|
|
category = request.GET.get("category")
|
|
|
|
if category:
|
|
category = TransactionCategory.objects.get(id=category)
|
|
|
|
# Generate data
|
|
account_data = get_category_sums_by_account(transactions, category)
|
|
else:
|
|
account_data = get_category_sums_by_account(transactions, category=None)
|
|
|
|
return render(
|
|
request,
|
|
"insights/fragments/category_explorer/charts/account.html",
|
|
{"account_data": account_data},
|
|
)
|
|
|
|
|
|
@only_htmx
|
|
@login_required
|
|
@require_http_methods(["GET"])
|
|
def category_sum_by_currency(request):
|
|
# Get filtered transactions
|
|
transactions = get_transactions(request, include_silent=True)
|
|
|
|
category = request.GET.get("category")
|
|
|
|
if category:
|
|
category = TransactionCategory.objects.get(id=category)
|
|
|
|
# Generate data
|
|
currency_data = get_category_sums_by_currency(transactions, category)
|
|
else:
|
|
currency_data = get_category_sums_by_currency(transactions, category=None)
|
|
|
|
return render(
|
|
request,
|
|
"insights/fragments/category_explorer/charts/currency.html",
|
|
{"currency_data": currency_data},
|
|
)
|
|
|
|
|
|
OVERVIEW_SESSION_PREFIX = "insights_overview"
|
|
|
|
# What a first visit shows: categories broken down by tags, as the old
|
|
# Categories Overview did, with entities available but switched off.
|
|
OVERVIEW_DEFAULT_LEVELS = ["categories", "tags"]
|
|
|
|
|
|
def _overview_setting(request, name, default):
|
|
"""Read a control from the query string, falling back to the last one used."""
|
|
key = f"{OVERVIEW_SESSION_PREFIX}_{name}"
|
|
if name in request.GET:
|
|
request.session[key] = request.GET[name]
|
|
return request.GET[name]
|
|
return request.session.get(key, default)
|
|
|
|
|
|
def _overview_chain(request):
|
|
"""The chip order and the switched on levels, from the request or session."""
|
|
chain_key = f"{OVERVIEW_SESSION_PREFIX}_chain"
|
|
levels_key = f"{OVERVIEW_SESSION_PREFIX}_levels"
|
|
|
|
if "chain" in request.GET:
|
|
chain = clean_chain(request.GET.getlist("chain"))
|
|
levels = clean_levels(request.GET.getlist("level"), chain)
|
|
request.session[chain_key] = chain
|
|
request.session[levels_key] = levels
|
|
else:
|
|
chain = clean_chain(request.session.get(chain_key, list(LEVEL_KEYS)))
|
|
levels = clean_levels(
|
|
request.session.get(levels_key, OVERVIEW_DEFAULT_LEVELS), chain
|
|
)
|
|
|
|
return chain, levels
|
|
|
|
|
|
@only_htmx
|
|
@login_required
|
|
@require_http_methods(["GET"])
|
|
def overview(request):
|
|
"""
|
|
One overview whose level chain the user arranges.
|
|
|
|
Renders only the controls; they stay put while the results below them
|
|
reload, so rearranging the chain never pulls the chips out from under the
|
|
pointer. The chips hold the order, which is why nothing here rewrites it.
|
|
"""
|
|
chain, levels = _overview_chain(request)
|
|
|
|
return render(
|
|
request,
|
|
"insights/fragments/overview/index.html",
|
|
{
|
|
"chips": [
|
|
{
|
|
"key": key,
|
|
"meta": OVERVIEW_LEVELS[key],
|
|
"enabled": key in levels,
|
|
"position": levels.index(key) + 1 if key in levels else "",
|
|
}
|
|
for key in chain
|
|
],
|
|
"view_type": _overview_setting(request, "view_type", "table"),
|
|
"showing": _overview_setting(request, "showing", "final"),
|
|
},
|
|
)
|
|
|
|
|
|
@only_htmx
|
|
@login_required
|
|
@require_http_methods(["GET"])
|
|
def overview_results(request):
|
|
"""The table or chart for the arrangement the controls submitted."""
|
|
chain, levels = _overview_chain(request)
|
|
view_type = _overview_setting(request, "view_type", "table")
|
|
showing = _overview_setting(request, "showing", "final")
|
|
|
|
total_table = get_grouped_totals(
|
|
transactions_queryset=get_transactions(request, include_silent=True),
|
|
levels=levels,
|
|
showing=showing,
|
|
ignore_empty=False,
|
|
depth=len(levels),
|
|
)
|
|
|
|
return render(
|
|
request,
|
|
"insights/fragments/overview/_results.html",
|
|
{
|
|
"total_table": total_table,
|
|
"view_type": view_type,
|
|
"showing": showing,
|
|
"level_1": OVERVIEW_LEVELS[levels[0]],
|
|
"level_2": OVERVIEW_LEVELS[levels[1]] if len(levels) > 1 else None,
|
|
"level_3": OVERVIEW_LEVELS[levels[2]] if len(levels) > 2 else None,
|
|
"empty_message": OVERVIEW_LEVELS[levels[0]]["empty_message"],
|
|
},
|
|
)
|
|
|
|
|
|
@only_htmx
|
|
@login_required
|
|
@require_http_methods(["GET"])
|
|
def latest_transactions(request):
|
|
limit = timezone.now() - relativedelta(days=3)
|
|
transactions = (
|
|
Transaction.objects.filter(created_at__gte=limit)
|
|
.collapse_transfers()
|
|
.prefetch_related("sub_transactions")
|
|
.order_by("-id")[:30]
|
|
)
|
|
|
|
return render(
|
|
request,
|
|
"insights/fragments/latest_transactions.html",
|
|
{"transactions": transactions},
|
|
)
|
|
|
|
|
|
@only_htmx
|
|
@login_required
|
|
@require_http_methods(["GET"])
|
|
def late_transactions(request):
|
|
now = timezone.localdate(timezone.now())
|
|
transactions = Transaction.objects.filter(
|
|
is_paid=False, date__lt=now
|
|
).collapse_transfers().prefetch_related("sub_transactions")
|
|
|
|
return render(
|
|
request,
|
|
"insights/fragments/late_transactions.html",
|
|
{"transactions": transactions},
|
|
)
|
|
|
|
|
|
@only_htmx
|
|
@login_required
|
|
@require_http_methods(["GET"])
|
|
def emergency_fund(request):
|
|
transactions_currency_queryset = (
|
|
Transaction.objects.filter(
|
|
is_paid=True, account__is_archived=False, account__is_asset=False
|
|
)
|
|
.exclude(account__in=request.user.untracked_accounts.all())
|
|
.order_by(
|
|
"account__currency__name",
|
|
)
|
|
)
|
|
currency_net_worth = calculate_currency_totals(
|
|
transactions_queryset=transactions_currency_queryset, ignore_empty=False
|
|
)
|
|
|
|
end_date = (timezone.now() - relativedelta(months=1)).replace(day=1)
|
|
start_date = (end_date - relativedelta(months=12)).replace(day=1)
|
|
|
|
# Step 1: Calculate total expense for each month and currency
|
|
monthly_expenses = (
|
|
Transaction.objects.filter(
|
|
type=Transaction.Type.EXPENSE,
|
|
is_paid=True,
|
|
account__is_asset=False,
|
|
reference_date__gte=start_date,
|
|
reference_date__lte=end_date,
|
|
category__mute=False,
|
|
mute=False,
|
|
)
|
|
.exclude(account__in=request.user.untracked_accounts.all())
|
|
.values("reference_date", "account__currency")
|
|
.annotate(monthly_total=Sum("amount"))
|
|
)
|
|
|
|
# Step 2: Calculate averages by currency using Python
|
|
currency_totals = defaultdict(list)
|
|
for expense in monthly_expenses:
|
|
currency_id = expense["account__currency"]
|
|
currency_totals[currency_id].append(expense["monthly_total"])
|
|
|
|
for currency_id, totals in currency_totals.items():
|
|
avg = currency_net_worth[currency_id]["average"] = sum(totals) / len(totals)
|
|
if currency_net_worth[currency_id]["total_current"] < 0:
|
|
currency_net_worth[currency_id]["months"] = 0
|
|
else:
|
|
currency_net_worth[currency_id]["months"] = int(
|
|
currency_net_worth[currency_id]["total_current"] / avg
|
|
)
|
|
|
|
return render(
|
|
request,
|
|
"insights/fragments/emergency_fund.html",
|
|
{"data": currency_net_worth},
|
|
)
|
|
|
|
|
|
@only_htmx
|
|
@login_required
|
|
@require_http_methods(["GET"])
|
|
def year_by_year(request):
|
|
if "group_by" in request.GET:
|
|
group_by = request.GET["group_by"]
|
|
request.session["insights_year_by_year_group_by"] = group_by
|
|
else:
|
|
group_by = request.session.get("insights_year_by_year_group_by", "categories")
|
|
|
|
# Validate group_by value
|
|
if group_by not in ("categories", "tags", "entities"):
|
|
group_by = "categories"
|
|
|
|
data = get_year_by_year_data(group_by=group_by)
|
|
|
|
return render(
|
|
request,
|
|
"insights/fragments/year_by_year.html",
|
|
{
|
|
"data": data,
|
|
"group_by": group_by,
|
|
},
|
|
)
|
|
|
|
|
|
@only_htmx
|
|
@login_required
|
|
@require_http_methods(["GET"])
|
|
def month_by_month(request):
|
|
# Handle year selection
|
|
if "year" in request.GET:
|
|
try:
|
|
year = int(request.GET["year"])
|
|
request.session["insights_month_by_month_year"] = year
|
|
except (ValueError, TypeError):
|
|
year = request.session.get(
|
|
"insights_month_by_month_year", timezone.localdate(timezone.now()).year
|
|
)
|
|
else:
|
|
year = request.session.get(
|
|
"insights_month_by_month_year", timezone.localdate(timezone.now()).year
|
|
)
|
|
|
|
# Handle group_by selection
|
|
if "group_by" in request.GET:
|
|
group_by = request.GET["group_by"]
|
|
request.session["insights_month_by_month_group_by"] = group_by
|
|
else:
|
|
group_by = request.session.get("insights_month_by_month_group_by", "categories")
|
|
|
|
# Validate group_by value
|
|
if group_by not in ("categories", "tags", "entities"):
|
|
group_by = "categories"
|
|
|
|
data = get_month_by_month_data(year=year, group_by=group_by)
|
|
|
|
return render(
|
|
request,
|
|
"insights/fragments/month_by_month.html",
|
|
{
|
|
"data": data,
|
|
"group_by": group_by,
|
|
"selected_year": year,
|
|
},
|
|
)
|