HouseBudget

Connexion & création de compteSign in & create account

Le premier écran. Créez votre compte, connectez-vous, ou récupérez un mot de passe oublié. C'est identique sur le web, l'application bureau et le mobile. The very first screen. Create your account, sign in, or recover a forgotten password. It is identical on web, desktop and mobile.

Pas à pasStep by step

1. Créer un compte :Create an account: touchez Créer un compte, saisissez votre nom, e-mail et mot de passe, puis Créer mon compte.tap Create account, enter your name, email and password, then Create my account.
2. Se connecter :Sign in: e-mail + mot de passe, puis Se connecter. Si la double authentification est active, un champ Code d'authentification apparaît — entrez le code à 6 chiffres.email + password, then Sign in. If two-factor is on, an Authentication code field appears — enter the 6-digit code.
3. Mot de passe oublié :Forgot password: Mot de passe oublié ? → e-mail → Envoyer le code → saisissez le code reçu + un nouveau mot de passe → Réinitialiser.Forgot password? → email → Send code → enter the emailed code + a new password → Reset.

Vos propriétésYour properties

Juste après la connexion. Choisissez une propriété pour y entrer, créez-en une nouvelle, ou rejoignez celle de quelqu'un d'autre avec un code d'invitation. Toute la suite de l'application concerne la propriété active. Right after signing in. Pick a property to open, create a new one, or join someone else's with an invite code. Everything else in the app is about the active property.

Pas à pasStep by step

1. Créer une propriété :Create a property: onglet Créer → saisissez le Nom et la Devise → (facultatif) renseignez surface, chambres, équipements → Créer et entrer. Les chambres et les modèles de documents par défaut sont créés automatiquement.the Create tab → enter the Name and Currency → (optional) fill area, bedrooms, equipment → Create and enter. Rooms and default document templates are created automatically.
2. Rejoindre :Join: onglet Rejoindre → collez le Code d'invitation (format HB-XXXXX) → Rejoindre. Vous entrez en tant que Lecteur.the Join tab → paste the Invite code (format HB-XXXXX) → Join. You enter as a Viewer.
3. Changer de propriété plus tard :Switch property later: via le sélecteur en haut du menu (web) ou « Changer de propriété » dans Plus (mobile).via the switcher at the top of the menu (web) or "Switch property" in More (mobile).

Se repérer dans l'applicationFinding your way around

La navigation change selon l'appareil : un menu latéral sur le web et le bureau, une barre en bas sur téléphone, et un rail à gauche sur tablette. Les fonctionnalités, elles, sont les mêmes partout. Navigation adapts to the device: a left sidebar on web/desktop, a bottom bar on phones, and a left rail on tablets. The features themselves are identical everywhere.

Le menu « Plus » (téléphone)The "More" menu (phone)

Sur téléphone, les écrans secondaires vivent sous Plus : Rapport bailleur, Statistiques, Objectifs & Épargne, Catégories, Unités, Paramètres et « Changer de propriété ». On y trouve aussi les réglages Langue (FR/EN), Devise (Auto/EUR/XAF/XOF), Thème (Clair/Sombre) et la Déconnexion. On phones, secondary screens live under More: Landlord report, Statistics, Goals & Savings, Categories, Units, Settings and "Switch property". It also holds the Language (FR/EN), Currency (Auto/EUR/XAF/XOF), Theme (Light/Dark) settings and Log out.

Tableau de bordDashboard 🖥️ Web · 📱 RésuméSummary

La vue d'ensemble de la propriété active sur les 6 derniers mois : ce qu'il faut faire, la trésorerie, les impayés, et les tendances. Toutes les cartes sont cliquables et mènent à l'écran concerné. The overview of the active property over the last 6 months: what to do, cash, arrears, and trends. Every card is clickable and jumps to the matching screen.

ContratsContracts 🖥️ 📱

Le cœur de l'application. Un contrat = un locataire dans une unité. Ici vous créez le bail, encaissez les loyers, gérez l'entrée et la sortie (état des lieux), la caution, les documents et la signature en ligne, puis mettez fin au bail. The heart of the app. One contract = one tenant in one unit. Here you create the lease, record rent, run move-in / move-out (inventory), the deposit, documents and online signature, then end the lease.

Pas à pasStep by step

