adding troubleshoot balance discrepancies in deposit-account.md

docs/en/assets/demo-portfolio-03.settings

@@ -1,4 +1,4 @@
-#Thu Jun 20 23:05:23 CEST 2024
+#Wed Jun 26 13:12:37 CEST 2024
 SecurityEventsPane={"items"\:[{"id"\:"0","sortDirection"\:1024,"width"\:80},{"id"\:"1","width"\:120},{"id"\:"2","width"\:80},{"id"\:"3","width"\:80},{"id"\:"4","width"\:300}]}
 StatementOfAssetsView-newsash=420
 PerformanceView@2Earnings={"items"\:[{"id"\:"0","sortDirection"\:1024,"width"\:100},{"id"\:"1","width"\:100},{"id"\:"2","width"\:80},{"id"\:"3","width"\:80},{"id"\:"4","width"\:80},{"id"\:"5","width"\:250},{"id"\:"6","width"\:100},{"id"\:"7","width"\:100},{"id"\:"note","width"\:200}]}
@@ -12,14 +12,14 @@ PerformanceView-calculation@v2={"items"\:[{"id"\:"label","width"\:350},{"id"\:"v
 AccountListView@top2={"items"\:[{"id"\:"0","width"\:150},{"id"\:"1","width"\:114},{"id"\:"currency","width"\:60},{"id"\:"note","width"\:200}]}
 ReturnsVolatilityChartView-risk-metric=VOLATILITY
 PerformanceView-newsash=200
-PerformanceChartView-PICKER$picked=69cff468-3eb7-413a-aa63-51726c5415e5
 Model@bottom=true
+PerformanceChartView-PICKER$picked=69cff468-3eb7-413a-aa63-51726c5415e5
 PerformanceView@byaccounts2={"items"\:[{"id"\:"0","width"\:400},{"id"\:"1","width"\:80},{"id"\:"2","width"\:80},{"id"\:"3","width"\:80},{"id"\:"4","width"\:80},{"id"\:"5","width"\:80}]}
 TransactionsTab@v3={"items"\:[{"id"\:"0","sortDirection"\:1024,"width"\:185},{"id"\:"1","width"\:150},{"id"\:"2","width"\:250},{"id"\:"3","width"\:80},{"id"\:"4","width"\:80},{"id"\:"5","width"\:80},{"id"\:"6","width"\:80},{"id"\:"7","width"\:80},{"id"\:"8","width"\:120},{"id"\:"9","width"\:200}]}
 TradeDetailsView-newsash=200
-StatementOfAssetsHistoryView-PICKER$picked=ec4dc660-8854-43ad-80d4-31584fe10e19
-SettingsView-newsash=200
 SecurityPriceChartPane=Y3
+SettingsView-newsash=200
+StatementOfAssetsHistoryView-PICKER$picked=ec4dc660-8854-43ad-80d4-31584fe10e19
 BookmarksListTab@bottom={"items"\:[{"id"\:"0","width"\:150},{"id"\:"1","width"\:500}]}
 IMPORT_NOTESPortfolio\ Transactions=true
 performance-chart-aggregation-period=
@@ -31,13 +31,14 @@ name.abuchen.portfolio.ui.views.panes.TransactionsPane={"items"\:[{"id"\:"0","so
 import-target-portfolio-Account\ Transactions=ccd0ccf0-d4cd-4c16-8316-2b8727eb514d
 PortfolioListView-newsash=1566
 import-target-portfolio-Portfolio\ Transactions=ccd0ccf0-d4cd-4c16-8316-2b8727eb514d
+TroubleshootBalanceDiscrepancyDialog-balance@Vxy11={"items"\:[{"id"\:"date","sortDirection"\:1024,"width"\:100},{"id"\:"value","width"\:120},{"id"\:"delta","width"\:120},{"id"\:"expected","width"\:120}]}
 CalculationLineItemPane={"items"\:[{"id"\:"0","sortDirection"\:128,"width"\:170},{"id"\:"1","width"\:110},{"id"\:"2","width"\:80},{"id"\:"3","width"\:85},{"id"\:"4","width"\:139},{"id"\:"5","width"\:133},{"id"\:"6","width"\:287},{"id"\:"7","width"\:97},{"id"\:"8","width"\:86},{"id"\:"9","width"\:183}]}
 name.abuchen.portfolio.ui.views.SecuritiesTable$picked=ace4b28f-3207-4dc2-95fa-edc3936851f9
 name.abuchen.portfolio.ui.views.AllTransactionsView={"items"\:[{"id"\:"0","sortDirection"\:128,"width"\:180},{"id"\:"1","width"\:155},{"id"\:"2","width"\:115},{"id"\:"3","width"\:80},{"id"\:"4","width"\:80},{"id"\:"5","width"\:80},{"id"\:"6","width"\:80},{"id"\:"7","width"\:80},{"id"\:"8","width"\:196},{"id"\:"account","width"\:177},{"id"\:"9","width"\:187},{"id"\:"10","width"\:200},{"id"\:"source","width"\:200}]}
 PerformanceView@2Taxes={"items"\:[{"id"\:"0","sortDirection"\:1024,"width"\:100},{"id"\:"1","width"\:100},{"id"\:"2","width"\:80},{"id"\:"3","width"\:80},{"id"\:"4","width"\:80},{"id"\:"5","width"\:250},{"id"\:"6","width"\:100},{"id"\:"7","width"\:100},{"id"\:"note","width"\:200}]}
 SecuritiesPerformanceView-newsash=495
 CSV_IMPORT_PATH=D\:\\tmp
-DashboardView-newsash=-200
+DashboardView-newsash=-1
 AccountListView-newsash=538
 SecurityListView-newsash=568
 AttributeListTab@v2={"items"\:[{"id"\:"0","width"\:250},{"id"\:"1","width"\:150},{"id"\:"2","width"\:150},{"id"\:"3","width"\:100}]}

docs/en/reference/view/accounts/deposit-account.md

@@ -1,34 +1,53 @@
 ---
 title: Deposit accounts
 ---
-# View › Accounts › Deposit Accounts
 
 A deposit account serves as a central hub for managing cash flow within the portfolio, allowing users to allocate funds for investment activities and track incoming and outgoing cash transactions. One can visualize it as a list, akin to a shopping list, where transactions such as withdrawals and deposits of digital money are recorded. There can be many deposit accounts within one portfolio, for example, for different currencies that are traded. As part of the installation process, at least one security account and one deposit account have already been created.
 
 Figure: Example of Deposit Accounts. {class="pp-figure"}
 
 ![](images/sb-accounts-deposit-accounts.png)
 
-In Figure 1 (main pane), there are three deposit accounts named `Broker-1 (EUR)`, `Broker-1 (USD)`, and `broker-2 (EUR)`. Based on their names, it can be inferred that these accounts likely represent two cash accounts held at `Broker-1` (in EUR & USD) and one cash account in EUR with `Broker-2`. It may appear somewhat redundant to add "EUR" and "USD" in the name of the account because you also need to specify the currency for each deposit account (see the third column in Figure 1). On the other hand, in many dialogs (for example when buying a security) you need to specify the deposit account. The added currency in the name of the deposit account will help you then choosing the correct one.
 
-Of course, you can use other names depending on your needs. For example, if you want to keep all your dividends and taxes in a separate account, you could name it `Dividends` and `Taxes`. If you receive dividends in both EUR and USD, then you need also two deposit accounts.
+## Main pane
+
+In Figure 1 (main pane), there are four deposit accounts. It may seem unnecessary to include the currency in the name of an account, as the currency is already specified for each deposit account in the third column of Figure 1. However, including the currency in the name of the deposit account can be helpful in situations where you need to select a deposit account from a list, such as when buying a security. In these cases, having the currency clearly displayed in the name of the account can help you quickly and accurately choose the correct one.
+
+You can use different names for accounts depending on your preferences and needs. For example, if you wish to keep your dividends and taxes separate, you could create two accounts named `Dividends`" and `Taxes`.
 
 Figure: Add account. {class=align-right style="width:20%"}
 
 ![](images/create-new-account.png)
 
-To create a new deposit account, click on the green + icon located at the top right (refer to Figure 2). Then, select the option `Add account`. Since you're in the Deposit Account view, a new deposit account named `No Name` will be created with the default currency of the portfolio. Remember to change the currency if needed by double-clicking on the currency field (e.g., EUR) and selecting another currency from the dropdown menu. While navigating the currency list, you can use the first letter of the desired currency for faster navigation. Initially, the balance of the newly created deposit account will be zero.
+To create a new deposit account, click on the green + icon located at the top right (refer to Figure 2). Then, select the option `Add account`. Since you're in the Deposit Account view, a new deposit account named `No Name` will be created with the default currency of the portfolio. To rename the account, simply double-click on the Name field and enter the desired name. Remember also to change the currency if needed by double-clicking on the currency field (e.g., EUR) and selecting another currency from the dropdown menu. While navigating the currency list, you can use the first letter of the desired currency for faster navigation. Initially, the balance of the newly created deposit account will be zero.
 
 A deposit account can be negative. However, good practice requires that you first add a deposit of a large enough sum to cover the subsequent buy transactions, just as you would do with a real broker.
 
-To deactivate an account, right-click on the account and choose `Deactivate account` from the context menu. The account name will appear greyed out and will no longer be visible in the list of deposit accounts when making a deposit transaction. With the Filter icon (top right), you an hide inactive accounts.
+To deactivate an account, right-click on the account and choose `Deactivate account` from the context menu. The account name will appear greyed out and will no longer be visible in the list of deposit accounts when making a deposit transaction. With the Filter icon (top right), you can hide inactive accounts.
+
+You can delete a deposit account using the context menu. However, it is important to note that you can only delete an account if there are no transactions associated with it.
+
+If you want to delete an account that has transactions, you will need to first delete the transactions that are linked to that account. Once all transactions have been removed, you can then delete the account itself.
+
+Using the Show or Hide columns option (accessible via the :gear: gear icon at the top right), you can customize the view by hiding or adding columns. The available columns for display include: `Cash account`, `Balance`, `Currency`, `Note`, and `Attributes`. See also [How-to > User Interface](../../../how-to/user-interface.md) for more detailed information about handling the table.
 
-Using the Show or Hide columns option (accessible via the gear icon at the top right), you can customize the view by hiding or adding columns. Available columns include: Cash account (name), Balance, Currency, Notes, and Attributes. Additionally, you can hide or rename a column through the context menu.
+## Information pane
 
 The information pane at the bottom displays the transactions of the selected deposit account in the main pane. It consists of two tabs: Transactions and Account balance chart. The Transactions tab displays fields such as date, type, amount, and balance of each transaction. The Account Balance chart provides a graphical representation of the account balance. Due to fewer data points compared to a historical prices graph, the chart may appear more blocked. Figure 3 illustrates the balance of the `Broker-1 (EUR)` account, where the early spikes are the result from deposits followed by purchases on the next day.
 
 Figure: Example of the Account Balance Chart. {class=pp-figure}
 
 ![](images/sb-accounts-deposit-accounts-balance-chart.png)
 
-The context menu, accessed by right-clicking on the chart, offers the same options as many other charts; for example, you can refer to the [chart menu of the `All Securities` info pane](../../view/securities/all-securities.md#chart-menu) for more information.
+The context menu, accessed by right-clicking on the chart, offers the same options as many other charts; for example, you can refer to the [chart menu of the `All Securities` info pane](../../view/securities/all-securities.md#chart-menu) for more information. There are no other configuration settings.
+
+## Troubleshoot Balance Discrepancy
+
+If you notice any discrepancies in a deposit account between the calculated balance of PP and the actual balance of the bank/broker, you can use the context menu to troubleshoot the issue. To do so, right-click on the account in the main pane and select "Troubleshoot Balance Discrepancy" from the menu.
+
+This will open a dialog box displaying the calculated monthly balances for the selected deposit account. In the "Expected balance" column, you can enter the balance that you expect according to your bank account statement. Portfolio Performance (PP) will then use the calculated difference to try to identify any transactions that may be causing the discrepancy. For example, PP may find transactions that were made to a different account or are dated in the future.
+
+<video width="100%"  controls>
+  <source src="../images/troubleshoot-balance-discrepancy.mp4" type="video/mp4">
+</video>
+

docs/en/reference/view/securities/all-securities.md

@@ -27,7 +27,7 @@ If you find yourself needing a custom layout regularly, you can duplicate the st
 
 With the Search box you can filter the list of visible securities. For example, entering "DE" in the Search box will only display share-1 and share-2 because their ticker symbol contains the string "DE".
 
-The Filter icon is used as a more categorical filter. Available options are: Only active instruments, Only securities, Only exchange rates, Shares held ≠ 0, Shares held = 0, and Securities: Limit price exceeded. For the latter, you need to create a new attribute of type “limit price” in the [settings](../general-data/settings.md) of the portfolio (menu View > Settings). Then you can add this column to the table and enter some values.
+The Filter icon is used as a more categorical filter. Available options are: Only active instruments,Only inactive instruments, Only securities, Only exchange rates, Shares held ≠ 0, Shares held = 0, and Securities: Limit price exceeded. For the latter, you need to create a new attribute of type “limit price” in the [settings](../general-data/settings.md) of the portfolio (menu View > Settings). Then you can add this column to the table and enter some values.
 
 The table displayed in the current view can be exported as a CSV file, preserving the number of rows and columns along with their (custom) column headings.