Commit initial

4 years ago · cde3aa56d0
47 changed files with 4062 additions and 0 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@ -0,0 +1,8 @@
				@@ -0,0 +1,8 @@
+# Changelog
+All notable changes to Bénévalibre will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/)
+and this project adheres to [Semantic Versioning](http://semver.org/).
+
+## [Unreleased]
+### Added
--- a/CONTRIBUTORS.txt
+++ b/CONTRIBUTORS.txt
@ -0,0 +1 @@
				@@ -0,0 +1 @@
+This software is developped by Cliss XXI.
--- a/661
+++ b/661
--- a/144
+++ b/144
@ -0,0 +1,144 @@
				@@ -0,0 +1,144 @@
+# -*- mode: makefile-gmake -*-
+## Définition des variables
+# Le nom de l'exécutable Python à utiliser ou son chemin absolu
+# (ex. : python ou python3).
+PYTHON_EXE := python3
+# S'il faut utiliser un environnement virtuel (y ou n).
+USE_VENV := y
+# Configuration de l'environnement virtuel.
+VENV_DIR := venv
+VENV_OPT := --system-site-packages
+
+# Définis les chemins et options des exécutables.
+PYTHON_EXE_BASENAME := $(shell basename $(PYTHON_EXE))
+VENV_PYTHON := --python=$(PYTHON_EXE_BASENAME)
+ifeq ($(USE_VENV), y)
+  PYTHON := $(VENV_DIR)/bin/$(PYTHON_EXE_BASENAME)
+  PIP := $(VENV_DIR)/bin/pip
+else
+  PYTHON := $(shell which $(PYTHON_EXE))
+  PIP := $(shell which pip)
+endif
+
+# Détermine s'il faut charger le fichier de configuration.
+ifneq ($(READ_CONFIG_FILE), 0)
+  READ_CONFIG_FILE := 1
+else
+  READ_CONFIG_FILE := 0
+endif
+
+# Détermine l'environnement à utiliser.
+DEFAULT_ENV := production
+ifndef ENV
+  ifeq ($(READ_CONFIG_FILE), 1)
+      # Commence par chercher la dernière valeur de DJANGO_SETTINGS_MODULE,
+      # puis de ENV s'il n'y en a pas, ou utilise l'environnement par défaut.
+      ENV = $(shell \
+        sed -n -e '/^DJANGO_SETTINGS_MODULE/s/[^.]*\.settings\.\([^.]*\)/\1/p' \
+            -e '/^ENV/s/[^=]*=\(.*\)/\1/p' config.env 2> /dev/null \
+          | tail -n 1 | grep -Ee '^..*' || echo "$(DEFAULT_ENV)")
+  else
+    ifdef DJANGO_SETTINGS_MODULE
+      ENV = $(shell echo $(DJANGO_SETTINGS_MODULE) | cut -d. -f3)
+    else
+      ENV := $(DEFAULT_ENV)
+    endif  # ifdef DJANGO_SETTINGS_MODULE
+  endif  # ifeq READ_CONFIG_FILE
+endif  # ifndef ENV
+
+# Définis EDITOR pour l'édition interactive.
+ifndef EDITOR
+  ifdef VISUAL
+    EDITOR := $(VISUAL)
+  else
+    EDITOR := vi
+  endif
+endif
+
+# Définition des cibles -------------------------------------------------------
+
+.PHONY: clean-pyc clean-build clear-venv help check check-config
+.DEFAULT_GOAL := help
+
+# Commentaire d'une cible : #-> interne ##-> aide production+dev ###-> aide dev
+help: ## affiche cette aide
+ifeq ($(ENV), production)
+	@perl -nle'print $& if m{^[a-zA-Z_-]+:[^#]*?## .*$$}' $(MAKEFILE_LIST) \
+	  | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-15s\033[0m %s\n", $$1, $$2}'
+else
+	@perl -nle'print $& if m{^[a-zA-Z_-]+:[^#]*?###? .*$$}' $(MAKEFILE_LIST) \
+	  | sort | awk 'BEGIN {FS = ":.*?###? "}; {printf "\033[36m%-15s\033[0m %s\n", $$1, $$2}'
+endif
+
+clean: clean-build clean-pyc ## nettoie tous les fichiers temporaires
+
+clean-build: ### nettoie les fichiers de construction du paquet
+	rm -rf build/
+	rm -rf dist/
+	rm -rf *.egg-info
+
+clean-pyc: ### nettoie les fichiers temporaires python
+	find benevalibre/ \
+	  \( -name '*.pyc' -o -name '*.pyo' -o -name '*~' \) -exec rm -f {} +
+
+init: create-venv config.env update ## initialise l'environnement et l'application
+
+config.env:
+ifeq ($(READ_CONFIG_FILE), 1)
+	cp config.env.example config.env
+	chmod go-rwx config.env
+	$(EDITOR) config.env
+endif
+
+update: check-config install-deps migrate static ## mets à jour l'application et ses dépendances
+	touch benevalibre/wsgi.py
+
+check: check-config ## vérifie la configuration de l'instance
+	$(PYTHON) manage.py check
+
+check-config:
+	@find . -maxdepth 1 -name config.env -perm /o+rwx -exec false {} + || \
+	{ echo "\033[31mErreur :\033[0m les permissions de config.env ne sont pas bonnes, \
+	vous devriez au moins faire : chmod o-rwx config.env"; false; }
+
+install-deps: ## installe les dépendances de l'application
+	$(PIP) install --upgrade --requirement requirements/$(ENV).txt
+
+migrate: ## mets à jour le schéma de la base de données
+	$(PYTHON) manage.py migrate
+
+static: ## collecte les fichiers statiques
+ifeq ($(ENV), production)
+	@echo "Collecte des fichiers statiques..."
+	$(PYTHON) manage.py collectstatic --no-input --verbosity 0
+endif
+
+## Cibles liées à l'environnement virtuel
+
+create-venv: $(PYTHON)
+
+$(PYTHON):
+ifeq ($(USE_VENV), y)
+	virtualenv $(VENV_OPT) $(VENV_PYTHON) $(VENV_DIR)
+else
+	@echo "\033[31mErreur !\033[0m Impossible de trouver l'exécutable Python $(PYTHON)"
+	@exit 1
+endif
+
+clear-venv: ## supprime l'environnement virtuel
+	-rm -rf $(VENV_DIR)
+
+## Cibles pour le développement
+
+serve: ### démarre un serveur local pour l'application
+	$(PYTHON) manage.py runserver
+
+test: ### lance les tests de l'application
+	$(PYTHON) -m pytest --cov --cov-report=term:skip-covered
+
+cov: test ### vérifie la couverture de code
+	$(PYTHON) -m coverage html
+	@echo open htmlcov/index.html
+
+lint: ### vérifie la syntaxe et le code python
+	$(PYTHON) -m flake8 benevalibre
--- a/README.md
+++ b/README.md
@ -0,0 +1,231 @@
				@@ -0,0 +1,231 @@
+# Bénévalibre
+
+Valoriser l'engagement
+
+**Table of content**
+
+- [Installation](#installation)
+- [Deployment](#deployment)
+- [Structure](#structure)
+- [Development](#development)
+
+## Installation
+### Requirements
+
+On a Debian-based host - running at least Debian Stretch, you will need the
+following packages:
+- python3
+- virtualenv
+- python3-psycopg2 (optional, in case of a PostgreSQL database)
+
+### Quick start
+
+It assumes that you already have the application source code locally - the best
+way is by cloning this repository - and that you are in this folder.
+
+1.  Define your local configuration in a file named `config.env`, which can be
+    copied from `config.env.example` and edited to suits your needs.
+
+    Depending on your environment, you will have to create your database and the
+    user at first.
+
+2.  Run `make init`.
+
+    Note that if there is no `config.env` file, it will be created interactively.
+
+That's it! Your environment is now initialized with the application installed.
+To update it, once the source code is checked out, simply run `make update`.
+
+### Manual installation
+
+If you don't want to use the `Makefile` facilities, here is what is done behind the scene.
+
+It assumes that you have downloaded the last release of Bénévalibre,
+extracted it and that you moved to that folder.
+
+1.  Start by creating a new virtual environment under `./venv` and activate it:
+
+        $ virtualenv --system-site-packages ./venv
+        $ source ./venv/bin/activate
+
+2.  Install the required Python packages depending on your environment:
+
+        $ pip install -r requirements/production.txt
+        ... or ...
+        $ pip install -r requirements/development.txt
+
+3.  Configure the application by setting the proper environment variables
+    depending on your environment. You can use the `config.env.example` which
+    give you the main variables with example values.
+
+        $ cp config.env.example config.env
+        $ nano config.env
+        $ chmod go-rwx config.env
+
+    Note that this `./config.env` file will be loaded by default when the
+    application starts. If you don't want that, just move this file away or set
+    the `READ_CONFIG_FILE` environment variable to `0`.
+
+4.  Create the database tables - it assumes that you have created the database
+    and set the proper configuration to use it:
+
+        $ ./manage.py migrate
+
+That's it! You should now be able to start the Django development server to
+check that everything is working fine with:
+
+    $ ./manage.py runserver
+
+## Deployment
+
+Here is an example deployment using NGINX - as the Web server - and uWSGI - as
+the application server.
+
+The uWSGI configuration doesn't require a special configuration, except that we
+are using Python 3 and a virtual environment. Note that if you serve the application
+on a sub-location, you will have to add `route-run = fixpathinfo:` to your uWSGI configuration (from
+[v2.0.11](https://uwsgi-docs.readthedocs.io/en/latest/Changelog-2.0.11.html#fixpathinfo-routing-action)).
+
+In the `server` block of your NGINX configuration, add the following blocks and
+set the path to your application instance and to the uWSGI socket:
+
+```
+location / {
+    include uwsgi_params;
+    uwsgi_pass unix:<uwsgi_socket_path>;
+}
+location /media {
+    alias <app_instance_path>/var/media;
+}
+location /static {
+    alias <app_instance_path>/var/static;
+    # Optional: don't log access to assets
+    access_log off;
+}
+```
+
+You should also check that your application is well configured by running
+`make check`.
+
+## Structure
+### Overview
+
+All the application files - e.g. Django code including settings, templates and
+statics - are located into the `benevalibre/`. It should
+permit in a near future to distribute the application as a Python package and
+install it system-wide.
+
+Two environments are defined - either for requirements and settings:
+- `development`: for local application development and testing. It uses a
+  SQLite3 database and enable debugging by default, add some useful settings
+  and applications for development purpose - i.e. the `django-debug-toolbar`.
+- `production`: for production. It checks that configuration is set and
+  correct, try to optimize performances and enforce some settings - i.e. HTTPS
+  related ones.
+
+### Local changes
+
+You can override and extend statics and templates locally. This can be useful
+if you have to change the logo for a specific instance for example. For that,
+just put your files under the `local/static/` and `local/templates/` folders.
+
+Regarding the statics, do not forget to collect them after that. Note also that
+the `local/` folder is ignored by *git*.
+
+### Variable content
+
+All the variable content - e.g. user-uploaded media, collected statics - are
+stored inside the `var/` folder. It is also ignored by *git* as it's specific
+to each application installation.
+
+So, you will have to configure your Web server to serve the `var/media/` and
+`var/static/` folders, which should point to `/media/` and `/static/`,
+respectively.
+
+## Development
+
+The easiest way to deploy a development environment is by using the `Makefile`.
+
+Before running `make init`, ensure that you have either set `ENV=development`
+in the `config.env` file or have this environment variable. Note that you can
+still change this variable later and run `make init` again.
+
+There is some additional rules when developing, which are mainly wrappers for
+`manage.py`. You can list all of them by running `make help`. Here are the main ones:
+- `make serve`: run a development server
+- `make test`: test the whole application
+- `make lint`: check the Python code syntax
+
+### Assets
+
+The assets - e.g. CSS, JavaScript, images, fonts - are generated using a
+[Gulp](https://gulpjs.com/)-powered build system with these features:
+- SCSS compilation and prefixing
+- JavaScript module bundling with webpack
+- Styleguide and components preview
+- Built-in BrowserSync server
+- Compression for production builds
+
+The source files live in `assets/`, and the styleguide in `styleguide/`.
+
+#### Requirements
+
+You will need to have [npm](https://www.npmjs.com/) installed on your system.
+If you are running Debian, do not rely on the npm package which is either
+outdated or removed - starting from Debian Stretch. Instead, here is a way
+to install the last version as a regular user:
+
+1.  Ensure that you have the following Debian packages installed, from at least
+    `stretch-backports`:
+      - nodejs
+      - node-rimraf
+
+2.  Set the npm's installation prefix as an environment variable:
+
+	      $ export npm_config_prefix=~/.node_modules
+
+3.  Retrieve and execute the last npm's installation script:
+
+	      $ curl -L https://www.npmjs.com/install.sh | sh
+
+4.  Add the npm's binary folder to your environment variables:
+
+        $ export PATH="${HOME}/.node_modules/bin:${PATH}"
+
+    In order to keep those environment variables the next time you will log in,
+    you can append the following lines to the end of your `~/.profile` file:
+
+    ```bash
+    if [ -d "${HOME}/.node_modules/bin" ] ; then
+        PATH="${HOME}/.node_modules/bin:${PATH}"
+        export npm_config_prefix=~/.node_modules
+    fi
+    ```
+
+5.  That's it! You can check that npm is now installed by running the following:
+
+        $ npm --version
+
+#### Usage
+
+Start by installing the application dependencies - which are defined in
+`package.json` - by running: `npm install`.
+
+The following tasks are then available:
+- `npm run build`: build all the assets for development and production use,
+  and put them in the static folder - e.g `benevalibre/static`.
+- `npm run styleguide`: run a server with the styleguide and watch for file
+  changes.
+- `npm run serve`: run a proxy server to the app - which must already be served on
+  `localhost:8000` - with the styleguide on `/stylguide` and watch for file
+  changes.
+- `npm run lint`: lint the JavaScript and the SCSS code.
+
+In production, only the static files will be used. It is recommended to commit
+the compiled assets just before a new release only. This will prevent to have a
+growing repository due to the minified files.
+
+## License
+
+Bénévalibre is developed by Cliss XXI and licensed under the
+[AGPLv3+](LICENSE).
--- a/assets/js/app.js
+++ b/assets/js/app.js
@ -0,0 +1,18 @@
				@@ -0,0 +1,18 @@
+import $ from 'jquery';
+
+import './vendor/bootstrap';
+
+// Export jQuery for external usage
+window.jQuery = window.$ = $; // eslint-disable-line no-multi-assign
+
+// -----------------------------------------------------------------------------
+// Main application
+// -----------------------------------------------------------------------------
+
+$(() => {
+  $('.no-js').removeClass('no-js');
+
+  // Initialize Popover and Tooltip on the whole page
+  $('[data-toggle="popover"]').popover();
+  $('[data-toggle="tooltip"]').tooltip();
+});
--- a/assets/js/vendor/bootstrap.js
+++ b/assets/js/vendor/bootstrap.js
@ -0,0 +1,23 @@
				@@ -0,0 +1,23 @@
+// -----------------------------------------------------------------------------
+// Bootstrap 4
+// -----------------------------------------------------------------------------
+// see: ../../node_modules/bootstrap/js/src/index.js
+
+// Import all Bootstrap components
+
+import 'bootstrap';
+
+// ... or import them individually
+
+// import 'bootstrap/js/dist/util';
+// import 'bootstrap/js/dist/alert';
+// import 'bootstrap/js/dist/button';
+// import 'bootstrap/js/dist/carousel';
+// import 'bootstrap/js/dist/collapse';
+// import 'bootstrap/js/dist/dropdown';
+// import 'bootstrap/js/dist/modal';
+// import 'bootstrap/js/dist/popover';
+// import 'bootstrap/js/dist/scrollspy';
+// import 'bootstrap/js/dist/tab';
+// import 'bootstrap/js/dist/toast';
+// import 'bootstrap/js/dist/tooltip';
--- a/assets/scss/abstracts/_variables-bootstrap.scss
+++ b/assets/scss/abstracts/_variables-bootstrap.scss
@ -0,0 +1,24 @@
				@@ -0,0 +1,24 @@
+// -----------------------------------------------------------------------------
+// Bootstrap's configuration for the application
+// -----------------------------------------------------------------------------
+// see: ../../node_modules/bootstrap/scss/_variables.scss
+
+// Color system
+
+// You can generate a color scheme with:
+// https://palx.jxnblk.com/
+$blue: #007bff;
+$indigo: #6610f2;
+$purple: #6f42c1;
+$pink: #e83e8c;
+$red: #dc3545;
+$orange: #fd7e14;
+$yellow: #ffc107;
+$green: #28a745;
+$teal: #20c997;
+$cyan: #17a2b8;
+
+// Add 'error' as an alternative to 'danger' since it is used by Django.
+$theme-colors: (
+  "error": $red
+);
--- a/assets/scss/abstracts/_variables.scss
+++ b/assets/scss/abstracts/_variables.scss
@ -0,0 +1,8 @@
				@@ -0,0 +1,8 @@
+// -----------------------------------------------------------------------------
+// Application-wide variables
+// -----------------------------------------------------------------------------
+
+/// Path to fonts and images folders, relative to css/app.css.
+/// @type String
+$font-path: "../fonts";
+$img-path: "../img";
--- a/assets/scss/app.scss
+++ b/assets/scss/app.scss
@ -0,0 +1,21 @@
				@@ -0,0 +1,21 @@
+@charset "utf-8";
+
+// Configuration and helpers
+@import "abstracts/variables";
+@import "abstracts/variables-bootstrap";
+
+// Vendors
+@import "vendor/bootstrap";
+
+// Base styles
+@import "base/fonts";
+
+// Layout-related sections
+//@import "layout/header";
+//@import "layout/footer";
+
+// Components
+@import "components/forms";
+
+// Page-specific styles
+//@import "pages/home";
--- a/assets/scss/base/_fonts.scss
+++ b/assets/scss/base/_fonts.scss
@ -0,0 +1,3 @@
				@@ -0,0 +1,3 @@
+// -----------------------------------------------------------------------------
+// Font faces declarations
+// -----------------------------------------------------------------------------
--- a/assets/scss/components/_forms.scss
+++ b/assets/scss/components/_forms.scss
@ -0,0 +1,9 @@
				@@ -0,0 +1,9 @@
+// -----------------------------------------------------------------------------
+// Forms component's extension
+// -----------------------------------------------------------------------------
+
+// Indicate that a form field is required.
+.required {
+  font-size: 90%;
+  color: $danger;
+}
--- a/assets/scss/fork-awesome.scss
+++ b/assets/scss/fork-awesome.scss
@ -0,0 +1,12 @@
				@@ -0,0 +1,12 @@
+@charset "utf-8";
+
+// Configuration and helpers
+@import "abstracts/variables";
+
+// Fork Awesome
+// ------------
+// @link https://forkawesome.github.io/
+
+$fa-font-path: "#{$font-path}/fork-awesome";
+
+@import "fork-awesome/scss/fork-awesome";
--- a/assets/scss/vendor/_bootstrap.scss
+++ b/assets/scss/vendor/_bootstrap.scss
@ -0,0 +1,48 @@
				@@ -0,0 +1,48 @@
+// ----------------------------------------------------------------------------
+// Bootstrap 4
+// ----------------------------------------------------------------------------
+// see: ../../node_modules/bootstrap/scss/bootstrap.scss
+
+/// Import all Bootstrap components
+
+@import "bootstrap/scss/bootstrap";
+
+/// ... or import them individually
+
+//@import "bootstrap/scss/functions";
+//@import "bootstrap/scss/variables";
+//@import "bootstrap/scss/mixins";
+//@import "bootstrap/scss/root";
+//@import "bootstrap/scss/reboot";
+//@import "bootstrap/scss/type";
+//@import "bootstrap/scss/images";
+//@import "bootstrap/scss/code";
+//@import "bootstrap/scss/grid";
+//@import "bootstrap/scss/tables";
+//@import "bootstrap/scss/forms";
+//@import "bootstrap/scss/buttons";
+//@import "bootstrap/scss/transitions";
+//@import "bootstrap/scss/dropdown";
+//@import "bootstrap/scss/button-group";
+//@import "bootstrap/scss/input-group";
+//@import "bootstrap/scss/custom-forms";
+//@import "bootstrap/scss/nav";
+//@import "bootstrap/scss/navbar";
+//@import "bootstrap/scss/card";
+//@import "bootstrap/scss/breadcrumb";
+//@import "bootstrap/scss/pagination";
+//@import "bootstrap/scss/badge";
+//@import "bootstrap/scss/jumbotron";
+//@import "bootstrap/scss/alert";
+//@import "bootstrap/scss/progress";
+//@import "bootstrap/scss/media";
+//@import "bootstrap/scss/list-group";
+//@import "bootstrap/scss/close";
+//@import "bootstrap/scss/toasts";
+//@import "bootstrap/scss/modal";
+//@import "bootstrap/scss/tooltip";
+//@import "bootstrap/scss/popover";
+//@import "bootstrap/scss/carousel";
+//@import "bootstrap/scss/spinners";
+//@import "bootstrap/scss/utilities";
+//@import "bootstrap/scss/print";
--- a/benevalibre/init.py
+++ b/benevalibre/init.py
@ -0,0 +1 @@
				@@ -0,0 +1 @@
+__version__ = '0.1.0'
--- a/benevalibre/base/init.py
+++ b/benevalibre/base/init.py
@ -0,0 +1 @@
				@@ -0,0 +1 @@
+default_app_config = 'benevalibre.base.apps.BaseConfig'
--- a/benevalibre/base/apps.py
+++ b/benevalibre/base/apps.py
@ -0,0 +1,6 @@
				@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class BaseConfig(AppConfig):
+    name = 'benevalibre.base'
+    verbose_name = "Base"
--- a/benevalibre/base/templatetags/init.py
+++ b/benevalibre/base/templatetags/init.py
--- a/benevalibre/base/templatetags/minified.py
+++ b/benevalibre/base/templatetags/minified.py
@ -0,0 +1,33 @@
				@@ -0,0 +1,33 @@
+import functools
+import os.path
+
+from django import template
+from django.conf import settings
+from django.contrib.staticfiles import finders
+from django.templatetags.static import static
+
+register = template.Library()
+
+
+@functools.lru_cache(maxsize=None)
+def get_minified_static_path(path):
+    """Retourne de préférence le chemin d'un fichier compressé.
+
+    Détermine et retourne le chemin relatif à utiliser pour le fichier
+    statique `path`, en fonction de l'environnement. Si elle existe, la
+    version compressée (e.g. avec le suffixe `.min` avant l'extension) du
+    fichier sera retournée quand le débogage est désactivé.
+    """
+    if settings.DEBUG:
+        return path
+    root, ext = os.path.splitext(path)
+    min_path = '{}.min{}'.format(root, ext or '')
+    if finders.find(min_path):
+        return min_path
+    return path
+
+
+@register.simple_tag
+def minified(path):
+    """Retourne le chemin absolu d'un fichier statique compressé."""
+    return static(get_minified_static_path(path))
--- a/benevalibre/base/tests/init.py
+++ b/benevalibre/base/tests/init.py
--- a/benevalibre/base/tests/test_templatetags.py
+++ b/benevalibre/base/tests/test_templatetags.py
@ -0,0 +1,15 @@
				@@ -0,0 +1,15 @@
+import pytest
+
+from ..templatetags.minified import get_minified_static_path
+
+
+@pytest.mark.parametrize(
+    'path, result',
+    [
+        ('css/app.css', 'css/app.min.css'),
+        ('path/to/file.ext', 'path/to/file.ext'),
+        ('path/to/file', 'path/to/file'),
+    ],
+)
+def test_get_minified_static_path(path, result):
+    assert get_minified_static_path(path) == result
--- a/benevalibre/base/urls.py
+++ b/benevalibre/base/urls.py
@ -0,0 +1,7 @@
				@@ -0,0 +1,7 @@
+from django.urls import path
+from django.views.generic import TemplateView
+
+urlpatterns = [
+    path('', TemplateView.as_view(template_name='pages/home.html'),
+         name='home'),
+]
--- a/benevalibre/settings/init.py
+++ b/benevalibre/settings/init.py
@ -0,0 +1,22 @@
				@@ -0,0 +1,22 @@
+import environ
+
+"""The default environment to use."""
+DEFAULT_ENVIRONMENT = 'production'
+
+"""The environment variables of the app instance."""
+env = environ.Env()
+
+"""Path to the package root - e.g. Django project."""
+root_dir = environ.Path(__file__) - 2
+
+"""Path to the base directory of the app instance."""
+base_dir = env.path('BASE_DIR', default=str(root_dir - 1))
+
+# Load config.env, OS environment variables will take precedence
+if env.bool('READ_CONFIG_FILE', default=True):
+    env.read_env(str(base_dir.path('config.env')))
+
+"""The Django settings module's name to use."""
+DJANGO_SETTINGS_MODULE = env(
+    'DJANGO_SETTINGS_MODULE', default='benevalibre.settings.{}'.format(env(
+        'ENV', default=DEFAULT_ENVIRONMENT)))
--- a/benevalibre/settings/base.py
+++ b/benevalibre/settings/base.py
@ -0,0 +1,235 @@
				@@ -0,0 +1,235 @@
+"""
+Django settings for Bénévalibre project.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/stable/topics/settings/
+
+For the full list of settings and their values, see
+https://docs.djangoproject.com/en/stable/ref/settings/
+"""
+import os.path
+
+from . import env, base_dir, root_dir
+
+# ENVIRONMENT VARIABLES AND PATHS
+# ------------------------------------------------------------------------------
+
+# Local directory used for static and templates overrides
+local_dir = base_dir.path('local')
+
+# Directory for variable stuffs, i.e. user-uploaded media
+var_dir = base_dir.path('var')
+if not os.path.isdir(var_dir()):
+    os.mkdir(var_dir(), mode=0o755)
+
+# Location on which the application is served
+APP_LOCATION = env('APP_LOCATION', default='/')
+
+# GENERAL
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#debug
+DEBUG = env.bool('DJANGO_DEBUG', default=True)
+
+# Local time zone for this installation
+TIME_ZONE = 'Europe/Paris'
+
+# https://docs.djangoproject.com/en/stable/ref/settings/#language-code
+LANGUAGE_CODE = 'fr'
+
+# https://docs.djangoproject.com/en/dev/ref/settings/#site-id
+SITE_ID = 1
+
+# https://docs.djangoproject.com/en/stable/ref/settings/#use-i18n
+USE_I18N = True
+# https://docs.djangoproject.com/en/stable/ref/settings/#use-l10n
+USE_L10N = True
+# https://docs.djangoproject.com/en/stable/ref/settings/#use-tz
+USE_TZ = True
+
+# DATABASES
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#databases
+# https://django-environ.readthedocs.io/en/stable/#supported-types
+DATABASES = {
+    'default': env.db('DJANGO_DATABASE_URL', default='sqlite:///{}'.format(
+        base_dir('sqlite.db')
+    )),
+}
+
+# URLS
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#root-urlconf
+ROOT_URLCONF = 'benevalibre.urls'
+# https://docs.djangoproject.com/en/stable/ref/settings/#wsgi-application
+WSGI_APPLICATION = 'benevalibre.wsgi.application'
+
+# APP CONFIGURATION
+# ------------------------------------------------------------------------------
+DJANGO_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+]
+
+# Project dependencies
+THIRD_PARTY_APPS = []
+
+# Project applications
+LOCAL_APPS = [
+    'benevalibre.base',
+]
+
+# https://docs.djangoproject.com/en/stable/ref/settings/#installed-apps
+INSTALLED_APPS = DJANGO_APPS + THIRD_PARTY_APPS + LOCAL_APPS
+
+# PASSWORDS
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#password-hashers
+PASSWORD_HASHERS = [
+    # https://docs.djangoproject.com/en/stable/topics/auth/passwords/#using-argon2-with-django
+    # 'django.contrib.auth.hashers.Argon2PasswordHasher',
+    'django.contrib.auth.hashers.PBKDF2PasswordHasher',
+    'django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher',
+    'django.contrib.auth.hashers.BCryptSHA256PasswordHasher',
+    'django.contrib.auth.hashers.BCryptPasswordHasher',
+]
+
+# https://docs.djangoproject.com/en/stable/topics/auth/passwords/#password-validation
+AUTH_PASSWORD_VALIDATORS = [
+    {
+        'NAME': ('django.contrib.auth.password_validation.'
+                 'UserAttributeSimilarityValidator'),
+    },
+    {
+        'NAME': ('django.contrib.auth.password_validation.'
+                 'MinimumLengthValidator'),
+    },
+    {
+        'NAME': ('django.contrib.auth.password_validation.'
+                 'CommonPasswordValidator'),
+    },
+    {
+        'NAME': ('django.contrib.auth.password_validation.'
+                 'NumericPasswordValidator'),
+    },
+]
+
+# MIDDLEWARE
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#middleware
+MIDDLEWARE = [
+    'django.middleware.security.SecurityMiddleware',
+    'django.contrib.sessions.middleware.SessionMiddleware',
+    'django.middleware.common.CommonMiddleware',
+    'django.middleware.csrf.CsrfViewMiddleware',
+    'django.contrib.auth.middleware.AuthenticationMiddleware',
+    'django.contrib.messages.middleware.MessageMiddleware',
+    'django.middleware.clickjacking.XFrameOptionsMiddleware',
+]
+
+# STATIC
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#static-files
+STATIC_ROOT = var_dir('static')
+
+# https://docs.djangoproject.com/en/stable/ref/settings/#static-url
+STATIC_URL = os.path.join(APP_LOCATION, 'static/')
+
+# https://docs.djangoproject.com/en/stable/ref/settings/#staticfiles-dirs
+STATICFILES_DIRS = [
+    root_dir('static'),
+]
+if os.path.isdir(local_dir('static')):
+    STATICFILES_DIRS.insert(0, local_dir('static'))
+
+# https://docs.djangoproject.com/en/stable/ref/contrib/staticfiles/#staticfiles-finders
+STATICFILES_FINDERS = [
+    'django.contrib.staticfiles.finders.FileSystemFinder',
+    'django.contrib.staticfiles.finders.AppDirectoriesFinder',
+]
+
+# MEDIA
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#media-root
+MEDIA_ROOT = var_dir('media')
+
+# https://docs.djangoproject.com/en/stable/ref/settings/#media-url
+MEDIA_URL = os.path.join(APP_LOCATION, 'media/')
+
+# https://docs.djangoproject.com/en/stable/ref/settings/#file-upload-directory-permissions
+FILE_UPLOAD_DIRECTORY_PERMISSIONS = 0o755
+# https://docs.djangoproject.com/en/stable/ref/settings/#file-upload-permissions
+FILE_UPLOAD_PERMISSIONS = 0o644
+
+# TEMPLATES
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#templates
+TEMPLATES = [
+    {
+        'BACKEND': 'django.template.backends.django.DjangoTemplates',
+        'DIRS': [
+            root_dir('templates'),
+        ],
+        'OPTIONS': {
+            'debug': DEBUG,
+            'loaders': [
+                'django.template.loaders.filesystem.Loader',
+                'django.template.loaders.app_directories.Loader',
+            ],
+            'context_processors': [
+                'django.template.context_processors.debug',
+                'django.template.context_processors.request',
+                'django.contrib.auth.context_processors.auth',
+                'django.template.context_processors.media',
+                'django.template.context_processors.static',
+                'django.template.context_processors.tz',
+                'django.contrib.messages.context_processors.messages',
+            ],
+        },
+    },
+]
+if os.path.isdir(local_dir('templates')):
+    TEMPLATES[0]['DIRS'].insert(0, local_dir('templates'))
+
+# FIXTURES
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#fixture-dirs
+FIXTURE_DIRS = (
+    root_dir('fixtures'),
+)
+
+# EMAIL
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/topics/email/#email-backends
+# https://django-environ.readthedocs.io/en/stable/#supported-types
+vars().update(env.email_url(
+    'DJANGO_EMAIL_URL', default='smtp://localhost:25'))
+
+DEFAULT_FROM_EMAIL = env('DEFAULT_FROM_EMAIL', default='webmaster@localhost')
+# Use the same email address for error messages
+SERVER_EMAIL = DEFAULT_FROM_EMAIL
+
+# ADMIN
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#admins
+ADMINS = [
+    ("""Cliss XXI""", 'tech@cliss21.com'),
+]
+
+# https://docs.djangoproject.com/en/stable/ref/settings/#managers
+MANAGERS = ADMINS
+
+# SESSIONS AND COOKIES
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#session-cookie-path
+SESSION_COOKIE_PATH = APP_LOCATION
+
+# https://docs.djangoproject.com/en/stable/ref/settings/#csrf-cookie-path
+CSRF_COOKIE_PATH = APP_LOCATION
+
+# ------------------------------------------------------------------------------
+# APPLICATION AND 3RD PARTY LIBRARY SETTINGS
+# ------------------------------------------------------------------------------
--- a/benevalibre/settings/development.py
+++ b/benevalibre/settings/development.py
@ -0,0 +1,53 @@
				@@ -0,0 +1,53 @@
+"""
+Development settings.
+
+- use Console backend for emails sending by default
+- add the django-debug-toolbar
+"""
+from .base import *  # noqa
+from .base import env
+
+# GENERAL
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#secret-key
+SECRET_KEY = env('DJANGO_SECRET_KEY', default='CHANGEME!!!')
+
+# https://docs.djangoproject.com/en/stable/ref/settings/#allowed-hosts
+ALLOWED_HOSTS = env.list('DJANGO_ALLOWED_HOSTS', default=[
+    'localhost',
+    '0.0.0.0',
+    '127.0.0.1',
+])
+
+# EMAIL
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/topics/email/#email-backends
+# https://django-environ.readthedocs.io/en/stable/#supported-types
+vars().update(env.email_url(
+    'DJANGO_EMAIL_URL', default='consolemail://'))
+
+# ------------------------------------------------------------------------------
+# APPLICATION AND 3RD PARTY LIBRARY SETTINGS
+# ------------------------------------------------------------------------------
+
+# DJANGO DEBUG TOOLBAR
+# ------------------------------------------------------------------------------
+# https://django-debug-toolbar.readthedocs.io/en/stable/installation.html
+MIDDLEWARE += ['debug_toolbar.middleware.DebugToolbarMiddleware']  # noqa: F405
+INSTALLED_APPS += ['debug_toolbar']  # noqa: F405
+
+INTERNAL_IPS = ['127.0.0.1']
+
+DEBUG_TOOLBAR_CONFIG = {
+    'DISABLE_PANELS': [
+        'debug_toolbar.panels.redirects.RedirectsPanel',
+    ],
+    'SHOW_TEMPLATE_CONTEXT': True,
+    # Uncomment if jQuery is already loaded by your assets:
+    # 'JQUERY_URL': '',
+}
+
+# DJANGO EXTENSIONS
+# ------------------------------------------------------------------------------
+# https://django-extensions.readthedocs.io/en/stable/index.html
+INSTALLED_APPS += ['django_extensions']  # noqa: F405
--- a/benevalibre/settings/production.py
+++ b/benevalibre/settings/production.py
@ -0,0 +1,103 @@
				@@ -0,0 +1,103 @@
+"""
+Production settings.
+
+- validate the configuration
+- disable debug mode
+- load secret key from environment variables
+- set other production configurations
+"""
+import os
+
+from django.core.exceptions import ImproperlyConfigured
+
+from .base import *  # noqa
+from .base import env, var_dir
+
+# CONFIGURATION VALIDATION
+# ------------------------------------------------------------------------------
+# Ensure that the database configuration has been set
+if not env('DJANGO_DATABASE_URL', default=None):
+    raise ImproperlyConfigured(
+        "No database configuration has been set, you should check "
+        "the value of your DATABASE_URL environment variable."
+    )
+
+# Ensure that the default email address has been set
+if not env('DEFAULT_FROM_EMAIL', default=None):
+    raise ImproperlyConfigured(
+        "No default email address has been set, you should check "
+        "the value of your DEFAULT_FROM_EMAIL environment variable."
+    )
+
+# GENERAL
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#debug
+DEBUG = False
+
+# https://docs.djangoproject.com/en/stable/ref/settings/#secret-key
+SECRET_KEY = env('DJANGO_SECRET_KEY')
+
+# https://docs.djangoproject.com/en/stable/ref/settings/#allowed-hosts
+ALLOWED_HOSTS = env.list('DJANGO_ALLOWED_HOSTS', default=[])
+
+# TEMPLATES
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#templates
+TEMPLATES[0]['OPTIONS']['debug'] = DEBUG  # noqa F405
+TEMPLATES[0]['OPTIONS']['loaders'] = [  # noqa F405
+    ('django.template.loaders.cached.Loader', [
+        'django.template.loaders.filesystem.Loader',
+        'django.template.loaders.app_directories.Loader',
+    ]),
+]
+
+# LOGGING
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/topics/logging/
+LOGGING = {
+    'version': 1,
+    'disable_existing_loggers': False,
+    'formatters': {
+        'verbose': {
+            'format': '%(asctime)s - %(levelname)s - %(module)s: %(message)s',
+        },
+    },
+    'handlers': {
+        'mail_admins': {
+            'level': 'ERROR',
+            'class': 'django.utils.log.AdminEmailHandler'
+        },
+        'file': {
+            'level': 'DEBUG',
+            'class': 'logging.handlers.TimedRotatingFileHandler',
+            'filename': var_dir('log/benevalibre.log'),
+            'formatter': 'verbose',
+            'when': 'midnight',
+            'interval': 1,
+            'backupCount': 30,
+        },
+    },
+    'loggers': {
+        'django': {
+            'level': 'WARNING',
+            'handlers': ['file'],
+            'propagate': True,
+        },
+        'django.request': {
+            'level': 'WARNING',
+            'handlers': ['file', 'mail_admins'],
+            'propagate': True,
+        },
+        'benevalibre': {
+            'level': 'INFO',
+            'handlers': ['file', 'mail_admins'],
+            'propagate': True,
+        },
+    },
+}
+if not os.path.isdir(var_dir('log')):
+    os.mkdir(var_dir('log'), mode=0o750)
+
+# ------------------------------------------------------------------------------
+# APPLICATION AND 3RD PARTY LIBRARY SETTINGS
+# ------------------------------------------------------------------------------
--- a/benevalibre/settings/test.py
+++ b/benevalibre/settings/test.py
@ -0,0 +1,54 @@
				@@ -0,0 +1,54 @@
+"""
+With these settings, tests run faster.
+"""
+from .base import *  # noqa
+from .base import env
+
+# GENERAL
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#debug
+DEBUG = False
+
+# https://docs.djangoproject.com/en/stable/ref/settings/#secret-key
+SECRET_KEY = env('DJANGO_SECRET_KEY', default='CHANGEME!!!')
+
+# https://docs.djangoproject.com/en/stable/ref/settings/#test-runner
+TEST_RUNNER = 'django.test.runner.DiscoverRunner'
+
+# CACHES
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#caches
+CACHES = {
+    'default': {
+        'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',
+        'LOCATION': '',
+    }
+}
+
+# PASSWORDS
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#password-hashers
+PASSWORD_HASHERS = ['django.contrib.auth.hashers.MD5PasswordHasher']
+
+# TEMPLATES
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#templates
+TEMPLATES[0]['OPTIONS']['debug'] = DEBUG  # noqa: F405
+TEMPLATES[0]['OPTIONS']['loaders'] = [  # noqa: F405
+    (
+        'django.template.loaders.cached.Loader',
+        [
+            'django.template.loaders.filesystem.Loader',
+            'django.template.loaders.app_directories.Loader',
+        ],
+    )
+]
+
+# EMAIL
+# ------------------------------------------------------------------------------
+# https://docs.djangoproject.com/en/stable/ref/settings/#email-backend
+EMAIL_BACKEND = 'django.core.mail.backends.locmem.EmailBackend'
+# https://docs.djangoproject.com/en/stable/ref/settings/#email-host
+EMAIL_HOST = 'localhost'
+# https://docs.djangoproject.com/en/stable/ref/settings/#email-port
+EMAIL_PORT = 1025
--- a/benevalibre/static/css/.gitkeep
+++ b/benevalibre/static/css/.gitkeep
--- a/benevalibre/static/js/.gitkeep
+++ b/benevalibre/static/js/.gitkeep
--- a/benevalibre/templates/404.html
+++ b/benevalibre/templates/404.html
@ -0,0 +1,7 @@
				@@ -0,0 +1,7 @@
+{% extends "base.html" %}
+
+{% block title %}Page introuvable{% endblock %}
+
+{% block content %}
+<p>La page que vous demandez semble introuvable...</p>
+{% endblock %}
--- a/benevalibre/templates/500.html
+++ b/benevalibre/templates/500.html
@ -0,0 +1,7 @@
				@@ -0,0 +1,7 @@
+{% extends "base.html" %}
+
+{% block title %}Erreur interne{% endblock %}
+
+{% block content %}
+<p>Une erreur inattendue est survenue...</p>
+{% endblock %}
--- a/benevalibre/templates/base.html
+++ b/benevalibre/templates/base.html
@ -0,0 +1,44 @@
				@@ -0,0 +1,44 @@
+{% load minified %}<!DOCTYPE html>
+<html class="no-js" lang="fr">
+  <head>
+    <meta charset="utf-8">
+    <meta http-equiv="x-ua-compatible" content="ie=edge">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+    <title>
+      {% block title %}{% endblock %}
+      {% block title_suffix %}- Bénévalibre{% endblock %}
+    </title>
+
+    <meta name="description" content="">
+    <meta name="keywords" content="">
+
+    {% block css %}
+    <link rel="stylesheet" href="{% minified "css/fork-awesome.css" %}">
+    <link rel="stylesheet" href="{% minified "css/app.css" %}">
+    {% endblock %}
+
+    {% block extra_head %}{% endblock %}
+  </head>
+  <body>
+    <div class="container">
+
+      {% if messages %}
+        {% for message in messages %}
+          <div class="alert{% if message.tags %} {{ message.tags }}{% endif %}">{{ message }}</div>
+        {% endfor %}
+      {% endif %}
+
+      {% block content %}
+      <p>Utilisez ce modèle pour démarrer rapidement une nouvelle application.</p>
+      {% endblock %}
+
+    </div><!-- .container -->
+
+    {% block modal %}{% endblock %}
+
+    {% block javascript %}
+    <script src="{% minified "js/app.js" %}"></script>
+    {% endblock %}
+  </body>
+</html>
--- a/benevalibre/templates/pages/home.html
+++ b/benevalibre/templates/pages/home.html
@ -0,0 +1,8 @@
				@@ -0,0 +1,8 @@
+{% extends "base.html" %}
+
+{% block title %}Accueil{% endblock %}
+
+{% block content %}
+<h1>Bienvenue !</h1>
+<p>Cette page ne dira pas grand chose de plus, à vous de la personnaliser.</p>
+{% endblock content %}
--- a/benevalibre/urls.py
+++ b/benevalibre/urls.py
@ -0,0 +1,37 @@
				@@ -0,0 +1,37 @@
+from django.conf import settings
+from django.contrib import admin
+from django.urls import include, path
+
+from .base import urls as base_urls
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+
+    # Local applications
+    # ...
+]
+
+if settings.DEBUG:
+    from django.conf.urls.static import static
+    from django.views import defaults as default_views
+
+    # This allows the error pages to be debugged during development, just visit
+    # these url in browser to see how these error pages look like.
+    urlpatterns += [
+        path('400/', default_views.bad_request,
+             kwargs={'exception': Exception('Bad Request!')}),
+        path('403/', default_views.permission_denied,
+             kwargs={'exception': Exception('Permission Denied')}),
+        path('404/', default_views.page_not_found,
+             kwargs={'exception': Exception('Page not Found')}),
+        path('500/', default_views.server_error),
+    ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
+
+    if 'debug_toolbar' in settings.INSTALLED_APPS:
+        import debug_toolbar
+        urlpatterns.insert(0, path('__debug__/', include(debug_toolbar.urls)))
+
+# Root application
+urlpatterns += [
+    path('', include(base_urls)),
+]
--- a/benevalibre/wsgi.py
+++ b/benevalibre/wsgi.py
@ -0,0 +1,21 @@
				@@ -0,0 +1,21 @@
+"""
+WSGI config for Bénévalibre project.
+
+This module contains the WSGI application used by Django's development server
+and any production WSGI deployments. It should expose a module-level variable
+named ``application``. Django's ``runserver`` and ``runfcgi`` commands discover
+this application via the ``WSGI_APPLICATION`` setting.
+"""
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+from benevalibre.settings import DJANGO_SETTINGS_MODULE
+
+# Set the default settings module to use.
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', DJANGO_SETTINGS_MODULE)
+
+# This application object is used by any WSGI server configured to use this
+# file. This includes Django's development server, if the WSGI_APPLICATION
+# setting points here.
+application = get_wsgi_application()
--- a/config.env.example
+++ b/config.env.example
@ -0,0 +1,84 @@
				@@ -0,0 +1,84 @@
+###########################################################
+#                                                         #
+#  Edit the following configuration to suits your needs.  #
+#                                                         #
+###########################################################
+
+# Environment to use within the application.
+#
+# The environment is used to load the proper settings for your application
+# instance. There is two ways for defining it, with the following precedence:
+#  - DJANGO_SETTINGS_MODULE: the Python path to the settings module to use. It
+#      allows you to define and use your own settings module. Use it with care!
+#      Note: the module name will be used as the environment.
+#  - ENV: the environment to use, which is one of 'production' or 'development'.
+#
+# Default is the 'production' environment.
+#ENV=production
+#ENV=development
+
+# The secret key used to provide cryptographic signing.
+#
+# It should be set to a unique, unpredictable value. On a GNU/Linux system, you
+# could generate a new one with:
+#
+#     $ head -c50 /dev/urandom | base64
+#
+# /!\ Required in production.
+#DJANGO_SECRET_KEY=CHANGEME!!!
+
+# A coma-separated string representing the host/domain names that this
+# application instance can serve.
+#
+# /!\ Required in production.
+#DJANGO_ALLOWED_HOSTS=example.org,
+
+# Database configuration, as an URI.
+#
+# In production, the recommended database backend for better performances is
+# PostgreSQL - or MySQL if you prefer.
+#
+# Default is a SQLite database in development only.
+#
+# /!\ Required in production.
+#DJANGO_DATABASE_URL=postgres://user:password@127.0.0.1:5432/benevalibre
+#DJANGO_DATABASE_URL=mysql://user:password@127.0.0.1:3306/benevalibre
+
+# Email configuration for sending messages, as an URI.
+#
+# In production, you should either use a local SMTP server or a relay one. The
+# URI will be in that case of the form:
+#
+#     PROTOCOL://[USER:PASSWORD@]HOST[:PORT]
+#
+# PROTOCOL can be smtp, smtp+ssl or smtp+tls. Note that special characters
+# in USER and PASSWORD - e.g. @ - must be escaped. It can be achieve with:
+#
+#     $ python3 -c 'from urllib.parse import quote as q;print(q("USER")+":"+q("PASSWORD"))'
+#
+# Default is the local SMTP server in production and the console in development.
+#DJANGO_EMAIL_URL=smtp://localhost:25
+
+# Default email address to use for various automated correspondence.
+#
+# /!\ Required in production.
+#DEFAULT_FROM_EMAIL=webmaster@example.org
+
+# URL prefix on which the application is served.
+#
+# This is used to generate the static and media URLs, but also links to the
+# application which require an absolute URL.
+#
+# Default is '/', e.g. at the domain root.
+#APP_LOCATION=/
+
+# Base directory of the app instance, where the local and var folders are
+# located.
+#
+# Default is the current directory.
+#BASE_DIR=
+
+# Turn on/off debug mode.
+#
+# Note that it's always disabled in production.
+#DJANGO_DEBUG=off
--- a/gulpfile.js
+++ b/gulpfile.js
@ -0,0 +1,268 @@
				@@ -0,0 +1,268 @@
+const gulp = require('gulp');
+const plugins = require('gulp-load-plugins');
+const merge = require('merge-stream');
+const sherpa = require('style-sherpa');
+const named = require('vinyl-named');
+const webpack = require('webpack');
+const webpackStream = require('webpack-stream');
+
+const browser = require('browser-sync').create();
+
+// Load all Gulp plugins into one variable
+const $ = plugins();
+
+/// Configuration -------------------------------------------------------------
+
+const CONFIG = {
+  // Proxy target of the BrowserSync'server
+  SERVER_PROXY: 'http://127.0.0.1:8000',
+
+  // Port on which the BrowserSync'server will listen
+  SERVER_PORT: 8090,
+
+  // Paths to other assets which will be copied
+  ASSETS_FILES: [
+    {
+      src: [
+        'assets/**/*',
+        '!assets/{img,js,scss}',
+        '!assets/{img,js,scss}/**/*'
+      ],
+      dest: ''
+    },
+    {
+      // ForkAwesome
+      src: 'node_modules/fork-awesome/fonts/*',
+      dest: 'fonts/fork-awesome'
+    }
+  ],
+
+  // Paths to images which will be compressed and copied
+  IMAGES_FILES: [
+    'assets/img/**/*'
+  ],
+
+  // Paths to JavaScript entries which will be bundled
+  JS_ENTRIES: [
+    'assets/js/app.js'
+  ],
+
+  // Paths to Sass files which will be compiled
+  SASS_ENTRIES: [
+    'assets/scss/app.scss',
+    'assets/scss/fork-awesome.scss'
+  ],
+
+  // Paths to Sass libraries, which can then be loaded with @import
+  SASS_INCLUDE_PATHS: [
+    'node_modules'
+  ],
+
+  // Path to the build output, which will never be cleaned
+  BUILD_PATH: 'benevalibre/static'
+};
+
+/// CSS -----------------------------------------------------------------------
+
+// Compile Sass into CSS.
+gulp.task('sass', function() {
+  return gulp.src(CONFIG.SASS_ENTRIES)
+    .pipe($.sourcemaps.init())
+    .pipe($.sass({
+      includePaths: CONFIG.SASS_INCLUDE_PATHS
+    }).on('error', $.sass.logError))
+    .pipe($.autoprefixer())
+    .pipe($.sourcemaps.write('.'))
+    .pipe(gulp.dest(`${CONFIG.BUILD_PATH}/css`))
+    .pipe(browser.reload({ stream: true }));
+});
+
+// Lint Sass files.
+gulp.task('lint:sass', function() {
+  return gulp.src('assets/scss/**/*.scss')
+    .pipe($.stylelint({
+      failAfterError: true,
+      reporters: [
+        { formatter: 'verbose', console: true }
+      ]
+    }));
+});
+
+// Compress CSS files.
+gulp.task('compress:css', function() {
+  return gulp.src([
+      `${CONFIG.BUILD_PATH}/css/*.css`,
+      `!${CONFIG.BUILD_PATH}/css/*.min.css`
+    ])
+    .pipe($.cleanCss())
+    .pipe($.rename({ suffix: '.min' }))
+    .pipe(gulp.dest(`${CONFIG.BUILD_PATH}/css`));
+});
+
+gulp.task('css',
+  gulp.series('sass', 'compress:css'));
+
+/// JavaScript ----------------------------------------------------------------
+
+let webpackConfig = {
+  devtool: 'source-map',
+  mode: 'development',
+  module: {
+    rules: [
+      {
+        test: /.js$/,
+        use: {
+          loader: 'babel-loader',
+          options: {
+            presets: ['@babel/preset-env'],
+            compact: false
+          }
+        }
+      }
+    ]
+  },
+  stats: {
+    chunks: false,
+    entrypoints: false,
+  }
+}
+
+// Bundle JavaScript module.
+gulp.task('javascript', function() {
+  return gulp.src(CONFIG.JS_ENTRIES)
+    .pipe(named())
+    .pipe(webpackStream(webpackConfig, webpack))
+    .pipe(gulp.dest(`${CONFIG.BUILD_PATH}/js`));
+});
+
+// Lint JavaScript source files.
+gulp.task('lint:javascript', function() {
+  return gulp.src('assets/js/**/*.js')
+    .pipe($.eslint())
+    .pipe($.eslint.format())
+    .pipe($.eslint.failAfterError());
+});
+
+// Compress JavaScript files.
+gulp.task('compress:javascript', function() {
+  return gulp.src([
+      `${CONFIG.BUILD_PATH}/js/*.js`,
+      `!${CONFIG.BUILD_PATH}/js/*.min.js`
+    ])
+    .pipe($.terser().on('error', e => { console.log(e); }))
+    .pipe($.rename({ suffix: '.min' }))
+    .pipe(gulp.dest(`${CONFIG.BUILD_PATH}/js`));
				`@ -0,0 +1 @@` @@ -0,0 +1 @@
				`This software is developped by Cliss XXI.`
				`@ -0,0 +1 @@` @@ -0,0 +1 @@
				`default_app_config = 'benevalibre.base.apps.BaseConfig'`