English

Introduction

OneLedger (formerly Eicheesel / Eicheesel X) helps you project and track long-term wealth across savings accounts, portfolios, property, and loans. Compare projections with actual amounts year after year for milestones such as retirement. The app accounts for inflation so you can adjust contributions to stay on target.

On your device the app is named OneLedger. The App Store listing may still show Eicheesel X during the transition. The name “Eicheesel” (squirrel in Lorraine Franconian) reflected saving for the future — that idea continues with OneLedger.

0. Quick start

Recommended path for a new installation:

1. First launch (iOS): choose sample patrimony to explore, start empty, or import a backup.
2. Set reference currency in the toolbar if you use several currencies (see « Key concepts » below).
3. Add your savings accounts with start year, annual contribution, and expected return rate.
4. Enter actual amounts at year-end (green icon) to compare with projections.
5. Optional: portfolios (Alphavantage key), property, loans, savings goals (Projects).
6. Review the Dashboard, Balance sheet, and Wealth overview hub.
7. Enable a Quick backup in Settings once your data looks correct.

Key concepts

These terms appear throughout the app and in the numbered chapters below (sections 1 to 7).

• Reference currency — Totals on the Dashboard, balance sheet, and Wealth overview are converted into this currency (toolbar on macOS; Settings / rates on iOS). Individual accounts keep their own currency; conversion uses exchange rates (including optional fixed rates in Settings).
• Projection model — For each savings account: initial amount, annual contributions, return rate, duration, and start year build a year-by-year theoretical balance (compound interest).
• Actual amounts — Values you record per year; charts compare actual vs projected wealth.
• Net real estate — Property value minus the remaining balance of an optional linked loan (created under Patrimoine → Loans; often a mortgage but not required).
• Net worth (Wealth overview) — Savings + portfolios + net real estate minus outstanding loans.
• Gross vs net projection — If tax impact is enabled on an account or portfolio, the app can show estimated tax on gains at exit and a net curve on the Dashboard.

Main navigation (sidebar)

The sidebar groups screens as in the app:

• Dashboard — overview and charts (section 1).
• Patrimoine (Wealth) — five entries at the same level, in sidebar order:
  • Savings — cash accounts (section 2.1)
  • Portfolios — listed securities (section 2.2)
  • Real estate — properties (section 3)
  • Loans — all loans (mortgage, consumer, auto, etc.) and amortization (section 4)
  • Balance sheet — yearly view of all wealth (section 5)
• Analyses — Wealth overview (allocation, savings structure, cash flow, actual vs projected, projects & capacity, tax overview, stress tests — section 6.8), Account status, Categories, Projects (savings goals), Account scenarios, Loan scenarios, Expert (macro liquidity & cycle tools — section 6.9).
• Settings — language, appearance, API keys, backups, security, inflation rates, in-app help, credits, purchase / trial (section 7).

Some screens are shown inside a trial or purchase gate depending on your plan and platform. A trial banner may appear at the bottom of the sidebar (macOS) or under Settings (iOS).

Toolbar & calculator

The toolbar provides access to backup management (see 7.1.5.2), setting exchange rates, generating reports (see 7.1.6.4), and choosing the reference currency where applicable.

Calculator: On macOS, use the calculator toolbar button or ⌘K. On iOS, open it from the toolbar in the detail area. It is a simple overlay for quick arithmetic.

1. Dashboard

It allows you to view:

• The sum of your assets (accounts, portfolio, and equity — the difference between total accounts and total debts);
• The current performance of your portfolios;
• The sum of your debts;
• Your current capital excluding equity;
• The sum of your scheduled annual payments;
• The estimated final capital, sum of all projections excluding real estate;
• The current value of your portfolios;
• The value of the latest inflation;
• The sum of your loans (initial amounts);
• Graphical evolution of simulated calculations;
• Graphical evolution of the actual status of your accounts and portfolios;
• Graphical evolution of the actual status adjusted for inflation.

You can include savings goals (Projects) in the long-term projection curve when that option is enabled, and optionally show a net projection when tax impact is configured on accounts or portfolios. Display options for projects and net projection sit under the projection chart. Info (i) buttons next to the main charts give short explanations (wealth over time, portfolios, loans).

1.1 Charts

• Wealth over time — Simulated total (accounts + portfolios, excluding real estate in the main projection curve unless configured elsewhere).
• Projection chart — Long-term model; toggle Projects and Net projection under the chart when applicable.
• Actual amounts — Year-by-year real balances; portfolio series reflects listed holdings converted to reference currency.
• Inflation-adjusted actuals — Same actual path deflated using inflation rates from Settings.
• Loans — Outstanding debt over time from amortization schedules.
• Portfolio tiles — Current value and performance per portfolio in reference currency.

2. Patrimoine — savings and portfolios

In the app: Patrimoine → Savings or Portfolios. Real estate, Loans, and Balance sheet follow in that order (chapters 3–5), at the same sidebar level.

2.1 Savings

2.1.1 Add an account

You can add an account by clicking on the "+" at the top right of the window.

• Account name: enter the account name.
• Category: enter the desired category. Default categories are: Retirement, Savings, Investment, Real Estate. You can define other categories.
• Initial amount: enter the initial amount deposited in the account. The amount must be positive.
• Annual payment: enter your annual savings amount for the account. The amount must be positive.
• Rate of return: enter the estimated rate of return for the account. The amount must be positive.
• Start year: enter the first year of deposit in the account. The start year must be 1970 or later (within the limits enforced by the app).
• Duration(years): enter the investment duration.
• Currency: choose the investment currency (not functional in V1.0)
• Liquidity: choose the liquidity of the account.
• Savings pocket (optional): classify the account as Everyday buffer, Emergency reserve, Goals & growth, or Satellite / alternatives, or leave Automatic so the app infers from horizon and liquidity. Used in Wealth overview → Savings structure.
• Tax impact (optional): enable estimated tax on gains and set a rate; gross vs net appears in projections, scenarios, and Dashboard display options when configured.

2.1.2 Modify an account

Click on the blue icon and modify the data according to your preferences.

2.1.3 Delete an account

Click on the red icon. Confirm or cancel.

2.1.4 Add actual account status

Click on the green icon and modify the data according to your preferences. It is recommended to enter data at the end of the year after interest payments, if any.

2.2 Stocks

2.2.1 Portfolios

2.2.1.1 Add a portfolio

Click on "+" at the top right of the window, then enter the portfolio name. Choose whether it's stocks or ETFs (the selection is indicative and has no impact). Click "Create".

2.2.1.2 Delete a portfolio

Click on the red icon. Confirm or cancel.

2.2.1.3 Add a stock/ETF to a portfolio

Click on the portfolio name to access its details.

• Click on "+" at the top right of the window.
• Enter the stock/ETF symbol (example: AAPL for Apple).
• Enter the number of shares.
• Enter the purchase price.
• Select the purchase date.
• Click "Add".

2.2.1.4 Delete a stock/ETF from a portfolio

Click on the portfolio name to access its details. Click on the red icon next to the stock/ETF to delete. Confirm or cancel.

2.2.1.5 Modify a stock/ETF in a portfolio

Click on the portfolio name to access its details. Click on the blue icon next to the stock/ETF to modify. Update the information and click "Save".

2.2.1.6 Update portfolio values

Click on the refresh icon at the top right of the window. The values will be updated using the Alphavantage API (see 7.1.3.1).

2.2.1.7 Tax impact (portfolio)

When creating or editing a portfolio, you can enable tax impact (same idea as savings accounts): estimated tax on gains at a chosen exit year feeds gross vs net projections, scenarios, and the Wealth overview tax card.

3. Real Estate

In the app: Patrimoine → Real estate. Properties only. To link a loan, register it first under Patrimoine → Loans (chapter 4) — not required.

3.1 Properties

3.1.1 Add a heritage

Click "+" at the top right of the window.

• Heritage name: enter the name of the heritage.
• Initial amount: enter the initial amount of the heritage. The amount must be positive.
• Start date: select the start date of the heritage. The start year must be 1970 or later (within the limits enforced by the app).
• Linked loan (optional): pick a loan already in Patrimoine → Loans (often the property mortgage, but any loan you choose). Used for net equity and may align periods. With no link, the property value stands alone.
• Location and currency of the property.
• Annual value growth % after the last recorded actual value.
• Actual values per year in the property editor (green icon, like savings accounts).

