Comptes est une application web permettant de suivre ses comptes bancaires et dépenses de transport.

You can't improve what you can't measure.

Basée sur ce principe, elle a pour but de proposer des outils d'analyse : statistiques et graphiques.

Son architecture Symfony2 la rend très modulable et son intérêt réside dans le fait que chacun peut l'adapter à ses besoins et définir de nouvelles statistiques.

• gestion et catégorisation de mouvements de comptes bancaires
• gestion de pleins de carburant d'un parc de véhicules
• statistiques : solde des comptes, dépenses par catégories, épargne mensuelle moyenne, consommation des véhicules, et bien d'autres
• tableau de bord personnalisable
• moteur d'import des relevés de comptes et des pleins de carburant (en ligne de commande ou par interface web)

Ce paragraphe sera bref puisqu'il s'agit d'une installation Symfony2 classique.

1. Clôner https://github.com/vrobic/mysql et https://github.com/vrobic/traefik et les démarrer avec docker compose up -d
2. Clôner https://github.com/vrobic/comptes
3. Depuis le répertoire du projet : 3.1. lancer un make up pour démarrer la stack 3.2. puis un make install pour installer la base de données
4. Modifier /etc/hosts pour faire pointer comptes.loc vers 127.0.0.1
5. Accéder à l'application via http://comptes.loc/app_dev.php

Ce paragraphe décrit les grandes étapes de la configuration. Les fichiers dont il est question ci-dessous sont généreusement documentés et vous apporteront le complément d'informations nécessaire.

Les fixtures sont les jeux de données nécessaires au fonctionnement de l'application. Elles contiennent la liste des comptes bancaires, des catégories de mouvements, des véhicules et des carburants. Pour vous permettre de les définir facilement, ces données sont regroupées dans le fichier fixtures.yml :

src/ComptesBundle/Resources/config/fixtures.yml

Une fois les données saisies, vous pouvez créer la base de données et importer les fixtures :

make install

L'application peut maintenant être ouverte dans un navigateur web !

Le moteur d'import requiert un rapide paramétrage dans import.yml :

src/ComptesBundle/Resources/config/import.yml

Il vous faut modifier le tableau handlers pour ajuster les identifiants de comptes bancaires et de véhicules.

Le moteur d'import est capable de catégoriser automatiquement les mouvements importés, en analysant les mots-clés contenus dans leur description. Si vous souhaitez bénéficier de cette fonctionnalité, il vous faudra vous rendre sur la page d'édition des catégories et renseigner les mots-clés associés à chaque catégorie de mouvement.

docker compose exec mysql mysqldump -uroot -proot comptes > ~/Downloads/comptes.sql

Les mouvements de comptes bancaires et pleins de carburant peuvent être importés soit par l'interface web, soit en ligne de commande.

Import des mouvements de comptes bancaires :

php app/console comptes:import:mouvements filename handler

Import des pleins de carburant d'un parc de véhicules :

php app/console comptes:import:pleins filename handler

où filename est le chemin du fichier et handler le service de prise en charge du fichier. En cas de doute, donnez une valeur arbitraire à handler pour que le système vous liste les possibilités.

Le fichier que vous tentez d'importer n'est pas pris en charge ? La documentation CONTRIBUTING.md vous détaillera le développement d'un handler d'import.