Proposition de fonctionnalité : création d’email automatique

jdauphant commented 4 years ago

Proposition (Par Anne-So)

[x] 1. La nouvelle recrue de la communauté clique sur un bouton “Créer un compte”
[x] 2. Il remplit un formulaire (nom, prénom, date de début et de fin de mission, email pro ou perso...)
[x] 3. Ça fait une PR sur Github pour créer la fiche (grosse valeur ajoutée car c’est une manipulation très fastidieuse pour tous les non devs de la communauté)
[x] 4. Ça créé l’email
[x] 5. Ça assigne un marrain ou une parraine (#391)

jdauphant commented 4 years ago

Analyse technique : Pour créer le fiche utilisateur :

API Github : récupérer le SHA du master du repo beta.gouv.fr

curl \
-H "Accept: application/vnd.github.v3+json" \
https://api.github.com/repos/betagouv/beta.gouv.fr/git/ref/heads/master

{
"ref": "refs/heads/master",
"node_id": "MDM6UmVmNDgyMzcwMDY6cmVmcy9oZWFkcy9tYXN0ZXI=",
"url": "https://api.github.com/repos/betagouv/beta.gouv.fr/git/refs/heads/master",
"object": {
"sha": "afb50522d4da0198d3a007cb8600daa5c4b9244c",
"type": "commit",
"url": "https://api.github.com/repos/betagouv/beta.gouv.fr/git/commits/afb50522d4da0198d3a007cb8600daa5c4b9244c"
}
}

API Github créé une branche avec ce SHA (les références de commit sont valable à travers tous les forks) sur le repo du compte pour le bot : https://docs.github.com/en/rest/reference/git#create-a-reference
API Github pour créer un fichier sur cette nouvelle branche : https://docs.github.com/en/rest/reference/repos#create-or-update-file-contents
API Github pour ouvrir une pull request de cette branche vers le repo beta.gouv.fr : https://docs.github.com/en/rest/reference/pulls#create-a-pull-request

Lib JS fournit par github : https://github.com/octokit/request.js/

Avec beaucoup de chance on peut se débrouiller avec ces 4 appels. Je recommanderais d'utiliser un compte github externe sans droit d'écriture au repo (c'est plus secure et normalement ça marche).

astranchet commented 4 years ago

J'ai vu sur github qu'il y avait en fait aussi déjà une interface sur Netifly pour créer une fiche. C'est déjà un petit pas mais elle n'est pas intégré au reste du parcours donc c'est dommage et le fait qu'elle soit générée automatiquement fait que l'interface n'est pas toujours optimale (que ça soit dans le nom des champs ou des boutons, les types de champs affichés, l'aide...).

jdauphant commented 4 years ago

L'interface Netifly est encore lourde pour un débutant (il faut un compte github et avoir les droits sur github sur le repo beta.gouv.fr)

astranchet commented 4 years ago

Je suis en train de travailler sur l'interface, et par exemple sur le champ "Rôle". Je voudrais proposer des valeurs "communes" mais laisser le champ libre.

Pour info, voici ce qu'on retrouve dans la "base" aujourd'hui :

grep "role:" content/_authors/* | cut -d ":" -f3 | sort | uniq -c | sort -r
 167  Développeur
  69  Intrapreneur
  44  Intrapreneuse
  31  Coach
  15  Chargée de développement
  15  Chargé de développement
  12  Chargée de déploiement
  11  Développeuse
   9  Responsable de produit
   8  Chargé de déploiement
   7  Designer
   7  Business Developer
   5  UX designer
   4  UX Designer
   4  Product Owner
   4  Intrapreneure
   4  Designer UX/UI
   3  Développeur web
   3  Développeur full-stack
   3  Développeur Fullstack
   3  Cheffe de produit
   3  Chef de produit
   3  Chargée de développement territorial Bas-Rhin
   3  Chargée de déploiement
   2  Équipe projet
   2  intrapreneur
   2  intrapeneur
   2  Volontaire
   2  Tech lead
   2  Stagiaire
   2  Ops
   2  Entrepreneur d'intérêt général
   2  Développeur fullstack
   2  Développeur
   2  Developpeur
   2  DevOps
   2  Designer UX / UI
   2  Designer UI / UX
   2  Data scientist
   2  Data Scientist
   2  Chargée de développement territorial Hérault
   2  Chargée d'accompagnement
   2  Chargé de développement territorial Seine-Saint-Denis
   2  Chargé de déploiement
   2  Chargé d'accompagnement
   2  CTO
   2  Business developer
   1  développeur
   1  déploiement
   1  datalchemist & business developper
   1  coach, PO/PM, portage
   1  coach
   1  co-animateur de l'incubateur Pôle emploi
   1  co-animateur de l'incubateur
   1  co-animateur de l'Incubateur des Territoires
   1  chargée de missions inclusion et communs numériques à l'ANCT
   1  awesome dev
   1  animatrice pré-incubation ARS Ile de France
   1  VP Product
   1  UX/UI designer
   1  UX-UI Designer
   1  UX research, content management
   1  UX Designer transverse
   1  UX & growth
   1  UX
   1  Support aux utilisateurs des APIs
   1  Support
   1  Statisticienne
   1  Startup Coach
   1  Stagiaire
   1  Software Designer
   1  Sociologue
   1  Référent Technique / Développeur
   1  Responsable produit
   1  Responsable du déploiement
   1  Responsable de produit junior
   1  Responsable de l'incubateur des Ministères Sociaux
   1  Responsable de l'incubateur de Pôle emploi
   1  Responsable adjoint du laboratoire d'innovation du Ministère de l'Intérieur
   1  Responsable Lab du Ministère de l'intérieur
   1  Relation et service à l'usager
   1  Punk Développeur
   1  Product manager
   1  Product designer
   1  PO
   1  OpsDev
   1  Ops / DevOps
   1  OPS
   1  Mentor Technique et Produit
   1  Mentor
   1  Maker
   1  Lien DGEC-DGPR
   1  Lead Développeur
   1  Lead Developper
   1  Investigatrice
   1  Intrapreneure / "Aides-territoires"
   1  Intrapreneur/expert métier
   1  Intrapreneur
   1  Ingénieur recherche
   1  Ingénieur pédagogique multimédia
   1  Ingénieur pédagogique multimedia
   1  Illustrateur
   1  Growth Hacking / Product strategist / Couteau suisse bourguignon
   1  Growth Hacker 🚀
   1  Gestionnaire publique
   1  Gentil organisateur
   1  Full-stack developpeur
   1  Full-stack / DevOps / Data Something
   1  Full-stack
   1  Experte scientifique
   1  Expert scientifique
   1  Expert jardinage dans l'espace public
   1  Ergonome
   1  Entrepreneur public
   1  Entrepreneur en résidence
   1  En immersion
   1  Développeu·r·se
   1  Développeuse full-stack
   1  Développeure
   1  Développeur web / Data scientist
   1  Développeur open source
   1  Développeur full-stack senior / Data trucs
   1  Développeur full stack
   1  Développeur […]
   1  Développeur Produit
   1  Développeur Full-stack
   1  Développeur / Product Owner / Accompagnateur Running Lean
   1  Développeur / Data Scientist
   1  Développement commercial
   1  Déploiement
   1  Directeur opérationnel
   1  Developer
   1  Dev Agile
   1  Dev
   1  Designeure
   1  Designer UI/UX # Développeuse / Développeur / Intrapreneuse / Intrapreneur / Coach / Chargée de développement / Chargé de développement...
   1  Designer / Product Owner
   1  Datatouilleur
   1  Data Girl
   1  Data Geek
   1  Data Analyste
   1  Communication
   1  Coach, Rails Dev
   1  Coach et développeuse junior
   1  Coach et accoucheur de papillons
   1  Coach Produit
   1  Coach Experience Design & Product
   1  Coach Cyber & Compliance
   1  Coach
   1  Co-responsable du déploiement d'Administration+ sur les Maisons France Service
   1  Co-animatrice du programme beta.gouv.fr
   1  Co-animatrice du programme Startups d'État
   1  Co-animateur du programme beta.gouv.fr
   1  Co-animateur
   1  Claquettiste 🕺
   1  Cheffe de produit par interim et chargée de déploiement
   1  Cheffe de Produit
   1  Chef du laboratoire d'innovation du Ministère de l'Intérieur
   1  Chef de projet
   1  Chef de la Fabrique numérique
   1  Chef de Produit
   1  Chargée de suivi de l'expérimentation
   1  Chargée de mission
   1  Chargée de marketing et développement produit
   1  Chargée de développement territorial Guyane
   1  Chargée de développement territorial Finistère et Guyane
   1  Chargée de développement territorial Finistère
   1  Chargée de développement territorial
   1  Chargée de développement stagiaire
   1  Chargée de développement Seine-Saint-Denis & opérateurs nationaux
   1  Chargée de développement
   1  Chargée de développement
   1  Chargée de déploiement
   1  Chargée de deploiement
   1  Chargée d'Accompagnement
   1  Chargé de développement territorial Hérault
   1  Chargé de développement territorial Finistère
   1  Chargé de déploiement et formation
   1  Chargé de deploiement
   1  Chargee de la moderation et de l'animation reseau
   1  Chargee de communication editoriale
   1  CNAMien spécialiste des systèmes d'informations
   1  CNAMien spécialiste de l'organisation sanitaire.
   1  Business développeuse
   1  Business Development
   1  Buisiness Developer & Coach
   1  Bizdev
   1  Biz dev
   1  Artisan éleveur de lignes de code / Aime les Rubis sur rails et VueJS
   1  Animateur de la Communauté A+
   1  'Growth Hacker '
   1  "Développeur
   1   Chargé de développement

Typiquement, c'est chouette de laisser la personnalité de chacun s'exprimer mais on a des données pas facilement consolidable ensuite ("Bizdev" ou "Biz dev" autant mettre la même valeur).

jdauphant commented 4 years ago

Je comptais laisser la section role libre. Mais mettre un mutltisecteur d'intérêts ou sous-role pour catégoriser. Par contre, je me souviens pourquoi on en avait besoins :thinking:

astranchet commented 4 years ago

On se programme une session de travail pour discuter de ces champs et de à quoi ils servent ? Ça sera l'occasion de mettre ca a plat !

Le lun. 24 août 2020 à 16:29, Julien DAUPHANT notifications@github.com a écrit :

Je comptais laisser la section role libre. Mais mettre un mutltisecteur d'intérêts ou sous-role pour catégoriser. Par contre, je me souviens pourquoi on en avait besoins 🤔

— You are receiving this because you were assigned. Reply to this email directly, view it on GitHub https://github.com/betagouv/secretariat/issues/152#issuecomment-679161173, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAKPRNII6HFUBBPLKAFFGITSCJ2LXANCNFSM4QIG4NBQ .

astranchet commented 4 years ago

Un début d'interface https://www.figma.com/proto/PwjUHlF7UIt0hywZP2CeJD/betagouv?node-id=390%3A0&scaling=min-zoom

jdauphant commented 4 years ago

Le status est une liste à 3-4 choix. La startup d'état est facultatif pour le moment. C'est pas proscrit les placeholders ? il me semble que ça peut pertuber.

Après le principale est là, on pourra ajuster à l'implémentation. On peut le proposer à la communauté sur #incubateur-stratégie pour avoir un retour avant le développement ?

astranchet commented 4 years ago

Pour les placeholders, tu as raison, old habits die hard !

Je complète 2-3 trucs ce week-end dans la maquette (checkliste pour moi)

[ ] Checkbox pour le statut (en expliquant chacun)
[ ] Icône "Date" pour les inputs missions (décrire le picker de date)
[x] Faire un lien vers "Créer un compte" sur la page d'accueil
[x] Startup d'État facultatif, menu déroulant
[x] Startup d"Etat : ajouter texte d'aide du genre "Si tu ne le retrouves pas dans la liste, faire machin..."
[x] Créer le compte -> "Créer mon compte BetaGouv"
[x] Faire la page de succès : "Un administrateur va valider ta requête. Tu recevras un email sur plop@gmail.com pour te confirmer que ton compte a bien été créé."

et on montre ensuite à la communauté ?

astranchet commented 4 years ago

@jdauphant J'ai mis à jour l'interface : https://www.figma.com/proto/PwjUHlF7UIt0hywZP2CeJD/betagouv?node-id=390%3A0&scaling=min-zoom

Je me pose une quesion : à quel point est-ce que la création d'email est automatique ? Est-ce que ça sera validée par un.e admin avant (pour éviter pleins de créations d'email ?) ? Qui va transformer le "nom prenom" en nom.prenom@beta.gouv.fr : un.e humain.e ou un algorithme ?

astranchet commented 4 years ago

Concernant les statuts, que représente le statut "Service" ? C'est pour "Société de Service" ? et "Administration", c'est pour les gens en poste à l'administration ?

jdauphant commented 4 years ago

C'est pas un admin, c'est n'importe qui déjà dans la communauté avec une compte github valide (avec la double facteur authentification) et référencé dans sa fiche (ce qui donne les droits). Il y a aura une PR dans github sur betagouv/beta.gouv.fr , si on a du spam, on fera des ajustements.

nom.prenom on va l'automatiser et peut être permettre de le corriger manuellement (ça pourra aussi être corriger si une erreur avant la fusion de la PR).

Service c'est si on est un employé d'une société de service. Et administration, c'est des agents publiques.

astranchet commented 4 years ago

Noté pour le workflow.

nom.prenom on va l'automatiser et peut être permettre de le corriger manuellement (ça pourra aussi être corriger si une erreur avant la fusion de la PR).

C'est exactement à ça que je pensais : est-ce que je montre dans l'interface le mail qui sera fabriqué, et si oui, est-ce que le champ pourrait être éditable ?

jdauphant commented 4 years ago

Il faut l'éditer que s'il y a un soucis (il faudrait surement nudger pour que la proposition par défaut soit accepté et faire corriger que s'il y a une erreur).

Aussi pour "parle en dans le channel #incubateur-secretariat", ce n'est pas encore possible pour la personne car elle n'a pas accès à Slack pour le moment (puisqu'il faut un compte).

astranchet commented 3 years ago

J'ai transformé la description en checkliste. Reste à faire :

créer l'email automatiquement au merge
chercher un.e marrain.e automatiquement

LucasCharrier commented 3 years ago

création automatique des emails : #362

betagouv / secretariat

Proposition de fonctionnalité : création d’email automatique #152