Net equity = latest actual value minus linked loan balance, or full property value if no loan is linked.

4. Loans

In the app: Patrimoine → Loans (fourth entry, after Real estate). This is where you create and manage every loan — mortgage, consumer, auto, etc. A loan does not have to be tied to a property.

4.1 Add a loan

Click on "+" at the top right of the window.

• Loan name: enter the loan name.
• Initial amount: enter the initial amount of the loan. The amount must be positive.
• Interest rate (%): enter the interest rate of the loan. The interest rate must be positive.
• Duration (years): enter the loan duration in years. The loan duration must not exceed 30 years
• Start date: select the start date of repayment. The start year must be 1970 or later (within the limits enforced by the app).
• Currency: choose the loan currency.
• Liquidity: choose the liquidity of the loan. The liquidity is the time it takes to access the money of the loan. The liquidity is in months.

While you enter the loan details, a live preview shows the monthly payment, total interest, and a yearly amortization chart before you save.

4.2 Modify a loan

Click on the blue icon and modify the data according to your preferences.

4.3 Delete a loan

Click on the red icon. Confirm or cancel.

4.4 See amortization table

Click on the loan name to access its amortization table. You can see the details of each payment, including principal and interest portions.

5. Balance sheet (Bilan)

In the app: Patrimoine → Balance sheet — same level as Real estate and Loans.

The balance sheet covers all your wealth (savings, portfolios, net property, debt) and shows year-by-year totals in your reference currency: actual wealth vs modelled projection, gaps, and year-over-year change. You can switch reference currency from the screen. Sections are collapsible and can be exported as plain text from the balance sheet screen. A full archive export (plain text) is also available in Settings. Sections cover global totals, then per savings account, property (net equity), and portfolio, where data exists.

6. Analysis

6.1 Account Status

You can view: the total sum of current accounts, your total target, the total of a particular account, and its attached target. The color bar visually indicates progress relative to the target.

Charts: Waterfall and treemap views help you see how balances are split across accounts. Use the toolbar menu to optionally include investment portfolios in the analysis (pick portfolios, select all, or none). The same menu lets you choose whether the headline total target uses only savings-plan objectives or also includes portfolio value; portfolio holdings always count toward your current total. Chart visibility, portfolio selection, and total-target mode are remembered when you leave the screen.

6.2 Category Status

You can view the distribution of your current assets by categories, currency, and liquidity. The same optional portfolios, bulk selection, and total-target behaviour as in Account status apply, and your choices are remembered between visits.

6.3 Account Scenarios

Pick an existing account, then adjust a parallel “simulated” set of parameters (contribution, rate, duration, etc.). The chart overlays real vs simulated projection curves (and net curves if tax is set). Access may require purchase or trial on some platforms.

6.4 Loan Scenarios

Same principle for an existing loan: compare actual repayment to a simulated variant (modified amount, rate, or duration). Subject to the same purchase or trial rules as account scenarios.

6.5 Savings goals (Projects)

Create goals with a target amount and currency, link them to accounts and/or portfolios (with optional caps), and optionally attach a simple loan simulation inside the goal. Choose when the goal affects the long-term projection: immediately, from a given year, or spread over several years.

Select one or more goals with the checkboxes. The screen shows impact by account and by category: requested amounts, balances, what is already counted toward the goal, and a small usage bar. A note at the bottom reminds you that amounts may add up if the same account feeds several selected goals.

6.6 Inflation

Inflation rates are not in the sidebar: open Settings → Inflation → Manage inflation rates. They feed inflation-adjusted views elsewhere in the app.

Add an inflation rate for a year:

