facto

Outil de comptabilité familiale

L'outil de comptabilité familiale garde une trace de chaque transaction que votre famille effectue. Son objectif est de:

• Extraire les statistiques utiles des données
  EG: Combien est consacré à la nourriture chaque mois?
• Calculer la dette interne
  Par exemple: Alice achète du papier toilette pour toute la famille avec son propre argent. Cet outil enregistre ensuite que la famille doit Alice le coût du papier hygiénique.
• Fournir un moyen de vérifier si aucun argent ne disparaît dans les dépenses inattendues
  Par exemple: vous remarquerez quand il y a des frais bancaires cachés

Capture d'écran

Installation de la version

• Installez Java 11 (JDK 11) sur votre serveur
• Télécharger "Binaires (fichiers compilés) avec configuration de démonstration" à partir de la dernière version
• Déballer les archives
• Open conf/application.conf dans le dossier non emballé:
  • Configurez une base de données. Le moyen le plus simple consiste à configurer un serveur MARIADB localement, à créer une base de données vide appelée facto et à le configurer comme suit:

 db.default {
  driver = com.mysql.jdbc.Driver
  url = "jdbc:mysql://localhost/facto?user=mysqluser&password=mysqlpassword"
  slick.profile = "slick.jdbc.MySQLProfile$"
}

• Choisissez des valeurs secrètes pour play.http.secret.key et app.setup.defaultPassword

• Ouvrez un terminal dans le dossier déballé

• Exécutez les commandes suivantes pour faire fonctionner l'application:

   # Create database tables
  bin/server -DdropAndCreateNewDb
  
  # Create admin user
  bin/server -DcreateAdminUser
  
  # Run application
  bin/server
  

• Parcourez http: // localhost: 9000 / app / userAdIminging (nom d'utilisateur: "admin", mot de passe: "Changeme")

Installation avec Docker (découragé)

AVERTISSEMENT: Ce qui suit fonctionne bien pour le lancement d'un serveur de démonstration pour jeter un œil. Mais si vous souhaitez exécuter cela en tant que service avec des données réelles et une configuration personnalisée, il est recommandé de suivre la section "Installation de la version" à la place (voir ce problème pour les raisons pour lesquelles).

Les commandes suivantes lanceront un nouveau serveur aux côtés d'une base de données dans Docker Contaters:

 # Get the docker-compose.yml file
wget https://raw.githubusercontent.com/nymanjens/facto/master/docker-compose.yml

# Choose a unique random string here of sufficient length
export APPLICATION_SECRET="$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)"

# Create an empty database with a single admin user
docker-compose run web sleep 5 # Wait for the database to be ready
docker-compose run web bin/server -DdropAndCreateNewDb
docker-compose run web bin/server -DcreateAdminUser

# Bring up the server
docker-compose up

Une fois terminé, parcourez http: // localhost: 9000 / (nom d'utilisateur: "admin", mot de passe: "Changeme")

Configuration

• conf/application.conf :
  Configurer et configurer une base de données ici.
• Ajouter des utilisateurs:
  Un utilisateur par défaut est créé avec l'indicateur -DcreateAdminUser (nom d'utilisateur: admin, mot de passe: Changeme). Ce compte peut créer de nouveaux utilisateurs.
• conf/accounting-config.yml :
  Modifiez ce fichier pour refléter votre situation et vos préférences. Notez que userLoginName doit faire référence à un utilisateur qui existe déjà dans la base de données (voir point précédent)

Usage

Pour utiliser efficacement cet outil, vous devez apprendre à saisir correctement les transactions. Par conséquent, il est important de comprendre le sens des catégories et des comptes.

Catégories

Ceux-ci sont utilisés pour diviser vos dépenses en catégories. Chaque compte a des catégories spéciales:

• Catégorie de comptabilité:
  Utilisé pour le revenu / dépenses non réel. Cette catégorie sera ignorée lors de l'analyse de l'excédent / déficit mensuel en termes de dépenses. Utilisez cette catégorie, par exemple lorsque les dépenses seront remboursées par votre employeur
• Catégorie de dotation:
  Utilisé pour le transfert d'argent sur le compte commun (voir l'exemple dans la section suivante)

Comptes

Un compte peut se référer à une personne ordinaire ou au compte commun.

Exemple:

Une famille a deux membres: Alice et Bob. Il y aura trois comptes:

• Alice
• Bob
• Le compte commun

Alice et Bob transfèrent régulièrement de l'argent sur le compte commun qui peut être utilisé pour effectuer des dépenses communes. Ce transfert vers le compte commun est appelé «dotation» .

Entrée des transactions

Champs spéciaux:

• Bénéficiaire:
  En cas de dépense: celui qui bénéficiera des dépenses
  En cas de revenu: celui qui a été payé
• Payé avec / à:
  En cas de dépense: payé avec
  En cas de revenu: payé à
• Couler:
  En cas de dépense: nombre négatif représentant le prix
  En cas de revenu: nombre positif

Utiliser efficacement l'aperçu des flux de trésorerie

L'aperçu des flux de trésorerie est un outil puissant pour vérifier les dépenses non comptabilisées.

Tu devrais:

• Définissez le montant actuel que vous avez pour chaque mode de paiement (espèces, carte, ...). Vous pouvez le faire en utilisant le bouton "Set" .
• Chaque fois que vous effectuez une transaction, le solde sera mis à jour automatiquement.
• Vous pouvez recouvrir votre argent et voir s'il correspond à la valeur calculée. Si c'est le cas, vous pouvez utiliser le bouton à cocher pour marquer cela. Si ce n'est pas le cas, vous avez fait une erreur ou perdu de l'argent.

À propos de ce projet

Ce projet a été créé et maintenu par moi (Jens) pendant mon temps libre pour ma famille, et je l'ai fait open source dans l'espoir qu'il pourrait être utile pour les autres.

Si vous décidez de l'utiliser, il y a de fortes chances que vous l'utilisiez beaucoup ou arrêtez de l'utiliser après un certain temps. Si vous êtes dans la première catégorie, veuillez m'envoyer un message à [email protected] (ou envisager d'envoyer un don) afin que je sache que d'autres utilisent cela. Faites-moi également savoir si vous avez un intérêt à passer à des versions plus récentes ou à utiliser les fonctionnalités les plus avancées (cachées) comme les taux de change et la correction de l'inflation.