agnarae/README.md

# agnarae

*Agnarae* est une bibliothèque de modules [Django](https://www.djangoproject.com/) dédiée à la gestion en ligne de productions agricoles avec une approche collaborative entre producteurs et conseillers agronomes.

| | |
| --- | --- |
| Code | [https://develop.auchamp.ca/public/agnarae](https://develop.auchamp.ca/public/agnarae/) |
| License | GPLv3.0+, javascript code: LGPLv3.0+ |
| Support | [https://develop.auchamp.ca/public/agnarae/issues](https://develop.auchamp.ca/public/agnarae/issues/) |


## Feuille de route

La mise à disposition de la bibliothèque *agnarae* est une initiative de la communauté de développement de la plateforme [auchamp.ca](https://auchamp.ca) utilisée pour le suivi d'exploitations agricoles au Québec dans le domaine vinicole et la pomiculture.

Considérant l'état d'avancement actuel de la plateforme [auchamp.ca](https://auchamp.ca) et constatant le manque de ressources dans le domaine, nous planifions la publication sous license libre de plusieurs modules du projet au sein de la bibliothèque *agnarae*. Avec ces modules, quiconque pourra instancier un serveur [django](https://www.djangoproject.com/) pour créer un site permettant à ses utilisateurs de décrire leurs entreprises, leurs productions et les blocs mis en culture.

- *Janvier 2019*: le premier lot de modules à partager a été identifié. Leurs mise à disposition est prévu durant l'année 2019: 
	- `producer.company`
	- `producer.session`
	- `producer.blocks.block`
	- `producer.blocks.farmmap`
	- `db.inheritance`
	- `ui.map`
	- `ui.enhancement`
	- `ui.admin_extended.admin`
	- `crops.crop`
	- `demo`


## Contenu de la bibliothèque

### producer

Gestion des dossiers des producteurs

- `producer.company` enregistrement des informations initiales d'un producteur (identification, localisation, contact principal, etc.);
- `producer.session` navigation dans les dossiers de chaque producteur;
- `producer.blocks.block`: gestion des blocs de culture du producteur, taille, localisation, plantation, évolution;
- `producer.blocks.farmmap`: édition et visualisation des blocs de culture sur carte;

### crops

Gestion des types de culture

- `crops.crop`: édition et gestion de cultures génériques

### db

Outils additionnels pour la gestion de la base de données sous-jacente

- `db.inheritance`: gestion hierarchique de type de données;

### ui

Outils additionnels pour la définition des interfaces

- `ui.map`: édition et visualisation de cartes;
- `ui.enhancement`: ajouts de fonctionnalités dans les formulaires et les visualisations de Django;
- `ui.admin_extended.admin`: extension du module *django.contrib.admin*;

### demo

Site de démonstration de la bibliothèque

## License

Agnarae est publié sous license GPLv3+, à l'exception des fichiers javascript (.js) publié sous license LGPLv3+. Pour plus d'information, regardez les fichiers [LICENSE](https://develop.auchamp.ca/public/agnarae/src/branch/master/LICENSE) et [NOTICE](https://develop.auchamp.ca/public/agnarae/src/branch/master/NOTICE).