Enter the year and the inflation rate (for the euro zone see: https://ec.europa.eu/eurostat ). Click on add. The year must be between 1970 and 2100. The rate must be between -20% and 100%.

Delete an inflation rate for a year:

Click on the red "trash" icon of a year to delete the inflation rate.

6.8 Wealth overview

Wealth overview is a hub under Analyses that summarizes your patrimony from savings accounts, portfolios, property, and loans (amounts in your reference currency). Open a card to drill into each analysis. If you have no data yet, you can load the sample patrimony from the empty state or from Settings (see 7.1.7).

• Allocation — Split across savings, portfolios, and net real estate; outstanding debt and net worth KPIs.
• Savings structure — Everyday, emergency, goals, and satellite pockets; personal benchmarks (net income, expenses, target months for buffers, satellite cap). Assign a pocket per account in the editor, or leave Automatic. Amounts per layer, % vs benchmark, and insight banners. Educational pyramid infographic only. Indicative only — not investment advice.
• Cash flow & loans — Planned annual contributions vs loan repayments and net saving capacity; loan breakdown.
• Actual vs projected — Compare current-year actuals with the projection model (same logic as Dashboard and balance sheet).
• Projects & capacity — Annual saving capacity vs project load and loans.
• Tax overview — Consolidated estimated exit tax on accounts and portfolios where tax impact is enabled.
• Stress tests — Simplified shocks to current net worth (educational illustration).

For macro context (euro / US zones, cycles), open Expert from the Analysis menu (section 6.9).

6.9 Expert mode

Expert is an educational screen about global liquidity and macro cycles. It is separate from your personal account data. The flow is organized in clear steps: macro data, how your wealth compares by zone (euro vs US), simulations, and a short conclusion. Banners appear when US (FRED) data is missing.

• Liquidity by zone: Broad money-style indicators (e.g. M2/M3) for major areas. US data typically needs a FRED API key stored in Settings; euro area data is loaded from public ECB series where available.
• Charts & “thermometer”: Visual context for liquidity growth and regime.
• Valuation & cycle blocks: Indicators and a synthetic business-cycle phase (expansion, overheating, contraction, recession) with short commentary — not investment advice.
• Tools: e.g. rate stress test sliders to illustrate sensitivity scenarios.
• Use Refresh or pull-to-refresh to reload data; errors (network, API limits) are shown inline.

Always read the on-screen disclaimer: indicators are simplified and delayed; they do not replace professional advice.

7. Settings

7.1 Settings

Free version, trial, and purchase: without purchase, typical limits are 3 savings accounts, 1 portfolio, 1 property, and 1 loan. Some screens (scenarios, real estate, balance sheet, Wealth overview, Expert on iOS) may be gated. Purchase removes limits. Trial status appears in Settings and in the sidebar banner (macOS) or under Settings (iOS).

7.1.1 Language

You can choose the display language of the application. By default, the displayed language is that of the system. The application must be restarted for the change to take effect. Three languages are available: English, French, and Spanish.

7.1.2 Appearance

You can choose how the app follows the system appearance and pick a base theme: Light, Light + (higher-contrast / vivid light palette), Dark, or Dark + (higher-contrast / vivid dark palette). Chart and label colours adapt to these modes.

7.1.2.1 Analysis screens (default charts)

In Settings, the Analysis section lets you set whether charts are shown by default when opening Account status and Categories. You can still show or hide charts from the toolbar on each screen.

7.1.3 Help & credits

From Settings, open Help for in-app assistance and Credits for acknowledgements and legal notices related to the application.

7.1.3.1 API Alphavantage

You can enter an API key from the site Alphavantage.co(c) (link: https://www.alphavantage.co/support/#api-key). Eicheesel is not responsible for the limitations, modifications, or unavailability of the API from alphavantage.com. Free use of the API is limited to a certain number of calls per day. Beyond that, the application will return an unavailability message. The value of your stocks/ETFs will be calculated with the last called/available value.

• To view the API key, hidden by default, click on the "view" icon.
• To delete the key, click on the red "trash" icon.

7.1.4 Expert APIs (FRED, ECB)

In Settings, the Expert API (FRED, ECB) section lets you enter a free FRED key for US monetary data used in Expert mode, and clear the Expert cache if needed. Euro-area series use public ECB data where applicable.

7.1.4.1 Fixed exchange rates

Settings → Exchange rates → Fixed rates overrides automatic rates for specific currency pairs when converting to your reference currency.

7.1.5 Backups

Note: all backups are encrypted using the open-source library available at this link: https://github.com/kishikawakatsumi/KeychainAccess Copyright (c) 2014 kishikawa katsumi.

7.1.5.1 Quick Backup

To backup your data within the application, click on "Quick Backup". By default and in normal operation, the data will be saved in the application while being encrypted.

7.1.5.2 Manage Backups

By clicking on "Manage Backups", a window opens allowing you to see the list of backups.

7.1.5.2.1 Delete a backup

Slide the chosen backup in the list to the left and click on the red "trash" icon. Confirm or cancel. Note: The list presented contains backups in the application only.

7.1.5.2.2 Create a backup

• Default folder: The backup is made in the application.
• Choose a folder: You can choose a place in the finder to backup an instance of your encrypted data. Note: this will have no impact on backups in the application.
• Import a backup: You can choose an instance of backup in the finder and import it.

7.1.5.3 Export Data

You can export your data to a JSON file. This can be useful for backing up your data. This data is not encrypted!

7.1.5.4 Import Data

You can import data into the application. This can be useful for recovering backed-up data.

7.1.6 Security

7.1.6.1 Enable Locking

The first time the application asks you to choose a PIN code that must contain at least 4 digits. You can then modify it with the "Modify PIN Code" button. Attention, if you forget your PIN code you will have to reinstall the application. So think to backup your data (See 5. Settings --> Backups). The PIN code is encrypted and cannot be decrypted.

7.1.6.2 Use Touch ID

Click if you want to replace the PIN code with the Touch ID function.

7.1.6.3 Reset Application

You can reset the application. The application will be reset and all your data will be lost. Your purchase status and trial period will be preserved. Remember to backup your data to JSON format before this operation (See 5. Settings --> Backups).

7.1.6.4 Generate Report

You can generate a report by clicking on the "Generate Report" button. You can choose the output format (PDF or CSV). The report will be saved in the default backup folder.

7.1.6.5 Text reports and exports

Settings → Reports: export a full plain-text archive of your data. From the Balance sheet screen, export the bilan as plain text (toolbar). CSV balance export may be unavailable depending on version.

7.1.7 Getting started (sample patrimony)

On first launch (iOS), a welcome screen lets you explore with sample data, start empty, or import a backup. The sample patrimony is fictional — use it to try the Dashboard, projections, and Wealth overview. A banner reminds you while sample data is active. In Settings → Getting started you can load or remove the sample, or replay the discovery checklist (short guided steps to main tabs after loading the sample).

7.1.8 Notifications

Optional monthly reminder to update actual amounts (Settings). Requires notification permission on iOS.

7.1.9 Startup disclaimer (iOS)

Disclaimer shown on first launch; also available in Settings or About.

8. Version notes

Documentation version: 2.0 — OneLedger rebrand, interface refresh, and consolidated “What’s New” text (see top of this page). Earlier feature details remain in sections 0–5 below.

V2.0 (current)

• OneLedger — New product name on the home screen; redesigned UI (light/dark themes, clearer charts, harmonized forms).
• Wealth overview — Analysis hub: allocation, cash flow vs loans, actual vs projected, projects, tax estimates, stress tests; Expert for macro context.
• Savings structure — Pockets (everyday, emergency, goals, satellite); benchmarks, charts, pyramid infographic.
• Getting started — Welcome flow, sample data, discovery checklist, backup import.
• Loans — Live preview: monthly payment, total interest, yearly amortization chart.
• Polish — Dynamic Type cap on dense screens; EN / FR / ES wording refresh.

V1.6

• Wealth overview — Hub in Analyses: allocation, savings structure, cash flow & loans, actual vs projected, projects & capacity, tax overview, stress tests; link to Expert for macro context.
• Savings structure — Savings pockets on accounts; personal benchmarks; charts, insights, educational pyramid infographic.
• Getting started — Welcome on first launch; optional sample patrimony and discovery checklist; manage sample in Settings.
• Loans — Live preview (payment, total interest, amortization chart) when adding or editing a loan.
• Polish — Harmonized add/edit forms; refined analysis layouts; Dynamic Type cap on dense analysis screens; wording in EN, FR, ES.

V1.5

• Expert — Reworked steps (macro, zone comparison, simulations, conclusion); FRED missing-data banners.
• Tax impact — Optional estimated tax on gains; gross vs net in projections, scenarios, Dashboard.
• Balance sheet — Collapsible sections; plain-text export from Bilan and full archive in Settings.
• Dashboard — Improved portfolio line on Actual amounts chart; projection options under the chart.
• Settings — Monthly reminder for actual amounts; harmonized real estate & loan lists; startup disclaimer (iOS).

V1.4 and earlier

• Patrimoine & Analyses sidebar; Dashboard, savings, portfolios, real estate, loans, balance sheet (Bilan).
• Account status, categories, projects, scenarios, Expert (macro liquidity).
• Settings: language, appearance (Light+ / Dark+), APIs, backups, security, inflation, Help, Credits; calculator (toolbar / ⌘K on macOS).

7. FAQ

General questions

What is OneLedger? OneLedger is a long-term wealth planning app that lets you compare financial projections with actual results year after year. It is especially useful for milestones such as retirement.

Does the app provide financial advice? No. Wealth planning is personal and varies by country (tax, products, yields). OneLedger helps you project and track progress toward your own goals — it does not recommend investments.

How are interest and projections calculated? For savings accounts, interest is applied at year-end on opening balance plus contributions made during the year (compound model). Portfolio and property values follow the parameters you enter; market quotes use your Alphavantage key when configured.

Does OneLedger account for inflation? Yes. Enter annual inflation rates in Settings; charts can show inflation-adjusted actual wealth.

Troubleshooting

Français

Introduction

OneLedger (anciennement Eicheesel / Eicheesel X) permet de projeter et suivre votre patrimoine sur le long terme : comptes, portefeuilles, immobilier et prêts. Comparez le modèle aux montants réels année après année (retraite, grandes étapes). L’inflation est intégrée pour ajuster vos versements.

Sur votre appareil l’application s’appelle OneLedger. La fiche App Store peut encore afficher Eicheesel X pendant la transition. Le nom « Eicheesel » (écureuil en francique de Lorraine) évoquait l’épargne pour l’avenir — cette idée se poursuit avec OneLedger.

0. Prise en main rapide

Parcours conseillé pour une nouvelle installation :

1. Premier lancement (iOS) : patrimoine fictif pour explorer, départ à zéro, ou import d’une sauvegarde.
2. Devise de référence dans la barre d’outils si vous utilisez plusieurs devises (voir « Concepts clés » ci-dessous).
3. Ajoutez vos comptes d’épargne (année de début, versement annuel, taux de rendement).
4. Saisissez les montants réels en fin d’année (icône verte) pour comparer au modèle.
5. En option : portefeuilles (clé Alphavantage), biens, prêts, projets d’épargne.
6. Consultez le tableau de bord, le bilan et la synthèse patrimoine.
7. Activez une sauvegarde rapide dans Paramètres lorsque vos données sont correctes.

Concepts clés

Ces notions reviennent dans toute l’application et dans les chapitres numérotés plus bas (sections 1 à 7).

• Devise de référence — Les totaux du tableau de bord, du bilan et de la synthèse sont convertis dans cette devise (barre d’outils sur macOS ; taux dans Paramètres sur iOS). Chaque compte garde sa devise ; conversion via les taux de change (taux fixes optionnels dans Paramètres).
• Modèle de projection — Par compte : montant initial, versements annuels, taux, durée et année de début → solde théorique année par année (intérêts composés).
• Montants réels — Valeurs saisies par année ; les graphiques comparent réel et prévu.
• Immobilier net — Valeur du bien moins le capital restant du prêt lié, si vous en avez choisi un (optionnel ; le prêt est créé dans Patrimoine → Prêts, pas obligatoirement un crédit immobilier).
• Patrimoine net (synthèse) — Épargne + portefeuilles + immobilier net − dettes restantes.
• Brut / net — Avec impact fiscal activé, impôt estimé à la sortie et courbe nette possible sur le tableau de bord.

Navigation principale (barre latérale)

La barre latérale regroupe les écrans comme dans l’application :

• Tableau de bord — vue d’ensemble et graphiques (section 1).
• Patrimoine — cinq entrées au même niveau, dans l’ordre de la barre latérale :
  • Épargne — comptes d’épargne (section 2.1)
  • Portefeuilles — titres cotés (section 2.2)
  • Immobilier — biens (section 3)
  • Prêts — tous vos prêts (immobilier, conso, auto, etc.) et amortissement (section 4)
  • Bilan — synthèse annuelle de tout le patrimoine (section 5)
• Analyses — Synthèse patrimoine (allocation, structure d’épargne, flux, écarts, projets, fiscalité, stress tests — section 6.8), État des comptes, Catégories, Projets, Scénarios comptes, Scénarios prêt, Expert (macro et liquidité — section 6.9).
• Paramètres — langue, apparence, clés API, sauvegardes, sécurité, inflation, aide intégrée, crédits, achat / essai (section 7).

Certaines vues peuvent être limitées selon votre offre et la plateforme. Une bannière d’essai peut apparaître en bas de la barre latérale (macOS) ou sous Paramètres (iOS).

Barre d’outils & calculatrice

La barre d’outils donne accès aux sauvegardes (voir 7.1.5.2), aux taux de change, à la génération de rapports (voir 7.1.6.4) et au choix de la devise de référence le cas échéant.

Calculatrice : sur macOS, bouton de la barre d’outils ou ⌘K ; sur iOS, depuis la barre d’outils de la zone de détail. Simple fenêtre pour des calculs rapides.

1. Tableau de bord

Vous y consultez notamment :

• La somme de vos actifs (comptes, portefeuilles, patrimoine net immobilier) ;
• La performance actuelle des portefeuilles ;
• La somme de vos dettes ;
• Le capital hors immobilier ;
• La somme des versements annuels planifiés ;
• Le capital final estimé (projections hors immobilier) ;
• La valeur actuelle des portefeuilles ;
• Le dernier taux d’inflation ;
• La somme des prêts (montants initiaux) ;
• L’évolution graphique des calculs simulés ;
• L’évolution des montants réels (comptes et portefeuilles) ;
• L’évolution des montants réels corrigés de l’inflation.

Vous pouvez inclure les projets d’épargne dans la courbe de projection long terme, et afficher une projection nette si l’impact fiscal est activé sur des comptes ou portefeuilles. Les options projets et projection nette se trouvent sous le graphique de projection. Les boutons d’aide (i) résument les graphiques principaux.

1.1 Graphiques

• Patrimoine dans le temps — Total simulé (comptes + portefeuilles ; courbe principale hors immobilier sauf configuration contraire).
• Graphique de projection — Modèle long terme ; options Projets et Projection nette sous le graphique.
• Montants réels — Soldes réels année par année ; série portefeuille en devise de référence.
• Réel corrigé de l’inflation — Même trajectoire réelle avec les taux saisis dans Paramètres.
• Prêts — Dette restante selon les tableaux d’amortissement.
• Cartes portefeuille — Valeur et performance en devise de référence.

2. Patrimoine — épargne et titres

Dans l’app, ouvrez le menu Patrimoine puis Épargne ou Portefeuilles. Immobilier, Prêts et Bilan suivent dans cet ordre (chapitres 3 à 5), au même niveau dans la barre latérale.

2.1 Épargne

2.1.1 Ajouter un compte

Cliquez sur « + » en haut à droite.

• Nom du compte.
• Catégorie : Retraite, Épargne, Investissement, Immobilier par défaut, ou catégories personnalisées.
• Montant initial : doit être positif.
• Versement annuel : positif.
• Taux de rendement : positif.
• Année de début : 1970 ou ultérieure (selon les limites de l’app).
• Durée (années).
• Devise.
• Liquidité.
• Poche d’épargne (optionnel) : Quotidien, Réserve, Objectifs & croissance, Satellite / alternatives, ou Automatique (inférence selon horizon et liquidité). Utilisée dans Synthèse patrimoine → Structure d’épargne.
• Impact fiscal (optionnel) : estimation de l’impôt sur les plus-values ; brut / net dans projections, scénarios et options du tableau de bord.

2.1.2 Modifier un compte

Icône bleue, puis enregistrez vos modifications.

2.1.3 Supprimer un compte

Icône rouge. Confirmez ou annulez.

2.1.4 Saisir les montants réels

Icône verte ; de préférence en fin d’année après les intérêts éventuels.

2.2 Titres (portefeuilles)

2.2.1 Portefeuilles

2.2.1.1 Ajouter un portefeuille

« + », nom du portefeuille, type actions ou ETF (indicatif, sans impact sur les calculs), puis « Créer ».

2.2.1.2 Supprimer un portefeuille

Icône rouge. Confirmez ou annulez.

2.2.1.3 Ajouter un titre

Ouvrez le portefeuille, puis « + » : symbole (ex. AAPL), nombre de parts, prix d’achat, date, « Ajouter ».

2.2.1.4 Supprimer un titre

Icône rouge à côté de la ligne. Confirmez ou annulez.

2.2.1.5 Modifier un titre

Icône bleue, modifiez, « Enregistrer ».

2.2.1.6 Mettre à jour les cours

Icône d’actualisation ; les cours passent par l’API Alphavantage (voir 7.1.3.1).

2.2.1.7 Impact fiscal (portefeuille)

À la création ou l’édition d’un portefeuille, activez l’impact fiscal (comme sur les comptes d’épargne) : impôt estimé sur les plus-values à l’année de sortie choisie, visible en brut/net dans les projections, les scénarios et la carte fiscalité de la synthèse patrimoine.

3. Immobilier

Où dans l’app : Patrimoine → Immobilier (troisième entrée du menu Patrimoine). Saisie des biens uniquement. Pour lier un crédit, enregistrez d’abord le prêt dans Patrimoine → Prêts (chapitre 4) — ce n’est pas obligatoire.

3.1 Biens immobiliers

3.1.1 Ajouter un bien

« + » :

• Nom du bien.
• Montant initial : positif.
• Date de début : année ≥ 1970.
• Prêt lié (optionnel) : choisissez un prêt déjà enregistré dans Patrimoine → Prêts (souvent un crédit immobilier, mais ce peut être tout prêt que vous associez à ce bien). Sert au calcul de l’immobilier net et peut aligner les périodes. Sans prêt lié, la valeur du bien est prise seule.
• Localisation et devise du bien.
• Revalorisation annuelle % après la dernière valeur réelle saisie.
• Valeurs réelles par année dans l’éditeur du bien (icône verte, comme pour l’épargne).

Immobilier net = dernière valeur réelle − capital restant du prêt lié, ou valeur du bien seule si aucun prêt n’est associé.

4. Prêts

Où dans l’app : Patrimoine → Prêts (quatrième entrée, après Immobilier). C’est le seul endroit pour créer et gérer vos prêts — crédit immobilier, consommation, auto, etc. Un prêt n’est pas forcément lié à un bien.

4.1 Ajouter un prêt

« + », puis :

• Nom du prêt.
• Montant initial : positif.
• Taux d’intérêt (%) : positif.
• Durée (années) : maximum 30 ans.
• Date de début : année ≥ 1970.
• Devise.
• Liquidité (délai d’accès au capital, en mois).

Pendant la saisie, un aperçu en direct affiche la mensualité, le total des intérêts et un graphique d’amortissement annuel avant enregistrement.

4.2 Modifier un prêt

Icône bleue.

4.3 Supprimer un prêt

Icône rouge. Confirmez ou annulez.

4.4 Tableau d’amortissement

Cliquez sur le nom du prêt : détail de chaque échéance (capital et intérêts).

5. Bilan patrimonial

Où dans l’app : Patrimoine → Bilan — au même niveau qu’Immobilier et Prêts, pas à l’intérieur d’Immobilier.

Le bilan couvre tout votre patrimoine (épargne, portefeuilles, immobilier net, dettes) : totaux année par année en devise de référence, patrimoine réel vs projection modèle, écarts, variation d’une année sur l’autre. Changement de devise sur l’écran. Sections repliables ; export en texte brut depuis l’écran Bilan ; archive complète (texte) dans Paramètres. Détail global, puis par compte d’épargne, bien (net) et portefeuille.

6. Analyses

6.1 État des comptes

Totaux, objectifs et barres de progression par compte.

Graphiques : cascade et treemap. Menu barre d’outils : inclure des portefeuilles (sélection, tout / aucun) ; l’objectif total peut ne compter que les objectifs d’épargne ou inclure la valorisation des portefeuilles (ceux-ci comptent toujours dans le total actuel). Affichage des graphiques, sélection et mode d’objectif sont mémorisés.

6.2 Catégories

Répartition par catégorie, devise et liquidité ; mêmes options portefeuilles et objectif total que l’état des comptes ; préférences mémorisées.

6.3 Scénarios comptes

Choisissez un compte existant, puis modifiez un jeu de paramètres « simulé » en parallèle (versement, taux, durée, etc.). Le graphique superpose les courbes réel et simulé (et nettes si l’impact fiscal est activé). L’accès peut être réservé à la version complète ou à la période d’essai selon la plateforme.

6.4 Scénarios prêt

Même principe pour un prêt existant : comparez le remboursement réel à une variante simulée (montant, taux ou durée modifiés). Accès soumis aux mêmes conditions d’achat ou d’essai que les scénarios comptes.

6.5 Projets (objectifs d’épargne)

Objectif avec montant et devise, liens vers comptes et/ou portefeuilles (plafonds optionnels), prêt simulé optionnel. Impact sur la projection : immédiat, à partir d’une année ou étalé sur plusieurs années.

Sélection multiple par cases à cocher ; impact par compte et par catégorie (montants demandés, soldes, déjà comptabilisé, barre d’utilisation). Note en bas : risque de cumul si un même compte alimente plusieurs objectifs sélectionnés.

6.6 Inflation

Pas dans la barre latérale : Paramètres → Inflation → Gérer les taux d’inflation. Alimente les vues corrigées de l’inflation.

Ajouter un taux :

Année et taux (zone euro : https://ec.europa.eu/eurostat ). « Ajouter ». Année entre 1970 et 2100 ; taux entre -20 % et 100 %.

Supprimer un taux :

Icône corbeille rouge sur l’année concernée.

6.8 Synthèse patrimoine

Hub sous Analyses : synthèse à partir de vos comptes, portefeuilles, biens et prêts (devise de référence). Ouvrez une carte pour le détail. Sans données : chargez le patrimoine fictif (état vide ou Paramètres, § 7.1.7).

• Allocation — Répartition épargne, portefeuilles, immobilier net ; dettes et patrimoine net.
• Structure d’épargne — Poches quotidien, réserve, objectifs, satellite ; repères personnels (revenus nets, charges, mois cibles pour le quotidien et la réserve, plafond satellite). Attribuez une poche à chaque compte dans l’éditeur, ou laissez Automatique. Montants par couche, % par rapport au repère et alertes (réserve insuffisante, satellite au-dessus du plafond, etc.). Infographie pyramide pédagogique uniquement (modèle de référence, pas votre patrimoine réel). Indicatif — pas un conseil en investissement.
• Flux & crédits — Versements annuels prévus vs remboursements de prêts ; capacité d’épargne nette ; détail des prêts.
• Écarts réel / prévu — Année en cours : réalisé vs modèle (même logique que tableau de bord et bilan).
• Projets & capacité — Capacité annuelle face à la charge des projets et aux prêts.
• Fiscalité consolidée — Impôt estimé à la sortie sur comptes et portefeuilles configurés.
• Stress tests — Chocs simplifiés sur le patrimoine net actuel (illustration pédagogique).

Pour le contexte macro (zones euro / US, cycles), ouvrez Expert (section 6.9).

6.9 Mode Expert

Écran éducatif sur la liquidité mondiale et les cycles macro, distinct de vos données personnelles. Parcours en étapes : données macro, comparaison de votre patrimoine par zone (euro vs États-Unis), simulations, courte conclusion. Bannières si les données US (FRED) manquent.

• Liquidité par zone : indicateurs type masse monétaire (M2/M3). Données US : clé FRED dans Paramètres ; zone euro : séries BCE publiques lorsque disponibles.
• Graphiques et « thermomètre » : contexte visuel de croissance et de régime.
• Valorisation et cycles : phase de cycle synthétique (expansion, surchauffe, contraction, récession) et commentaires — pas un conseil en investissement.
• Outils : curseurs de stress test sur les taux, par exemple.
• Actualiser ou tirer pour recharger ; erreurs réseau / API affichées sur l’écran.

Lisez l’avertissement à l’écran : indicateurs simplifiés et retardés ; ne remplacent pas un avis professionnel.

7. Paramètres

7.1 Paramètres

Version gratuite, essai et achat : sans achat, limites typiques — 3 comptes d’épargne, 1 portefeuille, 1 bien immobilier, 1 prêt. Certaines vues (scénarios, immobilier, bilan, synthèse patrimoine, Expert sur iOS) peuvent être limitées. L’achat lève ces plafonds. Le statut d’essai apparaît dans Paramètres et via la bannière en bas de la barre latérale (macOS) ou sous Paramètres (iOS).

7.1.1 Langue

Français, anglais, espagnol. Par défaut : langue du système. Redémarrage nécessaire pour appliquer le changement.

7.1.2 Apparence

Suivi du système et thèmes : Clair, Clair +, Sombre, Sombre + (palettes plus contrastées / vives). Couleurs des graphiques et libellés adaptées.

7.1.2.1 Écrans d’analyse (graphiques par défaut)

Section Analyses : afficher les graphiques par défaut à l’ouverture d’État des comptes et de Catégories (bascule possible dans la barre d’outils de chaque écran).

7.1.3 Aide & crédits

Aide et Crédits depuis Paramètres.

7.1.3.1 API Alphavantage

Clé gratuite sur https://www.alphavantage.co/support/#api-key . Eicheesel n’est pas responsable des limites ou indisponibilités de l’API. Usage gratuit plafonné en appels/jour ; au-delà, message d’indisponibilité. Dernière valeur disponible utilisée pour les cours.

• Afficher la clé : icône « voir ».
• Supprimer : icône corbeille rouge.

7.1.4 API Expert (FRED, BCE)

Section API Expert (FRED, BCE) : clé FRED gratuite pour les données monétaires US ; vider le cache Expert si besoin. Zone euro : données BCE publiques le cas échéant.

7.1.4.1 Taux de change fixes

Paramètres → Taux de change → Taux de change fixes : forcez certains couples de devises vers votre devise de référence lorsque vous ne souhaitez pas utiliser le taux automatique.

7.1.5 Sauvegardes

Chiffrement via la bibliothèque open source : https://github.com/kishikawakatsumi/KeychainAccess Copyright (c) 2014 kishikawa katsumi.

7.1.5.1 Sauvegarde rapide

« Sauvegarde rapide » : données enregistrées dans l’application, chiffrées.

7.1.5.2 Gérer les sauvegardes

Liste des sauvegardes dans l’application.

7.1.5.2.1 Supprimer une sauvegarde

Glisser vers la gauche, corbeille rouge. Confirmez. Liste = sauvegardes internes uniquement.

7.1.5.2.2 Créer une sauvegarde

• Dossier par défaut : dans l’application.
• Choisir un dossier : copie chiffrée dans le Finder (sans effet sur les sauvegardes internes).
• Importer : restaurer une sauvegarde depuis le Finder.

7.1.5.3 Exporter les données

Export JSON (non chiffré).

7.1.5.4 Importer les données

Import JSON pour restaurer une sauvegarde.

7.1.6 Sécurité

7.1.6.1 Verrouillage

Code PIN d’au moins 4 chiffres au premier usage ; modification via « Modifier le code PIN ». En cas d’oubli : réinstallation (pensez aux sauvegardes, § 7). PIN chiffré, non récupérable.

7.1.6.2 Touch ID

Remplace le PIN par Touch ID si vous le souhaitez.

7.1.6.3 Réinitialiser l’application

Efface toutes les données ; achat et essai conservés. Sauvegardez en JSON avant (§ 7).

7.1.6.4 Générer un rapport

« Générer un rapport » : format PDF ou CSV, enregistré dans le dossier de sauvegarde par défaut.

7.1.6.5 Rapports et exports texte

Paramètres → Rapports : export d’une archive complète en texte brut de vos données. Depuis l’écran Bilan, export du bilan en texte via la barre d’outils. L’export CSV du bilan peut être indisponible selon la version de l’application.

7.1.7 Prise en main (patrimoine fictif)

Au premier lancement (iOS) : explorer avec des données fictives, partir de zéro ou importer une sauvegarde. Le patrimoine fictif est illustratif — pour essayer tableau de bord, projections et synthèse. Bannière tant qu’il est actif. Paramètres → Prise en main : charger / supprimer l’exemple, rejouer la checklist de découverte (étapes vers les onglets principaux).

7.1.8 Notifications

Rappel mensuel optionnel pour mettre à jour les montants réels (Paramètres). Autorisation notifications requise sur iOS.

7.1.9 Avertissement au démarrage (iOS)

Disclaimer affiché au premier lancement ; consultable dans Paramètres ou À propos.

8. Notes de version

Version de la documentation : 2.0 — synthèse patrimoine, structure d’épargne, patrimoine fictif, aperçu prêt, et fonctions antérieures (Expert, fiscalité, export bilan, etc.). Texte exact App Store : champ « Nouveautés ».

V2.0 (actuelle — Sequoia)

• Essai 14 jours — Accès complet pour les non-acheteurs à partir de la mise à jour 2.0, puis version gratuite limitée.
• Sequoia — Évolutions majeures sur la branche Sequoia-v2.0.

V1.6

• Synthèse patrimoine — Hub Analyses : allocation, structure d’épargne, flux & crédits, écarts réel / prévu, projets & capacité, fiscalité, stress tests ; lien vers Expert.
• Structure d’épargne — Poches sur les comptes ; repères personnels ; graphiques, alertes, infographie pyramide.
• Prise en main — Accueil premier lancement ; patrimoine fictif et checklist ; gestion dans Paramètres.
• Prêts — Aperçu en direct (mensualité, intérêts, amortissement) à la création ou l’édition.
• Finitions — Formulaires harmonisés ; mises en page d’analyse ; plafond texte dynamique ; textes FR / EN / ES.

V1.5

• Expert — Étapes repensées (macro, comparaison par zone, simulations, conclusion) ; bannières FRED manquant.
• Impact fiscal — Estimation optionnelle ; brut / net dans projections, scénarios, tableau de bord.
• Bilan — Sections repliables ; export texte depuis le Bilan et archive dans Paramètres.
• Tableau de bord — Ligne portefeuille sur Montants réels ; options de projection sous le graphique.
• Paramètres — Rappel mensuel ; listes immobilier / prêts harmonisées ; avertissement au démarrage (iOS).

V1.4 et antérieur

• Barre latérale Patrimoine & Analyses ; tableau de bord, épargne, portefeuilles, immobilier, prêts, bilan.
• État des comptes, catégories, projets, scénarios, Expert (liquidité macro).
• Paramètres : langue, apparence (Clair+ / Sombre+), API, sauvegardes, sécurité, inflation, aide, crédits ; calculatrice (barre d’outils / ⌘K sur macOS).

7. FAQ

Questions générales

Qu’est-ce que OneLedger ? Application de projection patrimoniale qui compare vos prévisions aux montants réels, année après année — utile pour la retraite et les grands objectifs.

L’application donne-t-elle des conseils ? Non. La gestion du patrimoine est personnelle et varie selon les pays (fiscalité, produits, rendements). OneLedger vous aide à vous projeter et à mesurer vos objectifs, sans recommandation d’investissement.

Comment sont calculés les intérêts et les projections ? Pour l’épargne, les intérêts sont appliqués en fin d’année sur le solde d’ouverture et les versements de l’année (modèle composé). Portefeuilles et biens suivent vos paramètres ; les cours passent par Alphavantage si une clé est configurée.

L’inflation est-elle prise en compte ? Oui. Saisissez les taux annuels dans Paramètres ; des graphiques affichent le patrimoine réel corrigé de l’inflation.

Dépannage

Español

Introducción

OneLedger (antes Eicheesel / Eicheesel X) le permite proyectar y seguir su patrimonio a largo plazo: cuentas, carteras, inmuebles y préstamos. Compare el modelo con los datos reales año tras año (jubilación, hitos de vida). La inflación se integra para ajustar sus aportaciones.

En su dispositivo la app se llama OneLedger. La ficha de la App Store puede seguir mostrando Eicheesel X durante la transición. El nombre « Eicheesel » (ardilla en fráncico de Lorena) evocaba ahorrar para el futuro — esa idea continúa con OneLedger.

0. Inicio rápido

Ruta recomendada tras instalar la aplicación:

1. Primer inicio (iOS): patrimonio de ejemplo, empezar vacío o importar una copia.
2. Moneda de referencia en la barra de herramientas si usa varias divisas (véase « Conceptos clave » más abajo).
3. Añada sus cuentas de ahorro (año de inicio, aporte anual, tipo de rendimiento).
4. Introduzca importes reales a fin de año (icono verde) para comparar con el modelo.
5. Opcional: carteras (clave Alphavantage), inmuebles, préstamos, proyectos.
6. Consulte el panel principal, el balance y la síntesis patrimonial.
7. Active una copia rápida en Ajustes cuando los datos sean correctos.

Conceptos clave

Estos términos aparecen en toda la app y en los capítulos numerados más abajo (secciones 1 a 7).

• Moneda de referencia — Los totales del panel, balance y síntesis se convierten a esta divisa (barra de herramientas en macOS; tipos de cambio en Ajustes en iOS). Cada cuenta conserva su divisa; conversión con tipos de cambio (tipos fijos opcionales en Ajustes).
• Modelo de proyección — Por cuenta: importe inicial, aportes anuales, tipo, duración y año de inicio → saldo teórico año a año (interés compuesto).
• Importes reales — Valores registrados por año; los gráficos comparan real y previsto.
• Inmueble neto — Valor del bien menos el capital pendiente del préstamo vinculado (opcional; el préstamo se crea en Patrimonio → Préstamos, no tiene por qué ser hipotecario).
• Patrimonio neto (síntesis) — Ahorro + carteras + inmueble neto − deudas pendientes.
• Bruto / neto — Con impacto fiscal activado, impuesto estimado a la salida y curva neta posible en el panel principal.

Navegación principal (barra lateral)

La barra lateral agrupa las pantallas como en la aplicación:

• Panel principal — resumen y gráficos (sección 1).
• Patrimonio — cinco entradas al mismo nivel, en el orden de la barra lateral:
  • Ahorro — cuentas de ahorro (sección 2.1)
  • Carteras — valores cotizados (sección 2.2)
  • Inmobiliario — bienes (sección 3)
  • Préstamos — todos sus préstamos (hipoteca, consumo, coche, etc.) y amortización (sección 4)
  • Balance — síntesis anual de todo el patrimonio (sección 5)
• Análisis — Síntesis patrimonial (asignación, estructura del ahorro, flujos, desvíos, proyectos, fiscalidad, stress tests — sección 6.8), Estado de cuentas, Categorías, Proyectos, Escenarios de cuentas, Escenarios de préstamo, Experto (macro y liquidez — sección 6.9).
• Ajustes — idioma, apariencia, claves API, copias de seguridad, seguridad, inflación, ayuda integrada, créditos, compra / prueba (sección 7).

Algunas pantallas pueden estar limitadas según su plan y la plataforma. Puede aparecer un banner de prueba al pie de la barra lateral (macOS) o bajo Ajustes (iOS).

Barra de herramientas y calculadora

La barra de herramientas da acceso a las copias de seguridad (véase 7.1.5.2), a los tipos de cambio, a la generación de informes (véase 7.1.6.4) y a la moneda de referencia cuando proceda.

Calculadora: en macOS, botón de la barra de herramientas o ⌘K; en iOS, desde la barra de herramientas del área de detalle. Ventana simple para cálculos rápidos.

1. Panel principal

Puede consultar entre otros:

• La suma de sus activos (cuentas, carteras, patrimonio inmobiliario neto);
• El rendimiento actual de las carteras;
• La suma de sus deudas;
• El capital excluyendo inmobiliario;
• La suma de los aportes anuales planificados;
• El capital final estimado (proyecciones sin inmobiliario);
• El valor actual de las carteras;
• El último tipo de inflación;
• La suma de los préstamos (importes iniciales);
• La evolución gráfica de los cálculos simulados;
• La evolución de los importes reales (cuentas y carteras);
• La evolución de los importes reales corregidos por inflación.

Puede incluir los proyectos de ahorro en la curva de proyección a largo plazo y mostrar una proyección neta si el impacto fiscal está activado en cuentas o carteras. Las opciones de proyectos y proyección neta están bajo el gráfico de proyección. Los botones de ayuda (i) resumen los gráficos principales.

1.1 Gráficos

• Patrimonio en el tiempo — Total simulado (cuentas + carteras; curva principal sin inmobiliario salvo configuración distinta).
• Gráfico de proyección — Modelo a largo plazo; opciones Proyectos y Proyección neta bajo el gráfico.
• Montos reales — Saldos reales año a año; serie de carteras en moneda de referencia.
• Real ajustado por inflación — Misma trayectoria con tasas de Ajustes.
• Préstamos — Deuda pendiente según amortización.
• Tarjetas de cartera — Valor y rendimiento en moneda de referencia.

2. Patrimonio — ahorro y carteras

En la app: menú Patrimonio → Ahorro o Carteras. Inmobiliario, Préstamos y Balance siguen en ese orden (capítulos 3 a 5), al mismo nivel en la barra lateral.

2.1 Ahorro

2.1.1 Añadir una cuenta

Pulse « + » arriba a la derecha.

• Nombre de la cuenta.
• Categoría: Jubilación, Ahorro, Inversión, Inmobiliario por defecto, u otras personalizadas.
• Importe inicial: debe ser positivo.
• Aporte anual: positivo.
• Tipo de rendimiento: positivo.
• Año de inicio: 1970 o posterior (según los límites de la app).
• Duración (años).
• Moneda.
• Liquidez.
• Bolsillo de ahorro (opcional): Cotidiano, Reserva, Objetivos y crecimiento, Satélite / alternativas, o Automático (inferencia según horizonte y liquidez). Se usa en Síntesis patrimonial → Estructura del ahorro.
• Impacto fiscal (opcional): estimación del impuesto sobre plusvalías; bruto / neto en proyecciones, escenarios y opciones del panel principal.

2.1.2 Modificar una cuenta

Icono azul y guarde los cambios.

2.1.3 Eliminar una cuenta

Icono rojo. Confirme o cancele.

2.1.4 Introducir importes reales

Icono verde; preferiblemente a fin de año tras los intereses, si los hay.

2.2 Valores (carteras)

2.2.1 Carteras

2.2.1.1 Añadir una cartera

« + », nombre de la cartera, tipo acciones o ETF (indicativo, sin impacto en los cálculos), « Crear ».

2.2.1.2 Eliminar una cartera

Icono rojo. Confirme o cancele.

2.2.1.3 Añadir un valor

Abra la cartera, « + »: símbolo (ej. AAPL), número de títulos, precio de compra, fecha, « Añadir ».

2.2.1.4 Eliminar un valor

Icono rojo junto a la línea. Confirme o cancele.

2.2.1.5 Modificar un valor

Icono azul, modifique, « Guardar ».

2.2.1.6 Actualizar cotizaciones

Icono de actualización; cotizaciones vía API Alphavantage (véase 7.1.3.1).

2.2.1.7 Impacto fiscal (cartera)

Al crear o editar una cartera, active el impacto fiscal (como en cuentas de ahorro): impuesto estimado sobre plusvalías en el año de salida elegido; bruto/neto en proyecciones, escenarios y en la tarjeta fiscal de la síntesis patrimonial.

3. Inmobiliario

En la app: Patrimonio → Inmobiliario. Solo bienes. Para un crédito, créelo antes en Patrimonio → Préstamos (capítulo 4) — no es obligatorio.

3.1 Bienes inmobiliarios

3.1.1 Añadir un bien

« + »:

• Nombre del bien.
• Importe inicial: positivo.
• Fecha de inicio: año ≥ 1970.
• Préstamo vinculado (opcional): elija un préstamo ya registrado en Patrimonio → Préstamos (a menudo la hipoteca del bien, pero puede ser cualquier préstamo que asocie). Sirve para el inmueble neto y puede alinear periodos. Sin préstamo, se usa solo el valor del bien.
• Ubicación y moneda del bien.
• Revalorización anual % tras el último valor real registrado.
• Valores reales por año en el editor del bien (icono verde, como en ahorro).

Inmueble neto = último valor real − capital pendiente del préstamo vinculado, o valor del bien solo si no hay préstamo asociado.

4. Préstamos

En la app: Patrimonio → Préstamos (cuarta entrada, después de Inmobiliario). Aquí se crean y gestionan todos los préstamos (hipoteca, consumo, coche, etc.). Un préstamo no tiene por qué estar vinculado a un inmueble.

4.1 Añadir un préstamo

« + », luego:

• Nombre del préstamo.
• Importe inicial: positivo.
• Tipo de interés (%): positivo.
• Duración (años): máximo 30 años.
• Fecha de inicio: año ≥ 1970.
• Moneda.
• Liquidez (plazo de acceso al capital, en meses).

Al introducir los datos, una vista previa en vivo muestra la cuota mensual, los intereses totales y un gráfico de amortización anual antes de guardar.

4.2 Modificar un préstamo

Icono azul.

4.3 Eliminar un préstamo

Icono rojo. Confirme o cancele.

4.4 Tabla de amortización

Pulse el nombre del préstamo: detalle de cada cuota (capital e intereses).

5. Balance patrimonial

En la app: Patrimonio → Balance — al mismo nivel que Inmobiliario y Préstamos.

El balance abarca todo su patrimonio (ahorro, carteras, inmueble neto, deudas): totales año por año en moneda de referencia: patrimonio real frente al modelo, desvíos, variación interanual. Cambio de moneda en pantalla. Secciones plegables; exportación en texto plano desde la pantalla Balance; archivo completo (texto) en Ajustes. Detalle global, luego por cuenta de ahorro, bien (neto) y cartera.

6. Análisis

6.1 Estado de cuentas

Totales, objetivos y barras de progreso por cuenta.

Gráficos: cascada y treemap. Menú de la barra de herramientas: incluir carteras (selección, todas / ninguna); el objetivo total puede contar solo metas de ahorro o incluir la valoración de carteras (estas siempre cuentan en el total actual). Visibilidad de gráficos, selección y modo de objetivo se recuerdan.

6.2 Categorías

Distribución por categoría, moneda y liquidez; mismas opciones de carteras y objetivo total que el estado de cuentas; preferencias memorizadas.

6.3 Escenarios de cuentas

Elija una cuenta existente y ajuste parámetros « simulados » en paralelo (aporte, tipo, duración, etc.). El gráfico superpone curvas real y simulada (y netas si hay fiscalidad). El acceso puede requerir compra o periodo de prueba según la plataforma.

6.4 Escenarios de préstamo

Mismo principio para un préstamo existente: compare el reembolso real con una variante simulada (importe, tipo o duración modificados). Mismas condiciones de acceso que los escenarios de cuentas.

6.5 Proyectos (objetivos de ahorro)

Objetivo con importe y moneda, enlaces a cuentas y/o carteras (topes opcionales), préstamo simulado opcional. Impacto en la proyección: inmediato, desde un año o repartido en varios años.

Selección múltiple con casillas; impacto por cuenta y por categoría (importes solicitados, saldos, ya contabilizado, barra de uso). Nota al pie: riesgo de doble conteo si una misma cuenta alimenta varios objetivos seleccionados.

6.6 Inflación

No está en la barra lateral: Ajustes → Inflación → Gestionar tasas de inflación. Alimenta las vistas corregidas por inflación.

Añadir un tipo:

Año y tasa (zona euro: https://ec.europa.eu/eurostat ). « Añadir ». Año entre 1970 y 2100; tasa entre -20 % y 100 %.

Suprimir un tipo:

Icono de papelera roja en el año correspondiente.

6.8 Síntesis patrimonial

Centro bajo Análisis: resumen a partir de sus cuentas, carteras, bienes y préstamos (moneda de referencia). Abra una tarjeta para el detalle. Sin datos: cargue el patrimonio de ejemplo (estado vacío o Ajustes, § 7.1.7).

• Asignación — Reparto entre ahorro, carteras e inmueble neto; deudas y patrimonio neto.
• Estructura del ahorro — Bolsillos cotidiano, reserva, objetivos, satélite; referencias personales (ingresos netos, gastos, meses objetivo para cotidiano y reserva, tope satélite). Asigne un bolsillo en el editor de cuenta o deje Automático. Importes por capa, % frente a referencia y avisos. Infografía pirámide solo pedagógica. Indicativo — no es asesoramiento de inversión.
• Flujos y préstamos — Aportes anuales previstos frente a reembolsos de préstamos; capacidad de ahorro neta; detalle de préstamos.
• Real frente a previsto — Año en curso: realizado frente al modelo (misma lógica que panel principal y balance).
• Proyectos y capacidad — Capacidad anual frente a la carga de proyectos y préstamos.
• Fiscalidad consolidada — Impuesto estimado a la salida en cuentas y carteras configuradas.
• Stress tests — Choques simplificados sobre el patrimonio neto actual (ilustración pedagógica).

Para el contexto macro (zonas euro / EE. UU., ciclos), abra Experto (sección 6.9).

6.9 Modo Experto

Pantalla educativa sobre liquidez mundial y ciclos macro, separada de sus datos personales. Recorrido por pasos: datos macro, comparación de su patrimonio por zona (euro frente a EE. UU.), simulaciones, breve conclusión. Avisos si faltan datos US (FRED).

• Liquidez por zona: indicadores tipo masa monetaria (M2/M3). Datos EE. UU.: clave FRED en Ajustes; zona euro: series BCE públicas cuando estén disponibles.
• Gráficos y « termómetro »: contexto visual de crecimiento y régimen.
• Valoración y ciclos: fase de ciclo sintética (expansión, sobrecalentamiento, contracción, recesión) y comentarios — no es asesoramiento de inversión.
• Herramientas: cursores de stress test sobre tipos, por ejemplo.
• Actualizar o tirar para recargar; errores de red / API en pantalla.

Lea el aviso en pantalla: indicadores simplificados y retrasados; no sustituyen un asesoramiento profesional.

7. Ajustes

7.1 Ajustes

Versión gratuita, prueba y compra: sin compra, límites habituales — 3 cuentas de ahorro, 1 cartera, 1 inmueble, 1 préstamo. Algunas pantallas (escenarios, inmobiliario, balance, síntesis, Experto en iOS) pueden estar limitadas. La compra elimina los límites. Estado visible en Ajustes y en el banner de prueba (macOS / iOS).

7.1.1 Idioma

Español, francés, inglés. Por defecto: idioma del sistema. Puede requerirse reiniciar la aplicación.

7.1.2 Apariencia

Seguimiento del sistema y temas: Claro, Claro +, Oscuro, Oscuro + (paletas más contrastadas / vivas). Colores de gráficos y etiquetas adaptados.

7.1.2.1 Pantallas de análisis (gráficos por defecto)

Sección Análisis: mostrar gráficos por defecto al abrir Estado de cuentas y Categorías (conmutador en la barra de herramientas de cada pantalla).

7.1.3 Ayuda y créditos

Ayuda y Créditos desde Ajustes.

7.1.3.1 API Alphavantage

Clave gratuita en https://www.alphavantage.co/support/#api-key . Eicheesel no es responsable de los límites o indisponibilidades de la API. Uso gratuito con tope de llamadas/día; más allá, mensaje de indisponibilidad. Se usa el último valor disponible para las cotizaciones.

• Ver la clave: icono « ver ».
• Eliminar: icono de papelera roja.

7.1.4 API Experto (FRED, BCE)

Sección API Experto (FRED, BCE): clave FRED gratuita para datos monetarios US; vaciar la caché Experto si hace falta. Zona euro: datos BCE públicos cuando proceda.

7.1.4.1 Tipos de cambio fijos

Ajustes → Tipos de cambio → Tipos de cambio fijos: fuerce pares de divisas hacia su moneda de referencia cuando no quiera usar el tipo automático.

7.1.5 Copias de seguridad

Cifrado mediante biblioteca open source: https://github.com/kishikawakatsumi/KeychainAccess Copyright (c) 2014 kishikawa katsumi.

7.1.5.1 Copia rápida

« Copia rápida »: datos guardados en la aplicación, cifrados.

7.1.5.2 Gestionar copias

Lista de copias en la aplicación.

7.1.5.2.1 Eliminar una copia

Deslice a la izquierda, papelera roja. Confirme. Lista = copias internas únicamente.

7.1.5.2.2 Crear una copia

• Carpeta por defecto: en la aplicación.
• Elegir carpeta: copia cifrada en el Finder (sin efecto en las copias internas).
• Importar: restaurar una copia desde el Finder.

7.1.5.3 Exportar datos

Exportación JSON (sin cifrar).

7.1.5.4 Importar datos

Importación JSON para restaurar una copia.

7.1.6 Seguridad

7.1.6.1 Bloqueo

Código PIN de al menos 4 dígitos en el primer uso; modificación con « Modificar código PIN ». Si lo olvida: reinstalación (haga copias de seguridad, § 7). PIN cifrado, no recuperable.

7.1.6.2 Touch ID

Sustituye el PIN por Touch ID si lo desea.

7.1.6.3 Restablecer la aplicación

Borra todos los datos; compra y periodo de prueba se conservan. Exporte a JSON antes (§ 7).

7.1.6.4 Generar informe

« Generar informe »: formato PDF o CSV, guardado en la carpeta de copia por defecto.

7.1.6.5 Informes y exportaciones en texto

Ajustes → Informes: archivo completo en texto plano. Desde Balance, exportación del balance en texto (barra de herramientas). El CSV del balance puede no estar disponible según la versión.

7.1.7 Primeros pasos (patrimonio de ejemplo)

En el primer inicio (iOS): explorar con datos de ejemplo, empezar vacío o importar una copia. El patrimonio de ejemplo es ficticio — para probar panel principal, proyecciones y síntesis. Banner mientras esté activo. Ajustes → Primeros pasos: cargar / eliminar el ejemplo, repetir la checklist de descubrimiento (pasos hacia las pestañas principales).

7.1.8 Notificaciones

Recordatorio mensual opcional para actualizar importes reales (Ajustes). Requiere permiso de notificaciones en iOS.

7.1.9 Aviso legal al inicio (iOS)

Disclaimer en el primer inicio; consultable en Ajustes o Acerca de.

8. Notas de versión

Versión de la documentación: 2.0 — síntesis patrimonial, estructura del ahorro, patrimonio de ejemplo, vista previa de préstamos, y funciones anteriores (Experto, fiscalidad, exportación de balance, etc.). Texto exacto App Store: « Novedades ».

V2.0 (actual — Sequoia)

• Prueba 14 días — Acceso completo para no compradores desde la actualización 2.0, luego versión gratuita limitada.
• Sequoia — Mejoras importantes en la rama Sequoia-v2.0.

V1.6

• Síntesis patrimonial — Centro en Análisis: asignación, estructura del ahorro, flujos y préstamos, real frente a previsto, proyectos y capacidad, fiscalidad, stress tests; enlace a Experto.
• Estructura del ahorro — Bolsillos en cuentas; referencias personales; gráficos, avisos, infografía en pirámide.
• Primeros pasos — Bienvenida al primer inicio; patrimonio de ejemplo y checklist; gestión en Ajustes.
• Préstamos — Vista previa en vivo (cuota, intereses, amortización) al crear o editar.
• Mejoras — Formularios armonizados; diseños de análisis refinados; tope de texto dinámico; textos ES / FR / EN.

V1.5

• Experto — Pasos reorganizados (macro, comparación por zona, simulaciones, conclusión); avisos si falta FRED.
• Impacto fiscal — Estimación opcional; bruto / neto en proyecciones, escenarios, panel principal.
• Balance — Secciones plegables; exportación en texto desde Balance y archivo en Ajustes.
• Panel principal — Línea de carteras en Montos reales; opciones de proyección bajo el gráfico.
• Ajustes — Recordatorio mensual; listas inmobiliario / préstamos armonizadas; aviso legal al inicio (iOS).

V1.4 y anteriores

• Barra lateral Patrimonio y Análisis; panel principal, ahorro, carteras, inmobiliario, préstamos, balance.
• Estado de cuentas, categorías, proyectos, escenarios, Experto (liquidez macro).
• Ajustes: idioma, apariencia (Claro+ / Oscuro+), API, copias, seguridad, inflación, ayuda, créditos; calculadora (barra de herramientas / ⌘K en macOS).

7. FAQ

Preguntas generales

¿Qué es OneLedger? Aplicación de planificación patrimonial a largo plazo que compara proyecciones con datos reales año a año — útil para la jubilación y grandes hitos.

¿Ofrece asesoramiento financiero? No. La planificación es personal y varía por país (fiscalidad, productos, rentabilidad). OneLedger le ayuda a proyectar y seguir sus objetivos, sin recomendar inversiones.

¿Cómo se calculan intereses y proyecciones? En cuentas de ahorro, los intereses se aplican a fin de año sobre saldo inicial más aportes del año (interés compuesto). Carteras e inmuebles siguen sus parámetros; las cotizaciones usan Alphavantage si hay clave.

¿Tiene en cuenta la inflación? Sí. Introduzca tasas anuales en Ajustes; hay gráficos con patrimonio real ajustado por inflación.

Resolución de problemas