🔑 Installation et activation
Télécharge l'installeur depuis la page d'accueil du site, lance-le, puis ouvre Masroofi.
Au premier lancement, un formulaire d'inscription apparaît (Nom + Email). Tu peux :
- Laisser le champ License Key vide → un essai gratuit de 30 jours démarre automatiquement
- Coller une clé déjà achetée → activation immédiate
Pour activer ou changer de clé plus tard : menu Help → Activate License.
⚙️ Réglages
Bouton ⚙️ Settings en bas de l'écran (ou menu Tools → Settings) :
- Langue : Arabe / Anglais / Français — l'app redémarre pour appliquer
- Devise : 16 devises disponibles, appliquée partout (montants, totaux, rapports)
- Convertisseur de devises intégré — taux mis à jour en temps réel via une API gratuite
- Chemin de la base de données — pointe vers un dossier OneDrive/Google Drive pour utiliser les mêmes données sur plusieurs PC
- Alertes au démarrage — active/désactive l'alerte stock bas et l'avertissement budget
💸 Ajouter une dépense
Onglet Expenses → remplis le formulaire à gauche : code (ou scan), description, montant, catégorie, magasin, date, devise.
Tu peux aussi assigner la dépense à un membre de la famille via l'onglet Family.
⚖️ Produits vendus au poids (tomates, fromage…)
Pour les produits dont le prix dépend du poids :
- Dans Inventory, configure une fois : "Sold by" = kg/litre, et le prix au kilo
- Dans Expenses, entre le montant total payé et le poids indiqué sur le ticket
- L'app calcule automatiquement le prix au kilo et le stocke pour comparer dans le temps
🧾 Session de scan — "ticket de caisse"
Bouton 🛒 Scan Purchase Session (Expenses) : choisis le magasin une fois, puis scanne tous tes produits sans interruption. Double-clique sur une ligne pour corriger nom/prix/poids/quantité avant de confirmer.
🛍️ Liste de courses
Onglet Shopping : ajoute des articles manuellement, depuis l'inventaire, ou par scan. Code couleur : 🟢 essentiel, 🔴 luxe, blanc = normal — pour repérer rapidement où économiser.
📷 Mode caisse enregistreuse (scan avec le téléphone)
Utilise une app de scan sur ton téléphone (type "BT Scanner") connectée en Bluetooth à ton PC.
- Clique sur l'onglet Shopping (ou Inventory/Expenses) → une fenêtre scanner flottante s'ouvre automatiquement, toujours au premier plan
- Scanne un produit → ajouté instantanément à la liste, quantité +1 si déjà présent
- Si le produit est inconnu, l'app le cherche automatiquement en ligne (Open Food Facts, UPC databases, Open Library pour les ISBN…)
📧 Envoyer la liste de courses
Bouton Email List : envoie une page HTML interactive avec vraies cases à cocher, à ouvrir sur ton téléphone — coche au fur et à mesure dans le magasin. Chaque article affiche aussi son code-barres pour vérifier prix/disponibilité aux bornes en magasin.
Bouton PDF génère une version imprimable avec cases ☐ à cocher à la main.
Tu peux choisir plusieurs destinataires en même temps depuis ton carnet de Contacts, plus des adresses tapées manuellement si besoin.
📦 Gérer l'inventaire
Formulaire d'ajout à gauche, liste au centre (Code + Nom), fiche détaillée à droite (photo, marque, catégorie, stock, prix). Clique une ligne pour l'afficher en grand.
Boutons disponibles : Edit Item, Delete Selected (admin), Quick Edit Price, Adjust Stock, Stock Movements, Low Stock Alert, Add to Shopping, From Expenses (récupère les achats non encore en inventaire), Import/Export Excel, PDF Catalog (avec codes-barres).
🏷️ Catégories à profondeur illimitée
Plus de limite à 3 niveaux — chaque catégorie peut avoir autant de sous-niveaux que nécessaire.
Gestion : menu Tools → Manage Categories → Product Categories — arbre complet avec Ajouter/Supprimer, import/export Excel par chemin complet (ex: Alimentation > Épicerie > Pâtes).
📊 Codes-barres dynamiques (produits pesés en magasin)
Certains codes-barres encodent le prix directement (produits pesés à la balance du magasin). Masroofi les décode et utilise un identifiant stable (indépendant du prix scanné) pour toujours retrouver le bon produit, peu importe la variation de prix d'un achat à l'autre.
🖼️ Photos des produits
Dans la fiche détail d'un produit : boutons Add Picture / Delete Picture. Survole l'image pour un aperçu agrandi.
🟢🟡🔴 Classer essentiel / normal / luxe
Bouton 🏷️ Classify : classe tes produits en masse par catégorie, pour repérer facilement où réduire les dépenses dans la liste de courses.
👨👩👧 Comptes & budgets des membres
Onglet Family : ajoute chaque membre avec un budget mensuel. Les budgets familiaux s'intègrent automatiquement dans le Budget Summary et les alertes salaire.
Assigner une dépense à un membre : sélectionne-la dans Expenses, puis dans Family choisis le membre → ✔ Assign.
🔐 Connexion & accès limité enfants
Écran de connexion au démarrage (nom d'utilisateur + mot de passe). 3 rôles :
- 👑 Admin — accès complet
- 👤 Parent — tout sauf gestion des membres
- 👦 Child — Shopping + consultation de l'inventaire (ajout à la liste uniquement) + tableau de bord de son propre budget (restant à dépenser, dépenses récentes)
Configurer le mot de passe d'un membre : Family → double-clic sur le membre → Edit.
💼 Salaire & Revenus — sources récurrentes
Onglet protégé par mot de passe, fusionné en 3 sous-onglets.
Sources de revenus récurrentes : ajoute autant de sources que nécessaire (Salaire, Freelance, Loyer perçu...), chacune avec son propre montant, sa devise, et son jour de paiement (1 à 28). Chaque source est créditée automatiquement et indépendamment des autres.
- ⏸ Pause/Reprendre une source sans la supprimer
- 🗑 Supprimer une source
- Historique de tous les versements passés, par source
- Graphique d'évolution mensuelle (12 derniers mois)
💵 Revenus ponctuels
Pour les rentrées d'argent non récurrentes (vente d'objet, cadeau, remboursement...). Formulaire simple : description, montant, catégorie/source. Un camembert affiche la répartition par source.
📊 Comparaison mensuelle revenus / dépenses
3ème sous-onglet de Salaire & Revenus. Affiche, sur les 12 derniers mois :
- Un graphique barres (revenus en vert, dépenses en rouge) + ligne du net
- Un tableau détaillé avec le % d'évolution du net vs le mois précédent (🟢 amélioration, 🔴 dégradation)
🎉 Événements & Projets — créer un événement
Pour tout ce qui sort du quotidien : mariage, anniversaire, voyage, séjour médical, rénovation...
À la création, renseigne le nom, le type, la date, et un budget total + devise. Deux liaisons automatiques :
- Si le budget est > 0 → une ligne one-time est créée automatiquement dans l'onglet Budgets, dans la bonne devise
- Si tu coches "Besoin d'un prêt" → une entrée est créée dans la table des Prêts
🏨 Prestataires & tarification adaptée
Pour chaque événement, ajoute des prestataires avec leurs coordonnées (téléphone, email, site web, pays) et leur prix. Le formulaire de prix s'adapte automatiquement selon la catégorie choisie :
- 🏨 Hôtel / 💉 Clinique / 🏥 Hôpital → option pension (Room only / B&B / Half board / Full board) + prix/nuit
- 🍽 Restaurant → à la carte ou buffet + prix/invité
- 🎪 Salle de fête → prix/chaise ou forfait
- 🛫 Compagnie aérienne → classe (Economy/Business/First) + prix/billet
- 📷 Photographe → par session ou par photo
Un bouton "= Calculer" remplit automatiquement le prix total (quantité × prix unitaire) — modifiable manuellement si besoin. Chaque prestataire peut être facturé dans sa propre devise (utile pour un mariage à l'étranger).
📋 Tâches & attribution aux contacts
Double-clique sur un événement dans la liste pour ouvrir sa fenêtre de tâches.
- Ajoute une tâche, attribue-la à un contact, fixe une échéance
- Clique sur la case ☐ pour marquer une tâche comme terminée (☑)
- Double-clique sur une tâche pour la modifier (changer le nom, réattribuer à quelqu'un d'autre, changer le statut)
- Bouton 📧 Send Tasks by Email : envoie un email à chaque personne assignée, contenant uniquement ses propres tâches
👤 Carnet de contacts
Onglet dédié pour gérer les personnes que tu assignes aux tâches d'événements (ou à qui envoyer la liste de courses). Prénom, nom, email, et autant de numéros de téléphone que nécessaire par contact :
- Choisis le pays → l'indicatif téléphonique se remplit automatiquement (modifiable)
- Type de numéro : Mobile / Home / Work / WhatsApp / Other
Dans Shopping → Email List, tu peux désormais sélectionner plusieurs destinataires directement depuis ce carnet de contacts (en plus d'adresses tapées manuellement).
✂️ Photo de contact & recadrage
Clique "Add Picture" sur un contact pour ouvrir l'outil de recadrage interactif :
- Un carré de sélection que tu peux glisser pour le positionner où tu veux sur la photo
- Un curseur pour agrandir/rétrécir la zone sélectionnée
- "✅ Crop & Save" applique exactement la zone choisie
🍽️ Recettes
Crée une recette en listant les ingrédients par nom générique (ex: "Spaghetti"), peu importe la marque en stock — la recherche est tolérante aux fautes de frappe.
- Cook This! sur une recette → vérifie le stock, ajoute automatiquement ce qui manque à la liste de courses
- Suggest Recipes → analyse ton inventaire et propose les recettes réalisables, triées par % d'ingrédients déjà disponibles
📅 Budgets
Budgets par catégorie avec récurrence et réinitialisation automatique. Le Budget Summary combine budgets catégorie + budgets famille pour une vue d'ensemble.
Chaque budget peut être dans sa propre devise (utile pour les budgets liés à un événement à l'étranger). ⚠️ Le total global combiné n'effectue pas encore de conversion entre devises différentes.
💰 Comparer les prix entre magasins
Chaque scan/achat avec un magasin sélectionné alimente un historique de prix. Price Comparison affiche, pour chaque produit, le magasin le moins cher (🟢) et le plus cher (🔴), avec l'économie potentielle.
📤 Import / Export Excel
Disponible pour Inventory, Expenses, Income, Shopping List et Catégories. Pratique pour sauvegarder, modifier en masse dans Excel, ou migrer les données.
☁️ Utiliser Masroofi sur plusieurs ordinateurs
Settings → chemin de la base de données → choisis un dossier synchronisé (OneDrive/Google Drive). Installe Masroofi sur l'autre PC, pointe vers le même dossier synchronisé → mêmes données partout.