1. Créer un bail :Create a lease: + Nouveau contrat → choisissez l'Unité louée (le loyer et la caution se pré-remplissent), le Nom du locataire, le Téléphone, la Date de début, le Loyer et la Caution → onglet « Détails » pour l'email, la fin, le renouvellement auto, les colocataires, le garant → Enregistrer.+ New contract → pick the Rental unit (rent and deposit auto-fill), the Tenant name, Phone, Start date, Rent and Deposit → the "Details" tab for email, end date, auto-renewal, co-tenants, guarantor → Save.
2. Encaisser un loyer :Record rent: dépliez la carte → « Enregistrer un loyer » : mois, année, montant → Encaisser. Imprimez la Quittance depuis l'historique.expand the card → "Record a rent payment": month, year, amount → Record. Print the Receipt from the history.
3. Encaisser la caution :Collect the deposit: bloc 💰 Caution → Encaisser la caution → saisissez le Montant reçu → confirmez ; un reçu de caution s'imprime.the 💰 Deposit block → Collect the deposit → enter the Amount received → confirm; a deposit receipt prints.
4. Entrée / sortie (état des lieux) :Move-in / move-out (inventory): ▶ Réaliser l'entrée ou ⏹ Réaliser la sortie → relevez les compteurs, les clés, l'état des équipements → Enregistrer & envoyer le pack (envoie au locataire) ou Enregistrer seulement.▶ Do the move-in or ⏹ Do the move-out → record meters, keys, equipment condition → Record & send the pack (emails the tenant) or Record only.
5. Générer & faire signer le bail :Generate & e-sign the lease: bloc Documents → choisissez la langue et la Ville de signature → 📦 Pack locataire pour imprimer/PDF, puis ✍️ Signer en ligne pour envoyer un lien. Une fois signé, 📄 Voir le document signé.the Documents block → choose the language and Signing city → 📦 Tenant pack to print/PDF, then ✍️ Sign online to send a link. Once signed, 📄 View signed document.
6. Terminer & régler la caution :End & settle the deposit: Mettre fin au contrat → Régler la caution → ajoutez les Déductions (et cochez « Déduire les loyers impayés ») → Enregistrer & imprimer le décompte.End the contract → Settle deposit → add Deductions (and tick "Deduct outstanding rent") → Record & print settlement.

Transactions 🖥️ 📱

Le journal des revenus et des dépenses de la propriété. Saisissez, recherchez, filtrez et classez vos mouvements. Les loyers encaissés depuis un contrat apparaissent ici automatiquement. The property's income & expense ledger. Record, search, filter and classify your movements. Rent recorded from a contract shows up here automatically.

Pas à pasStep by step

1. Ajouter :Add: + Ajouter → choisissez Dépense ou Revenu → montant, date, description (la catégorie se propose seule grâce aux mots-clés) → Enregistrer.+ Add → pick Expense or Income → amount, date, description (the category is suggested from keywords) → Save.
2. Rattacher au bien :Link to the property: choisissez une Unité et un Contrat / locataire ; pour un revenu, réglez la Nature (Loyer, Réinvesti, Don, Autre) ou détaillez la ventilation.pick a Unit and a Contract / tenant; for income, set the Nature (Rent, Reinvested, Gift, Other) or break down the split.
3. Classer en masse (web) :Bulk-classify (web): cochez plusieurs lignes → barre d'outils → Loyer / Réinvesti / Don / Autre.tick several rows → toolbar → Rent / Reinvested / Gift / Other.

RappelsReminders 🖥️ 📱

Votre liste de tâches automatique : loyers en retard, entrées/sorties à réaliser, baux qui se terminent, cautions à rembourser, transactions attendues et échéances récurrentes. Chaque ligne propose l'action qui la résout. Your automatic to-do list: overdue rent, move-ins/outs to do, ending leases, deposits to refund, expected transactions and recurring due dates. Each row offers the action that clears it.

CatégoriesCategories 🖥️ 📱

Classez vos transactions et fixez des budgets mensuels par poste. Les mots-clés permettent le classement automatique. Vous pouvez partir des catégories par défaut et les adapter. Classify your transactions and set monthly budgets per line. Keywords enable auto-matching. You can start from the default categories and adapt them.

UnitésUnits 🖥️ 📱

Les unités louables de la propriété (chambres, studios, place de parking…). Suivez l'occupation, ajoutez rapidement une unité, et renseignez loyer, caution et équipements — qui pré-remplissent ensuite les contrats. The property's rentable units (rooms, studios, parking space…). Track occupancy, quickly add a unit, and fill rent, deposit and equipment — which then pre-fill contracts.

Rapport bailleurLandlord report 🖥️ 📱

