Autonomie

Un progiciel de gestion pour CAE -Coopérative d'activité et d'emploi.

Licence

Ceci est un logiciel libre, pour les conditions d'accès, d'utilisation, de copie et d'exploitation, voir LICENSE.txt

Nouvelles fonctionnalités/Anomalies

Site officiel : http://autonomie.coop

L'essentiel du développement est réalisé sur financement de Coopérer pour entreprendre.

Si vous rencontrez un bogue, ou avez une idée de fonctionnalité, il est possible de signaler cela aux développeurs directement ou en utilisant le système de tickets de github. Exception : pour les bogues de sécurité, merci d'écrire un courriel à autonomie@majerti.fr.

Instructions pour l'installation du logiciel

Installation des paquets (nécessaire pour l'installation dans un environnement virtuel):

Sous Debian:

apt-get install virtualenvwrapper libmariadbclient-dev build-essential libjpeg-dev libfreetype6 libfreetype6-dev libxml2-dev zlib1g-dev python-mysqldb redis-server libxslt1-dev

Sous Fedora:

dnf install virtualenvwrapper mardiadb-devel python-devel libxslt-devel libxml2-devel libtiff-devel libjpeg-devel libzip-devel freetype-devel lcms2-devel libwebp-devel tcl-devel tk-devel gcc redis-server

Création d'un environnement virtuel Python.

mkvirtualenv autonomie

Téléchargement et installation de l'application

git clone https://github.com/CroissanceCommune/autonomie.git
cd autonomie
python setup.py install
cp development.ini.sample development.ini

Éditer le fichier development.ini et configurer votre logiciel (Accès à la base de données, différents répertoires de ressources statiques ...).

Initialiser la base de données

autonomie-admin development.ini syncdb

Note

L'application synchronise automatiquement les modèles de données.

Puis créer un compte administrateur

autonomie-admin development.ini useradd [--user=<user>] [--pwd=<password>] [--firstname=<firstname>] [--lastname=<lastname>] [--group=<group>] [--email=<email>]

N.B : pour un administrateur, préciser

--group=admin

Puis lancer l'application web

pserve development.ini

Éxécution des tâches asynchrones

Un service de tâches asynchrones basé sur celery et redis est en charge de l'éxécution des tâches les plus longues.

Voir : https://github.com/CroissanceCommune/autonomie_celery

pour plus d'informations.

Mise à jour

La mise à jour d'Autonomie s'effectue en deux temps (il est préférable de sauvegarder vos données avant de lancer les commandes suivantes)

Mise à jour de la structure de données

autonomie-migrate app.ini upgrade

Configuration des données par défaut dans la base de données

autonomie-admin app.ini syncdb

Développement

Dans un contexte de développement, installez autonomie avec les commandes suivantes

git clone https://github.com/CroissanceCommune/autonomie.git
cd autonomie
pip install pyramid_debugtoolbar
# Ici on install autonomie en mode developpement
python setup.py develop
cp development.ini.sample development.ini

Base de données avec Vagrant

Pour héberger la base de données dans une machine virtuelle jettable et reproductible sans toucher à la machine hôte, une configuration Vagrant est disponible. Pour l'utiliser :

apt install virtualbox vagrant

Et pour lancer cette machine :

vagrant up

Un serveur MariaDB est alors installé et configuré (port local 13306 de l'hôte local, base: autonomie, login: autonomie, password: autonomie).

Des configurations adaptées à vagrant sont commentées dans test.ini.sample et developement.ini.sample.

Au besoin, la base peut être remise à zéro avec :

vagrant provision

Tests

Installer les dépendances de test

pip install -r test_requirements.txt

Copier et personaliser le fichier de configuration

Lancer les tests

py.test autonomie/tests