Models
Transactions
Transactions are the core feature of WYGIWYH, representing expenses or income in your accounts. Each transaction consists of the following fields:
Type
- Income: A positive amount entering your account
- Expense: A negative amount exiting your account
Paid Status
A transaction can be either:
- Current: When marked as paid
- Projected: When marked as unpaid
Account
The account associated with the transaction. Required, limited to one account per transaction.
Entity
The party involved in the transaction:
- For Income: The paying entity
- For Expense: The receiving entity
Optional field.
Date
The date when the transaction occurred. Required.
Reference Date
One of WYGIWYH's key features. The reference date determines which month a transaction should count towards. For example, you can have a transaction that occurred on January 26th count towards February's finances.
Optional - defaults to the transaction date's month if not specified.
Caution
While designed primarily for credit card closing dates, this feature allows for debt rolling across months. Use responsibly to maintain accurate financial tracking.
Type
- Income, meaning a positive amount (usually) entering your account
- Expense, meaning a negative amount exiting your account
Description
The name or purpose of the transaction. Required.
Amount
The monetary value of the transaction. Required.
Category
The primary classification of the transaction. Optional.
Tags
Additional labels for transaction categorization. Optional.
Notes
Additional information about the transaction. Optional.
Installment Plan
An Installment Plan is a helper model that generates a series of recurring transactions over a fixed period.
Core Fields
- Account: The account for all transactions in the plan. Required.
- Entity: The paying or receiving party for all transactions. Optional.
- Description: The name of the installment plan, used for all transactions. Required.
- Notes: Additional information applied to all transactions. Optional.
Installment Configuration
- Number of Installments: Total number of transactions to create (e.g., 1/10, 2/10)
- Installment Start: Initial counting point
- Start Date: Date of the first transaction
- Reference Date: Reference date for the first transaction
- Recurrence: Frequency of transactions (e.g., Monthly)
Transaction Details
- Amount: Value for each transaction. Required.
- Category: Primary classification for all transactions. Optional.
- Tags: Labels applied to all transactions. Optional.
Recurring Transaction
A Recurring Transaction is a helper model that generates recurring transactions indefinitely or until a certain date.
Core Fields
- Account: The account for all transactions in the plan. Required.
- Entity: The paying or receiving party for all transactions. Optional.
- Description: The name of the recurring transaction, used for all transactions. Required.
- Notes: Additional information applied to all transactions. Optional.
Recurring Transaction Configuration
- Start Date: Date of the first transaction. Required.
- Reference Date: Reference date for the first transaction. Optional.
- Recurrence Type: Frequency of transactions (e.g., Monthly). Required.
- Recurrence Interval: The interval between transactions (e.g. every 1 month, every 2 weeks, etc.). Required.
- End date: When new transactions should stop being created. Optional.
Transaction Details
- Amount: Value for each transaction. Required.
- Category: Primary classification for all transactions. Optional.
- Tags: Labels applied to all transactions. Optional.
Other information
- Recurring transactions are checked and created every midnight using Procrastinate.
- WYGIWYH tries to keep at most 6 future transactions created at any time.
- If you delete a recurring transaction it will not be recreated.
- You can stop or pause a recurring transaction at any time on the config page (/recurring-trasanctions/)
Account
Accounts represent different financial entities where transactions occur. They have the following attributes:
- Name: A unique identifier for the account.
- Group: An optional account group the account belongs to for organizational purposes.
- Currency: The primary currency of the account.
- Exchange Currency: An optional currency used for exchange rate calculations.
- Is Asset: A boolean indicating if the account is considered an asset (counts towards net worth).
- Is Archived: A boolean indicating if the account is archived (doesn't show up in active lists or count towards net worth).
Account Groups
Account Groups are used to organize accounts into logical categories. They consist of:
- Name: A unique identifier for the group.
Currency
Currencies represent different monetary units. They include:
- Code: A unique identifier for the currency (e.g., USD, EUR).
- Name: The full name of the currency.
- Decimal Place: The number of decimal places used for the currency.
- Prefix: An optional symbol or text that comes before the amount.
- Suffix: An optional symbol or text that comes after the amount.
Exchange Rate
Exchange Rates store conversion rates between currencies:
- From Currency: The source currency.
- To Currency: The target currency.
- Rate: The conversion rate.
- Date: The date the rate was recorded or is valid for.
Category
Categories are used to classify transactions:
- Name: A unique identifier for the category.
- Muted: Muted categories won't count towards your monthly total.
- Active: A boolean indicating if the category is currently in use. This will disable its use on new transactions.
Tag
Tags provide additional labeling for transactions:
- Name: A unique identifier for the tag.
- Active: A boolean indicating if the category is currently in use. This will disable its use on new transactions.
Entity
Entities represent parties involved in transactions:
- Name: A unique identifier for the entity.
- Active: A boolean indicating if the entity is currently in use. This will disable its use on new transactions.
Helper actions
Transfer
A transfer happens when you move a monetary value from one account to another. This will create two transactions, one expense and one income with the values set by the user.
Contrary to other finance trackers, due to our multi-currency support, WYGIWYH's transfer system allows for non-zero transfers.
Balance (Account Reconciliation)
A balance is a easy way of updating your accounts balance. It creates a transaction with the difference between the balance currently in WYGIWYH and the new balance informed by you.
This can be useful for savings accounts or other interest accruing investments.
Views
Monthly
The Monthly view provides an overview of your financial activity for a specific month. It includes:
- Total income and expenses for the month
- Daily spending allowance calculation
- List of transactions for the month
Note
Reference dates are taken into account here.
Yearly by currency
This view gives you a yearly summary of your finances grouped by currency. It shows:
- Total income and expenses for each currency
- Monthly breakdown of income and expenses
Yearly by account
Similar to the yearly by currency view, but groups the data by account instead.
Calendar
The Calendar view presents your transactions in a monthly calendar format, allowing you to see your financial activity day by day. It includes:
- Visual representation of daily transaction totals
- Ability to view details of transactions for each day
Note
Reference dates are not taken into account here.
Networh
Current
The Current Net Worth view shows your present financial standing, including:
- Total value of all asset accounts
- Breakdown of assets by account and currency
- Historical net worth trend
Projected
The Projected Net Worth view estimates your future financial position based on current data and recurring transactions. It includes:
- Your total net worth with projected and current transactions
- Breakdown of assets by account and currency
- Historical and future net worth trend
All Transactions
This view provides a comprehensive list of all transactions across all accounts. Features include:
- Advanced filtering and sorting options
- Detailed information
You can use this to see how much you spent on a given category, or a given day, etc..
Configuration and Management
Management
The Management section in the navbar allows you to add and edit most elements of WYGIWYH, including:
- Accounts and Groups
- Currencies and Exchange Rates
- Categories, Tags and Entities
- Rules
User Settings
WYGIWYH allows users to personalize their experience through customizable settings. Each user can configure:
- Language: Choose your preferred interface language.
- Timezone: Set your local timezone for accurate date and time display.
- Start Page: Select which page you want to see first when you log in.
- Sound Preferences: Toggle sound effects on or off.
- Amount Display: Choose to show or hide monetary amounts by default.
To access and modify these settings:
- Click on your username in the top-right corner of the page.
- Select "Settings" from the dropdown menu.
- Adjust your preferences as desired.
- Click "Save" to apply your changes.
These settings ensure that WYGIWYH adapts to your personal preferences and working style.
Django Admin
From here you can also access Django's own admin site.
Warning
Most side effects aren't triggered from the admin. Only use it if you know what you're doing or were told by a developer to do so.
Tools
Calculator
The calculator is a floating widget that can be toggled by clicking the calculator icon on the navbar or by pressing Alt + C on any page.
It allows for any math expression supported by math.js.
Dollar Cost Average Tracker
The DCA Tracker can be accessed from the navbar's Tools menu.
It allows for tracking DCA strategies and getting helpful information and insights.
Important
Currently DCA exists separately from your main transactions. You will need to add your entries manually.
Unit Price Calculator
The Unit Price Calculator can be accessed from the navbar's Tools menu.
This is a self-contained tool for comparing and finding the most cost-efficient item quickly and easily.
Input the price and the amount of each item, the cheapeast will be highlighted in green, and the most expensive in red.
You can add additional items by clicking the Add button at the end of the page.
Note
This doesn't do unit convertion. The amount of all items needs to be on the same the unit for proper functioning.
Currency Converter
The Currency Converter is a tool that allows you to quickly convert amounts between different currencies.
Note
There's no external Exchange Rate fetching. This uses the Exchange Rates configured in the Management page for Exchange Rates
Automation
API
WYGIWYH has a comprehensive API, it's documentation can be accessed on <your-wygiwyh-url>/api/docs/
Note
While the API works, there's still much to be added to it to equipare functionality with the main web app.