Le rapport financier complet d'une propriété : compte de résultat, taux d'encaissement, occupation, et des indicateurs d'investisseur (rendement, NOI, DSCR, LTV…). Exportable en PDF. A property's full financial report: P&L, rent-collection rate, occupancy, and investor metrics (yield, NOI, DSCR, LTV…). Exportable to PDF.

StatistiquesStatistics 🖥️ 📱

La vue de tout votre portefeuille (toutes propriétés confondues), contrairement au Rapport qui concerne une seule propriété. En lecture seule. The view across your whole portfolio (all properties), unlike the Report which is about a single property. Read-only.

Objectifs & ÉpargneGoals & Savings 🖥️ 📱

Un simulateur d'épargne personnel (indépendant des propriétés) : construisez un budget mensuel, ajoutez des changements programmés et des mouvements ponctuels, fixez des objectifs, et voyez mois par mois quand vous les atteignez. A personal savings simulator (independent of properties): build a monthly budget, add scheduled changes and one-off movements, set goals, and see month-by-month when you reach them.

Modèles de documentsDocument templates 🖥️ Web seulementWeb only

Rédigez une fois vos documents réutilisables (bail, règlement intérieur, états des lieux) avec un éditeur visuel et des variables ({{locataire}}, {{loyer}}…). Ils sont ensuite proposés sur chaque contrat, pré-remplis. Author your reusable documents once (lease, house rules, inventories) with a visual editor and variables ({{tenant}}, {{rent}}…). They're then offered on every contract, pre-filled.

Signature en ligne (côté locataire)Online signature (tenant side) 🔗 Lien publicPublic link

Quand vous envoyez un pack « Signer en ligne », le locataire reçoit un lien. Il ouvre cette page (sans compte), lit le document, coche « Lu et approuvé », signe au doigt/souris, et vous recevez la copie signée. When you send a "Sign online" pack, the tenant gets a link. They open this page (no account), read the document, tick "Read and approved", sign with finger/mouse, and you receive the signed copy.

ParamètresSettings 🖥️ 📱

Tout ce qui concerne la propriété et votre compte : informations du bien, membres et leurs droits, sécurité (double authentification), mot de passe/e-mail, sauvegardes et journal d'audit. Everything about the property and your account: property info, members and their rights, security (two-factor), password/email, backups and the audit log.

🛡️ Super-administrationSuper-admin 🖥️ RéservéRestricted

Réservé à l'exploitant de la plateforme (pas aux bailleurs). Supervision de tous les comptes et propriétés : statistiques globales, gestion de la flotte, utilisateurs, audit des accès, et journal global. For the platform operator only (not landlords). Oversight of all accounts and properties: global stats, fleet management, users, access audit, and a global log.

Architecture 🖥️ 📱 ⚙️

Comment l'application est construite « sous le capot » : un backend unique en C#/.NET, une logique métier partagée en TypeScript, et trois clients (web, bureau, mobile) qui parlent tous à la même API. C'est ce qui garantit la parité entre les plateformes. How the app is built "under the hood": a single C#/.NET backend, shared business logic in TypeScript, and three clients (web, desktop, mobile) all talking to the same API. That's what keeps the platforms in parity.

Comment ça circuleHow it flows

1. Une seule logique métier :One shared codebase: les trois clients importent le même paquet @housebudget/core (TypeScript) — c'est ce qui garantit la parité entre web, bureau et mobile.all three clients import the same @housebudget/core package (TypeScript) — that's what keeps web, desktop and mobile in parity.
2. Appel à l'API :Calling the API: chaque client parle à l'API en HTTPS/JSON. Sur le serveur, Caddy reçoit la requête et gère le certificat HTTPS automatiquement.each client talks to the API over HTTPS/JSON. On the server, Caddy receives the request and manages the HTTPS certificate automatically.
3. Le backend :The backend: Caddy transmet à hb-api (C# / .NET 8), qui applique les règles métier et lit/écrit dans PostgreSQL via EF Core.Caddy forwards to hb-api (C# / .NET 8), which applies the business rules and reads/writes PostgreSQL through EF Core.
4. Bureau & mobile :Desktop & mobile: le bureau (.exe) est le frontend React empaqueté avec Tauri (coquille native en Rust) ; le mobile est le même métier via Expo / React Native.the desktop (.exe) is the React frontend packaged with Tauri (a native Rust shell); mobile is the same logic via Expo / React Native.

Architecture 3-tiers (et non 2-tiers)3-tier architecture (not 2-tier)

HouseBudget est une architecture 3-tiers : la présentation (les clients), l'application/logique (l'API) et les données (la base) sont trois couches physiquement séparées. Ce n'est pas du 2-tiers : aucun client ne parle directement à la base de données — tout passe par l'API, qui centralise les règles métier et la sécurité. HouseBudget is a 3-tier architecture: presentation (the clients), application/logic (the API) and data (the database) are three physically separated layers. It is not 2-tier: no client talks to the database directly — everything goes through the API, which centralises business rules and security.

