Administrans est un outil en ligne permettant de générer des fichiers pdf pour faire des attestations pour les changements de prénoms ainsi que des lettres pour demander les changements suite à un changement de prénom/mention genre. Il a pour but de faciliter les démarches administratives des personnes transgenre en France.
Administrans, anciennement trans-cec permet de générer des fichiers PDF à partir d'un formulaire Django en utilisant django-tex. Il s'agit d'un fork du project de Maria Climent-Pommeret
| Auteur.ice | Licence |
|---|---|
| Maria Climent-Pommeret | Licence MIT |
| Mainteneur.euse(s) | Tâche(s) | Contact |
|---|---|---|
| Emy Canton | all | github |
Pour l'instant, sont gérées :
- les lettres polies de demande de changement de prénom et de civilité
- les lettres de relance en cas d'absence de réponse (satisfaisante)
Les différents modes :
- par procuration (génère une procuration + la lettre de demande à faire envoyer par un.e cis de l'entourage qui pourra gérer les tracas administratifs, pour pas que vous ayez a gérer vous même cette merde)
- [to come] les lettres si vous souhaitez le faire vous même.
Si changement de prénom à l'EC
- Carte de transport
- CNI/passeport
- Permis de conduire
- Impôts
- Médecins
- Mutuelle
- Carte de groupe sanguin/donneur.se d'organes
- MDPH
- Électricité/gaz/eau
- Opérateur téléphonique/Internet
- Carte d'électeur.rice
- Livret de famille
Si changement de mention de sexe à l'État-Civil (pas encore pris en charge) :
- CNI/passeport
- Permis de conduire
- Numéro INSEE
- Numéro de sécurité sociale
- Livret de famille
- Python>=3.10 (Latest tested with)
- django-tex
- jinja2-django-tags
- texlive-full (pour la génération du PDF à partir de .tex)
Installer docker et docker-compose
$ sudo apt install docker docker-composeL'environnement de dev se base sur les valeurs présentes dans le fichier .env.dev
Pour lancer l'environnement avec docker-compose:
$ docker-compose up -d --buildL'option --build permet de re-build l'image pour qu'elle soit à jour.
L'option -d permet de passer en mode daemon.
Afficher les logs:
$ docker-compose logs<
8000
/div>
Arrêter l'environnement:
$ docker-compose down -vCommencer par créer le fichier d'environnement de Prod .env.prod:
DEBUG=0
SECRET_KEY=CHANGE_ME
DJANGO_ALLOWED_HOSTS=localhost 127.0.0.1 [::1]
CSRF_TRUSTED_ORIGINS=https://your-domain.com
NGINX_HOST=your-domain.com
CERTIF_EMAIL=email@example.orgCette solution est la plus facile à utiliser si vous n'avez pas d'autres services sur la machine. Elle permet de lancer trans-cec avec gunicorn et nginx en reverse proxy. Le tout avec certbot pour gérer automatiquement le HTTPS.
Pour permettre à TLS de fonctionner correctement, il faudra lancer le script d'init:
$ sudo bash ./init-letsencrypt.shPuis changer l'owner des fichiers dans ./nginx/data/
$ chown $USER:$USER -R ./nginx/dataOn peut enfin lancer la prod :
$ docker-compose -f docker-compose.prod_with_nginx.yml up -d --buildSi vous avez déjà votre propre reverse proxy, l'env de prod peut être lancé à l'aide de la commande:
$ docker-compose -f docker-compose.prod.yml up -d --buildLe service tourne sur le port 8000 par défaut.
OUI SVP ! Pour cela, n'hésitez pas à faire des issues github ou bien ouvrir directement des PR sur github
Pour cela les dépendances système requises sont :
- git
- python3.10
- python3-venv
- texlive-full
Il vous reste à configurer et faire fonctionner votre copie locale.
La première étape est de créer un environnement virtuel python afin d'installer les dépendances du projet :
$ python3 -m venv virtualenv
Ensuite, installez les dépendances python requises pour faire fonctionne le projet :
$ virtualenv/bin/pip install -r requirements.txt
Créez votre fichier de configuration :
$ cp mysite/mysite/localsettings.py.dist mysite/mysite/localsettings.py
Éditez le fichier mysite/mysite/localsettings.py et ajoutez une valeur pour SECRET_KEY,
par exemple SECRET_KEY = 'dev'.
Appliquez les migrations
$ virtualenv/bin/python mysite/manage.py migrate
Lancez le serveur de développement :
$ virtualenv/bin/python mysite/manage.py runserver
Le projet est démarré et accessible à l'adresse http://127.0.0.1:8000/ :)
Des tests unitaires sont disponibles pour ce projet. Si vous modifiez du code, vous pouvez les lancer pour vérifier que vous n'avez rien cassé :
$ cd mysite
$ pytest tests
Un grand merci à toutes ces personnes qui ont fait des tests, bugs reports, merge requests, corrections orthographiques et montré du soutien \o/ :
- Emy Canton
- Alice Climent-Pommeret
- Sasha Emily Chelsea Murgia
- Aurore Moisy-Mabille
- Agate Berriot
- Une autre Alice
- Freyja Wildes
- Misc