Les couches du backend (Api → Infrastructure → Domain)Backend layers (Api → Infrastructure → Domain)

Détail du Tier 2. Le backend est découpé en trois couches emboîtées. Une couche ne dépend que de la couche intérieure : l'Api s'appuie sur l'Infrastructure, qui s'appuie sur le Domaine. Le Domaine (les entités) ne dépend de rien — et ce sens ne s'inverse jamais. A closer look at Tier 2. The backend is split into three nested layers. A layer depends only on the inner one: Api builds on Infrastructure, which builds on the Domain. The Domain (the entities) depends on nothing — and that direction never reverses.

Diagramme de classes (modèle de données)Class diagram (data model)

Le modèle de données complet du domaine : chaque entité avec ses attributs et ses relations (cardinalités). Les noms sont ceux du code C# (universels). Faites défiler pour voir l'ensemble. The complete domain data model: every entity with its attributes and relations (cardinalities). Names are the C# code identifiers (universal). Scroll to see it all.

Énumérations (types à valeurs fixes utilisés ci-dessus) :Enumerations (fixed-value types used above):

Diagramme entité-relation (ERD)Entity-Relationship Diagram (ERD)

La même information, vue « base de données » : les tables, leurs clés (PK = clé primaire, FK = clé étrangère) et les cardinalités en pattes-d'oie. Le diagramme de classes ci-dessus liste tous les attributs ; l'ERD met en avant les clés et les liens. The same information, seen as a "database": the tables, their keys (PK = primary key, FK = foreign key) and crow's-foot cardinalities. The class diagram above lists every attribute; the ERD highlights keys and links.

Diagramme de séquence — signature du bail en ligneSequence diagram — online lease signing

Le déroulé d'un des flux les plus caractéristiques : le bailleur envoie le pack, le locataire signe en ligne, et la copie signée revient — sans que le locataire ait de compte. One of the most distinctive flows: the landlord sends the pack, the tenant signs online, and the signed copy comes back — with no tenant account.

Cas d'utilisation (acteurs & rôles)Use cases (actors & roles)

Qui fait quoi, selon le rôle. Les droits sont réglables finement par module dans les Paramètres. Who does what, by role. Rights are finely tunable per module in Settings.

Diagramme d'états — cycle de vie d'un contratState diagram — contract lifecycle

Les états par lesquels passe un bail, de sa création à sa clôture. Le statut principal (Brouillon → Actif → Terminé) englobe le parcours interne quand il est actif : entrée (état des lieux) → occupation (loyers, caution, révision, reconduction) → sortie → puis règlement de la caution avant la clôture. The states a lease goes through, from creation to closure. The main status (Draft → Active → Ended) wraps the inner journey while active: move-in (inventory) → occupancy (rent, deposit, revision, renewal) → move-out → then deposit settlement before closing.

Diagramme d'activité — création d'un bailActivity diagram — creating a lease

Le parcours pas à pas, avec ses points de décision : choix de l'unité (disponible ?), saisie des informations, champs optionnels, contrôle des champs requis (unité + locataire + loyer), enregistrement, puis envoi facultatif du bail par email. Les libellés sont bilingues (FR puis EN). The step-by-step journey with its decision points: choosing the unit (available?), entering the details, optional fields, checking the required fields (unit + tenant + rent), saving, then optionally emailing the lease. Labels are bilingual (French then English).

Diagramme de déploiement (conteneurs Docker sur Hetzner)Deployment diagram (Docker containers on Hetzner)

Où tourne réellement l'application. Tout est conteneurisé (Docker) sur un serveur Hetzner unique, derrière un Caddy partagé qui gère le HTTPS et route chaque sous-domaine. La base PostgreSQL est partagée (une base isolée par application). Le backend contacte deux services externes : Firebase (notifications push) et le SMTP (e-mails). Where the app actually runs. Everything is containerised (Docker) on a single Hetzner server, behind a shared Caddy that handles HTTPS and routes each subdomain. The PostgreSQL database is shared (one isolated database per app). The backend calls two external services: Firebase (push notifications) and SMTP (email).